Errors
Common Errors & Fixes
Common Error Codes and Solutions
Wallet and Transaction Errors
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
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
Non Base58 Error
Key Format Error
Usually caused by private key issues in .ENV file. Verify correct key entry
Network and RPC Errors
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
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
Last updated