solana-meme-sdk 1.0.0

package/dist/utils/batch-swap.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Batch Swap 实现
+ * 单交易 + ALT + 多钱包 Swap
+ * @module sol/utils/batch-swap
+ */
+import { Connection } from '@solana/web3.js';
+import type { AtomicBatchSwapParams, BatchSwapResult } from './batch-types.js';
+/**
+ * 执行 Batch Swap (Pump.fun)
+ * 使用单交易 + ALT 实现多钱包原子性 Swap
+ *
+ * 返回两个交易，用户需要按顺序广播：
+ * 1. altCreateTx - ALT 创建交易
+ * 2. swapTx - 主 Swap 交易 (需等待 ALT 激活后再发送)
+ *
+ * @param connection Solana 连接
+ * @param params Batch Swap 参数
+ * @returns Batch Swap 结果 (包含两个交易)
+ *
+ * @example
+ * ```ts
+ * const result = await batchSwapPump(connection, {
+ *   mint: 'TOKEN_MINT',
+ *   isBuy: true,
+ *   swaps: [
+ *     { wallet: wallet1, solAmount: 100_000_000n }, // 0.1 SOL
+ *     { wallet: wallet2, solAmount: 200_000_000n }, // 0.2 SOL
+ *   ],
+ *   slippageBps: 100,
+ * });
+ *
+ * if (result.success) {
+ *   // 步骤 1: 发送 ALT 创建交易
+ *   await connection.sendTransaction(result.altCreateTx!);
+ *
+ *   // 步骤 2: 等待 ALT 激活 (约 1 slot)
+ *   await waitForALTActivation(connection, result.altInfo!.publicKey);
+ *
+ *   // 步骤 3: 发送 Swap 交易
+ *   await connection.sendTransaction(result.swapTx!);
+ * }
+ * ```
+ */
+export declare function batchSwapPump(connection: Connection, params: AtomicBatchSwapParams): Promise<BatchSwapResult>;
+/**
+ * 快速 Batch Swap (不创建 ALT，仅适用于少量钱包)
+ * 适用于 3-5 个钱包的情况，不需要 ALT
+ *
+ * @returns 只返回 swapTx，无需 ALT 创建
+ */
+export declare function quickBatchSwapPump(connection: Connection, params: AtomicBatchSwapParams): Promise<BatchSwapResult>;
+//# sourceMappingURL=batch-swap.d.ts.map

package/dist/utils/batch-swap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-swap.d.ts","sourceRoot":"","sources":["../../src/utils/batch-swap.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACH,UAAU,EAMb,MAAM,iBAAiB,CAAC;AAiBzB,OAAO,KAAK,EACR,qBAAqB,EACrB,eAAe,EAGlB,MAAM,kBAAkB,CAAC;AA0I1B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,aAAa,CAC/B,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,qBAAqB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAoH1B;AAED;;;;;GAKG;AACH,wBAAsB,kBAAkB,CACpC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,qBAAqB,GAC9B,OAAO,CAAC,eAAe,CAAC,CAgE1B"}

package/dist/utils/batch-swap.js

