four-flap-meme-sdk 1.4.89 → 1.4.91

package/dist/sol/dex/jup/ultra.js

@@ -1,853 +0,0 @@
-/**
- * Jupiter Ultra API
- * @module sol/dex/jup/ultra
- *
- * Ultra API 提供最优化的交易路由和执行
- * 文档: https://docs.jup.ag/docs/apis/ultra-api
- */
-import { jupGet, jupPost } from './client.js';
-// ============================================================================
-// Order - 获取交易报价和交易
-// ============================================================================
-/**
- * 获取 Swap 报价和未签名交易
- *
- * @param params 请求参数
- * @param config Jupiter 配置
- * @returns Order 响应（包含报价和未签名交易）
- *
- * @example
- * ```typescript
- * import { Sol } from 'four-flap-meme-sdk'
- *
- * // 设置 API Key
- * Sol.setJupiterConfig({ apiKey: 'your-api-key' })
- *
- * // 获取报价
- * const order = await Sol.getJupiterOrder({
- *   inputMint: 'So11111111111111111111111111111111111111112',  // SOL
- *   outputMint: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
- *   amount: '10000000',  // 0.01 SOL
- *   taker: 'BQ72nSv9f3PRyRKCBnHLVrerrv37CYTHm5h3s9VSGQDV',
- * })
- *
- * console.log('输出数量:', order.outAmount)
- * console.log('价格影响:', order.priceImpact)
- * console.log('路由:', order.router)
- * ```
- */
-export async function getJupiterOrder(params, config) {
-    // 处理 excludeRouters 数组
-    let excludeRouters;
-    if (params.excludeRouters) {
-        excludeRouters = Array.isArray(params.excludeRouters)
-            ? params.excludeRouters.join(',')
-            : params.excludeRouters;
-    }
-    const queryParams = {
-        inputMint: params.inputMint,
-        outputMint: params.outputMint,
-        amount: params.amount,
-        taker: params.taker,
-        receiver: params.receiver,
-        payer: params.payer,
-        closeAuthority: params.closeAuthority,
-        referralAccount: params.referralAccount,
-        referralFee: params.referralFee,
-        excludeRouters,
-        excludeDexes: params.excludeDexes,
-    };
-    return jupGet('/ultra/v1/order', queryParams, config);
-}
-/**
- * 获取 Swap 报价（不包含交易，仅报价）
- *
- * @param inputMint 输入代币 Mint
- * @param outputMint 输出代币 Mint
- * @param amount 输入数量
- * @param config Jupiter 配置
- * @returns Order 响应（transaction 为 null）
- *
- * @example
- * ```typescript
- * const quote = await Sol.getJupiterQuote(
- *   'So11111111111111111111111111111111111111112',  // SOL
- *   'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
- *   '10000000',  // 0.01 SOL
- * )
- * console.log('预期输出:', quote.outAmount)
- * ```
- */
-export async function getJupiterQuote(inputMint, outputMint, amount, config) {
-    return getJupiterOrder({ inputMint, outputMint, amount }, config);
-}
-/**
- * 获取带交易的 Swap 报价
- *
- * @param inputMint 输入代币 Mint
- * @param outputMint 输出代币 Mint
- * @param amount 输入数量
- * @param taker 交易者地址
- * @param options 可选参数
- * @param config Jupiter 配置
- * @returns Order 响应（包含未签名交易）
- *
- * @example
- * ```typescript
- * const order = await Sol.getJupiterSwapTransaction(
- *   'So11111111111111111111111111111111111111112',
- *   'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
- *   '10000000',
- *   wallet.publicKey.toBase58(),
- * )
- *
- * if (order.transaction) {
- *   // 签名并执行交易
- *   const tx = Transaction.from(Buffer.from(order.transaction, 'base64'))
- *   tx.sign(wallet)
- *   await Sol.executeJupiterOrder({
- *     signedTransaction: tx.serialize().toString('base64'),
- *     requestId: order.requestId,
- *   })
- * }
- * ```
- */
-export async function getJupiterSwapTransaction(inputMint, outputMint, amount, taker, options, config) {
-    return getJupiterOrder({
-        inputMint,
-        outputMint,
-        amount,
-        taker,
-        ...options,
-    }, config);
-}
-// ============================================================================
-// Execute - 执行交易
-// ============================================================================
-/**
- * 执行已签名的 Swap 交易
- *
- * @param params 执行参数
- * @param config Jupiter 配置
- * @returns 执行结果
- *
- * @example
- * ```typescript
- * const result = await Sol.executeJupiterOrder({
- *   signedTransaction: signedTxBase64,
- *   requestId: order.requestId,
- * })
- *
- * if (result.status === 'Success') {
- *   console.log('交易成功:', result.signature)
- * }
- * ```
- */
-export async function executeJupiterOrder(params, config) {
-    return jupPost('/ultra/v1/execute', {
-        signedTransaction: params.signedTransaction,
-        requestId: params.requestId,
-    }, config);
-}
-// ============================================================================
-// 便捷方法
-// ============================================================================
-/**
- * 计算 Swap 输出数量
- *
- * @param inputMint 输入代币
- * @param outputMint 输出代币
- * @param amount 输入数量
- * @param config Jupiter 配置
- * @returns 输出数量和相关信息
- */
-export async function calculateSwapOutput(inputMint, outputMint, amount, config) {
-    const quote = await getJupiterQuote(inputMint, outputMint, amount, config);
-    return {
-        inAmount: quote.inAmount,
-        outAmount: quote.outAmount,
-        priceImpact: quote.priceImpact || 0,
-        slippageBps: quote.slippageBps,
-        feeBps: quote.feeBps,
-        routeLabel: quote.routePlan[0]?.swapInfo.label || 'Unknown',
-    };
-}
-/**
- * 获取代币价格 (以 USDC 计)
- *
- * @param mint 代币 Mint
- * @param amount 数量 (最小单位)
- * @param config Jupiter 配置
- * @returns USD 价格
- */
-export async function getTokenUsdPrice(mint, amount = '1000000000', // 默认 1 token (假设 9 位精度)
-config) {
-    const USDC = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v';
-    if (mint === USDC) {
-        return 1;
-    }
-    try {
-        const quote = await getJupiterQuote(mint, USDC, amount, config);
-        return quote.outUsdValue || null;
-    }
-    catch {
-        return null;
-    }
-}
-// ============================================================================
-// Holdings - 获取账户持仓
-// ============================================================================
-/**
- * 获取账户完整持仓信息
- *
- * 返回账户的原生 SOL 余额和所有代币持仓，包括每个代币账户的详细信息。
- *
- * @param address 钱包地址
- * @param config Jupiter 配置
- * @returns Holdings 响应
- *
- * @example
- * ```typescript
- * import { Sol } from 'four-flap-meme-sdk'
- *
- * Sol.setJupiterConfig({ apiKey: 'your-api-key' })
- *
- * const holdings = await Sol.getJupiterHoldings(
- *   '3X2LFoTQecbpqCR7G5tL1kczqBKurjKPHhKSZrJ4wgWc'
- * )
- *
- * // 原生 SOL 余额
- * console.log('SOL 余额:', holdings.uiAmount, 'SOL')
- *
- * // 遍历代币持仓
- * for (const [mint, accounts] of Object.entries(holdings.tokens)) {
- *   for (const account of accounts) {
- *     console.log(`${mint}: ${account.uiAmountString}`)
- *     console.log(`  账户: ${account.account}`)
- *     console.log(`  ATA: ${account.isAssociatedTokenAccount}`)
- *     console.log(`  冻结: ${account.isFrozen}`)
- *   }
- * }
- * ```
- *
- * @note 对于持有超过数千种代币的钱包，响应可能较慢。
- *       如果只需要 SOL 余额，请使用 getJupiterNativeHoldings()
- */
-export async function getJupiterHoldings(address, config) {
-    return jupGet(`/ultra/v1/holdings/${address}`, {}, config);
-}
-/**
- * 获取账户原生 SOL 余额
- *
- * 仅获取 SOL 余额，比 getJupiterHoldings() 更快。
- *
- * @param address 钱包地址
- * @param config Jupiter 配置
- * @returns Native Holdings 响应
- *
- * @example
- * ```typescript
- * const native = await Sol.getJupiterNativeHoldings(
- *   '3X2LFoTQecbpqCR7G5tL1kczqBKurjKPHhKSZrJ4wgWc'
- * )
- *
- * console.log('SOL 余额:', native.uiAmount, 'SOL')
- * console.log('Lamports:', native.amount)
- * ```
- */
-export async function getJupiterNativeHoldings(address, config) {
-    return jupGet(`/ultra/v1/holdings/${address}/native`, {}, config);
-}
-/**
- * 获取指定代币的持仓
- *
- * @param address 钱包地址
- * @param mint 代币 Mint 地址
- * @param config Jupiter 配置
- * @returns 代币账户信息数组，如果没有持仓则返回空数组
- *
- * @example
- * ```typescript
- * const jupSolHoldings = await Sol.getJupiterTokenHolding(
- *   '3X2LFoTQecbpqCR7G5tL1kczqBKurjKPHhKSZrJ4wgWc',
- *   'jupSoLaHXQiZZTSfEWMTRRgpnyFm8f6sZdosWBjx93v', // jupSOL
- * )
- *
- * if (jupSolHoldings.length > 0) {
- *   console.log('jupSOL 余额:', jupSolHoldings[0].uiAmountString)
- * }
- * ```
- */
-export async function getJupiterTokenHolding(address, mint, config) {
-    const holdings = await getJupiterHoldings(address, config);
-    return holdings.tokens[mint] || [];
-}
-/**
- * 获取账户所有代币余额汇总
- *
- * @param address 钱包地址
- * @param config Jupiter 配置
- * @returns 代币余额映射 { mint: uiAmount }
- *
- * @example
- * ```typescript
- * const balances = await Sol.getJupiterTokenBalances(
- *   '3X2LFoTQecbpqCR7G5tL1kczqBKurjKPHhKSZrJ4wgWc'
- * )
- *
- * for (const [mint, balance] of Object.entries(balances)) {
- *   console.log(`${mint}: ${balance}`)
- * }
- * ```
- */
-export async function getJupiterTokenBalances(address, config) {
-    const holdings = await getJupiterHoldings(address, config);
-    const balances = {};
-    for (const [mint, accounts] of Object.entries(holdings.tokens)) {
-        // 累加同一代币的所有账户余额
-        balances[mint] = accounts.reduce((sum, acc) => sum + acc.uiAmount, 0);
-    }
-    return balances;
-}
-// ============================================================================
-// Shield - 代币风险检测
-// ============================================================================
-/**
- * 检测代币风险警告
- *
- * Shield API 用于获取代币的安全信息和风险警告。
- * 如果代币有潜在风险，会在 warnings 对象中返回警告信息。
- *
- * @param mints 代币 mint 地址数组
- * @param config Jupiter 配置
- * @returns Shield 响应
- *
- * @example
- * ```typescript
- * import { Sol } from 'four-flap-meme-sdk'
- *
- * Sol.setJupiterConfig({ apiKey: 'your-api-key' })
- *
- * // 检查多个代币
- * const shield = await Sol.getJupiterShield([
- *   'So11111111111111111111111111111111111111112',  // SOL
- *   'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
- * ])
- *
- * // 检查警告
- * for (const [mint, warnings] of Object.entries(shield.warnings)) {
- *   console.log(`代币 ${mint} 有风险:`)
- *   warnings.forEach(w => console.log(`  - ${w}`))
- * }
- *
- * // 如果 warnings 为空对象，说明代币安全
- * if (Object.keys(shield.warnings).length === 0) {
- *   console.log('所有代币安全')
- * }
- * ```
- */
-export async function getJupiterShield(mints, config) {
-    const mintsParam = mints.join(',');
-    return jupGet('/ultra/v1/shield', { mints: mintsParam }, config);
-}
-/**
- * 检查单个代币是否有风险
- *
- * @param mint 代币 mint 地址
- * @param config Jupiter 配置
- * @returns 警告信息数组，如果为空则代币安全
- *
- * @example
- * ```typescript
- * const warnings = await Sol.checkTokenSafety(
- *   'SomeSuspiciousTokenMintAddress...'
- * )
- *
- * if (warnings.length > 0) {
- *   warnings.forEach(w => {
- *     console.log(`⚠️ [${w.severity}] ${w.type}: ${w.message}`)
- *     if (w.source) console.log(`   来源: ${w.source}`)
- *   })
- * } else {
- *   console.log('✓ 代币安全')
- * }
- * ```
- */
-export async function checkTokenSafety(mint, config) {
-    const shield = await getJupiterShield([mint], config);
-    return shield.warnings[mint] || [];
-}
-/**
- * 批量检查代币安全性
- *
- * @param mints 代币 mint 地址数组
- * @param config Jupiter 配置
- * @returns 安全性检查结果
- *
- * @example
- * ```typescript
- * const results = await Sol.batchCheckTokenSafety([
- *   'Token1...',
- *   'Token2...',
- *   'Token3...',
- * ])
- *
- * for (const [mint, result] of Object.entries(results)) {
- *   if (result.safe) {
- *     console.log(`✓ ${mint}: 安全`)
- *   } else {
- *     const criticals = result.warnings.filter(w => w.severity === 'critical')
- *     console.log(`⚠️ ${mint}: ${criticals.length} 个严重警告`)
- *   }
- * }
- * ```
- */
-export async function batchCheckTokenSafety(mints, config) {
-    const shield = await getJupiterShield(mints, config);
-    const results = {};
-    const severityOrder = { info: 1, warning: 2, critical: 3 };
-    for (const mint of mints) {
-        const warnings = shield.warnings[mint] || [];
-        const hasCritical = warnings.some(w => w.severity === 'critical');
-        let maxSeverity = null;
-        for (const w of warnings) {
-            if (!maxSeverity || severityOrder[w.severity] > severityOrder[maxSeverity]) {
-                maxSeverity = w.severity;
-            }
-        }
-        results[mint] = {
-            safe: warnings.length === 0,
-            warnings,
-            hasCritical,
-            maxSeverity,
-        };
-    }
-    return results;
-}
-/**
- * 检查代币是否有严重风险
- *
- * @param mint 代币 mint 地址
- * @param config Jupiter 配置
- * @returns 是否有严重 (critical) 风险
- *
- * @example
- * ```typescript
- * const isCritical = await Sol.hasTokenCriticalRisk('TokenMint...')
- * if (isCritical) {
- *   console.log('⛔ 代币有严重风险，不建议交易')
- * }
- * ```
- */
-export async function hasTokenCriticalRisk(mint, config) {
-    const warnings = await checkTokenSafety(mint, config);
-    return warnings.some(w => w.severity === 'critical');
-}
-// ============================================================================
-// Search - 代币搜索
-// ============================================================================
-/**
- * 搜索代币信息
- *
- * 可通过代币符号、名称或 mint 地址搜索代币。
- * 支持逗号分隔搜索多个代币（最多100个 mint 地址）。
- *
- * @param query 搜索查询（symbol、name 或 mint 地址，逗号分隔可搜索多个）
- * @param config Jupiter 配置
- * @returns 代币信息数组
- *
- * @example
- * ```typescript
- * import { Sol } from 'four-flap-meme-sdk'
- *
- * Sol.setJupiterConfig({ apiKey: 'your-api-key' })
- *
- * // 通过符号搜索
- * const tokens = await Sol.searchJupiterTokens('USDC')
- *
- * // 通过 mint 地址搜索
- * const usdc = await Sol.searchJupiterTokens(
- *   'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
- * )
- *
- * // 搜索多个代币
- * const multiple = await Sol.searchJupiterTokens(
- *   'So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
- * )
- *
- * // 查看代币信息
- * tokens.forEach(token => {
- *   console.log(`${token.symbol}: $${token.usdPrice}`)
- *   console.log(`  市值: $${token.mcap}`)
- *   console.log(`  流动性: $${token.liquidity}`)
- *   console.log(`  24h 价格变化: ${token.stats24h?.priceChange}%`)
- *   console.log(`  有机评分: ${token.organicScoreLabel}`)
- * })
- * ```
- */
-export async function searchJupiterTokens(query, config) {
-    return jupGet('/ultra/v1/search', { query }, config);
-}
-/**
- * 批量搜索代币（通过 mint 地址数组）
- *
- * @param mints 代币 mint 地址数组（最多100个）
- * @param config Jupiter 配置
- * @returns 代币信息数组
- *
- * @example
- * ```typescript
- * const tokens = await Sol.batchSearchTokens([
- *   'So11111111111111111111111111111111111111112',  // SOL
- *   'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v', // USDC
- *   'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB', // USDT
- * ])
- * ```
- */
-export async function batchSearchTokens(mints, config) {
-    if (mints.length > 100) {
-        throw new Error('Maximum 100 mint addresses allowed');
-    }
-    return searchJupiterTokens(mints.join(','), config);
-}
-/**
- * 获取单个代币详细信息
- *
- * @param mint 代币 mint 地址
- * @param config Jupiter 配置
- * @returns 代币信息，如果未找到则返回 null
- *
- * @example
- * ```typescript
- * const usdc = await Sol.getJupiterTokenInfo(
- *   'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
- * )
- *
- * if (usdc) {
- *   console.log(`${usdc.name} (${usdc.symbol})`)
- *   console.log(`价格: $${usdc.usdPrice}`)
- *   console.log(`市值: $${usdc.mcap}`)
- *   console.log(`FDV: $${usdc.fdv}`)
- *   console.log(`流动性: $${usdc.liquidity}`)
- *   console.log(`持有者: ${usdc.holderCount}`)
- *   console.log(`已验证: ${usdc.isVerified}`)
- *
- *   // 审计信息
- *   if (usdc.audit) {
- *     console.log(`Mint 权限禁用: ${usdc.audit.mintAuthorityDisabled}`)
- *     console.log(`冻结权限禁用: ${usdc.audit.freezeAuthorityDisabled}`)
- *   }
- * }
- * ```
- */
-export async function getJupiterTokenInfo(mint, config) {
-    const results = await searchJupiterTokens(mint, config);
-    return results.find(t => t.id === mint) || results[0] || null;
-}
-/**
- * 获取代币价格和市值信息
- *
- * @param mint 代币 mint 地址
- * @param config Jupiter 配置
- * @returns 价格和市值信息
- *
- * @example
- * ```typescript
- * const priceInfo = await Sol.getJupiterTokenPriceInfo(
- *   'So11111111111111111111111111111111111111112'
- * )
- *
- * console.log(`价格: $${priceInfo.price}`)
- * console.log(`24h 变化: ${priceInfo.priceChange24h}%`)
- * console.log(`市值: $${priceInfo.mcap}`)
- * ```
- */
-export async function getJupiterTokenPriceInfo(mint, config) {
-    const token = await getJupiterTokenInfo(mint, config);
-    if (!token) {
-        return {
-            price: null,
-            priceChange5m: null,
-            priceChange1h: null,
-            priceChange6h: null,
-            priceChange24h: null,
-            mcap: null,
-            fdv: null,
-            liquidity: null,
-            volume24h: null,
-        };
-    }
-    return {
-        price: token.usdPrice,
-        priceChange5m: token.stats5m?.priceChange || null,
-        priceChange1h: token.stats1h?.priceChange || null,
-        priceChange6h: token.stats6h?.priceChange || null,
-        priceChange24h: token.stats24h?.priceChange || null,
-        mcap: token.mcap,
-        fdv: token.fdv,
-        liquidity: token.liquidity,
-        volume24h: token.stats24h
-            ? (token.stats24h.buyVolume || 0) + (token.stats24h.sellVolume || 0)
-            : null,
-    };
-}
-/**
- * 检查代币是否可信
- *
- * 基于审计信息和有机评分判断代币可信度
- *
- * @param mint 代币 mint 地址
- * @param config Jupiter 配置
- * @returns 可信度检查结果
- *
- * @example
- * ```typescript
- * const trust = await Sol.checkTokenTrust('TokenMint...')
- *
- * if (trust.isTrusted) {
- *   console.log('✓ 代币可信')
- * } else {
- *   console.log('⚠️ 代币风险:', trust.warnings)
- * }
- * ```
- */
-export async function checkTokenTrust(mint, config) {
-    const token = await getJupiterTokenInfo(mint, config);
-    const warnings = [];
-    if (!token) {
-        return {
-            isTrusted: false,
-            isVerified: false,
-            organicScore: null,
-            organicScoreLabel: null,
-            hasMintAuthority: true,
-            hasFreezeAuthority: true,
-            isSuspicious: true,
-            warnings: ['Token not found'],
-        };
-    }
-    const audit = token.audit;
-    const isVerified = token.isVerified || false;
-    // 如果 mintAuthority/freezeAuthority 字段存在且非空，说明权限未禁用
-    const hasMintAuthority = !!token.mintAuthority;
-    const hasFreezeAuthority = !!token.freezeAuthority;
-    const isSuspicious = audit?.isSus || false;
-    // 收集警告
-    if (!isVerified)
-        warnings.push('Not verified');
-    if (hasMintAuthority)
-        warnings.push('Mint authority enabled');
-    if (hasFreezeAuthority)
-        warnings.push('Freeze authority enabled');
-    if (isSuspicious)
-        warnings.push('Flagged as suspicious');
-    if (token.organicScoreLabel === 'low')
-        warnings.push('Low organic score');
-    if (audit?.topHoldersPercentage && audit.topHoldersPercentage > 50) {
-        warnings.push(`Top holders own ${audit.topHoldersPercentage.toFixed(2)}%`);
-    }
-    if (audit?.devBalancePercentage && audit.devBalancePercentage > 10) {
-        warnings.push(`Dev owns ${audit.devBalancePercentage.toFixed(2)}%`);
-    }
-    // 综合判断是否可信
-    // 注意：对于稳定币如 USDC，mintAuthority 和 freezeAuthority 是正常存在的
-    const isTrusted = isVerified &&
-        !isSuspicious &&
-        token.organicScoreLabel !== 'low';
-    return {
-        isTrusted,
-        isVerified,
-        organicScore: token.organicScore,
-        organicScoreLabel: token.organicScoreLabel,
-        hasMintAuthority,
-        hasFreezeAuthority,
-        isSuspicious,
-        warnings,
-    };
-}
-// ============================================================================
-// Routers - 获取可用路由器列表
-// ============================================================================
-/**
- * 获取可用路由器列表
- *
- * 返回 Jupiter Ultra API 支持的所有路由器信息。
- *
- * @param config Jupiter 配置
- * @returns 路由器信息数组
- *
- * @example
- * ```typescript
- * import { Sol } from 'four-flap-meme-sdk'
- *
- * Sol.setJupiterConfig({ apiKey: 'your-api-key' })
- *
- * const routers = await Sol.getJupiterRouters()
- *
- * routers.forEach(router => {
- *   console.log(`${router.name} (${router.id})`)
- *   console.log(`  图标: ${router.icon}`)
- * })
- *
- * // 输出:
- * // Iris (iris)
- * // JupiterZ (jupiterz)
- * ```
- */
-export async function getJupiterRouters(config) {
-    return jupGet('/ultra/v1/order/routers', {}, config);
-}
-/**
- * 获取路由器 ID 列表
- *
- * @param config Jupiter 配置
- * @returns 路由器 ID 数组
- *
- * @example
- * ```typescript
- * const routerIds = await Sol.getJupiterRouterIds()
- * // ['iris', 'jupiterz']
- * ```
- */
-export async function getJupiterRouterIds(config) {
-    const routers = await getJupiterRouters(config);
-    return routers.map(r => r.id);
-}
-// ============================================================================
-// Balances - 轻量余额查询
-// ============================================================================
-/**
- * 获取账户所有代币余额（轻量版）
- *
- * 比 getJupiterHoldings() 更轻量，返回格式更简洁。
- * 键为代币符号 (SOL) 或 mint 地址。
- *
- * @param address 钱包地址
- * @param config Jupiter 配置
- * @returns 代币余额映射
- *
- * @example
- * ```typescript
- * import { Sol } from 'four-flap-meme-sdk'
- *
- * Sol.setJupiterConfig({ apiKey: 'your-api-key' })
- *
- * const balances = await Sol.getJupiterBalances(
- *   'GqUEBPPxiq3YjDxTe7TPhoSzSEGNPpSy4ciScxpd1hJz'
- * )
- *
- * // 原生 SOL 余额
- * console.log('SOL:', balances['SOL'].uiAmount)
- *
- * // 代币余额 (通过 mint 地址)
- * const usdcMint = 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
- * if (balances[usdcMint]) {
- *   console.log('USDC:', balances[usdcMint].uiAmount)
- * }
- *
- * // 遍历所有余额
- * for (const [key, info] of Object.entries(balances)) {
- *   console.log(`${key}: ${info.uiAmount} (frozen: ${info.isFrozen})`)
- * }
- * ```
- */
-export async function getJupiterBalances(address, config) {
-    return jupGet(`/ultra/v1/balances/${address}`, {}, config);
-}
-/**
- * 获取账户 SOL 余额
- *
- * @param address 钱包地址
- * @param config Jupiter 配置
- * @returns SOL 余额信息，如果账户不存在返回 null
- *
- * @example
- * ```typescript
- * const sol = await Sol.getJupiterSolBalance('wallet...')
- * if (sol) {
- *   console.log('SOL 余额:', sol.uiAmount)
- * }
- * ```
- */
-export async function getJupiterSolBalance(address, config) {
-    const balances = await getJupiterBalances(address, config);
-    return balances['SOL'] || null;
-}
-/**
- * 获取账户指定代币余额
- *
- * @param address 钱包地址
- * @param mint 代币 mint 地址
- * @param config Jupiter 配置
- * @returns 代币余额信息，如果没有该代币返回 null
- *
- * @example
- * ```typescript
- * const usdc = await Sol.getJupiterTokenBalance(
- *   'wallet...',
- *   'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v'
- * )
- * if (usdc) {
- *   console.log('USDC 余额:', usdc.uiAmount)
- * }
- * ```
- */
-export async function getJupiterTokenBalance(address, mint, config) {
-    const balances = await getJupiterBalances(address, config);
-    return balances[mint] || null;
-}
-/**
- * 获取账户所有非零余额的代币 mint 列表
- *
- * @param address 钱包地址
- * @param config Jupiter 配置
- * @returns 代币 mint 地址数组（不包含 SOL）
- *
- * @example
- * ```typescript
- * const mints = await Sol.getJupiterTokenMints('wallet...')
- * console.log('持有的代币:', mints)
- * ```
- */
-export async function getJupiterTokenMints(address, config) {
-    const balances = await getJupiterBalances(address, config);
-    return Object.keys(balances).filter(key => key !== 'SOL');
-}
-/**
- * 获取账户余额摘要
- *
- * @param address 钱包地址
- * @param config Jupiter 配置
- * @returns 余额摘要
- *
- * @example
- * ```typescript
- * const summary = await Sol.getJupiterBalanceSummary('wallet...')
- * console.log('SOL:', summary.solBalance)
- * console.log('代币数量:', summary.tokenCount)
- * console.log('冻结代币:', summary.frozenCount)
- * ```
- */
-export async function getJupiterBalanceSummary(address, config) {
-    const balances = await getJupiterBalances(address, config);
-    const solBalance = balances['SOL']?.uiAmount || 0;
-    const tokens = [];
-    let frozenCount = 0;
-    for (const [key, info] of Object.entries(balances)) {
-        if (key === 'SOL')
-            continue;
-        tokens.push({
-            mint: key,
-            balance: info.uiAmount,
-            isFrozen: info.isFrozen,
-        });
-        if (info.isFrozen)
-            frozenCount++;
-    }
-    return {
-        solBalance,
-        tokenCount: tokens.length,
-        frozenCount,
-        tokens,
-    };
-}