four-flap-meme-sdk 1.3.82 → 1.3.83

package/dist/sol/dex/pump/pump-bundle.js

@@ -0,0 +1,383 @@
+/**
+ * Pump.fun 批量签名（用于 Jito Bundle）
+ * 只构建指令和签名，不发送交易，提交到后端服务器通过 Jito 广播
+ * @module sol/dex/pump/pump-bundle
+ */
+import { Keypair, PublicKey, Transaction, } from '@solana/web3.js';
+import BN from 'bn.js';
+import { PUMP_SDK, OnlinePumpSdk, getBuyTokenAmountFromSolAmount, getSellSolAmountFromTokenAmount, } from '@pump-fun/pump-sdk';
+import { getAssociatedTokenAddressSync, createAssociatedTokenAccountIdempotentInstruction, TOKEN_PROGRAM_ID, TOKEN_2022_PROGRAM_ID, } from '@solana/spl-token';
+import { buildTipInstruction, getRandomTipAccount } from '../../jito/tip.js';
+/**
+ * 获取代币程序 ID
+ * Pump 新代币使用 Token-2022，旧代币使用 Token Program
+ */
+async function getTokenProgramForMint(connection, mint) {
+    try {
+        const accountInfo = await connection.getAccountInfo(mint);
+        if (accountInfo && accountInfo.owner.equals(TOKEN_2022_PROGRAM_ID)) {
+            return TOKEN_2022_PROGRAM_ID;
+        }
+    }
+    catch { }
+    return TOKEN_PROGRAM_ID;
+}
+/**
+ * 构建批量买入指令（用于 Jito Bundle）
+ * 每个钱包一笔交易，最后加 Tip 交易
+ *
+ * @param connection Solana 连接
+ * @param mint 代币 Mint 地址
+ * @param buyers 买入列表
+ * @param tipPayer Tip 支付者
+ * @param tipLamports Tip 金额
+ * @param slippageBps 滑点（基点）
+ */
+export async function signPumpBundleBuy(connection, params) {
+    try {
+        const { mint, buyers, tipPayer, tipLamports = BigInt(10000), slippageBps = 100, } = params;
+        if (buyers.length === 0) {
+            return { success: false, error: 'No buyers provided' };
+        }
+        const mintPubkey = new PublicKey(mint);
+        const onlineSdk = new OnlinePumpSdk(connection);
+        // 获取全局状态和 bonding curve
+        const global = await onlineSdk.fetchGlobal();
+        const bondingCurve = await onlineSdk.fetchBondingCurve(mintPubkey);
+        const tokenProgram = await getTokenProgramForMint(connection, mintPubkey);
+        // 获取 blockhash
+        const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash('finalized');
+        const serializedTransactions = [];
+        const allSignatures = [];
+        const tipAccount = getRandomTipAccount();
+        // 为每个买家构建交易
+        for (const { wallet, solAmount } of buyers) {
+            const solAmountBN = new BN(solAmount.toString());
+            // 计算代币数量
+            const tokenAmount = getBuyTokenAmountFromSolAmount({
+                global,
+                feeConfig: null,
+                mintSupply: bondingCurve.tokenTotalSupply,
+                bondingCurve,
+                amount: solAmountBN,
+            });
+            // 计算带滑点的最大 SOL
+            const maxSolAmount = solAmountBN.add(solAmountBN.mul(new BN(slippageBps)).div(new BN(10000)));
+            const instructions = [];
+            // 创建 ATA（如果需要）
+            const ata = getAssociatedTokenAddressSync(mintPubkey, wallet.publicKey, true, tokenProgram);
+            instructions.push(createAssociatedTokenAccountIdempotentInstruction(wallet.publicKey, ata, wallet.publicKey, mintPubkey, tokenProgram));
+            // 买入指令
+            const buyIx = await PUMP_SDK.getBuyInstructionRaw({
+                user: wallet.publicKey,
+                mint: mintPubkey,
+                creator: bondingCurve.creator,
+                amount: tokenAmount,
+                solAmount: maxSolAmount,
+                feeRecipient: global.feeRecipient,
+                tokenProgram,
+            });
+            instructions.push(buyIx);
+            // 构建交易
+            const transaction = new Transaction();
+            transaction.add(...instructions);
+            transaction.recentBlockhash = blockhash;
+            transaction.feePayer = wallet.publicKey;
+            transaction.sign(wallet);
+            const serialized = transaction.serialize();
+            serializedTransactions.push({
+                data: Buffer.from(serialized).toString('base64'),
+                isVersioned: false,
+                signature: transaction.signature ? Buffer.from(transaction.signature).toString('base64') : undefined,
+            });
+            if (transaction.signature) {
+                allSignatures.push(Buffer.from(transaction.signature).toString('base64'));
+            }
+        }
+        // 添加 Tip 交易
+        const tipTx = new Transaction().add(buildTipInstruction(tipPayer.publicKey, tipLamports, tipAccount));
+        tipTx.recentBlockhash = blockhash;
+        tipTx.feePayer = tipPayer.publicKey;
+        tipTx.sign(tipPayer);
+        serializedTransactions.push({
+            data: Buffer.from(tipTx.serialize()).toString('base64'),
+            isVersioned: false,
+            signature: tipTx.signature ? Buffer.from(tipTx.signature).toString('base64') : undefined,
+        });
+        if (tipTx.signature) {
+            allSignatures.push(Buffer.from(tipTx.signature).toString('base64'));
+        }
+        return {
+            success: true,
+            bundleData: {
+                transactions: serializedTransactions,
+                signatures: allSignatures,
+                tip: {
+                    account: tipAccount,
+                    lamports: tipLamports,
+                },
+                recentBlockhash: blockhash,
+                lastValidBlockHeight,
+                createdAt: Date.now(),
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message,
+        };
+    }
+}
+/**
+ * 构建批量卖出指令（用于 Jito Bundle）
+ */
+export async function signPumpBundleSell(connection, params) {
+    try {
+        const { mint, sellers, tipPayer, tipLamports = BigInt(10000), slippageBps = 100, } = params;
+        if (sellers.length === 0) {
+            return { success: false, error: 'No sellers provided' };
+        }
+        const mintPubkey = new PublicKey(mint);
+        const onlineSdk = new OnlinePumpSdk(connection);
+        // 获取全局状态和 bonding curve
+        const global = await onlineSdk.fetchGlobal();
+        const bondingCurve = await onlineSdk.fetchBondingCurve(mintPubkey);
+        const tokenProgram = await getTokenProgramForMint(connection, mintPubkey);
+        // 获取 blockhash
+        const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash('finalized');
+        const serializedTransactions = [];
+        const allSignatures = [];
+        const tipAccount = getRandomTipAccount();
+        // 为每个卖家构建交易
+        for (const { wallet, tokenAmount } of sellers) {
+            const tokenAmountBN = new BN(tokenAmount.toString());
+            // 计算 SOL 数量
+            const solAmount = getSellSolAmountFromTokenAmount({
+                global,
+                feeConfig: null,
+                mintSupply: bondingCurve.tokenTotalSupply,
+                bondingCurve,
+                amount: tokenAmountBN,
+            });
+            // 计算带滑点的最小 SOL
+            const minSolAmount = solAmount.sub(solAmount.mul(new BN(slippageBps)).div(new BN(10000)));
+            // 卖出指令
+            const sellIx = await PUMP_SDK.getSellInstructionRaw({
+                user: wallet.publicKey,
+                mint: mintPubkey,
+                creator: bondingCurve.creator,
+                amount: tokenAmountBN,
+                solAmount: minSolAmount,
+                feeRecipient: global.feeRecipient,
+                tokenProgram,
+            });
+            // 构建交易
+            const transaction = new Transaction();
+            transaction.add(sellIx);
+            transaction.recentBlockhash = blockhash;
+            transaction.feePayer = wallet.publicKey;
+            transaction.sign(wallet);
+            const serialized = transaction.serialize();
+            serializedTransactions.push({
+                data: Buffer.from(serialized).toString('base64'),
+                isVersioned: false,
+                signature: transaction.signature ? Buffer.from(transaction.signature).toString('base64') : undefined,
+            });
+            if (transaction.signature) {
+                allSignatures.push(Buffer.from(transaction.signature).toString('base64'));
+            }
+        }
+        // 添加 Tip 交易
+        const tipTx = new Transaction().add(buildTipInstruction(tipPayer.publicKey, tipLamports, tipAccount));
+        tipTx.recentBlockhash = blockhash;
+        tipTx.feePayer = tipPayer.publicKey;
+        tipTx.sign(tipPayer);
+        serializedTransactions.push({
+            data: Buffer.from(tipTx.serialize()).toString('base64'),
+            isVersioned: false,
+            signature: tipTx.signature ? Buffer.from(tipTx.signature).toString('base64') : undefined,
+        });
+        if (tipTx.signature) {
+            allSignatures.push(Buffer.from(tipTx.signature).toString('base64'));
+        }
+        return {
+            success: true,
+            bundleData: {
+                transactions: serializedTransactions,
+                signatures: allSignatures,
+                tip: {
+                    account: tipAccount,
+                    lamports: tipLamports,
+                },
+                recentBlockhash: blockhash,
+                lastValidBlockHeight,
+                createdAt: Date.now(),
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message,
+        };
+    }
+}
+/**
+ * 构建创建代币 + 批量买入的 Bundle
+ * 第一笔：创建代币 + 创建者购买
+ * 后续：其他钱包购买
+ * 最后：Tip
+ */
+export async function signPumpBundleCreateAndBuy(connection, params) {
+    try {
+        const { name, symbol, uri, creator, mintKeypair = Keypair.generate(), creatorBuyAmount = BigInt(0), buyers, tipPayer, tipLamports = BigInt(10000), slippageBps = 100, mayhemMode = false, } = params;
+        const onlineSdk = new OnlinePumpSdk(connection);
+        const global = await onlineSdk.fetchGlobal();
+        // 获取 blockhash
+        const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash('finalized');
+        const serializedTransactions = [];
+        const allSignatures = [];
+        const tipAccount = getRandomTipAccount();
+        // 第一笔：创建代币（可选：创建者同时购买）
+        let createInstructions;
+        if (creatorBuyAmount > 0) {
+            const solAmount = new BN(creatorBuyAmount.toString());
+            const tokenAmount = getBuyTokenAmountFromSolAmount({
+                global,
+                feeConfig: null,
+                mintSupply: null,
+                bondingCurve: null,
+                amount: solAmount,
+            });
+            createInstructions = await PUMP_SDK.createV2AndBuyInstructions({
+                global,
+                mint: mintKeypair.publicKey,
+                name,
+                symbol,
+                uri,
+                creator: creator.publicKey,
+                user: creator.publicKey,
+                amount: tokenAmount,
+                solAmount,
+                mayhemMode,
+            });
+        }
+        else {
+            const createIx = await PUMP_SDK.createV2Instruction({
+                mint: mintKeypair.publicKey,
+                name,
+                symbol,
+                uri,
+                creator: creator.publicKey,
+                user: creator.publicKey,
+                mayhemMode,
+            });
+            createInstructions = [createIx];
+        }
+        const createTx = new Transaction();
+        createTx.add(...createInstructions);
+        createTx.recentBlockhash = blockhash;
+        createTx.feePayer = creator.publicKey;
+        createTx.sign(creator, mintKeypair);
+        serializedTransactions.push({
+            data: Buffer.from(createTx.serialize()).toString('base64'),
+            isVersioned: false,
+            signature: createTx.signature ? Buffer.from(createTx.signature).toString('base64') : undefined,
+        });
+        if (createTx.signature) {
+            allSignatures.push(Buffer.from(createTx.signature).toString('base64'));
+        }
+        // 后续买家交易
+        // 注意：创建后的 bonding curve 状态需要预估
+        const tokenProgram = TOKEN_2022_PROGRAM_ID; // 新代币使用 Token-2022
+        for (const { wallet, solAmount } of buyers) {
+            const solAmountBN = new BN(solAmount.toString());
+            // 预估代币数量（使用初始状态）
+            const tokenAmount = getBuyTokenAmountFromSolAmount({
+                global,
+                feeConfig: null,
+                mintSupply: null,
+                bondingCurve: null,
+                amount: solAmountBN,
+            });
+            const maxSolAmount = solAmountBN.add(solAmountBN.mul(new BN(slippageBps)).div(new BN(10000)));
+            const instructions = [];
+            // 创建 ATA
+            const ata = getAssociatedTokenAddressSync(mintKeypair.publicKey, wallet.publicKey, true, tokenProgram);
+            instructions.push(createAssociatedTokenAccountIdempotentInstruction(wallet.publicKey, ata, wallet.publicKey, mintKeypair.publicKey, tokenProgram));
+            // 买入指令
+            const buyIx = await PUMP_SDK.getBuyInstructionRaw({
+                user: wallet.publicKey,
+                mint: mintKeypair.publicKey,
+                creator: creator.publicKey,
+                amount: tokenAmount,
+                solAmount: maxSolAmount,
+                feeRecipient: global.feeRecipient,
+                tokenProgram,
+            });
+            instructions.push(buyIx);
+            const transaction = new Transaction();
+            transaction.add(...instructions);
+            transaction.recentBlockhash = blockhash;
+            transaction.feePayer = wallet.publicKey;
+            transaction.sign(wallet);
+            serializedTransactions.push({
+                data: Buffer.from(transaction.serialize()).toString('base64'),
+                isVersioned: false,
+                signature: transaction.signature ? Buffer.from(transaction.signature).toString('base64') : undefined,
+            });
+            if (transaction.signature) {
+                allSignatures.push(Buffer.from(transaction.signature).toString('base64'));
+            }
+        }
+        // Tip 交易
+        const tipTx = new Transaction().add(buildTipInstruction(tipPayer.publicKey, tipLamports, tipAccount));
+        tipTx.recentBlockhash = blockhash;
+        tipTx.feePayer = tipPayer.publicKey;
+        tipTx.sign(tipPayer);
+        serializedTransactions.push({
+            data: Buffer.from(tipTx.serialize()).toString('base64'),
+            isVersioned: false,
+            signature: tipTx.signature ? Buffer.from(tipTx.signature).toString('base64') : undefined,
+        });
+        if (tipTx.signature) {
+            allSignatures.push(Buffer.from(tipTx.signature).toString('base64'));
+        }
+        return {
+            success: true,
+            mintAddress: mintKeypair.publicKey.toBase58(),
+            bundleData: {
+                transactions: serializedTransactions,
+                signatures: allSignatures,
+                tip: {
+                    account: tipAccount,
+                    lamports: tipLamports,
+                },
+                recentBlockhash: blockhash,
+                lastValidBlockHeight,
+                createdAt: Date.now(),
+            },
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message,
+        };
+    }
+}
+/**
+ * 将 Bundle 数据转换为后端 API 格式
+ */
+export function toBundleApiRequest(bundleData) {
+    return {
+        transactions: bundleData.transactions.map(tx => tx.data),
+        signatures: bundleData.signatures,
+        tipAccount: bundleData.tip.account,
+        tipLamports: bundleData.tip.lamports.toString(),
+        recentBlockhash: bundleData.recentBlockhash,
+        lastValidBlockHeight: bundleData.lastValidBlockHeight,
+        timestamp: bundleData.createdAt,
+    };
+}

package/dist/sol/dex/pump/pump-swap-bundle.d.ts

@@ -0,0 +1,103 @@
+/**
+ * Pump Swap 批量签名（用于 Jito Bundle）
+ * 代币毕业后在 Pump Swap 池子进行交易
+ * @module sol/dex/pump/pump-swap-bundle
+ */
+import { Connection, Keypair } from '@solana/web3.js';
+import type { SignedBundleData } from '../../jito/types.js';
+/**
+ * Pump Swap 批量买入项
+ */
+export interface PumpSwapBundleBuyItem {
+    wallet: Keypair;
+    /** SOL 数量（lamports） */
+    solAmount: bigint;
+}
+/**
+ * Pump Swap 批量卖出项
+ */
+export interface PumpSwapBundleSellItem {
+    wallet: Keypair;
+    /** 代币数量 */
+    tokenAmount: bigint;
+}
+/**
+ * Pump Swap Bundle 签名结果
+ */
+export interface PumpSwapBundleSignResult {
+    success: boolean;
+    bundleData?: SignedBundleData;
+    error?: string;
+}
+/**
+ * 构建 Pump Swap 批量买入（Jito Bundle）
+ *
+ * @param connection Solana 连接
+ * @param params 参数
+ */
+export declare function signPumpSwapBundleBuy(connection: Connection, params: {
+    /** 代币 Mint 地址 */
+    mint: string;
+    /** 买入列表 */
+    buyers: PumpSwapBundleBuyItem[];
+    /** Tip 支付者 */
+    tipPayer: Keypair;
+    /** Tip 金额（lamports） */
+    tipLamports?: bigint;
+    /** 滑点（百分比，如 1 表示 1%） */
+    slippagePercent?: number;
+}): Promise<PumpSwapBundleSignResult>;
+/**
+ * 构建 Pump Swap 批量卖出（Jito Bundle）
+ */
+export declare function signPumpSwapBundleSell(connection: Connection, params: {
+    /** 代币 Mint 地址 */
+    mint: string;
+    /** 卖出列表 */
+    sellers: PumpSwapBundleSellItem[];
+    /** Tip 支付者 */
+    tipPayer: Keypair;
+    /** Tip 金额（lamports） */
+    tipLamports?: bigint;
+    /** 滑点（百分比） */
+    slippagePercent?: number;
+}): Promise<PumpSwapBundleSignResult>;
+/**
+ * 构建 Pump Swap 批量买入（按代币数量）
+ * 指定想买多少代币，计算需要多少 SOL
+ */
+export declare function signPumpSwapBundleBuyByTokenAmount(connection: Connection, params: {
+    mint: string;
+    buyers: Array<{
+        wallet: Keypair;
+        tokenAmount: bigint;
+    }>;
+    tipPayer: Keypair;
+    tipLamports?: bigint;
+    slippagePercent?: number;
+}): Promise<PumpSwapBundleSignResult>;
+/**
+ * 构建 Pump Swap 批量卖出（按 SOL 数量）
+ * 指定想获得多少 SOL，计算需要卖多少代币
+ */
+export declare function signPumpSwapBundleSellBySolAmount(connection: Connection, params: {
+    mint: string;
+    sellers: Array<{
+        wallet: Keypair;
+        solAmount: bigint;
+    }>;
+    tipPayer: Keypair;
+    tipLamports?: bigint;
+    slippagePercent?: number;
+}): Promise<PumpSwapBundleSignResult>;
+/**
+ * 获取 Pump Swap 池子信息
+ */
+export declare function getPumpSwapBundlePoolInfo(connection: Connection, mint: string): Promise<{
+    poolAddress: string;
+    baseReserve: bigint;
+    quoteReserve: bigint;
+    lpSupply: bigint;
+    baseMint: string;
+    quoteMint: string;
+} | null>;