four-flap-meme-sdk 1.5.5 → 1.5.6

package/dist/sol/types.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Solana SDK 类型定义
+ * @module sol/types
+ */
+import { PublicKey, Keypair } from '@solana/web3.js';
+/**
+ * 支持的 Solana DEX
+ */
+export type SolanaDex = 'PUMP' | 'PUMP_SWAP' | 'RAYDIUM' | 'ORCA' | 'METEORA';
+/**
+ * 池子类型
+ */
+export type PoolType = 'AMM' | 'CLMM' | 'DLMM' | 'DAMM' | 'BONDING_CURVE';
+/**
+ * LP 目标 DEX
+ */
+export type LpTargetDex = 'RAYDIUM_AMM' | 'RAYDIUM_CLMM' | 'ORCA' | 'METEORA_DLMM' | 'METEORA_DAMM';
+/**
+ * 代币发射平台
+ */
+export type TokenLaunchPlatform = 'SPL_TOKEN_2022' | 'SPL' | 'PUMP' | 'RAYDIUM' | 'METEORA_DBC';
+/**
+ * Solana 钱包信息
+ */
+export interface SolanaWallet {
+    publicKey: PublicKey;
+    secretKey: Uint8Array;
+    address: string;
+}
+/**
+ * 钱包生成结果
+ */
+export interface WalletGenerateResult {
+    publicKey: string;
+    secretKey: Uint8Array;
+    secretKeyBase58: string;
+    address: string;
+}
+/**
+ * 代币元数据
+ */
+export interface TokenMetadata {
+    name: string;
+    symbol: string;
+    description: string;
+    image: string;
+    external_url?: string;
+    attributes?: Array<{
+        trait_type: string;
+        value: string | number;
+    }>;
+    properties?: {
+        files?: Array<{
+            uri: string;
+            type: string;
+        }>;
+        category?: string;
+    };
+}
+/**
+ * Token-2022 创建参数
+ */
+export interface CreateToken2022Params {
+    name: string;
+    symbol: string;
+    decimals: number;
+    initialSupply: bigint;
+    uri: string;
+    creator: Keypair;
+    mintAuthority?: PublicKey;
+    freezeAuthority?: PublicKey | null;
+}
+/**
+ * 代币创建结果
+ */
+export interface TokenCreateResult {
+    mint: PublicKey;
+    metadataAddress: PublicKey;
+    signature: string;
+    metadataUri?: string;
+    lpPoolAddress?: string;
+    lpSignature?: string;
+}
+/**
+ * 交易参数
+ */
+export interface SwapParams {
+    dex: SolanaDex;
+    tokenAddress: string;
+    amount: bigint;
+    slippage: number;
+    wallet: Keypair;
+    isBuy: boolean;
+}
+/**
+ * 批量交易参数
+ */
+export interface BatchSwapParams {
+    dex: SolanaDex;
+    tokenAddress: string;
+    wallets: Array<{
+        wallet: Keypair;
+        amount: bigint;
+    }>;
+    slippage: number;
+    isBuy: boolean;
+}
+/**
+ * 交易结果
+ */
+export interface TransactionResult {
+    success: boolean;
+    signature?: string;
+    error?: string;
+    fee?: bigint;
+    timestamp: number;
+}
+/**
+ * 批量交易结果
+ */
+export interface BatchTransactionResult {
+    totalCount: number;
+    successCount: number;
+    failedCount: number;
+    results: TransactionResult[];
+    signatures: string[];
+}
+/**
+ * LP 操作参数
+ */
+export interface LiquidityParams {
+    dex: SolanaDex;
+    poolAddress: string;
+    tokenA: string;
+    tokenB: string;
+    amountA: bigint;
+    amountB: bigint;
+    wallet: Keypair;
+}
+/**
+ * LP 添加结果
+ */
+export interface AddLiquidityResult {
+    poolAddress: string;
+    lpTokenAmount: bigint;
+    signature: string;
+}
+/**
+ * 交易类型
+ */
+export type TransactionType = 'BUY' | 'SELL' | 'ADD_LP' | 'REMOVE_LP' | 'CREATE' | 'TRANSFER';
+/**
+ * 交易状态
+ */
+export type TransactionStatus = 'PENDING' | 'SUCCESS' | 'FAILED';
+/**
+ * 交易流水记录
+ */
+export interface TransactionLog {
+    id: string;
+    chain: 'SOLANA';
+    type: TransactionType;
+    dex?: SolanaDex;
+    tokenAddress: string;
+    tokenSymbol?: string;
+    walletAddress: string;
+    amount: string;
+    solAmount?: string;
+    fee: string;
+    signature: string;
+    status: TransactionStatus;
+    timestamp: number;
+    blockTime?: number;
+    slot?: number;
+    errorMessage?: string;
+}

package/dist/sol/types.js

@@ -0,0 +1,7 @@
+/**
+ * Solana SDK 类型定义
+ * @module sol/types
+ */
+export {};
+// ==================== Jito Bundle ====================
+// 注意：Jito 相关类型已移至 jito/types.ts

package/dist/sol/utils/balance.d.ts

