❌Errors

Common Errors & Fixes

Common Error Codes and Solutions

Wallet and Transaction Errors

Error Code	Description	Solution/Explanation
0x1	Insufficient Funds	One or more of your wallets does not have enough SOL to execute the given task
0xc / 12	Symbol too long	Your symbol (ticker) is too long, maximum length is 10 characters
0x1772 / 6002	Slippage Error (Buy)	Too much SOL required to buy the given amount of tokens
0x1773 / 6003	Slippage Error (Sell)	Too little SOL received to sell the given amount of tokens
0x1771 / 101 / 6001	AlreadyInitialized	Token Address already exists as a PF token. Either regenerate Vanity or delete any .JSON files from /token folder

Key and Authentication Errors

Error Code	Description	Solution/Explanation
Bad Secret Key Size	Invalid Key Format	Private key is malformed; keys must be in BASE58 format (Phantom export format)
Invalid Public Key	Address Error	Common causes: incorrect token/wallet address or missing LOOKUP TABLE
Non Base58 Error	Key Format Error	Usually caused by private key issues in .ENV file. Verify correct key entry

Network and RPC Errors

Error Code	Description	Solution/Explanation
BLOCKHASH NOT FOUND	RPC Connection Issue	Retry or change RPCs. Verify IP whitelist status and RPC availability
Fetch Failed	RPC Connection Issue	General RPC communication error
429 Rate Limited	Too Many Requests	RPC usage limit exceeded. Consider upgrading from free RPC tier
500 Internal Server Error	PumpFun/Captcha Error	Either retry the operation or change proxies if in use
403 Unauthorized	Authentication Error	Verify: IP whitelist status, API key correctness, RPC URL accuracy

Data and Configuration Errors

Error Code	Description	Solution/Explanation
0x66 / 102	Deserialization Error	Image size exceeds limit (maximum 4.3MB). Compress image
Account Not Found	Zero Balance	One or more wallets has 0 SOL
Error Uploading Metadata	Signing Error	Metadata too large, usually due to image size (4.3MB maximum)
TypeError: Endpoint URL	Configuration Error	ENV file is either not properly filled out or not saved

---

Best Practices

• Always verify wallet balances before transactions

• Keep image sizes under 4.3MB

• Use reliable RPC providers

• Double-check all key formats and addresses

• Maintain proper configuration in ENV files