four-flap-meme-sdk 1.4.20 → 1.4.21

package/dist/sol/jito/bundle.d.ts

@@ -1,90 +0,0 @@
-/**
- * Jito Bundle 构建和签名
- * SDK 只负责构建和签名，提交到后端服务器广播
- * @module sol/jito/bundle
- */
-import { Connection, Keypair, Transaction, TransactionInstruction } from '@solana/web3.js';
-import type { SerializedTransaction, SignedBundleData, TransactionBuildOptions } from './types.js';
-/**
- * Bundle 构建器
- * 用于构建、签名 Jito Bundle，然后提交到后端
- */
-export declare class BundleBuilder {
-    private connection;
-    private transactions;
-    private signers;
-    private tipAccount;
-    private tipLamports;
-    constructor(connection: Connection, options?: {
-        tipAccount?: string;
-        tipLamports?: bigint;
-    });
-    /**
-     * 添加交易
-     * @param transaction 交易
-     * @param signers 签名者列表
-     */
-    addTransaction(transaction: Transaction, signers: Keypair[]): this;
-    /**
-     * 添加多个交易
-     * @param items 交易和签名者列表
-     */
-    addTransactions(items: Array<{
-        transaction: Transaction;
-        signers: Keypair[];
-    }>): this;
-    /**
-     * 设置 Tip
-     * @param lamports Tip 金额
-     * @param account Tip 账户
-     */
-    setTip(lamports: bigint, account?: string): this;
-    /**
-     * 获取交易数量
-     */
-    getTransactionCount(): number;
-    /**
-     * 清空所有交易
-     */
-    clear(): this;
-    /**
-     * 构建并签名 Bundle
-     * @param feePayer 手续费支付者
-     * @returns 签名后的 Bundle 数据，用于提交到后端
-     */
-    buildAndSign(feePayer: Keypair): Promise<SignedBundleData>;
-}
-/**
- * 构建单个交易并签名（用于简单场景）
- * @param connection Solana 连接
- * @param instructions 指令列表
- * @param signers 签名者列表（第一个为 feePayer）
- * @param options 选项
- */
-export declare function buildAndSignTransaction(connection: Connection, instructions: TransactionInstruction[], signers: Keypair[], options?: TransactionBuildOptions): Promise<SerializedTransaction>;
-/**
- * 构建批量交易并签名（每个钱包一笔交易）
- * @param connection Solana 连接
- * @param walletInstructions 每个钱包的指令
- * @param options 选项
- */
-export declare function buildAndSignBatchTransactions(connection: Connection, walletInstructions: Array<{
-    wallet: Keypair;
-    instructions: TransactionInstruction[];
-}>, options?: TransactionBuildOptions & {
-    /** 统一的 feePayer，如果不指定则每个钱包自己付费 */
-    feePayer?: Keypair;
-}): Promise<SignedBundleData>;
-/**
- * 将 SignedBundleData 转换为后端 API 需要的格式
- * @param bundleData 签名后的 Bundle 数据
- */
-export declare function toBundleRequest(bundleData: SignedBundleData): {
-    transactions: string[];
-    signatures: string[];
-    tipAccount: string;
-    tipLamports: string;
-    recentBlockhash: string;
-    lastValidBlockHeight: number;
-    timestamp: number;
-};

package/dist/sol/jito/bundle.js

