four-flap-meme-sdk 1.4.87 → 1.4.89

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

@@ -0,0 +1,853 @@
+/**
+ * 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,
+    };
+}