pump-trader 1.1.5 → 1.1.9

package/dist/index.d.ts

@@ -1,4 +1,9 @@
 import { Connection, PublicKey, Transaction, TransactionInstruction, Keypair } from "@solana/web3.js";
+/** Wallet 接口：兼容 Keypair（自动签名）和前端钱包适配器（弹出确认） */
+export type Wallet = Keypair | {
+    publicKey: PublicKey;
+    signTransaction<T extends Transaction>(tx: T): Promise<T>;
+};
 interface TradeOptions {
     maxSolPerTx: bigint;
     slippage: {
@@ -33,9 +38,11 @@ interface BondingCurveState {
     realSolReserves: bigint;
     tokenTotalSupply: bigint;
     complete: boolean;
-    quoteMint?: PublicKey;
     isMayhemMode?: boolean;
     isCashbackCoin?: boolean;
+    quoteMint?: PublicKey;
+    virtualQuoteReserves?: bigint;
+    realQuoteReserves?: bigint;
 }
 interface BondingInfo {
     bonding: PublicKey;
@@ -85,15 +92,18 @@ interface MetadataInfo {
 }
 export declare class PumpTrader {
     private connection;
-    private wallet;
+    private _wallet;
+    publicKey: PublicKey;
     private global;
     private globalState;
     private tokenProgramCache;
-    constructor(rpc: string, privateKey: string);
+    constructor(rpc: string, wallet: Wallet);
+    private signTx;
     /**
      * 自动检测代币使用的 token program
      */
     detectTokenProgram(tokenAddr: string): Promise<TokenProgramType>;
+    detectQuoteTokenProgram(quoteMint: PublicKey): Promise<PublicKey>;
     /**
      * 检测代币是否在外盘 (AMM)
      */
@@ -106,6 +116,9 @@ export declare class PumpTrader {
     getBondingPda(mint: PublicKey): PublicKey;
     deriveBondingCurveV2(mint: PublicKey): PublicKey;
     private pickFeeRecipient;
+    private pickBuybackFeeRecipient;
+    private pickReservedFeeRecipient;
+    getSharingConfigPda(mint: PublicKey): PublicKey;
     private buildBondingBuyKeys;
     private buildBondingSellKeys;
     loadBonding(mint: PublicKey): Promise<BondingInfo>;
@@ -117,9 +130,7 @@ export declare class PumpTrader {
         price: number;
         completed: boolean;
     }>;
-    getAmmPrice(mint: PublicKey, quoteMint?: PublicKey): Promise<number>;
-    private getEffectiveQuoteMint;
-    private getMintDecimals;
+    getAmmPrice(mint: PublicKey): Promise<number>;
     /**
      * 查询代币余额
      * @param tokenAddr - 代币地址（可选），如果不传则返回所有代币
@@ -150,17 +161,21 @@ export declare class PumpTrader {
     splitIntoN(total: bigint, n: number): bigint[];
     /**
      * 自动判断内盘/外盘并执行买入
+     * @param useV2 - use buy_v2 instruction (supports USDC quote) instead of legacy buy
+     * @param quoteMint - quote mint for V2 (SOL_MINT for SOL-paired, or USDC mint for USDC-paired)
      */
-    autoBuy(tokenAddr: string, totalSolIn: bigint, tradeOpt: TradeOptions): Promise<TradeResult>;
+    autoBuy(tokenAddr: string, totalSolIn: bigint, tradeOpt: TradeOptions, useV2?: boolean, quoteMint?: PublicKey): Promise<TradeResult>;
     /**
      * 自动判断内盘/外盘并执行卖出
+     * @param useV2 - use sell_v2 instruction (supports USDC quote) instead of legacy sell
+     * @param quoteMint - quote mint for V2 (SOL_MINT for SOL-paired, or USDC mint for USDC-paired)
      */
-    autoSell(tokenAddr: string, totalTokenIn: bigint, tradeOpt: TradeOptions): Promise<TradeResult>;
+    autoSell(tokenAddr: string, totalTokenIn: bigint, tradeOpt: TradeOptions, useV2?: boolean, quoteMint?: PublicKey): Promise<TradeResult>;
     buy(tokenAddr: string, totalSolIn: bigint, tradeOpt: TradeOptions): Promise<TradeResult>;
     sell(tokenAddr: string, totalTokenIn: bigint, tradeOpt: TradeOptions): Promise<TradeResult>;
-    ammBuy(tokenAddr: string, totalSolIn: bigint, tradeOpt: TradeOptions): Promise<TradeResult>;
-    ammSell(tokenAddr: string, totalTokenIn: bigint, tradeOpt: TradeOptions): Promise<TradeResult>;
-    getAmmPoolInfo(mint: PublicKey): Promise<PoolInfo>;
+    ammBuy(tokenAddr: string, totalSolIn: bigint, tradeOpt: TradeOptions, quoteMint?: PublicKey): Promise<TradeResult>;
+    ammSell(tokenAddr: string, totalTokenIn: bigint, tradeOpt: TradeOptions, quoteMint?: PublicKey): Promise<TradeResult>;
+    getAmmPoolInfo(mint: PublicKey, quoteMint?: PublicKey): Promise<PoolInfo>;
     parseAmmGlobalConfig(data: Buffer, address: PublicKey): {
         address: PublicKey;
         admin: PublicKey;
@@ -170,10 +185,39 @@ export declare class PumpTrader {
     deriveAmmPoolV2(baseMint: PublicKey): PublicKey;
     createAmmBuyInstruction(poolInfo: PoolInfo, userBaseAta: PublicKey, userQuoteAta: PublicKey, baseAmountOut: bigint, maxQuoteAmountIn: bigint, tokenProgramId: PublicKey): TransactionInstruction;
     createAmmSellInstruction(poolInfo: PoolInfo, userBaseAta: PublicKey, userQuoteAta: PublicKey, baseAmountIn: bigint, minQuoteAmountOut: bigint, tokenProgramId: PublicKey): TransactionInstruction;
+    /**
+     * Build accounts for buy_v2 instruction (27 accounts)
+     * Ref: https://github.com/pump-fun/pump-public-docs/blob/main/docs/instructions/BUY.md
+     */
+    private buildBondingBuyV2Keys;
+    /**
+     * Build accounts for sell_v2 instruction (26 accounts)
+     * Ref: https://github.com/pump-fun/pump-public-docs/blob/main/docs/instructions/SELL.md
+     */
+    private buildBondingSellV2Keys;
+    /**
+     * Buy using buy_v2 instruction (supports both SOL-paired and USDC-paired coins)
+     * For SOL-paired coins: quoteMint = SOL_MINT, quoteTokenProgram = TOKEN_PROGRAM_ID
+     * For USDC-paired coins: quoteMint = USDC mint, quoteTokenProgram = TOKEN_PROGRAM_ID
+     */
+    buyV2(tokenAddr: string, totalQuoteIn: bigint, tradeOpt: TradeOptions, quoteMint?: PublicKey): Promise<TradeResult>;
+    /**
+     * Sell using sell_v2 instruction (supports both SOL-paired and USDC-paired coins)
+     */
+    sellV2(tokenAddr: string, totalTokenIn: bigint, tradeOpt: TradeOptions, quoteMint?: PublicKey): Promise<TradeResult>;
+    /**
+     * Collect creator fees from bonding curve creator vault (collect_creator_fee_v2)
+     * Ref: https://github.com/pump-fun/pump-public-docs/blob/main/docs/instructions/COLLECT_CREATOR_FEE.md
+     */
+    collectCreatorFeeV2(creator: PublicKey, quoteMint?: PublicKey): Promise<string>;
     confirmTransactionWithPolling(signature: string, lastValidBlockHeight: number, maxAttempts?: number, delayMs?: number): Promise<string>;
     listenTrades(callback: (event: TradeEvent) => void, mintFilter?: PublicKey | null): number;
     fetchMeta(tokenAddr: string): Promise<MetadataInfo | null>;
-    getWallet(): Keypair;
+    /**
+     * 获取原始 wallet 对象（Keypair 或前端 WalletAdapter）
+     */
+    getWallet(): Wallet;
+    getPublicKey(): PublicKey;
     getConnection(): Connection;
     /**
      * 清除token program缓存
@@ -184,4 +228,4 @@ export declare class PumpTrader {
      */
     getCachedTokenProgram(tokenAddr: string): TokenProgramType | undefined;
 }
-export type { TradeOptions, PendingTransaction, FailedTransaction, TradeResult, BondingCurveState, BondingInfo, PoolReserves, TradeEvent, GlobalState, TokenProgramType, PoolInfo, MetadataInfo };
+export type { TradeOptions, PendingTransaction, FailedTransaction, TradeResult, BondingCurveState, BondingInfo, PoolReserves, TradeEvent, GlobalState, TokenProgramType, PoolInfo, MetadataInfo, };