@@ -0,0 +1,286 @@
+/**
+ * Batch Swap 实现
+ * 单交易 + ALT + 多钱包 Swap
+ * @module sol/utils/batch-swap
+ */
+import { PublicKey, ComputeBudgetProgram, } from '@solana/web3.js';
+import BN from 'bn.js';
+import { OnlinePumpSdk, PUMP_SDK, getBuyTokenAmountFromSolAmount, getSellSolAmountFromTokenAmount, } from '@pump-fun/pump-sdk';
+import { TOKEN_PROGRAM_ID } from '@solana/spl-token';
+import { createAddressLookupTable, collectAddressesFromInstructions, buildVersionedTransaction, estimateTransactionSize, } from './alt.js';
+import { NOZOMI_CONFIG } from '../constants.js';
+import { buildNozomiTipInstruction, getRandomNozomiTipAccount } from '../nozomi/tip.js';
+/**
+ * 构建单个 Pump Buy 的指令
+ */
+async function buildPumpBuyInstructions(connection, mint, buyer, solAmount, slippageBps) {
+    const onlineSdk = new OnlinePumpSdk(connection);
+    const global = await onlineSdk.fetchGlobal();
+    const { bondingCurveAccountInfo, bondingCurve, associatedUserAccountInfo } = await onlineSdk.fetchBuyState(mint, buyer.publicKey);
+    const solAmountBN = new BN(solAmount.toString());
+    const tokenAmount = getBuyTokenAmountFromSolAmount({
+        global,
+        feeConfig: null,
+        mintSupply: bondingCurve.tokenTotalSupply,
+        bondingCurve,
+        amount: solAmountBN,
+    });
+    return PUMP_SDK.buyInstructions({
+        global,
+        bondingCurveAccountInfo,
+        bondingCurve,
+        associatedUserAccountInfo,
+        mint,
+        user: buyer.publicKey,
+        amount: tokenAmount,
+        solAmount: solAmountBN,
+        slippage: slippageBps / 100,
+        tokenProgram: TOKEN_PROGRAM_ID,
+    });
+}
+/**
+ * 构建单个 Pump Sell 的指令
+ */
+async function buildPumpSellInstructions(connection, mint, seller, tokenAmount, slippageBps) {
+    const onlineSdk = new OnlinePumpSdk(connection);
+    const global = await onlineSdk.fetchGlobal();
+    const { bondingCurveAccountInfo, bondingCurve } = await onlineSdk.fetchSellState(mint, seller.publicKey);
+    const tokenAmountBN = new BN(tokenAmount.toString());
+    const solAmount = getSellSolAmountFromTokenAmount({
+        global,
+        feeConfig: null,
+        mintSupply: bondingCurve.tokenTotalSupply,
+        bondingCurve,
+        amount: tokenAmountBN,
+    });
+    return PUMP_SDK.sellInstructions({
+        global,
+        bondingCurveAccountInfo,
+        bondingCurve,
+        mint,
+        user: seller.publicKey,
+        amount: tokenAmountBN,
+        solAmount,
+        slippage: slippageBps / 100,
+        tokenProgram: TOKEN_PROGRAM_ID,
+        mayhemMode: false,
+    });
+}
+/**
+ * 批量构建 Swap 指令
+ */
+async function buildBatchSwapInstructions(connection, params) {
+    const { mint, isBuy, swaps, slippageBps = 100 } = params;
+    const mintPubkey = new PublicKey(mint);
+    const allInstructions = [];
+    const signers = [];
+    // 并行获取所有钱包的买入指令
+    const instructionPromises = swaps.map(async (swap) => {
+        if (isBuy) {
+            if (!swap.solAmount) {
+                throw new Error('solAmount required for buy');
+            }
+            return {
+                instructions: await buildPumpBuyInstructions(connection, mintPubkey, swap.wallet, swap.solAmount, slippageBps),
+                signer: swap.wallet,
+            };
+        }
+        else {
+            if (!swap.tokenAmount) {
+                throw new Error('tokenAmount required for sell');
+            }
+            return {
+                instructions: await buildPumpSellInstructions(connection, mintPubkey, swap.wallet, swap.tokenAmount, slippageBps),
+                signer: swap.wallet,
+            };
+        }
+    });
+    const results = await Promise.all(instructionPromises);
+    for (const result of results) {
+        allInstructions.push(...result.instructions);
+        signers.push(result.signer);
+    }
+    return { instructions: allInstructions, signers };
+}
+/**
+ * 执行 Batch Swap (Pump.fun)
+ * 使用单交易 + ALT 实现多钱包原子性 Swap
+ *
+ * 返回两个交易，用户需要按顺序广播：
+ * 1. altCreateTx - ALT 创建交易
+ * 2. swapTx - 主 Swap 交易 (需等待 ALT 激活后再发送)
+ *
+ * @param connection Solana 连接
+ * @param params Batch Swap 参数
+ * @returns Batch Swap 结果 (包含两个交易)
+ *
+ * @example
+ * ```ts
+ * const result = await batchSwapPump(connection, {
+ *   mint: 'TOKEN_MINT',
+ *   isBuy: true,
+ *   swaps: [
+ *     { wallet: wallet1, solAmount: 100_000_000n }, // 0.1 SOL
+ *     { wallet: wallet2, solAmount: 200_000_000n }, // 0.2 SOL
+ *   ],
+ *   slippageBps: 100,
+ * });
+ *
+ * if (result.success) {
+ *   // 步骤 1: 发送 ALT 创建交易
+ *   await connection.sendTransaction(result.altCreateTx!);
+ *
+ *   // 步骤 2: 等待 ALT 激活 (约 1 slot)
+ *   await waitForALTActivation(connection, result.altInfo!.publicKey);
+ *
+ *   // 步骤 3: 发送 Swap 交易
+ *   await connection.sendTransaction(result.swapTx!);
+ * }
+ * ```
+ */
+export async function batchSwapPump(connection, params) {
+    try {
+        const { swaps, useNozomi, nozomiTipLamports } = params;
+        if (swaps.length === 0) {
+            return { success: false, error: 'No swaps provided' };
+        }
+        if (swaps.length > 15) {
+            return {
+                success: false,
+                error: `Too many swaps (${swaps.length}). Max recommended: 15. Consider using multiple transactions.`
+            };
+        }
+        // 1. 构建所有 swap 指令
+        const { instructions: swapInstructions, signers } = await buildBatchSwapInstructions(connection, params);
+        // 2. 添加 Compute Budget
+        const computeBudgetIxs = [
+            ComputeBudgetProgram.setComputeUnitLimit({
+                units: 200000 * swaps.length, // 每个 swap ~200k CU
+            }),
+            ComputeBudgetProgram.setComputeUnitPrice({
+                microLamports: 100000, // Priority fee
+            }),
+        ];
+        // 3. 添加 Tip (Nozomi)
+        const tipInstructions = [];
+        const payer = signers[0]; // 第一个钱包作为 payer
+        if (useNozomi) {
+            const tipAmount = nozomiTipLamports || BigInt(NOZOMI_CONFIG.DEFAULT_TIP_LAMPORTS);
+            tipInstructions.push(buildNozomiTipInstruction(payer.publicKey, tipAmount, getRandomNozomiTipAccount()));
+        }
+        // 4. 组装所有指令
+        const allInstructions = [
+            ...computeBudgetIxs,
+            ...tipInstructions,
+            ...swapInstructions,
+        ];
+        // 5. 收集地址用于 ALT
+        const addresses = collectAddressesFromInstructions(allInstructions);
+        // 6. 创建 ALT 交易 (不发送)
+        const { altAddress, createTx: altCreateTx } = await createAddressLookupTable(connection, payer, addresses);
+        // 7. 预先构建 Swap 交易 (使用预期的 ALT 结构)
+        // 注意：此交易假设 ALT 已激活，用户需确保 ALT 激活后再发送
+        const mockAltAccount = {
+            key: altAddress,
+            state: {
+                addresses: addresses,
+                authority: payer.publicKey,
+                deactivationSlot: BigInt('18446744073709551615'), // u64::MAX
+                lastExtendedSlot: 0,
+                lastExtendedSlotStartIndex: 0,
+            },
+            isActive: () => true,
+        };
+        const swapTx = await buildVersionedTransaction(connection, payer.publicKey, allInstructions, signers, [mockAltAccount]);
+        const txSize = estimateTransactionSize(swapTx);
+        if (txSize > 1232) {
+            return {
+                success: false,
+                error: `Transaction too large: ${txSize} bytes. Reduce number of swaps.`,
+                estimatedSize: txSize,
+            };
+        }
+        return {
+            success: true,
+            // ALT 创建交易
+            altCreateTx,
+            altCreateTxSerialized: Buffer.from(altCreateTx.serialize()).toString('base64'),
+            altInfo: {
+                address: altAddress.toBase58(),
+                publicKey: altAddress,
+                addresses: addresses.map(a => a.toBase58()),
+            },
+            // Swap 交易
+            swapTx,
+            swapTxSerialized: Buffer.from(swapTx.serialize()).toString('base64'),
+            // 原始指令 (高级用户)
+            instructions: allInstructions,
+            signers,
+            swapCount: swaps.length,
+            estimatedSize: txSize,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message,
+        };
+    }
+}
+/**
+ * 快速 Batch Swap (不创建 ALT，仅适用于少量钱包)
+ * 适用于 3-5 个钱包的情况，不需要 ALT
+ *
+ * @returns 只返回 swapTx，无需 ALT 创建
+ */
+export async function quickBatchSwapPump(connection, params) {
+    try {
+        const { swaps } = params;
+        if (swaps.length > 5) {
+            return {
+                success: false,
+                error: `quickBatchSwap only supports up to 5 wallets. Use batchSwapPump for more.`
+            };
+        }
+        // 1. 构建所有 swap 指令
+        const { instructions: swapInstructions, signers } = await buildBatchSwapInstructions(connection, params);
+        // 2. 添加 Compute Budget
+        const computeBudgetIxs = [
+            ComputeBudgetProgram.setComputeUnitLimit({
+                units: 200000 * swaps.length,
+            }),
+            ComputeBudgetProgram.setComputeUnitPrice({
+                microLamports: 100000,
+            }),
+        ];
+        const allInstructions = [...computeBudgetIxs, ...swapInstructions];
+        const payer = signers[0];
+        // 3. 直接构建 Versioned Transaction (无 ALT)
+        const swapTx = await buildVersionedTransaction(connection, payer.publicKey, allInstructions, signers);
+        const txSize = estimateTransactionSize(swapTx);
+        if (txSize > 1232) {
+            return {
+                success: false,
+                error: `Transaction too large: ${txSize} bytes. Use batchSwapPump with ALT.`,
+                estimatedSize: txSize,
+            };
+        }
+        return {
+            success: true,
+            // 无需 ALT
+            swapTx,
+            swapTxSerialized: Buffer.from(swapTx.serialize()).toString('base64'),
+            instructions: allInstructions,
+            signers,
+            swapCount: swaps.length,
+            estimatedSize: txSize,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            error: error.message,
+        };
+    }
+}
+//# sourceMappingURL=batch-swap.js.map

