mirror of
https://github.com/chainstacklabs/pumpfun-bonkfun-bot.git
synced 2026-08-13 15:28:05 +00:00
Refresh the vendored IDLs from pump-fun/pump-public-docs @ 9c82f61 and move all pump.fun trading onto the v2 instruction interface. This is required, not optional: legacy buy/sell cannot trade coins paired against a quote asset other than SOL, and USDC is already whitelisted in the on-chain Global account. Protocol changes absorbed: - buy_v2 (27 accounts) / sell_v2 (26 accounts) replace the legacy instructions. Every account is mandatory and the order is identical for all coins, so the conditional cashback/mayhem account lists are gone. Legacy remains available via PumpFunInstructionBuilder(use_legacy_instructions=True). - BondingCurve is 151 bytes: virtual_sol_reserves -> virtual_quote_reserves, real_sol_reserves -> real_quote_reserves, plus quote_mint at offset 83. Old field names are kept as aliases so existing callers keep working. - v2 instruction data drops the track_volume OptionBool; amounts are in the quote mint's raw units rather than always lamports. - create_v2 carries a non-SOL quote mint as optional remaining accounts 17-19, and CreateEvent gained quote_mint, so extreme_fast_mode can resolve the quote asset without an extra fetch. USDC support: new trade.quote_amounts and filters.allowed_quote_mints config, accepting "sol"/"usdc" aliases or raw mints. Amounts are per-quote-mint because 1 USDC and 1 SOL are not interchangeable. A coin whose quote mint has no configured amount is skipped rather than traded at the wrong size, so SOL-only configs are unaffected. Bug fixes found while verifying: - The logs and blocks listeners set no websocket max_size, so any frame over 1 MiB closed the connection with 1009 and the token in it was lost. Raised to 32 MiB. - PumpSwap priced against the raw quote vault balance, ignoring the new Pool.virtual_quote_reserves (i128 at offset 245; live pools are 301 bytes). Upstream's note that this field is 0 everywhere is out of date: a live pool carries 17.58 SOL against a 148 SOL vault, a 10.15% price error. - The seller read curve state once at confirmed commitment and silently fell back to create-time values, risking a stale creator_vault and ConstraintSeeds. It now retries at processed, matching the buyer. - Account cleanup would burn wrapped SOL when force_burn was set, destroying value that closing the account returns. WSOL is now closed without burning. - The mint scripts treated a landed transaction as a successful one, so a reverted buy printed as success. They now assert the on-chain result. Compute unit limits retuned from mainnet measurements: buy 100k -> 180k, sell 60k -> 120k. Mint-and-buy is no longer atomic, because create_v2 plus buy_v2 exceeds the 1232-byte transaction limit; both mint scripts send two transactions. Adds learning-examples/pump_v2.py as one shared, standalone v2 toolkit for the example scripts, and three verification scripts: an offline layout check against the IDL, a no-funds mainnet simulation, and a live listener matrix that buys, sells and closes the ATA per listener. Verified on mainnet: all four listeners (geyser, logs, blocks, pumpportal) and all eight example scripts completed a real buy, sell and ATA close, each confirmed by reading the transaction result back rather than trusting confirmation alone. The USDC path is verified structurally only; no USDC-paired coin could be found on-chain to exercise it. Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
112 lines
5.2 KiB
YAML
112 lines
5.2 KiB
YAML
# This file defines comprehensive parameters and settings for the trading bot.
|
|
# Carefully review and adjust values to match your trading strategy and risk tolerance.
|
|
|
|
# Bot identification and connection settings
|
|
name: "bot-sniper-1"
|
|
env_file: ".env"
|
|
rpc_endpoint: "${SOLANA_NODE_RPC_ENDPOINT}"
|
|
wss_endpoint: "${SOLANA_NODE_WSS_ENDPOINT}"
|
|
private_key: "${SOLANA_PRIVATE_KEY}"
|
|
|
|
enabled: true # You can turn off the bot w/o removing its config
|
|
separate_process: true
|
|
|
|
# Options: "pump_fun" (default), "lets_bonk"
|
|
platform: "pump_fun"
|
|
|
|
# Geyser configuration (fastest method for getting updates)
|
|
geyser:
|
|
endpoint: "${GEYSER_ENDPOINT}"
|
|
api_token: "${GEYSER_API_TOKEN}"
|
|
auth_type: "x-token" # or "basic"
|
|
|
|
# Trading parameters
|
|
# Control trade execution: amount of SOL per trade and acceptable price deviation
|
|
trade:
|
|
buy_amount: 0.0001 # Amount of SOL to spend when buying (in SOL)
|
|
buy_slippage: 0.3 # Maximum acceptable price deviation (0.3 = 30%)
|
|
sell_slippage: 0.3
|
|
|
|
# Spend amounts for coins paired against a non-SOL quote asset.
|
|
# pump.fun now supports quote mints other than SOL (USDC first). Amounts are
|
|
# in that mint's own whole units, so "usdc: 1.0" means one USDC — it is NOT
|
|
# comparable to buy_amount above. Keys accept the aliases "sol"/"usdc" or a
|
|
# raw base58 mint address. A coin whose quote mint has no entry here is
|
|
# skipped rather than bought with a SOL-sized amount.
|
|
# SOL always uses buy_amount above and needs no entry.
|
|
#quote_amounts:
|
|
# usdc: 1.0
|
|
|
|
# Exit strategy configuration
|
|
exit_strategy: "time_based" # Options: "time_based", "tp_sl", "manual"
|
|
#take_profit_percentage: 0.1 # Take profit at 10% gain (0.1 = 10%)
|
|
#stop_loss_percentage: 0.1 # Stop loss at 10% loss (0.1 = 10%)
|
|
max_hold_time: 5 # Maximum hold time in seconds for TP/SL strategy, for time_based - see wait_after_buy
|
|
#price_check_interval: 2 # Check price every 2 seconds
|
|
|
|
# EXTREME FAST mode configuration
|
|
# When enabled, skips waiting for the bonding curve to stabilize and RPC price check.
|
|
# The bot buys the specified number of tokens directly, making the process faster but less precise.
|
|
extreme_fast_mode: true
|
|
extreme_fast_token_amount: 20 # Amount of tokens to buy
|
|
|
|
# Priority fee configuration
|
|
# Manage transaction speed and cost on the Solana network.
|
|
# Note: dynamic mode requires an additional RPC call, which slows down the buying process.
|
|
priority_fees:
|
|
enable_dynamic: false # Use latest transactions to estimate required fee (getRecentPrioritizationFees)
|
|
enable_fixed: true # Use fixed amount below
|
|
fixed_amount: 1_000_000 # Base fee in microlamports
|
|
extra_percentage: 0.0 # Percentage increase on riority fee regardless of the calculation method (0.1 = 10%)
|
|
hard_cap: 1_000_000 # Maximum allowable fee in microlamports to prevent excessive spending
|
|
|
|
# Compute unit limits for transaction processing
|
|
# Operation-specific defaults are used if not specified: buy=100K, sell=60K
|
|
compute_units:
|
|
# Override default CU limits for this platform
|
|
# buy: 100_000 # Buy operations (ATA creation + trading)
|
|
# sell: 60_000 # Sell operations (just trading)
|
|
|
|
# Account data size optimization (reduces CU cost and improves tx priority)
|
|
# Reduces CU cost from 16k to ~128 CU by limiting loaded account data.
|
|
# Default is 64MB (16k CU). Setting to 512KB significantly reduces overhead.
|
|
# Note: Savings don't show in "consumed CU" but improve tx priority/cost.
|
|
# Note (Nov 23, 2025): with data size set to 512KB, transactions fail - increasing to 12.5MB resolves the issue.
|
|
# Reference: https://www.anza.xyz/blog/cu-optimization-with-setloadedaccountsdatasizelimit
|
|
# account_data_size: 12_500_000 # Disabled: causes MaxLoadedAccountsDataSizeExceeded with Token-2022
|
|
|
|
# Filters for token selection
|
|
filters:
|
|
match_string: null # Only process tokens with this string in name/symbol
|
|
bro_address: null # Only trade tokens created by this user address
|
|
# Restrict which quote assets to trade. Omit (or set null) to allow any quote
|
|
# mint that has an amount configured under trade.quote_amounts.
|
|
# Accepts "sol"/"usdc" aliases or raw mint addresses.
|
|
#allowed_quote_mints: ["sol"]
|
|
listener_type: "geyser" # Method for detecting new tokens: "logs", "blocks", or "geyser"
|
|
max_token_age: 0.001 # Maximum token age in seconds for processing
|
|
marry_mode: false # Only buy tokens, skip selling
|
|
yolo_mode: false # Continuously trade tokens
|
|
|
|
# Retry and timeout settings
|
|
retries:
|
|
max_attempts: 1 # Number of attempts for transaction submission
|
|
wait_after_creation: 15 # Seconds to wait after token creation (only if EXTREME FAST is disabled)
|
|
wait_after_buy: 5 # Holding period after buy transaction
|
|
wait_before_new_token: 15 # Pause between token trades
|
|
|
|
# Token and account management
|
|
cleanup:
|
|
# Cleanup mode determines when to manage token accounts. Options:
|
|
# "disabled": no cleanup will occur.
|
|
# "on_fail": only clean up if a buy transaction fails.
|
|
# "after_sell": clean up after selling.
|
|
# "post_session": clean up all empty accounts after a trading session ends.
|
|
mode: "post_session"
|
|
force_close_with_burn: false # Force burning remaining tokens before closing account
|
|
with_priority_fee: false # Use priority fees for cleanup transactions
|
|
|
|
# Node provider configuration
|
|
node:
|
|
max_rps: 25 # Maximum requests per second
|