Skip to content

PUMPFUN_VERSIONS.md

Latest commit

 

History

History
126 lines (91 loc) · 9.42 KB

PUMPFUN_VERSIONS.md

File metadata and controls

126 lines (91 loc) · 9.42 KB
Raw

Pump.fun instruction versions

Client TradeConfig defaults to V3 (pumpfun_version=PumpFunVersion.V3). An explicit per-request version wins over the global setting. Low-level unversioned legacy builders retain compatibility; pass a version explicitly when calling them directly. This is independent of the Solana transaction-message version.

  • V1 (Legacy): native SOL curves and wallet SOL settlement only. Direct WSOL, USDC, and other token endpoints are rejected; use cached trade preparation for explicit conversion and native settlement.
  • V2: full account layout, selectable for compatibility.
  • V3: compact 17-account layout; supports native SOL and token quotes using the actual mint owner programs. Active non-cashback curves only in the current builder; unsupported states fail explicitly.

Token-quoted V3 direct trades require an explicit minimum output and verified zero base/quote transfer fees. Unknown or nonzero transfer fees are rejected. Native automatic quotes reject graduation-boundary buys rather than silently using partial fill. Cached multi-hop routes use coherent account snapshots and protect every leg; no RPC runs during quoting or building.

Replay and optional simulation

A per-hop version takes precedence over the request/global version in both directions. The replay example accepts pumpfun_version in each legs or candidates entry, so explicit hop versions survive route discovery.

Direct native V1/V3 buys and sells use wallet SOL. An explicit WSOL endpoint is rejected; use cached trade preparation for WSOL settlement and multi-hop routes, which include the required wrapping/unwrapping instructions.

A per-call fixed output overrides the protocol minimum: on sells it is the minimum received; on buys it selects exact output with the supplied input as the maximum budget. Native WithMaxInput buys estimate the token target from the supplied curve and apply slippage to the input budget. Token-quoted maximum-input buys require an explicit target; the SDK does not infer it from SOL units.

中文：原生 V1/V3 直接买卖使用钱包 SOL；V1 不会把显式指定的 WSOL、USDC 或其它代币改成 SOL，需走缓存路由的显式转换流程。 单笔固定输出优先于协议最小输出；买入表示目标数量，卖出表示到账下限。 WithMaxInput 保留最大输入语义，非 SOL 报价必须明确提供目标数量。

Run from this repository, with development dependencies installed:

.venv/bin/python examples/cached_trade.py examples/fixtures/pumpfun_whirlpool_usdc_buy_20261005.json --pumpfun-version v3
.venv/bin/python examples/cached_trade.py examples/fixtures/pumpfun_whirlpool_usdc_sell_20261005.json --pumpfun-version v3

Replace v3 with v1 or v2 to compare versions. These fixtures route USDC through SOL into a native Pump.fun curve (and the reverse); they are not token-quoted stock curves. The direct V3 unit tests separately exercise token-quoted curves and Token-2022 account roles. Snapshot files explicitly retain their original V2 version so saved simulation hashes stay reproducible. V1 fee recipient selection may vary, so compare instruction semantics rather than whole-wire hashes.

Add --simulate with SOLANA_RPC_URL to request simulateTransaction without broadcasting. Historical account snapshots may no longer match current chain state; refresh snapshots before treating simulation as current evidence. Offline construction alone is not successful mainnet execution.

中文：客户端全局默认 V3，单笔显式版本优先；V1 仅支持原生 SOL 内盘。示例支持三个版本的多跳买卖，默认离线构建，只有 --simulate 才访问 RPC，不广播。历史 V2 快照保持原样，不能作为 V3 当前链上模拟成功的证据。股票代币作为报价币时，V3 必须提供最小输出及已验证为零的转账费，并使用实际 Token Program。

Official multi-hop

Execution selection

The cached-trade request's pump_route selects execution independently of PumpFunVersion:

  • auto (default) prefers official multi_hop_swap only for a validated chain of 2–3 Pump.fun curves/canonical migrated PumpSwap pools, with an explicit fresh final minimum output and current PumpSwap GlobalConfig buyback recipient wallet.
  • official requires eligibility and both inputs; unsupported paths fail.
  • sequential keeps the existing swaps and per-hop limits in one atomic transaction.

prepare_cached_trade uses supplied frozen accounts only, with no RPC during selection or building. Cross-DEX conversions, missing official context, splits and unsupported layouts keep their existing path under Auto. Native SOL temporary-account settlement and currency curves using wallet SOL also retain that path in this cache facade; use the explicit official example below for native curve settlement. Existing prepared pool/candidate-quote APIs keep their sequential behavior.

