Troubleshooting

Insufficient SOL

Error: Insufficient SOL balance. Have 0.001 SOL, need at least ~0.005 SOL

Your wallet doesn’t have enough SOL to cover network transaction fees.

Fix: Send at least 0.01 SOL to your wallet address. Ask your agent “what’s my wallet address?” to get the address. Network fees for token creation are approximately 0.005 SOL.

IPFS upload failed

Error: IPFS upload failed after 3 attempts

The Pumpfun IPFS endpoint is temporarily unavailable.

Fix: Wait a few minutes and try again. The script retries 3 times with exponential backoff automatically. If it keeps failing, Pumpfun’s IPFS service may be experiencing issues — try again later.

Make sure your image file is a valid format (PNG, JPG, GIF, or WebP) and not too large.

Transaction not confirmed

Error: Transaction timeout or transaction was sent but confirmation timed out

The transaction was submitted to Solana but wasn’t confirmed within the 60-second timeout.

Fix: This doesn’t necessarily mean it failed. The transaction may still confirm. Check the mint address on pump.fun to see if the token exists. If it does, proceed normally — the agent will detect it. If it doesn’t exist after a few minutes, the transaction was dropped and you can safely retry.

Error: Fee sharing config failed (will retry next interaction)

The token was created successfully, but the fee sharing configuration transaction failed.

Fix: This is automatically retried on your next interaction with the agent. Your token is live and functional — fee sharing just needs to be configured. Tell your agent to “set up fee sharing for [token name]” to retry manually.

Below minimum distributable fee

Error: Below minimum distributable fee

The accumulated creator fees are too small to distribute.

Fix: Wait for more trading activity on your token. Pumpfun has a minimum threshold for fee distribution to avoid dust transactions. Your fees will continue accumulating and can be claimed once the threshold is met.

Node.js not found

Error: node: command not found

Node.js is not installed or not in your PATH.

Fix: Install Node.js from nodejs.org. ShipMyToken requires Node.js 18 or later. Verify installation with node --version.

RPC rate limits

Error: 429 Too Many Requests or Server responded with 429

You’re hitting the rate limit on Solana’s public RPC endpoint.

Fix: Set a custom RPC endpoint by configuring SOLANA_RPC_URL in your skill’s environment. Recommended providers:

Helius — free tier available
QuickNode — free tier available
Alchemy — free tier available

Wallet already configured

Message: Wallet already configured

You already have a wallet set up. This is not an error — it means setup was already completed.

If you need to see your wallet details, ask your agent “show my wallet address” or “backup my wallet”.

Token history not found

Error: No tokens found

You haven’t launched any tokens yet, or the token history file was deleted.

Fix: If you’ve launched tokens before and the history is missing, the data may have been lost. Your tokens still exist on-chain — you can re-add them by providing the mint address to your agent. For new users, just launch your first token.

Connection timeout

Error: Connection timeout or ECONNREFUSED

Cannot connect to the Solana RPC endpoint.

Fix: Check your internet connection. If using a custom RPC endpoint, verify it’s correct and accessible. Try switching to the default public endpoint temporarily to isolate the issue.

FAQ — common questions
Getting Started — setup guide
Commands — available commands