@@ -1,263 +0,0 @@
-/**
- * Jito Bundle 构建和签名
- * SDK 只负责构建和签名，提交到后端服务器广播
- * @module sol/jito/bundle
- */
-import { Transaction, ComputeBudgetProgram, } from '@solana/web3.js';
-import { TX_CONFIG } from '../constants.js';
-import { buildTipInstruction, getRandomTipAccount, calculateRecommendedTip } from './tip.js';
-/**
- * Bundle 构建器
- * 用于构建、签名 Jito Bundle，然后提交到后端
- */
-export class BundleBuilder {
-    constructor(connection, options) {
-        this.transactions = [];
-        this.signers = [];
-        this.connection = connection;
-        this.tipAccount = options?.tipAccount || getRandomTipAccount();
-        this.tipLamports = options?.tipLamports || BigInt(TX_CONFIG.COMPUTE_UNIT_PRICE);
-    }
-    /**
-     * 添加交易
-     * @param transaction 交易
-     * @param signers 签名者列表
-     */
-    addTransaction(transaction, signers) {
-        this.transactions.push(transaction);
-        this.signers.push(signers);
-        return this;
-    }
-    /**
-     * 添加多个交易
-     * @param items 交易和签名者列表
-     */
-    addTransactions(items) {
-        for (const item of items) {
-            this.addTransaction(item.transaction, item.signers);
-        }
-        return this;
-    }
-    /**
-     * 设置 Tip
-     * @param lamports Tip 金额
-     * @param account Tip 账户
-     */
-    setTip(lamports, account) {
-        this.tipLamports = lamports;
-        if (account) {
-            this.tipAccount = account;
-        }
-        return this;
-    }
-    /**
-     * 获取交易数量
-     */
-    getTransactionCount() {
-        return this.transactions.length;
-    }
-    /**
-     * 清空所有交易
-     */
-    clear() {
-        this.transactions = [];
-        this.signers = [];
-        return this;
-    }
-    /**
-     * 构建并签名 Bundle
-     * @param feePayer 手续费支付者
-     * @returns 签名后的 Bundle 数据，用于提交到后端
-     */
-    async buildAndSign(feePayer) {
-        if (this.transactions.length === 0) {
-            throw new Error('No transactions to bundle');
-        }
-        // 获取最新 blockhash
-        const { blockhash, lastValidBlockHeight } = await this.connection.getLatestBlockhash('finalized');
-        const serializedTransactions = [];
-        const allSignatures = [];
-        // 处理每个交易
-        for (let i = 0; i < this.transactions.length; i++) {
-            const tx = this.transactions[i];
-            const txSigners = this.signers[i];
-            // 设置 blockhash 和 feePayer
-            tx.recentBlockhash = blockhash;
-            tx.feePayer = feePayer.publicKey;
-            // 签名
-            const allTxSigners = [feePayer, ...txSigners.filter(s => !s.publicKey.equals(feePayer.publicKey))];
-            tx.sign(...allTxSigners);
-            // 序列化
-            const serialized = tx.serialize();
-            const signature = tx.signature?.toString('base64') || '';
-            serializedTransactions.push({
-                data: Buffer.from(serialized).toString('base64'),
-                isVersioned: false,
-                signature,
-            });
-            if (tx.signature) {
-                allSignatures.push(Buffer.from(tx.signature).toString('base64'));
-            }
-        }
-        // 创建 Tip 交易（最后一笔）
-        const tipTx = new Transaction().add(buildTipInstruction(feePayer.publicKey, this.tipLamports, this.tipAccount));
-        tipTx.recentBlockhash = blockhash;
-        tipTx.feePayer = feePayer.publicKey;
-        tipTx.sign(feePayer);
-        const tipSerialized = tipTx.serialize();
-        serializedTransactions.push({
-            data: Buffer.from(tipSerialized).toString('base64'),
-            isVersioned: false,
-            signature: tipTx.signature ? Buffer.from(tipTx.signature).toString('base64') : '',
-        });
-        if (tipTx.signature) {
-            allSignatures.push(Buffer.from(tipTx.signature).toString('base64'));
-        }
-        return {
-            transactions: serializedTransactions,
-            signatures: allSignatures,
-            tip: {
-                account: this.tipAccount,
-                lamports: this.tipLamports,
-            },
-            recentBlockhash: blockhash,
-            lastValidBlockHeight,
-            createdAt: Date.now(),
-        };
-    }
-}
-/**
- * 构建单个交易并签名（用于简单场景）
- * @param connection Solana 连接
- * @param instructions 指令列表
- * @param signers 签名者列表（第一个为 feePayer）
- * @param options 选项
- */
-export async function buildAndSignTransaction(connection, instructions, signers, options) {
-    if (signers.length === 0) {
-        throw new Error('At least one signer (feePayer) is required');
-    }
-    const feePayer = signers[0];
-    const { blockhash } = await connection.getLatestBlockhash('finalized');
-    const transaction = new Transaction();
-    // 添加计算预算指令（如果指定）
-    if (options?.computeUnitLimit) {
-        transaction.add(ComputeBudgetProgram.setComputeUnitLimit({
-            units: options.computeUnitLimit,
-        }));
-    }
-    if (options?.computeUnitPrice) {
-        transaction.add(ComputeBudgetProgram.setComputeUnitPrice({
-            microLamports: options.computeUnitPrice,
-        }));
-    }
-    // 添加业务指令
-    transaction.add(...instructions);
-    // 添加 Tip 指令（如果需要）
-    if (options?.addTip) {
-        const tipLamports = options.tipLamports || calculateRecommendedTip(1);
-        transaction.add(buildTipInstruction(feePayer.publicKey, tipLamports, options.tipAccount));
-    }
-    transaction.recentBlockhash = blockhash;
-    transaction.feePayer = feePayer.publicKey;
-    transaction.sign(...signers);
-    const serialized = transaction.serialize();
-    return {
-        data: Buffer.from(serialized).toString('base64'),
-        isVersioned: false,
-        signature: transaction.signature ? Buffer.from(transaction.signature).toString('base64') : undefined,
-    };
-}
-/**
- * 构建批量交易并签名（每个钱包一笔交易）
- * @param connection Solana 连接
- * @param walletInstructions 每个钱包的指令
- * @param options 选项
- */
-export async function buildAndSignBatchTransactions(connection, walletInstructions, options) {
-    if (walletInstructions.length === 0) {
-        throw new Error('No transactions to build');
-    }
-    const { blockhash, lastValidBlockHeight } = await connection.getLatestBlockhash('finalized');
-    const serializedTransactions = [];
-    const allSignatures = [];
-    // 确定 tip 支付者
-    const tipPayer = options?.feePayer || walletInstructions[0].wallet;
-    const tipAccount = options?.tipAccount || getRandomTipAccount();
-    const tipLamports = options?.tipLamports || calculateRecommendedTip(walletInstructions.length);
-    // 构建每个交易
-    for (const { wallet, instructions } of walletInstructions) {
-        const transaction = new Transaction();
-        // 添加计算预算
-        if (options?.computeUnitLimit) {
-            transaction.add(ComputeBudgetProgram.setComputeUnitLimit({
-                units: options.computeUnitLimit,
-            }));
-        }
-        if (options?.computeUnitPrice) {
-            transaction.add(ComputeBudgetProgram.setComputeUnitPrice({
-                microLamports: options.computeUnitPrice,
-            }));
-        }
-        // 添加业务指令
-        transaction.add(...instructions);
-        // 设置 blockhash 和 feePayer
-        transaction.recentBlockhash = blockhash;
-        transaction.feePayer = options?.feePayer?.publicKey || wallet.publicKey;
-        // 签名
-        const signers = options?.feePayer
-            ? [options.feePayer, wallet].filter((s, i, arr) => arr.findIndex(x => x.publicKey.equals(s.publicKey)) === i)
-            : [wallet];
-        transaction.sign(...signers);
-        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 交易
-    if (options?.addTip !== false) {
-        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 {
-        transactions: serializedTransactions,
-        signatures: allSignatures,
-        tip: {
-            account: tipAccount,
-            lamports: tipLamports,
-        },
-        recentBlockhash: blockhash,
-        lastValidBlockHeight,
-        createdAt: Date.now(),
-    };
-}
-/**
- * 将 SignedBundleData 转换为后端 API 需要的格式
- * @param bundleData 签名后的 Bundle 数据
- */
-export function toBundleRequest(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/jito/index.d.ts

@@ -1,7 +0,0 @@
-/**
- * Jito Bundle 服务
- * @module sol/jito
- */
-export * from './types.js';
-export * from './bundle.js';
-export * from './tip.js';

package/dist/sol/jito/index.js

@@ -1,7 +0,0 @@
-/**
- * Jito Bundle 服务
- * @module sol/jito
- */
-export * from './types.js';
-export * from './bundle.js';
-export * from './tip.js';

package/dist/sol/jito/tip.d.ts

@@ -1,51 +0,0 @@
-/**
- * Jito Tip 相关功能
- * @module sol/jito/tip
- */
-import { PublicKey, TransactionInstruction } from '@solana/web3.js';
-/**
- * 随机选择一个 Tip 账户
- * @returns Tip 账户地址
- */
-export declare function getRandomTipAccount(): string;
-/**
- * 获取所有 Tip 账户
- * @returns Tip 账户列表
- */
-export declare function getAllTipAccounts(): string[];
-/**
- * 验证是否是有效的 Tip 账户
- * @param address 地址
- */
-export declare function isValidTipAccount(address: string): boolean;
-/**
- * 构建 Tip 指令
- * @param fromPubkey 付款者公钥
- * @param tipLamports Tip 金额（lamports）
- * @param tipAccount 可选：指定 Tip 账户，默认随机选择
- * @returns TransactionInstruction
- */
-export declare function buildTipInstruction(fromPubkey: PublicKey, tipLamports?: bigint, tipAccount?: string): TransactionInstruction;
-/**
- * 计算推荐的 Tip 金额
- * 根据交易数量和优先级计算
- * @param txCount 交易数量
- * @param priority 优先级 (1-10，10 最高)
- * @returns 推荐的 Tip 金额（lamports）
- */
-export declare function calculateRecommendedTip(txCount?: number, priority?: number): bigint;
-/**
- * Tip 金额预设
- */
-export declare const TIP_PRESETS: {
-    /** 最低 tip (0.00001 SOL) */
-    readonly LOW: bigint;
-    /** 标准 tip (0.0001 SOL) */
-    readonly STANDARD: bigint;
-    /** 中等 tip (0.0005 SOL) */
-    readonly MEDIUM: bigint;
-    /** 高 tip (0.001 SOL) */
-    readonly HIGH: bigint;
-    /** 紧急 tip (0.005 SOL) */
-    readonly URGENT: bigint;
-};

package/dist/sol/jito/tip.js

@@ -1,83 +0,0 @@
-/**
- * Jito Tip 相关功能
- * @module sol/jito/tip
- */
-import { PublicKey, SystemProgram, } from '@solana/web3.js';
-import { JITO_CONFIG } from '../constants.js';
-/**
- * 随机选择一个 Tip 账户
- * @returns Tip 账户地址
- */
-export function getRandomTipAccount() {
-    const accounts = JITO_CONFIG.TIP_ACCOUNTS;
-    const index = Math.floor(Math.random() * accounts.length);
-    return accounts[index];
-}
-/**
- * 获取所有 Tip 账户
- * @returns Tip 账户列表
- */
-export function getAllTipAccounts() {
-    return [...JITO_CONFIG.TIP_ACCOUNTS];
-}
-/**
- * 验证是否是有效的 Tip 账户
- * @param address 地址
- */
-export function isValidTipAccount(address) {
-    return JITO_CONFIG.TIP_ACCOUNTS.includes(address);
-}
-/**
- * 构建 Tip 指令
- * @param fromPubkey 付款者公钥
- * @param tipLamports Tip 金额（lamports）
- * @param tipAccount 可选：指定 Tip 账户，默认随机选择
- * @returns TransactionInstruction
- */
-export function buildTipInstruction(fromPubkey, tipLamports = BigInt(JITO_CONFIG.DEFAULT_TIP_LAMPORTS), tipAccount) {
-    const tipAccountAddress = tipAccount || getRandomTipAccount();
-    // 确保 tip 金额不低于最小值
-    const finalTip = tipLamports < BigInt(JITO_CONFIG.MIN_TIP_LAMPORTS)
-        ? BigInt(JITO_CONFIG.MIN_TIP_LAMPORTS)
-        : tipLamports;
-    return SystemProgram.transfer({
-        fromPubkey,
-        toPubkey: new PublicKey(tipAccountAddress),
-        lamports: finalTip,
-    });
-}
-/**
- * 计算推荐的 Tip 金额
- * 根据交易数量和优先级计算
- * @param txCount 交易数量
- * @param priority 优先级 (1-10，10 最高)
- * @returns 推荐的 Tip 金额（lamports）
- */
-export function calculateRecommendedTip(txCount = 1, priority = 5) {
-    // 基础 tip
-    const baseTip = BigInt(JITO_CONFIG.DEFAULT_TIP_LAMPORTS);
-    // 根据交易数量增加
-    const txMultiplier = BigInt(Math.max(1, txCount));
-    // 根据优先级增加（1-10 映射到 0.5x - 2x）
-    const priorityMultiplier = 0.5 + (priority / 10) * 1.5;
-    const tip = BigInt(Math.floor(Number(baseTip * txMultiplier) * priorityMultiplier));
-    // 确保不低于最小值
-    return tip < BigInt(JITO_CONFIG.MIN_TIP_LAMPORTS)
-        ? BigInt(JITO_CONFIG.MIN_TIP_LAMPORTS)
-        : tip;
-}
-/**
- * Tip 金额预设
- */
-export const TIP_PRESETS = {
-    /** 最低 tip (0.00001 SOL) */
-    LOW: BigInt(10000),
-    /** 标准 tip (0.0001 SOL) */
-    STANDARD: BigInt(100000),
-    /** 中等 tip (0.0005 SOL) */
-    MEDIUM: BigInt(500000),
-    /** 高 tip (0.001 SOL) */
-    HIGH: BigInt(1000000),
-    /** 紧急 tip (0.005 SOL) */
-    URGENT: BigInt(5000000),
-};

package/dist/sol/jito/types.d.ts

@@ -1,100 +0,0 @@
-/**
- * Jito Bundle 类型定义
- * @module sol/jito/types
- */
-/**
- * Jito Bundle 状态
- */
-export type JitoBundleStatus = 'pending' | 'landed' | 'failed' | 'invalid' | 'dropped';
-/**
- * Jito Bundle 提交结果
- */
-export interface JitoBundleSubmitResult {
-    success: boolean;
-    bundleId?: string;
-    error?: string;
-}
-/**
- * Jito Bundle 状态查询结果
- */
-export interface JitoBundleStatusResult {
-    bundleId: string;
-    status: JitoBundleStatus;
-    slot?: number;
-    confirmationStatus?: string;
-    error?: string;
-}
-/**
- * 序列化的交易（用于提交到后端）
- */
-export interface SerializedTransaction {
-    /** Base64 编码的交易数据 */
-    data: string;
-    /** 是否是 VersionedTransaction */
-    isVersioned: boolean;
-    /** 交易签名（如果已签名） */
-    signature?: string;
-}
-/**
- * Bundle 请求（提交到后端）
- */
-export interface BundleRequest {
-    /** 序列化的交易列表 */
-    transactions: SerializedTransaction[];
-    /** Tip 金额（lamports） */
-    tipLamports: bigint;
-    /** Tip 账户地址 */
-    tipAccount: string;
-    /** 请求时间戳 */
-    timestamp: number;
-    /** 可选：最后有效区块高度 */
-    lastValidBlockHeight?: number;
-    /** 可选：blockhash */
-    recentBlockhash?: string;
-}
-/**
- * Bundle 响应（从后端返回）
- */
-export interface BundleResponse {
-    success: boolean;
-    bundleId?: string;
-    signatures?: string[];
-    error?: string;
-    /** 后端处理时间 */
-    processingTime?: number;
-}
-/**
- * 交易构建选项
- */
-export interface TransactionBuildOptions {
-    /** 是否添加 Jito Tip */
-    addTip?: boolean;
-    /** Tip 金额（lamports），默认使用 JITO_CONFIG.DEFAULT_TIP_LAMPORTS */
-    tipLamports?: bigint;
-    /** 指定 Tip 账户，默认随机选择 */
-    tipAccount?: string;
-    /** 计算单元限制 */
-    computeUnitLimit?: number;
-    /** 计算单元价格（microlamports） */
-    computeUnitPrice?: number;
-}
-/**
- * 签名后的 Bundle 数据（准备提交到后端）
- */
-export interface SignedBundleData {
-    /** 序列化的交易列表 */
-    transactions: SerializedTransaction[];
-    /** 所有交易签名 */
-    signatures: string[];
-    /** Tip 信息 */
-    tip: {
-        account: string;
-        lamports: bigint;
-    };
-    /** blockhash */
-    recentBlockhash: string;
-    /** 最后有效区块高度 */
-    lastValidBlockHeight: number;
-    /** 创建时间 */
-    createdAt: number;
-}

package/dist/sol/jito/types.js

@@ -1,5 +0,0 @@
-/**
- * Jito Bundle 类型定义
- * @module sol/jito/types
- */
-export {};