package/dist/utils/batch-swap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-swap.js","sourceRoot":"","sources":["../../src/utils/batch-swap.ts"],"names":[],"mappings":"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"}

package/dist/utils/batch-types.d.ts

@@ -0,0 +1,90 @@
+/**
+ * Batch Swap 类型定义
+ * 支持单交易 + ALT + 多钱包 Swap
+ * @module sol/utils/batch-types
+ */
+import { Keypair, PublicKey, TransactionInstruction, VersionedTransaction } from '@solana/web3.js';
+/**
+ * 单个 Swap 参数
+ */
+export interface SingleSwapInput {
+    /** 钱包 */
+    wallet: Keypair;
+    /** SOL 数量 (lamports) - 买入时使用 */
+    solAmount?: bigint;
+    /** Token 数量 - 卖出时使用 */
+    tokenAmount?: bigint;
+}
+/**
+ * Batch Swap 参数
+ */
+export interface AtomicBatchSwapParams {
+    /** Token Mint 地址 */
+    mint: string;
+    /** 是否买入 */
+    isBuy: boolean;
+    /** 钱包和金额列表 */
+    swaps: SingleSwapInput[];
+    /** 滑点 (bps), 默认 100 = 1% */
+    slippageBps?: number;
+    /** 使用 Nozomi 加速 */
+    useNozomi?: boolean;
+    /** Nozomi Tip (lamports) */
+    nozomiTipLamports?: bigint;
+    /** 使用 Jito */
+    useJito?: boolean;
+    /** Jito Tip (lamports) */
+    jitoTipLamports?: bigint;
+}
+/**
+ * ALT 信息
+ */
+export interface ALTInfo {
+    /** ALT 地址 */
+    address: string;
+    /** ALT PublicKey */
+    publicKey: PublicKey;
+    /** 包含的地址列表 */
+    addresses: string[];
+}
+/**
+ * Batch Swap 结果
+ * 返回所有必要的交易和信息，由用户自己决定如何广播
+ */
+export interface BatchSwapResult {
+    success: boolean;
+    /**
+     * 步骤 1: ALT 创建交易 (已签名)
+     * 用户需要先广播此交易并等待确认
+     */
+    altCreateTx?: VersionedTransaction;
+    /** ALT 创建交易序列化 (base64) */
+    altCreateTxSerialized?: string;
+    /** ALT 信息 */
+    altInfo?: ALTInfo;
+    /**
+     * 步骤 2: 主 Swap 交易 (已签名)
+     * ALT 激活后 (等待 1 slot)，广播此交易
+     */
+    swapTx?: VersionedTransaction;
+    /** Swap 交易序列化 (base64) */
+    swapTxSerialized?: string;
+    /** 所有 Swap 指令 (未签名，高级用户可自行组装) */
+    instructions?: TransactionInstruction[];
+    /** 签名者列表 */
+    signers?: Keypair[];
+    /** 包含的 swap 数量 */
+    swapCount?: number;
+    /** 预估交易大小 (bytes) */
+    estimatedSize?: number;
+    /** 错误信息 */
+    error?: string;
+}
+/**
+ * 指令构建结果
+ */
+export interface SwapInstructionsResult {
+    instructions: TransactionInstruction[];
+    signers: Keypair[];
+}
+//# sourceMappingURL=batch-types.d.ts.map