Sequential hop quotes are not official-route quotes: fee placement differs. Supply an independently quoted final minimum. Auto fallback must satisfy that minimum or fail. There is no route retry after a simulation/submission error. An official prepared route has execution = "official", one swap and an aggregate minimum; legs is empty because per-hop estimates/fills are unknown. The separate sol-trade-router-sdk CPI router remains an explicit alternative. Low-level derive/build APIs retain 4+ hop support with v0 + caller-provided ALTs; this selector accepts 2–3 hops.

The cached_trade JSON example accepts this optional request field (raw u64 amounts use decimal strings):

"pump_route": {
  "execution": "auto",
  "minimum_output_amount": "RAW_FINAL_MINIMUM",
  "buyback_recipient": "CURRENT_RECIPIENT_WALLET"
}

中文：默认 Auto 只在完整的 Pump 路径和独立官方最终下限均可用时切换； Official 强制校验，Sequential 保留逐跳。跨 DEX 与缓存入口的原生 SOL 临时账户结算 保持原逻辑。官方聚合结果不编造逐跳报价；缺少官方报价不会直接套用旧路径的报价。

pump_multi_hop reads one current RPC account batch and calls the native-language official execution selector. It supports 2 or 3 hops through Pump.fun curves and canonical migrated PumpSwap pools. --venue checks the target; intermediate venues may differ. This is the official PumpSwap multi_hop_swap, distinct from independently constructed swaps.

python -m examples.pump_multi_hop --help
export SOLANA_RPC_URL='YOUR_RPC_URL'

# Pump.fun 内盘买入 / curve buy
python -m examples.pump_multi_hop --venue pumpfun --side buy \
  --path SOL,INTERMEDIATE_MINT,CURVE_TARGET_MINT --user WALLET_PUBKEY \
  --amount RAW_LAMPORTS --min-out RAW_TARGET_MIN --simulate

# Pump.fun 内盘卖出 / curve sell
python -m examples.pump_multi_hop --venue pumpfun --side sell \
  --path SOL,INTERMEDIATE_MINT,CURVE_TARGET_MINT --user WALLET_PUBKEY \
  --amount RAW_TARGET_INPUT --min-out RAW_LAMPORTS_MIN --simulate

# PumpSwap 外盘买入 / pool buy
python -m examples.pump_multi_hop --venue pumpswap --side buy \
  --path SOL,INTERMEDIATE_MINT,POOL_TARGET_MINT --user WALLET_PUBKEY \
  --amount RAW_LAMPORTS --min-out RAW_TARGET_MIN --simulate

# PumpSwap 外盘卖出 / pool sell
python -m examples.pump_multi_hop --venue pumpswap --side sell \
  --path SOL,INTERMEDIATE_MINT,POOL_TARGET_MINT --user WALLET_PUBKEY \
  --amount RAW_TARGET_INPUT --min-out RAW_LAMPORTS_MIN --simulate

--path always uses buy order; sell reverses hop groups. Amounts are raw positive u64 values; --min-out protects the final route output and requires a fresh quote. No prices are inferred. The currency may also be USDC or another supported quote mint. All mints, owners, curve/pool identities, quote pairs and the current buyback recipient are validated; the SDK builder validates canonical addresses and route continuity.

路径始终按买入顺序填写，卖出自动反转。SOL 买入时，资金端外盘需要包装并 sync_native，资金端内盘支付原生 SOL；外盘卖出保留 WSOL，内盘卖出收原生 SOL。只幂等创建两端和回购 ATA，不创建中间币 ATA，不关闭已有 WSOL。生产环境应使用订阅快照准备账户，RPC 仅在此示例中用于启动与显式模拟。

The example constructs a V1 message (Solana message version, independent of Pump instruction versions). Omit --simulate to build only. Simulation uses zero signatures and sigVerify=false; it needs a funded wallet and, for an independent sell, real input tokens. It never signs or broadcasts. Optional --report NEW_FILE saves route identities, original wire, snapshot slot and simulation response without overwriting files. Simulation errors return a nonzero exit code.

参考：官方 MULTI_HOP_SWAP 文档。

Validated on mainnet on 2026-10-26: curve buy/sell and pool buy/sell all returned err=null, with snapshot slots 461383442, 461384911, 461384918, 461384928 respectively. Compute units were 171505, 154385, 136789, 119631; all three language examples produced the same CU for each workflow. Simulations used public wallet keys and zero signatures, with no broadcast. The small test amounts and min-out=1 were for instruction validation only; supply current quoted limits for trading.

Each language also rejected an intentionally excessive min-out with ExceededSlippage (Custom:6004), preserved the simulation response in its report and exited with an error.