Guides / The family business
Troubleshooting
Every error the launch API returns, what it means and what to do. Errors are always { "ok": false, "error": "…" } in plain language.
Launching
| Error | What to do |
|---|
| name is required, at most 32 characters · symbol … at most 10 | Shorten it. Both are permanent. |
| uri must be an https://, ipfs:// or ar:// link… | Host your metadata JSON and pass its link. |
| that name or ticker isn't allowed on Mob | It's on Mob's blocklist. Pick another. |
| that mint address is already in use | Generate a fresh keypair for the mint. |
| Preflight: insufficient funds | Top up the creator wallet; about 0.05 SOL covers everything. |
| The transaction expired | It carries a recent blockhash. Build it again and sign within a minute. |
Treasury, split and register
| Error | What to do |
|---|
| the coin isn't on chain yet | The create transaction hasn't landed. Check its signature, or send it. |
| no Mob launch for this mint | Books are built only for coins Mob built the launch for. |
| make the treasury first | Call /treasury and send its transaction before the split. |
| POST /burn-wallet first, or set burnBps to 0 | Create the burn wallet before giving it a share. |
| the other shares use 100%… | Leave room for the treasury: it gets what's left and needs some. |
| pump allows at most 10 recipients | Combine or drop recipients. |
| a wallet appears twice in the split | Each recipient once. |
| this coin's split is already set | pump.fun allows it once; it's done. You can still register if the treasury is a recipient. |
| only the coin's creator can set its split | Sign with the wallet that created the coin. |
| this coin has graduated… | Setting a split after graduation isn't supported yet. |
| no split on chain yet | Send both split transactions, in order, then register. |
| the treasury isn't one of the split's recipients | The split on chain doesn't pay the treasury Mob made; it can't be registered. |
Sending and limits
| Error | What to do |
|---|
| the network refused it | Read detail: usually a missing signature or an expired blockhash. |
| it landed with an error | It's on chain but failed; detail has the program's error. |
| Not confirmed within 45 s | Not an error: check the signature on Solscan. |
| slow down (429) | Over 30 builds or 10 sends a minute. Wait a minute. |
Still stuck? Write to hello@mob.markets with the mint and the error.