four-flap-meme-sdk 1.4.87 → 1.4.89

package/dist/sol/dex/jup/types.d.ts

@@ -0,0 +1,433 @@
+/**
+ * Jupiter API 类型定义
+ * @module sol/dex/jup/types
+ */
+/** Jupiter 客户端配置 */
+export interface JupiterConfig {
+    /** API Key (从 https://portal.jup.ag 获取) */
+    apiKey: string;
+    /** 基础 URL (默认: https://api.jup.ag) */
+    baseUrl?: string;
+    /** 请求超时 (ms) */
+    timeout?: number;
+}
+/** 路由器类型 */
+export type JupiterRouter = 'iris' | 'jupiterz' | 'dflow' | 'okx';
+/** Swap 模式 */
+export type JupiterSwapMode = 'ExactIn' | 'ExactOut';
+/** 错误代码 */
+export type JupiterErrorCode = 1 | 2 | 3;
+/** Swap 信息 */
+export interface JupiterSwapInfo {
+    /** AMM Key */
+    ammKey: string;
+    /** DEX 标签 */
+    label: string;
+    /** 输入代币 Mint */
+    inputMint: string;
+    /** 输出代币 Mint */
+    outputMint: string;
+    /** 输入数量 */
+    inAmount: string;
+    /** 输出数量 */
+    outAmount: string;
+    /** 费用数量 */
+    feeAmount: string;
+    /** 费用代币 Mint */
+    feeMint: string;
+    /** 市场滑点 (可选) */
+    marketIncurredSlippageBpsF64?: string;
+}
+/** 路由计划 */
+export interface JupiterRoutePlan {
+    /** 路由信息 */
+    swapInfo: JupiterSwapInfo;
+    /** 百分比 */
+    percent: number;
+    /** 基点 */
+    bps: number;
+    /** USD 价值 */
+    usdValue: number;
+}
+/** 平台费用 */
+export interface JupiterPlatformFee {
+    /** 费用基点 */
+    feeBps: number;
+    /** 费用金额 (可选) */
+    amount?: string;
+}
+/** Order 请求参数 */
+export interface JupiterOrderParams {
+    /** 输入代币 Mint */
+    inputMint: string;
+    /** 输出代币 Mint */
+    outputMint: string;
+    /** 输入数量 (最小单位) */
+    amount: string;
+    /** 交易者地址 */
+    taker?: string;
+    /** 接收者地址 (默认与 taker 相同) */
+    receiver?: string;
+    /** 代付 Gas 的地址 */
+    payer?: string;
+    /** ATA 关闭权限 (当 payer 传入时必填) */
+    closeAuthority?: string;
+    /** 推荐账户 (用于集成商费用) */
+    referralAccount?: string;
+    /** 推荐费用 (50-255 bps) */
+    referralFee?: number;
+    /** 排除的路由器 */
+    excludeRouters?: JupiterRouter | JupiterRouter[];
+    /** 排除的 DEX (例如: "Raydium,Orca+V2,Meteora+DLMM") */
+    excludeDexes?: string;
+}
+/** Order 响应 */
+export interface JupiterOrderResponse {
+    /** 模式 */
+    mode: string;
+    /** 输入代币 Mint */
+    inputMint: string;
+    /** 输出代币 Mint */
+    outputMint: string;
+    /** 输入数量 */
+    inAmount: string;
+    /** 输出数量 */
+    outAmount: string;
+    /** 其他数量阈值 */
+    otherAmountThreshold: string;
+    /** Swap 模式 */
+    swapMode: JupiterSwapMode;
+    /** 滑点 (bps) */
+    slippageBps: number;
+    /** 价格影响百分比 (已弃用，使用 priceImpact) */
+    priceImpactPct: string;
+    /** 路由计划 */
+    routePlan: JupiterRoutePlan[];
+    /** 费用 (bps) */
+    feeBps: number;
+    /** 平台费用 */
+    platformFee: JupiterPlatformFee;
+    /** 签名费用 (lamports) */
+    signatureFeeLamports: number;
+    /** 签名费用支付者 */
+    signatureFeePayer: string | null;
+    /** 优先费用 (lamports) */
+    prioritizationFeeLamports: number;
+    /** 优先费用支付者 */
+    prioritizationFeePayer: string | null;
+    /** 租金费用 (lamports) */
+    rentFeeLamports: number;
+    /** 租金费用支付者 */
+    rentFeePayer: string | null;
+    /** Swap 类型 (已弃用) */
+    swapType: string;
+    /** 路由器 */
+    router: JupiterRouter;
+    /** Base64 编码的未签名交易 */
+    transaction: string | null;
+    /** 是否无 Gas */
+    gasless: boolean;
+    /** 请求 ID (execute 时需要) */
+    requestId: string;
+    /** 总耗时 (ms) */
+    totalTime: number;
+    /** 交易者地址 */
+    taker: string | null;
+    /** 输入 USD 价值 */
+    inUsdValue?: number;
+    /** 输出 USD 价值 */
+    outUsdValue?: number;
+    /** 价格影响 */
+    priceImpact?: number;
+    /** Swap USD 价值 */
+    swapUsdValue?: number;
+    /** 推荐账户 */
+    referralAccount?: string;
+    /** 费用代币 Mint */
+    feeMint?: string;
+    /** 报价 ID */
+    quoteId?: string;
+    /** Maker 地址 */
+    maker?: string;
+    /** 过期时间 */
+    expireAt?: string;
+    /** 错误代码 */
+    errorCode?: JupiterErrorCode;
+    /** 错误信息 */
+    errorMessage?: string;
+}
+/** Execute 请求参数 */
+export interface JupiterExecuteParams {
+    /** 签名后的交易 (Base64) */
+    signedTransaction: string;
+    /** 请求 ID (从 order 响应获取) */
+    requestId: string;
+}
+/** Execute 响应 */
+export interface JupiterExecuteResponse {
+    /** 交易签名 */
+    signature: string;
+    /** 状态 */
+    status: 'Success' | 'Failed';
+    /** 错误信息 */
+    error?: string;
+}
+/** 代币账户信息 */
+export interface JupiterTokenAccountInfo {
+    /** 代币账户地址 */
+    account: string;
+    /** 原始数量 (最小单位) */
+    amount: string;
+    /** UI 数量 (已转换精度) */
+    uiAmount: number;
+    /** UI 数量字符串 */
+    uiAmountString: string;
+    /** 是否被冻结 */
+    isFrozen: boolean;
+    /** 是否是关联代币账户 (ATA) */
+    isAssociatedTokenAccount: boolean;
+    /** 代币精度 */
+    decimals: number;
+    /** Token Program ID */
+    programId: string;
+}
+/** Holdings 响应 */
+export interface JupiterHoldingsResponse {
+    /** 原生 SOL 数量 (lamports) */
+    amount: string;
+    /** UI 数量 */
+    uiAmount: number;
+    /** UI 数量字符串 */
+    uiAmountString: string;
+    /** 代币持仓 (按 mint 地址分组) */
+    tokens: Record<string, JupiterTokenAccountInfo[]>;
+    /** 错误信息 (失败时) */
+    error?: string;
+}
+/** Native SOL Holdings 响应 */
+export interface JupiterNativeHoldingsResponse {
+    /** 原生 SOL 数量 (lamports) */
+    amount: string;
+    /** UI 数量 */
+    uiAmount: number;
+    /** UI 数量字符串 */
+    uiAmountString: string;
+    /** 错误信息 (失败时) */
+    error?: string;
+}
+/** Shield 警告类型枚举 */
+export type JupiterShieldWarningType = 'NOT_VERIFIED' | 'LOW_LIQUIDITY' | 'NOT_SELLABLE' | 'LOW_ORGANIC_ACTIVITY' | 'HAS_MINT_AUTHORITY' | 'HAS_FREEZE_AUTHORITY' | 'HAS_PERMANENT_DELEGATE' | 'NEW_LISTING' | 'VERY_LOW_TRADING_ACTIVITY' | 'HIGH_SUPPLY_CONCENTRATION' | 'NON_TRANSFERABLE' | 'MUTABLE_TRANSFER_FEES' | 'SUSPICIOUS_DEV_ACTIVITY' | 'SUSPICIOUS_TOP_HOLDER_ACTIVITY' | 'HIGH_SINGLE_OWNERSHIP' | string;
+/** Shield 警告严重程度 */
+export type JupiterShieldSeverity = 'info' | 'warning' | 'critical';
+/** Shield 警告来源 */
+export type JupiterShieldSource = 'RugCheck' | string;
+/** Shield 单个警告信息 */
+export interface JupiterShieldWarning {
+    /** 警告类型 */
+    type: JupiterShieldWarningType;
+    /** 人类可读的警告消息 */
+    message: string;
+    /** 严重程度 */
+    severity: JupiterShieldSeverity;
+    /** 警告来源 (可选) */
+    source?: JupiterShieldSource;
+}
+/** Shield 响应 */
+export interface JupiterShieldResponse {
+    /**
+     * 代币警告信息
+     * 键为代币 mint 地址，值为警告信息数组
+     * 如果代币安全，则不会出现在此对象中
+     */
+    warnings: Record<string, JupiterShieldWarning[]>;
+    /** 错误信息 (失败时) */
+    error?: string;
+}
+/** Shield 请求参数 */
+export interface JupiterShieldParams {
+    /** 代币 mint 地址数组 */
+    mints: string[];
+}
+/** 代币交易统计 */
+export interface JupiterTokenStats {
+    /** 价格变化百分比 */
+    priceChange: number | null;
+    /** 持有者变化 */
+    holderChange: number | null;
+    /** 流动性变化 */
+    liquidityChange: number | null;
+    /** 交易量变化 */
+    volumeChange: number | null;
+    /** 买入量 */
+    buyVolume: number | null;
+    /** 卖出量 */
+    sellVolume: number | null;
+    /** 有机买入量 */
+    buyOrganicVolume: number | null;
+    /** 有机卖出量 */
+    sellOrganicVolume: number | null;
+    /** 买入次数 */
+    numBuys: number | null;
+    /** 卖出次数 */
+    numSells: number | null;
+    /** 交易者数量 */
+    numTraders: number | null;
+    /** 有机买家数量 */
+    numOrganicBuyers: number | null;
+    /** 净买家数量 */
+    numNetBuyers: number | null;
+}
+/** 代币首个池子信息 */
+export interface JupiterFirstPool {
+    /** 池子 ID */
+    id: string;
+    /** 创建时间 */
+    createdAt: string;
+}
+/** 代币审计信息 */
+export interface JupiterTokenAudit {
+    /** 是否可疑 */
+    isSus?: boolean;
+    /** Mint 权限是否禁用 */
+    mintAuthorityDisabled?: boolean;
+    /** 冻结权限是否禁用 */
+    freezeAuthorityDisabled?: boolean;
+    /** 前几名持有者占比 */
+    topHoldersPercentage?: number | null;
+    /** 开发者余额占比 */
+    devBalancePercentage?: number | null;
+    /** 开发者迁移次数 */
+    devMigrations?: number | null;
+    /** 开发者铸币次数 */
+    devMints?: number | null;
+}
+/** 代币收益率信息 */
+export interface JupiterTokenApy {
+    /** Jupiter Earn APY */
+    jupEarn?: number;
+}
+/** 简化统计 (7d/30d) */
+export interface JupiterTokenSimpleStats {
+    /** 价格变化百分比 */
+    priceChange: number | null;
+}
+/** 有机评分等级 */
+export type JupiterOrganicScoreLabel = 'high' | 'medium' | 'low';
+/** 代币搜索结果 */
+export interface JupiterTokenInfo {
+    /** 代币 Mint 地址 */
+    id: string;
+    /** 代币名称 */
+    name: string;
+    /** 代币符号 */
+    symbol: string;
+    /** 图标 URL */
+    icon: string | null;
+    /** 精度 */
+    decimals: number;
+    /** Twitter 链接 */
+    twitter: string | null;
+    /** Discord 链接 */
+    discord: string | null;
+    /** Telegram 链接 */
+    telegram: string | null;
+    /** 网站 */
+    website: string | null;
+    /** 开发者地址 */
+    dev: string | null;
+    /** 流通供应量 */
+    circSupply: number | null;
+    /** 总供应量 */
+    totalSupply: number | null;
+    /** Token Program 地址 */
+    tokenProgram: string;
+    /** Mint 权限地址 */
+    mintAuthority: string | null;
+    /** 冻结权限地址 */
+    freezeAuthority: string | null;
+    /** 发射平台 */
+    launchpad: string | null;
+    /** 合作配置 */
+    partnerConfig: string | null;
+    /** 毕业池子地址 */
+    graduatedPool: string | null;
+    /** 毕业时间 */
+    graduatedAt: string | null;
+    /** 首个池子信息 */
+    firstPool: JupiterFirstPool | null;
+    /** 持有者数量 */
+    holderCount: number | null;
+    /** 审计信息 */
+    audit: JupiterTokenAudit | null;
+    /** APY 收益率信息 */
+    apy: JupiterTokenApy | null;
+    /** 有机评分 (0-100) */
+    organicScore: number | null;
+    /** 有机评分等级 */
+    organicScoreLabel: JupiterOrganicScoreLabel | null;
+    /** CT (Crypto Twitter) 点赞数 */
+    ctLikes: number | null;
+    /** Smart CT 点赞数 */
+    smartCtLikes: number | null;
+    /** 是否已验证 */
+    isVerified: boolean | null;
+    /** 上线的 CEX 列表 */
+    cexes: string[] | null;
+    /** 标签 */
+    tags: string[] | null;
+    /** 创建时间 */
+    createdAt: string | null;
+    /** 全稀释估值 (FDV) */
+    fdv: number | null;
+    /** 市值 */
+    mcap: number | null;
+    /** USD 价格 */
+    usdPrice: number | null;
+    /** 价格区块 ID */
+    priceBlockId: number | null;
+    /** 流动性 */
+    liquidity: number | null;
+    /** 5分钟统计 */
+    stats5m: JupiterTokenStats | null;
+    /** 1小时统计 */
+    stats1h: JupiterTokenStats | null;
+    /** 6小时统计 */
+    stats6h: JupiterTokenStats | null;
+    /** 24小时统计 */
+    stats24h: JupiterTokenStats | null;
+    /** 7天统计 */
+    stats7d: JupiterTokenSimpleStats | null;
+    /** 30天统计 */
+    stats30d: JupiterTokenSimpleStats | null;
+    /** 更新时间 */
+    updatedAt: string;
+}
+/** Search 响应 (代币信息数组) */
+export type JupiterSearchResponse = JupiterTokenInfo[];
+/** 路由器信息 */
+export interface JupiterRouterInfo {
+    /** 路由器 ID */
+    id: string;
+    /** 路由器名称 */
+    name: string;
+    /** 图标 URL */
+    icon: string;
+}
+/** Routers 响应 */
+export type JupiterRoutersResponse = JupiterRouterInfo[];
+/** 单个代币余额信息 */
+export interface JupiterBalanceInfo {
+    /** 原始数量 (最小单位) */
+    amount: string;
+    /** UI 数量 (已转换精度) */
+    uiAmount: number;
+    /** Slot 高度 */
+    slot: number;
+    /** 是否被冻结 */
+    isFrozen: boolean;
+}
+/**
+ * Balances 响应
+ * 键为代币符号 (SOL) 或 mint 地址
+ */
+export type JupiterBalancesResponse = Record<string, JupiterBalanceInfo>;

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

@@ -0,0 +1,5 @@
+/**
+ * Jupiter API 类型定义
+ * @module sol/dex/jup/types
+ */
+export {};