.fomo developer platform
build with names
the family remembers.
Resolve human-readable .fomo identities, read the public registry, surface marketplace listings and verify every paid claim with its Solana transaction proof.
01 · QUICK START
resolve a name in seconds.
The resolver is public, read-only and CORS-enabled. No API key or wallet connection is required.
curl https://dotfomo-names.oversmart.chatgpt.site/api/resolve/explorer.fomoconst response = await fetch(
"https://dotfomo-names.oversmart.chatgpt.site/api/resolve/explorer.fomo"
);
if (!response.ok) throw new Error("Name not found");
const record = await response.json();
console.log(record.targets.solana);{
"domain": "explorer.fomo",
"ownerWallet": "AiV...8ZPj",
"targets": {
"solana": "AiV...8ZPj",
"base": null,
"bnb": null,
"monad": null
}
}02 · ARCHITECTURE
onchain settlement. signed ownership. fast resolution.
.fomo is a hybrid registry. Registration and marketplace payments settle in SOL on Solana mainnet and are verified from RPC transaction data. Name records resolve from the registry database. Transfers and listing changes require an Ed25519 message signed by the current wallet owner.
A unique 10-minute reservation and memo are created.
The wallet sends the exact SOL amount with that memo.
The server checks signer, recipient, amount, memo and time.
Ownership is written once; the transaction cannot be reused.
.fomo names are registry records, not NFTs or Solana Name Service domains. The onchain transaction is the payment proof; resolution and ownership state are served by this independent registry.
03 · RESOLVE NAMES
one endpoint, chain-aware responses.
/api/resolve/:nameReturn the full owner and address-target record.
/api/resolve/:name?chain=solanaReturn only the requested chain target.
/api/resolve/:nameCORS preflight for browser integrations.
import { useEffect, useState } from "react";
export function useFomoName(name) {
const [record, setRecord] = useState(null);
useEffect(() => {
if (!name) return;
fetch("https://dotfomo-names.oversmart.chatgpt.site/api/resolve/" + encodeURIComponent(name))
.then((response) => response.ok ? response.json() : null)
.then(setRecord);
}, [name]);
return record;
}04 · REGISTRY API
search public registrations and proof.
/api/registrations?page=1Paginated registrations, 18 records per page.
/api/registrations?q=explorerPrefix-search names and return transaction proof URLs.
/api/availability/:nameCheck registered and temporary-reservation state.
/api/statusLive Solana RPC and registry health.
type FomoRegistration = {
name: string;
domain: string;
owner: string;
createdAt: string;
proofType: "solana" | "admin";
proofUrl: string | null;
};
const { registrations } = await fetch(
"https://dotfomo-names.oversmart.chatgpt.site/api/registrations?page=1"
).then((response) => response.json());05 · REGISTRATION FLOW
build a verifiable claim transaction.
- 1POST /api/reserve
Send the normalized name and connected wallet. The response contains the treasury, exact lamports and unique memo.
- 2GET /api/solana/blockhash
Fetch a fresh mainnet blockhash through the protected server connection.
- 3Sign and send
Create one System Program transfer plus one Memo Program instruction.
- 4POST /api/register
Submit the reservation, wallet and transaction signature. Only verified payments create a record.
import { Buffer } from "buffer";
import {
PublicKey,
SystemProgram,
Transaction,
TransactionInstruction,
} from "@solana/web3.js";
const transaction = new Transaction({
feePayer: ownerPublicKey,
blockhash,
lastValidBlockHeight,
});
transaction.add(SystemProgram.transfer({
fromPubkey: ownerPublicKey,
toPubkey: new PublicKey(reservation.payment.recipient),
lamports: reservation.payment.lamports,
}));
transaction.add(new TransactionInstruction({
keys: [],
programId: new PublicKey("MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr"),
data: Buffer.from(reservation.reservation.memo, "utf8"),
}));06 · MARKETPLACE
owner-listed names with direct settlement.
Owners choose any custom price from 0.001 to 10,000 SOL and can update it with a new wallet signature. Marketplace SOL moves directly from buyer to seller. The registry changes owner only after the exact payment and unique sale memo verify.
/api/listingsActive listings, market stats and recent verified sales.
/api/listings/:name/reserveLock a listing for one buyer for ten minutes.
/api/listings/:name/buyVerify the payment and atomically move ownership.
const market = await fetch(
"https://dotfomo-names.oversmart.chatgpt.site/api/listings"
).then((response) => response.json());
console.log(market.stats.floorSol);
console.table(market.listings);
// Every listing includes its domain profile.
const { avatarUrl, bannerUrl, displayName, fomoUrl, profileUrl } =
market.listings[0].profile;07 · DOMAIN PROFILES
pictures and social identity, owned by the name.
Every registered name has a public profile route. The current domain owner can add an avatar, wide banner, display name, bio, public fomo.family link, X, Telegram, and website with a wallet-signed update. Profiles also expose registry activity, owned-name collections, and verified sale proofs. Profile data is cleared when the domain changes hands.
/api/profiles/:nameRead the public profile, listing state, owner wallet, and registration proof.
/api/profiles/:name/avatarServe the validated profile picture from object storage.
/api/profiles/:name/bannerServe the validated profile banner from object storage.
/api/profiles/:nameSave a multipart profile update after an Ed25519 ownership challenge.
/:name.fomoOpen the shareable public trader profile.
const { profile } = await fetch(
"https://dotfomo-names.oversmart.chatgpt.site/api/profiles/explorer"
).then((response) => response.json());
console.log(profile.domain); // explorer.fomo
console.log(profile.ownerWallet); // full Solana address
console.log(profile.avatarUrl); // same-origin image URL
console.log(profile.bannerUrl); // same-origin banner URL
console.log(profile.stats.marketSales); // registry-verified sales
console.log(profile.registrationProofUrl); // Solscan transactionA fomo.family URL is supplied and signed by the .fomo domain owner. It is displayed as “linked by domain owner,” not as official fomo.family OAuth verification.
08 · WALLET ACTIONS
prove ownership without spending SOL.
Transfers, listings and unlistings use short-lived, single-use challenges. The message includes the wallet, action, normalized payload, nonce and expiry.
const challenge = await fetch("https://dotfomo-names.oversmart.chatgpt.site/api/auth/challenge", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
wallet,
purpose: "transfer",
name: "explorer",
recipientWallet,
}),
}).then((response) => response.json());
const { signature } = await provider.signMessage(
new TextEncoder().encode(challenge.message),
"utf8"
);09 · SECURITY MODEL
checks that prevent free or replayed claims.
The payer must be a signer in the parsed Solana transaction.
Registration and sale amounts must exactly match the reservation.
Every reservation has an unguessable ID bound to its name.
Verified payment signatures are unique and cannot be reused.
Non-payment mutations require the current wallet's signature.
Pictures are size-limited, magic-byte checked, isolated, and never accepted as SVG.
Provider credentials never ship to browser JavaScript.
10 · ERRORS & LIMITS
predictable JSON errors.
400Invalid input or unconfirmed paymentValidate the name, wallet, signature and retry confirmation.
403Ownership proof failedThe wallet signature or current owner did not match.
404Name not foundThe requested registry record does not exist.
409State changedName, reservation, listing or payment is no longer usable.
429Rate limitedWait before repeating high-frequency requests.
502/503Temporary upstream issueRetry with the same reservation and transaction signature.