Skip to content
SHIP MY TOKEN SHIP MY TOKEN

Troubleshooting

Insufficient SOL

Section titled “Insufficient SOL”

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

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

Fix: Send at least 0.02 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.015 SOL.

IPFS upload failed

Section titled “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

Section titled “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.

Fee sharing configuration failed

Section titled “Fee sharing configuration failed”

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

Section titled “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

Section titled “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. SHIP MY TOKEN requires Node.js 18 or later. Verify installation with node --version.

RPC rate limits

Section titled “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:

Wallet already configured

Section titled “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

Section titled “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

Section titled “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.

Section titled “Related”