package/dist/utils/batch-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-types.d.ts","sourceRoot":"","sources":["../../src/utils/batch-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEnG;;GAEG;AACH,MAAM,WAAW,eAAe;IAC5B,SAAS;IACT,MAAM,EAAE,OAAO,CAAC;IAChB,gCAAgC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uBAAuB;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IAClC,oBAAoB;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,KAAK,EAAE,OAAO,CAAC;IACf,cAAc;IACd,KAAK,EAAE,eAAe,EAAE,CAAC;IACzB,4BAA4B;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,4BAA4B;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0BAA0B;IAC1B,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACpB,aAAa;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,oBAAoB;IACpB,SAAS,EAAE,SAAS,CAAC;IACrB,cAAc;IACd,SAAS,EAAE,MAAM,EAAE,CAAC;CACvB;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC5B,OAAO,EAAE,OAAO,CAAC;IAEjB;;;OAGG;IACH,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,2BAA2B;IAC3B,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,MAAM,CAAC,EAAE,oBAAoB,CAAC;IAC9B,0BAA0B;IAC1B,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,iCAAiC;IACjC,YAAY,CAAC,EAAE,sBAAsB,EAAE,CAAC;IACxC,YAAY;IACZ,OAAO,CAAC,EAAE,OAAO,EAAE,CAAC;IAEpB,kBAAkB;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qBAAqB;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACnC,YAAY,EAAE,sBAAsB,EAAE,CAAC;IACvC,OAAO,EAAE,OAAO,EAAE,CAAC;CACtB"}

