（3891期）Pump Sdk Core – Solana 代币交易离线构建工具

Solana 代币交易离线构建工具 Pump.fun 官方开源 SDK，提供离线构建 Solana 交易指令的能力，支持代币创建、买卖、迁移及创作者费用收取，无需实时 RPC 连接即可完成交易构造。 使用说明 核心用法 Pump SDK Core 是一个离线优先的 TypeScript SDK，专为 Solana 生态的 Pump 协议设计。开发者通过 PumpSdk 类可以在无网络连接的环境下构建完整的交易指令（TransactionInstruction[]），涵盖代币创建（createV2）、买入（buy）、卖出（sell）、自动迁移（migrate）及创作者费用收取等全生命周期操作。SDK 采用 Anchor 框架进行 IDL 驱动的指令序列化，支持 Token 标准（SPL）和 Token-2022 两种代币程序。 对于需要实时链上数据的场景，OnlinePumpSdk 扩展类提供 RPC 账户状态查询能力，包括批量获取多重账户信息（getMultipleAccountsInfo）以及跨程序数据聚合（Bonding Curve + AMM）。所有指令构建方法均返回指令数组而非完整交易对象，允许开发者自由组合、批量签名并优化交易结构。 显著优点 离线优先架构：核心 SDK 无需 RPC 连接即可运行，大幅降低节点依赖成本，适合高频交易场景和本地测试环境。 多程序协同：原生支持 Pump、PumpAMM、PumpFees 三个链上程序及 Mayhem 扩展，统一接口处理 Bonding Curve 定价、自动 AMM 迁移和分层费用机制。 灵活的指令组合：返回 TransactionInstruction[] 的设计模式允许开发者将 ATA 创建、指令执行、账户扩展等操作自由编排为单笔或多笔交易。 完善的类型系统：从账户状态解码（decodeBondingCurve、decodeFeeConfig）到 PDA 派生，全程 TypeScript 类型覆盖，配合 Anchor IDL 保证序列化安全。 滑点与验证内置：自动计算 maxSolCost/minSolReceived，并对股东分配数组执行严格验证（最多10人、总计10,000 bps、无重复零值）。 潜在缺点与局限性 学习曲线陡峭：需要熟悉 Solana 账户模型、Anchor 框架、PDA 派生机制以及 Pump 协议的 Bonding Curve 数学模型，对新手开发者不够友好。 链下状态滞后：离线模式下无法感知账户实时状态（如 BondingCurve.complete 标记），可能构造已失效的交易（如对已毕业代币执行曲线操作）。 环境配置敏感：依赖 SOLANARPCURL 环境变量，且 Token-2022 与 SPL Token 的切换需要显式传递 tokenProgram 参数，容易因参数遗漏导致交易失败。 生态绑定较深：指令结构与 Pump 协议紧密耦合，难以迁移至其他 Launchpad 平台或通用 DEX 场景。 适合的目标群体 Solana 生态开发者：正在构建与 Pump.fun 协议集成的交易机器人、分析工具或前端界面。 量化交易团队：需要离线预构造交易、本地签名后再上链的高频策略开发者。 协议研究者：希望深入理解 Bonding Curve AMM 机制、自动迁移逻辑及创作者费用分配模型。 MEV 搜索者：利用指令级控制能力优化交易打包顺序和计算单元预算。 使用风险 交易失败风险：未检查 BondingCurve.complete 状态或账户扩展需求（BONDINGCURVENEW_SIZE = 151）可能导致链上执行失败并损失计算费。 滑点计算误差：自定义滑点公式（slippage × 10 / 1000）与常规 DEX 表示方式不同，误用可能导致意外成交价格。 依赖项安全风险：依赖 @coral-xyz/anchor 及 Solana Web3.js 版本兼容性，需锁定依赖版本以避免 IDL 不匹配。 私钥管理风险：离线 SDK 使用虚拟密钥对初始化，生产环境需确保真实签名者隔离，防止私钥泄露。 废弃接口遗留：createInstruction（v1）已废弃但仍存在于代码库，维护旧项目时需主动迁移至 createV2Instruction。 原始说明 Build and extend the core Pump SDK — an offline-first TypeScript SDK that constructs Solana TransactionInstructions for token creation, buying, selling, migr...