@@ -0,0 +1,160 @@
+/**
+ * Solana 余额查询功能
+ * 使用批量 RPC 调用优化，减少限流风险
+ * @module sol/utils/balance
+ */
+import { Connection } from '@solana/web3.js';
+/**
+ * SOL 余额结果
+ */
+export interface SolBalanceResult {
+    address: string;
+    lamports: bigint;
+    sol: number;
+    success: boolean;
+    error?: string;
+}
+/**
+ * 代币余额结果
+ */
+export interface TokenBalanceResult {
+    address: string;
+    tokenAddress: string;
+    balance: bigint;
+    decimals: number;
+    uiBalance: number;
+    success: boolean;
+    error?: string;
+}
+/**
+ * 批量余额查询结果
+ */
+export interface BatchBalanceResult<T> {
+    results: T[];
+    successCount: number;
+    failedCount: number;
+}
+/**
+ * 钱包完整余额信息
+ */
+export interface WalletBalanceInfo {
+    address: string;
+    sol: {
+        lamports: bigint;
+        balance: number;
+    };
+    tokens: Array<{
+        mint: string;
+        balance: bigint;
+        decimals: number;
+        uiBalance: number;
+    }>;
+}
+/**
+ * 查询单个地址的 SOL 余额
+ * @param connection Solana 连接
+ * @param address 钱包地址
+ */
+export declare function getSolBalance(connection: Connection, address: string): Promise<SolBalanceResult>;
+/**
+ * 批量查询 SOL 余额
+ * @param connection Solana 连接
+ * @param addresses 钱包地址列表
+ * @param batchSize 每批查询数量（默认 100）
+ */
+export declare function batchGetSolBalance(connection: Connection, addresses: string[], batchSize?: number): Promise<BatchBalanceResult<SolBalanceResult>>;
+/**
+ * 查询单个地址的代币余额
+ * @param connection Solana 连接
+ * @param walletAddress 钱包地址
+ * @param tokenMint 代币 Mint 地址
+ * @param useToken2022 是否使用 Token-2022 程序（默认 false）
+ */
+export declare function getTokenBalance(connection: Connection, walletAddress: string, tokenMint: string, useToken2022?: boolean): Promise<TokenBalanceResult>;
+/**
+ * 批量查询代币余额（多个钱包，同一代币）
+ * 使用 getMultipleAccountsInfo 优化，单次 RPC 调用查询多个账户
+ *
+ * @param connection Solana 连接
+ * @param walletAddresses 钱包地址列表
+ * @param tokenMint 代币 Mint 地址
+ * @param useToken2022 是否使用 Token-2022 程序
+ */
+export declare function batchGetTokenBalance(connection: Connection, walletAddresses: string[], tokenMint: string, useToken2022?: boolean): Promise<BatchBalanceResult<TokenBalanceResult>>;
+/**
+ * 批量查询多个代币余额（单个钱包，多个代币）
+ *
+ * @param connection Solana 连接
+ * @param walletAddress 钱包地址
+ * @param tokenMints 代币 Mint 地址列表
+ * @param useToken2022 是否使用 Token-2022 程序
+ */
+export declare function batchGetMultiTokenBalance(connection: Connection, walletAddress: string, tokenMints: string[], useToken2022?: boolean): Promise<BatchBalanceResult<TokenBalanceResult>>;
+/**
+ * 获取钱包持有的所有代币
+ * @param connection Solana 连接
+ * @param walletAddress 钱包地址
+ * @param includeToken2022 是否包含 Token-2022 代币
+ */
+export declare function getAllTokenBalances(connection: Connection, walletAddress: string, includeToken2022?: boolean): Promise<WalletBalanceInfo>;
+/**
+ * 批量获取钱包完整余额信息
+ * @param connection Solana 连接
+ * @param walletAddresses 钱包地址列表
+ */
+export declare function batchGetAllBalances(connection: Connection, walletAddresses: string[]): Promise<WalletBalanceInfo[]>;
+/**
+ * 矩阵查询结果
+ */
+export interface MatrixBalanceResult {
+    /** 按钱包分组的结果 */
+    byWallet: Map<string, Map<string, TokenBalanceResult>>;
+    /** 按代币分组的结果 */
+    byToken: Map<string, Map<string, TokenBalanceResult>>;
+    /** 扁平化结果列表 */
+    results: TokenBalanceResult[];
+    /** 统计 */
+    stats: {
+        totalQueries: number;
+        successCount: number;
+        failedCount: number;
+        rpcCalls: number;
+    };
+}
+/**
+ * 批量查询多个钱包的多个代币余额（矩阵查询）
+ * 优化 RPC 调用次数，适合大批量查询
+ *
+ * @param connection Solana 连接
+ * @param walletAddresses 钱包地址列表
+ * @param tokenMints 代币 Mint 地址列表
+ * @param useToken2022 是否使用 Token-2022 程序
+ *
+ * @example
+ * ```typescript
+ * const result = await batchGetMatrixBalance(
+ *   connection,
+ *   ['wallet1', 'wallet2', 'wallet3'],
+ *   ['tokenA', 'tokenB'],
+ * )
+ *
+ * // 获取某个钱包的某个代币余额
+ * const balance = result.byWallet.get('wallet1')?.get('tokenA')
+ * ```
+ */
+export declare function batchGetMatrixBalance(connection: Connection, walletAddresses: string[], tokenMints: string[], useToken2022?: boolean): Promise<MatrixBalanceResult>;
+/**
+ * 清除 decimals 缓存
+ * @param mint 可选，指定代币地址；不传则清除全部
+ */
+export declare function clearDecimalsCache(mint?: string): void;
+/**
+ * 获取缓存的 decimals 数量
+ */
+export declare function getDecimalsCacheSize(): number;
+/**
+ * 预热 decimals 缓存
+ * @param connection Solana 连接
+ * @param mints 代币 Mint 地址列表
+ */
+export declare function warmupDecimalsCache(connection: Connection, mints: string[]): Promise<void>;