package/dist/utils/batch-types.js

@@ -0,0 +1,7 @@
+/**
+ * Batch Swap 类型定义
+ * 支持单交易 + ALT + 多钱包 Swap
+ * @module sol/utils/batch-types
+ */
+export {};
+//# sourceMappingURL=batch-types.js.map

package/dist/utils/batch-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-types.js","sourceRoot":"","sources":["../../src/utils/batch-types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/utils/connection.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Solana RPC 连接管理
+ * @module sol/utils/connection
+ */
+import { Connection, Commitment } from '@solana/web3.js';
+/**
+ * 创建 Solana 连接
+ *
+ * 重要：必须传入用户选择的 RPC URL，SDK 不提供默认 RPC
+ * 前端应从 RPC 设置中获取用户配置的节点
+ *
+ * @param rpcUrl RPC URL（必填）
+ * @param commitment Commitment 级别（可选，默认 confirmed）
+ *
+ * @example
+ * const connection = createConnection('https://user-selected-rpc.com')
+ *
+ * @throws Error 如果没有传入 rpcUrl
+ */
+export declare function createConnection(rpcUrl: string, commitment?: Commitment): Connection;
+/**
+ * 获取账户 SOL 余额
+ * @param connection Solana 连接
+ * @param address 账户地址
+ * @returns 余额（lamports）
+ */
+export declare function getBalance(connection: Connection, address: string): Promise<bigint>;
+/**
+ * 获取账户 SOL 余额（格式化）
+ * @param connection Solana 连接
+ * @param address 账户地址
+ * @returns 余额（SOL）
+ */
+export declare function getBalanceInSol(connection: Connection, address: string): Promise<number>;
+/**
+ * 获取最新 blockhash
+ * @param connection Solana 连接
+ */
+export declare function getLatestBlockhash(connection: Connection): Promise<{
+    blockhash: string;
+    lastValidBlockHeight: number;
+}>;
+/**
+ * 获取当前 slot
+ * @param connection Solana 连接
+ */
+export declare function getCurrentSlot(connection: Connection): Promise<number>;
+/**
+ * 检查账户是否存在
+ * @param connection Solana 连接
+ * @param address 账户地址
+ */
+export declare function accountExists(connection: Connection, address: string): Promise<boolean>;
+/**
+ * 获取账户信息
+ * @param connection Solana 连接
+ * @param address 账户地址
+ */
+export declare function getAccountInfo(connection: Connection, address: string): Promise<import("@solana/web3.js").AccountInfo<Buffer<ArrayBufferLike>> | null>;
+/**
+ * 获取最小租金豁免余额
+ * @param connection Solana 连接
+ * @param dataSize 账户数据大小
+ */
+export declare function getMinimumBalanceForRentExemption(connection: Connection, dataSize: number): Promise<bigint>;
+/**
+ * 等待交易确认
+ * @param connection Solana 连接
+ * @param signature 交易签名
+ * @param timeout 超时时间（毫秒）
+ */
+export declare function waitForConfirmation(connection: Connection, signature: string, timeout?: number): Promise<boolean>;
+/**
+ * 获取交易状态
+ * @param connection Solana 连接
+ * @param signature 交易签名
+ */
+export declare function getTransactionStatus(connection: Connection, signature: string): Promise<'pending' | 'confirmed' | 'failed'>;
+//# sourceMappingURL=connection.d.ts.map

package/dist/utils/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/utils/connection.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAa,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGpE;;;;;;;;;;;;;GAaG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,MAAM,EACd,UAAU,GAAE,UAAyC,GACpD,UAAU,CAQZ;AAED;;;;;GAKG;AACH,wBAAsB,UAAU,CAC9B,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAQjB;AAED;;;;;GAKG;AACH,wBAAsB,eAAe,CACnC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC;IACxE,SAAS,EAAE,MAAM,CAAC;IAClB,oBAAoB,EAAE,MAAM,CAAC;CAC9B,CAAC,CAUD;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5E;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,OAAO,CAAC,CAQlB;AAED;;;;GAIG;AACH,wBAAsB,cAAc,CAClC,UAAU,EAAE,UAAU,EACtB,OAAO,EAAE,MAAM,kFAQhB;AAED;;;;GAIG;AACH,wBAAsB,iCAAiC,CACrD,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CACvC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,GAAE,MAAuC,GAC/C,OAAO,CAAC,OAAO,CAAC,CAelB;AAED;;;;GAIG;AACH,wBAAsB,oBAAoB,CACxC,UAAU,EAAE,UAAU,EACtB,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC,CAa7C"}