four-flap-meme-sdk 1.4.87 → 1.4.89

package/dist/sol/constants.d.ts

@@ -0,0 +1,126 @@
+/**
+ * Solana SDK 常量配置
+ * @module sol/constants
+ */
+/**
+ * Jito 配置
+ *
+ * 注意：BLOCK_ENGINE_URL 需要由前端传入，不在 SDK 中写死
+ */
+export declare const JITO_CONFIG: {
+    /** Tip 账户列表（随机选择一个）- 这些是 Jito 官方账户，固定不变 */
+    readonly TIP_ACCOUNTS: readonly ["96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5", "HFqU5x63VTqvQss8hp11i4bVmkzdNaVB6PYjYgNd4W5U", "Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY", "ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49", "DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh", "ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt", "DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL", "3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT"];
+    /** 最小 Tip（lamports） */
+    readonly MIN_TIP_LAMPORTS: 1000;
+    /** 默认 Tip（lamports）- 0.00001 SOL */
+    readonly DEFAULT_TIP_LAMPORTS: 10000;
+};
+/**
+ * Solana 系统程序地址
+ */
+export declare const SYSTEM_PROGRAMS: {
+    /** Token Program */
+    readonly TOKEN_PROGRAM: "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA";
+    /** Token-2022 Program */
+    readonly TOKEN_2022_PROGRAM: "TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb";
+    /** Associated Token Account Program */
+    readonly ATA_PROGRAM: "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL";
+    /** Metaplex Token Metadata Program */
+    readonly METADATA_PROGRAM: "metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s";
+    /** System Program */
+    readonly SYSTEM_PROGRAM: "11111111111111111111111111111111";
+    /** Rent Sysvar */
+    readonly RENT_SYSVAR: "SysvarRent111111111111111111111111111111111";
+};
+/**
+ * Pump.fun 程序地址
+ */
+export declare const PUMP_PROGRAMS: {
+    /** Pump Program ID */
+    readonly PUMP_PROGRAM: "6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P";
+    /** Pump Swap Program ID */
+    readonly PUMP_SWAP_PROGRAM: "pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA";
+    /** Global Config */
+    readonly GLOBAL_CONFIG: "4wTV1YmiEkRvAtNtsSGPtUrqRYQMe5SKy2uB4Jjaxnjf";
+};
+/**
+ * Raydium 程序地址
+ */
+export declare const RAYDIUM_PROGRAMS: {
+    /** AMM Program ID */
+    readonly AMM_PROGRAM: "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8";
+    /** CLMM Program ID */
+    readonly CLMM_PROGRAM: "CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK";
+    /** LaunchLab Program ID */
+    readonly LAUNCHLAB_PROGRAM: "LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj";
+};
+/**
+ * Orca 程序地址
+ */
+export declare const ORCA_PROGRAMS: {
+    /** Whirlpool Program ID */
+    readonly WHIRLPOOL_PROGRAM: "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc";
+};
+/**
+ * Meteora 程序地址
+ */
+export declare const METEORA_PROGRAMS: {
+    /** DLMM Program ID */
+    readonly DLMM_PROGRAM: "LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo";
+    /** DAMM v2 Program ID */
+    readonly DAMM_V2_PROGRAM: "cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG";
+    /** DBC Program ID */
+    readonly DBC_PROGRAM: "dbcij3LWUppWqq96dh6gJWwBifmcGfLSB5D4DuSMaqN";
+};
+/**
+ * 常用代币地址
+ */
+export declare const TOKENS: {
+    /** Wrapped SOL */
+    readonly SOL: "So11111111111111111111111111111111111111112";
+    /** USDC */
+    readonly USDC: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
+    /** USDT */
+    readonly USDT: "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB";
+};
+/**
+ * 交易默认配置
+ */
+export declare const TX_CONFIG: {
+    /** 默认滑点 1% */
+    readonly DEFAULT_SLIPPAGE: 1;
+    /** 最大滑点 50% */
+    readonly MAX_SLIPPAGE: 50;
+    /** 计算单元限制 */
+    readonly COMPUTE_UNIT_LIMIT: 200000;
+    /** 计算单元价格（microlamports） */
+    readonly COMPUTE_UNIT_PRICE: 50000;
+    /** 确认超时（毫秒） */
+    readonly CONFIRMATION_TIMEOUT: 60000;
+    /** 默认 commitment */
+    readonly DEFAULT_COMMITMENT: "confirmed";
+};
+/**
+ * 账户大小（用于计算租金）
+ */
+export declare const ACCOUNT_SIZE: {
+    /** Mint 账户大小 */
+    readonly MINT: 82;
+    /** Token 账户大小 */
+    readonly TOKEN_ACCOUNT: 165;
+    /** Metadata 账户大小（近似值） */
+    readonly METADATA: 679;
+};
+/**
+ * SOL 单位换算
+ */
+export declare const SOL_DECIMALS = 9;
+export declare const LAMPORTS_PER_SOL = 1000000000;
+/**
+ * 将 SOL 转换为 lamports
+ */
+export declare function solToLamports(sol: number): bigint;
+/**
+ * 将 lamports 转换为 SOL
+ */
+export declare function lamportsToSol(lamports: bigint): number;

package/dist/sol/constants.js

@@ -0,0 +1,145 @@
+/**
+ * Solana SDK 常量配置
+ * @module sol/constants
+ */
+// ==================== Jito Bundle 配置 ====================
+/**
+ * Jito 配置
+ *
+ * 注意：BLOCK_ENGINE_URL 需要由前端传入，不在 SDK 中写死
+ */
+export const JITO_CONFIG = {
+    /** Tip 账户列表（随机选择一个）- 这些是 Jito 官方账户，固定不变 */
+    TIP_ACCOUNTS: [
+        '96gYZGLnJYVFmbjzopPSU6QiEV5fGqZNyN9nmNhvrZU5',
+        'HFqU5x63VTqvQss8hp11i4bVmkzdNaVB6PYjYgNd4W5U',
+        'Cw8CFyM9FkoMi7K7Crf6HNQqf4uEMzpKw6QNghXLvLkY',
+        'ADaUMid9yfUytqMBgopwjb2DTLSokTSzL1zt6iGPaS49',
+        'DfXygSm4jCyNCybVYYK6DwvWqjKee8pbDmJGcLWNDXjh',
+        'ADuUkR4vqLUMWXxW9gh6D6L8pMSawimctcNZ5pGwDcEt',
+        'DttWaMuVvTiduZRnguLF7jNxTgiMBZ1hyAumKUiL2KRL',
+        '3AVi9Tg9Uo68tJfuvoKvqKNWKkC5wPdSSdeBnizKZ6jT',
+    ],
+    /** 最小 Tip（lamports） */
+    MIN_TIP_LAMPORTS: 1000,
+    /** 默认 Tip（lamports）- 0.00001 SOL */
+    DEFAULT_TIP_LAMPORTS: 10000,
+};
+// ==================== 程序地址 ====================
+/**
+ * Solana 系统程序地址
+ */
+export const SYSTEM_PROGRAMS = {
+    /** Token Program */
+    TOKEN_PROGRAM: 'TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA',
+    /** Token-2022 Program */
+    TOKEN_2022_PROGRAM: 'TokenzQdBNbLqP5VEhdkAS6EPFLC1PHnBqCXEpPxuEb',
+    /** Associated Token Account Program */
+    ATA_PROGRAM: 'ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL',
+    /** Metaplex Token Metadata Program */
+    METADATA_PROGRAM: 'metaqbxxUerdq28cj1RbAWkYQm3ybzjb6a8bt518x1s',
+    /** System Program */
+    SYSTEM_PROGRAM: '11111111111111111111111111111111',
+    /** Rent Sysvar */
+    RENT_SYSVAR: 'SysvarRent111111111111111111111111111111111',
+};
+/**
+ * Pump.fun 程序地址
+ */
+export const PUMP_PROGRAMS = {
+    /** Pump Program ID */
+    PUMP_PROGRAM: '6EF8rrecthR5Dkzon8Nwu78hRvfCKubJ14M5uBEwF6P',
+    /** Pump Swap Program ID */
+    PUMP_SWAP_PROGRAM: 'pAMMBay6oceH9fJKBRHGP5D4bD4sWpmSwMn52FMfXEA',
+    /** Global Config */
+    GLOBAL_CONFIG: '4wTV1YmiEkRvAtNtsSGPtUrqRYQMe5SKy2uB4Jjaxnjf',
+};
+/**
+ * Raydium 程序地址
+ */
+export const RAYDIUM_PROGRAMS = {
+    /** AMM Program ID */
+    AMM_PROGRAM: '675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8',
+    /** CLMM Program ID */
+    CLMM_PROGRAM: 'CAMMCzo5YL8w4VFF8KVHrK22GGUsp5VTaW7grrKgrWqK',
+    /** LaunchLab Program ID */
+    LAUNCHLAB_PROGRAM: 'LanMV9sAd7wArD4vJFi2qDdfnVhFxYSUg6eADduJ3uj',
+};
+/**
+ * Orca 程序地址
+ */
+export const ORCA_PROGRAMS = {
+    /** Whirlpool Program ID */
+    WHIRLPOOL_PROGRAM: 'whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc',
+};
+/**
+ * Meteora 程序地址
+ */
+export const METEORA_PROGRAMS = {
+    /** DLMM Program ID */
+    DLMM_PROGRAM: 'LBUZKhRxPF3XUpBCjp4YzTKgLccjZhTSDM9YuVaPwxo',
+    /** DAMM v2 Program ID */
+    DAMM_V2_PROGRAM: 'cpamdpZCGKUy5JxQXB4dcpGPiikHawvSWAd6mEn1sGG',
+    /** DBC Program ID */
+    DBC_PROGRAM: 'dbcij3LWUppWqq96dh6gJWwBifmcGfLSB5D4DuSMaqN',
+};
+// ==================== 常用代币地址 ====================
+/**
+ * 常用代币地址
+ */
+export const TOKENS = {
+    /** Wrapped SOL */
+    SOL: 'So11111111111111111111111111111111111111112',
+    /** USDC */
+    USDC: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
+    /** USDT */
+    USDT: 'Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB',
+};
+// ==================== 交易配置 ====================
+/**
+ * 交易默认配置
+ */
+export const TX_CONFIG = {
+    /** 默认滑点 1% */
+    DEFAULT_SLIPPAGE: 1,
+    /** 最大滑点 50% */
+    MAX_SLIPPAGE: 50,
+    /** 计算单元限制 */
+    COMPUTE_UNIT_LIMIT: 200000,
+    /** 计算单元价格（microlamports） */
+    COMPUTE_UNIT_PRICE: 50000,
+    /** 确认超时（毫秒） */
+    CONFIRMATION_TIMEOUT: 60000,
+    /** 默认 commitment */
+    DEFAULT_COMMITMENT: 'confirmed',
+};
+// ==================== 账户大小 ====================
+/**
+ * 账户大小（用于计算租金）
+ */
+export const ACCOUNT_SIZE = {
+    /** Mint 账户大小 */
+    MINT: 82,
+    /** Token 账户大小 */
+    TOKEN_ACCOUNT: 165,
+    /** Metadata 账户大小（近似值） */
+    METADATA: 679,
+};
+// ==================== 单位换算 ====================
+/**
+ * SOL 单位换算
+ */
+export const SOL_DECIMALS = 9;
+export const LAMPORTS_PER_SOL = 1000000000;
+/**
+ * 将 SOL 转换为 lamports
+ */
+export function solToLamports(sol) {
+    return BigInt(Math.floor(sol * LAMPORTS_PER_SOL));
+}
+/**
+ * 将 lamports 转换为 SOL
+ */
+export function lamportsToSol(lamports) {
+    return Number(lamports) / LAMPORTS_PER_SOL;
+}

package/dist/sol/dex/blockrazor/client.d.ts

@@ -0,0 +1,51 @@
+/**
+ * BlockRazor 客户端配置管理
+ * @module sol/dex/blockrazor/client
+ */
+import type { BlockRazorConfig, BlockRazorSendParams } from './types.js';
+/**
+ * 设置默认 BlockRazor 配置
+ *
+ * @param config 配置
+ *
+ * @example
+ * ```typescript
+ * import { Sol } from 'four-flap-meme-sdk'
+ *
+ * Sol.setBlockRazorConfig({
+ *   apiKey: 'your-auth-token',
+ *   region: 'frankfurt',
+ * })
+ * ```
+ */
+export declare function setBlockRazorConfig(config: BlockRazorConfig): void;
+/**
+ * 获取 BlockRazor 配置
+ *
+ * @param config 可选配置（覆盖默认配置）
+ * @returns 配置对象
+ * @throws 未配置时抛出错误
+ */
+export declare function getBlockRazorConfig(config?: BlockRazorConfig): BlockRazorConfig;
+/**
+ * 获取端点 URL
+ *
+ * @param config 可选配置
+ * @returns 端点 URL
+ */
+export declare function getBlockRazorEndpoint(config?: BlockRazorConfig): string;
+/**
+ * 获取随机 BlockRazor Tip 账户
+ *
+ * 避免因地址占用导致的性能下降，建议轮换 Tip 账户。
+ *
+ * @returns 随机 Tip 账户地址
+ */
+export declare function getRandomBlockRazorTipAccount(): string;
+/**
+ * 验证发送交易参数
+ *
+ * @param params 发送参数
+ * @throws 参数无效时抛出错误
+ */
+export declare function validateSendParams(params: BlockRazorSendParams): void;

package/dist/sol/dex/blockrazor/client.js

@@ -0,0 +1,96 @@
+/**
+ * BlockRazor 客户端配置管理
+ * @module sol/dex/blockrazor/client
+ */
+import { BLOCKRAZOR_ENDPOINTS, BLOCKRAZOR_TIP_ACCOUNTS } from './constants.js';
+// ============================================================================
+// 客户端管理
+// ============================================================================
+let defaultConfig = null;
+/**
+ * 设置默认 BlockRazor 配置
+ *
+ * @param config 配置
+ *
+ * @example
+ * ```typescript
+ * import { Sol } from 'four-flap-meme-sdk'
+ *
+ * Sol.setBlockRazorConfig({
+ *   apiKey: 'your-auth-token',
+ *   region: 'frankfurt',
+ * })
+ * ```
+ */
+export function setBlockRazorConfig(config) {
+    defaultConfig = config;
+}
+/**
+ * 获取 BlockRazor 配置
+ *
+ * @param config 可选配置（覆盖默认配置）
+ * @returns 配置对象
+ * @throws 未配置时抛出错误
+ */
+export function getBlockRazorConfig(config) {
+    const cfg = config || defaultConfig;
+    if (!cfg) {
+        throw new Error('BlockRazor not configured. Call setBlockRazorConfig() first or pass config.');
+    }
+    return cfg;
+}
+/**
+ * 获取端点 URL
+ *
+ * @param config 可选配置
+ * @returns 端点 URL
+ */
+export function getBlockRazorEndpoint(config) {
+    const cfg = getBlockRazorConfig(config);
+    if (cfg.endpoint) {
+        return cfg.endpoint;
+    }
+    const region = cfg.region || 'frankfurt';
+    switch (region) {
+        case 'frankfurt':
+            return BLOCKRAZOR_ENDPOINTS.FRANKFURT;
+        case 'newyork':
+            return BLOCKRAZOR_ENDPOINTS.NEW_YORK;
+        case 'tokyo':
+            return BLOCKRAZOR_ENDPOINTS.TOKYO;
+        case 'amsterdam':
+            return BLOCKRAZOR_ENDPOINTS.AMSTERDAM;
+        default:
+            return BLOCKRAZOR_ENDPOINTS.FRANKFURT;
+    }
+}
+/**
+ * 获取随机 BlockRazor Tip 账户
+ *
+ * 避免因地址占用导致的性能下降，建议轮换 Tip 账户。
+ *
+ * @returns 随机 Tip 账户地址
+ */
+export function getRandomBlockRazorTipAccount() {
+    const index = Math.floor(Math.random() * BLOCKRAZOR_TIP_ACCOUNTS.length);
+    return BLOCKRAZOR_TIP_ACCOUNTS[index];
+}
+/**
+ * 验证发送交易参数
+ *
+ * @param params 发送参数
+ * @throws 参数无效时抛出错误
+ */
+export function validateSendParams(params) {
+    if (!params.transaction) {
+        throw new Error('transaction is required');
+    }
+    if (params.mode && !['fast', 'sandwichMitigation'].includes(params.mode)) {
+        throw new Error('mode must be "fast" or "sandwichMitigation"');
+    }
+    if (params.safeWindow !== undefined) {
+        if (params.safeWindow < 3 || params.safeWindow > 13) {
+            throw new Error('safeWindow must be between 3 and 13');
+        }
+    }
+}

package/dist/sol/dex/blockrazor/constants.d.ts

@@ -0,0 +1,34 @@
+/**
+ * BlockRazor 常量
+ * @module sol/dex/blockrazor/constants
+ */
+/** BlockRazor 区域端点 */
+export declare const BLOCKRAZOR_ENDPOINTS: {
+    /** 法兰克福 */
+    readonly FRANKFURT: "http://frankfurt.solana.blockrazor.xyz:443";
+    /** 纽约 */
+    readonly NEW_YORK: "http://newyork.solana.blockrazor.xyz:443";
+    /** 东京 */
+    readonly TOKYO: "http://tokyo.solana.blockrazor.xyz:443";
+    /** 阿姆斯特丹 */
+    readonly AMSTERDAM: "http://amsterdam.solana.blockrazor.xyz:443";
+};
+/** BlockRazor Tip 账户列表 */
+export declare const BLOCKRAZOR_TIP_ACCOUNTS: readonly ["Gywj98ophM7GmkDdaWs4isqZnDdFCW7B46TXmKfvyqSm", "FjmZZrFvhnqqb9ThCuMVnENaM3JGVuGWNyCAxRJcFpg9", "6No2i3aawzHsjtThw81iq1EXPJN6rh8eSJCLaYZfKDTG", "A9cWowVAiHe9pJfKAj3TJiN9VpbzMUq6E4kEvf5mUT22", "68Pwb4jS7eZATjDfhmTXgRJjCiZmw1L7Huy4HNpnxJ3o", "4ABhJh5rZPjv63RBJBuyWzBK3g9gWMUQdTZP2kiW31V9", "B2M4NG5eyZp5SBQrSdtemzk5TqVuaWGQnowGaCBt8GyM", "5jA59cXMKQqZAVdtopv8q3yyw9SYfiE3vUCbt7p8MfVf", "5YktoWygr1Bp9wiS1xtMtUki1PeYuuzuCF98tqwYxf61", "295Avbam4qGShBYK7E9H5Ldew4B3WyJGmgmXfiWdeeyV", "EDi4rSy2LZgKJX74mbLTFk4mxoTgT6F7HxxzG2HBAFyK", "BnGKHAC386n4Qmv9xtpBVbRaUTKixjBe3oagkPFKtoy6", "Dd7K2Fp7AtoN8xCghKDRmyqr5U169t48Tw5fEd3wT9mq", "AP6qExwrbRgBAVaehg4b5xHENX815sMabtBzUzVB4v8S"];
+/** 默认 Tip 金额 (lamports) */
+export declare const DEFAULT_TIP_AMOUNT = 1000000;
+/** 最小 Tip 金额 (lamports) */
+export declare const MIN_TIP_AMOUNT = 1000000;
+/** 默认请求超时 (ms) */
+export declare const BLOCKRAZOR_DEFAULT_TIMEOUT = 10000;
+/** Geyser Stream 端点 */
+export declare const GEYSER_STREAM_ENDPOINTS: {
+    /** 东京 */
+    readonly TOKYO: "geyserstream-tokyo.blockrazor.xyz:443";
+    /** 法兰克福 */
+    readonly FRANKFURT: "geyserstream-frankfurt.blockrazor.xyz:443";
+    /** 纽约 */
+    readonly NEW_YORK: "geyserstream-newyork.blockrazor.xyz:443";
+    /** 阿姆斯特丹 */
+    readonly AMSTERDAM: "geyserstream-amsterdam.blockrazor.xyz:443";
+};

package/dist/sol/dex/blockrazor/constants.js

@@ -0,0 +1,55 @@
+/**
+ * BlockRazor 常量
+ * @module sol/dex/blockrazor/constants
+ */
+// ============================================================================
+// Send Transaction 端点
+// ============================================================================
+/** BlockRazor 区域端点 */
+export const BLOCKRAZOR_ENDPOINTS = {
+    /** 法兰克福 */
+    FRANKFURT: 'http://frankfurt.solana.blockrazor.xyz:443',
+    /** 纽约 */
+    NEW_YORK: 'http://newyork.solana.blockrazor.xyz:443',
+    /** 东京 */
+    TOKYO: 'http://tokyo.solana.blockrazor.xyz:443',
+    /** 阿姆斯特丹 */
+    AMSTERDAM: 'http://amsterdam.solana.blockrazor.xyz:443',
+};
+/** BlockRazor Tip 账户列表 */
+export const BLOCKRAZOR_TIP_ACCOUNTS = [
+    'Gywj98ophM7GmkDdaWs4isqZnDdFCW7B46TXmKfvyqSm',
+    'FjmZZrFvhnqqb9ThCuMVnENaM3JGVuGWNyCAxRJcFpg9',
+    '6No2i3aawzHsjtThw81iq1EXPJN6rh8eSJCLaYZfKDTG',
+    'A9cWowVAiHe9pJfKAj3TJiN9VpbzMUq6E4kEvf5mUT22',
+    '68Pwb4jS7eZATjDfhmTXgRJjCiZmw1L7Huy4HNpnxJ3o',
+    '4ABhJh5rZPjv63RBJBuyWzBK3g9gWMUQdTZP2kiW31V9',
+    'B2M4NG5eyZp5SBQrSdtemzk5TqVuaWGQnowGaCBt8GyM',
+    '5jA59cXMKQqZAVdtopv8q3yyw9SYfiE3vUCbt7p8MfVf',
+    '5YktoWygr1Bp9wiS1xtMtUki1PeYuuzuCF98tqwYxf61',
+    '295Avbam4qGShBYK7E9H5Ldew4B3WyJGmgmXfiWdeeyV',
+    'EDi4rSy2LZgKJX74mbLTFk4mxoTgT6F7HxxzG2HBAFyK',
+    'BnGKHAC386n4Qmv9xtpBVbRaUTKixjBe3oagkPFKtoy6',
+    'Dd7K2Fp7AtoN8xCghKDRmyqr5U169t48Tw5fEd3wT9mq',
+    'AP6qExwrbRgBAVaehg4b5xHENX815sMabtBzUzVB4v8S',
+];
+/** 默认 Tip 金额 (lamports) */
+export const DEFAULT_TIP_AMOUNT = 1000000;
+/** 最小 Tip 金额 (lamports) */
+export const MIN_TIP_AMOUNT = 1000000;
+/** 默认请求超时 (ms) */
+export const BLOCKRAZOR_DEFAULT_TIMEOUT = 10000;
+// ============================================================================
+// Geyser Stream 端点
+// ============================================================================
+/** Geyser Stream 端点 */
+export const GEYSER_STREAM_ENDPOINTS = {
+    /** 东京 */
+    TOKYO: 'geyserstream-tokyo.blockrazor.xyz:443',
+    /** 法兰克福 */
+    FRANKFURT: 'geyserstream-frankfurt.blockrazor.xyz:443',
+    /** 纽约 */
+    NEW_YORK: 'geyserstream-newyork.blockrazor.xyz:443',
+    /** 阿姆斯特丹 */
+    AMSTERDAM: 'geyserstream-amsterdam.blockrazor.xyz:443',
+};

package/dist/sol/dex/blockrazor/geyser.d.ts

@@ -0,0 +1,128 @@
+/**
+ * BlockRazor Geyser Stream 服务
+ * @module sol/dex/blockrazor/geyser
+ *
+ * Geyser Stream 是基于 Yellowstone gRPC 的高性能 Solana 数据流服务。
+ *
+ * @see https://blockrazor.gitbook.io/blockrazor/solana/geyser-stream
+ */
+import type { GeyserRegion, GeyserSubscribeConfig, GeyserClientConfig, GeyserEventHandlers, GeyserStreamControl } from './types.js';
+/**
+ * Geyser Proto 定义（内联）
+ *
+ * 用于动态加载 gRPC 服务
+ */
+export declare const GEYSER_PROTO_DEFINITION = "\nsyntax = \"proto3\";\n\npackage geyser;\n\nservice Geyser {\n  rpc Subscribe(stream SubscribeRequest) returns (stream SubscribeUpdate);\n}\n\nmessage SubscribeRequest {\n  map<string, SubscribeRequestFilterAccounts> accounts = 1;\n  map<string, SubscribeRequestFilterSlots> slots = 2;\n  map<string, SubscribeRequestFilterTransactions> transactions = 3;\n  map<string, SubscribeRequestFilterBlocks> blocks = 4;\n  map<string, SubscribeRequestFilterBlocksMeta> blocks_meta = 5;\n  map<string, SubscribeRequestFilterEntry> entry = 6;\n  optional CommitmentLevel commitment = 7;\n  repeated SubscribeRequestAccountsDataSlice accounts_data_slice = 8;\n  optional SubscribeRequestPing ping = 9;\n}\n\nenum CommitmentLevel {\n  PROCESSED = 0;\n  CONFIRMED = 1;\n  FINALIZED = 2;\n}\n\nmessage SubscribeRequestFilterAccounts {\n  repeated string account = 1;\n  repeated string owner = 2;\n  repeated SubscribeRequestFilterAccountsFilter filters = 3;\n  optional bool nonempty_txn_signature = 4;\n}\n\nmessage SubscribeRequestFilterAccountsFilter {\n  oneof filter {\n    SubscribeRequestFilterAccountsFilterMemcmp memcmp = 1;\n    uint64 datasize = 2;\n    bool token_account_state = 3;\n    SubscribeRequestFilterAccountsFilterLamports lamports = 4;\n  }\n}\n\nmessage SubscribeRequestFilterAccountsFilterMemcmp {\n  uint64 offset = 1;\n  oneof data {\n    bytes bytes = 2;\n    string base58 = 3;\n    string base64 = 4;\n  }\n}\n\nmessage SubscribeRequestFilterAccountsFilterLamports {\n  oneof cmp {\n    uint64 eq = 1;\n    uint64 ne = 2;\n    uint64 lt = 3;\n    uint64 gt = 4;\n  }\n}\n\nmessage SubscribeRequestFilterSlots {\n  optional bool filter_by_commitment = 1;\n  optional bool interleave_global_updates = 2;\n}\n\nmessage SubscribeRequestFilterTransactions {\n  optional bool vote = 1;\n  optional bool failed = 2;\n  optional string signature = 3;\n  repeated string account_include = 4;\n  repeated string account_exclude = 5;\n  repeated string account_required = 6;\n}\n\nmessage SubscribeRequestFilterBlocks {\n  repeated string account_include = 1;\n  optional bool include_transactions = 2;\n  optional bool include_accounts = 3;\n  optional bool include_entries = 4;\n}\n\nmessage SubscribeRequestFilterBlocksMeta {}\n\nmessage SubscribeRequestFilterEntry {}\n\nmessage SubscribeRequestAccountsDataSlice {\n  uint64 offset = 1;\n  uint64 length = 2;\n}\n\nmessage SubscribeRequestPing {\n  int32 id = 1;\n}\n\nmessage SubscribeUpdate {\n  repeated string filters = 1;\n  oneof update_oneof {\n    SubscribeUpdateAccount account = 2;\n    SubscribeUpdateSlot slot = 3;\n    SubscribeUpdateTransaction transaction = 4;\n    SubscribeUpdateTransactionInfo transaction_info = 10;\n    SubscribeUpdateBlock block = 5;\n    SubscribeUpdatePing ping = 6;\n    SubscribeUpdatePong pong = 7;\n    SubscribeUpdateBlockMeta block_meta = 8;\n    SubscribeUpdateEntry entry = 9;\n  }\n  uint64 created_at = 11;\n}\n\nmessage SubscribeUpdateAccount {\n  SubscribeUpdateAccountInfo account = 1;\n  uint64 slot = 2;\n  optional bool is_startup = 3;\n}\n\nmessage SubscribeUpdateAccountInfo {\n  bytes pubkey = 1;\n  uint64 lamports = 2;\n  bytes owner = 3;\n  bool executable = 4;\n  uint64 rent_epoch = 5;\n  bytes data = 6;\n  uint64 write_version = 7;\n  optional bytes txn_signature = 8;\n}\n\nmessage SubscribeUpdateSlot {\n  uint64 slot = 1;\n  optional uint64 parent = 2;\n  CommitmentLevel status = 3;\n  optional int64 dead_error = 4;\n}\n\nmessage SubscribeUpdateTransaction {\n  SubscribeUpdateTransactionInfo transaction = 1;\n  uint64 slot = 2;\n}\n\nmessage SubscribeUpdateTransactionInfo {\n  bytes signature = 1;\n  bool is_vote = 2;\n  bytes transaction = 3;\n  bytes meta = 4;\n  optional uint64 index = 5;\n}\n\nmessage SubscribeUpdateBlock {\n  uint64 slot = 1;\n  string blockhash = 2;\n  SubscribeUpdateBlockRewards rewards = 3;\n  UnixTimestamp block_time = 4;\n  BlockHeight block_height = 5;\n  uint64 parent_slot = 6;\n  string parent_blockhash = 7;\n  uint64 executed_transaction_count = 8;\n  uint64 entries_count = 9;\n  repeated SubscribeUpdateTransactionInfo transactions = 10;\n  repeated SubscribeUpdateAccountInfo updated_account_count = 11;\n  repeated SubscribeUpdateEntry entries = 12;\n}\n\nmessage SubscribeUpdateBlockRewards {\n  bytes rewards = 1;\n}\n\nmessage UnixTimestamp {\n  int64 timestamp = 1;\n}\n\nmessage BlockHeight {\n  uint64 block_height = 1;\n}\n\nmessage SubscribeUpdatePing {}\n\nmessage SubscribeUpdatePong {\n  int32 id = 1;\n}\n\nmessage SubscribeUpdateBlockMeta {\n  uint64 slot = 1;\n  string blockhash = 2;\n  SubscribeUpdateBlockRewards rewards = 3;\n  UnixTimestamp block_time = 4;\n  BlockHeight block_height = 5;\n  uint64 parent_slot = 6;\n  string parent_blockhash = 7;\n  uint64 executed_transaction_count = 8;\n  uint64 entries_count = 9;\n}\n\nmessage SubscribeUpdateEntry {\n  uint64 slot = 1;\n  uint64 index = 2;\n  uint64 num_hashes = 3;\n  bytes hash = 4;\n  uint64 executed_transaction_count = 5;\n  optional uint64 starting_transaction_index = 6;\n}\n";
+/**
+ * 获取 Geyser Stream 端点
+ *
+ * @param region 区域
+ * @returns gRPC 端点地址
+ */
+export declare function getGeyserEndpoint(region?: GeyserRegion): string;
+/**
+ * 构建 Geyser 订阅请求
+ *
+ * @param config 订阅配置
+ * @returns gRPC 请求对象
+ */
+export declare function buildGeyserSubscribeRequest(config: GeyserSubscribeConfig): Record<string, unknown>;
+/**
+ * 创建默认账户订阅配置
+ *
+ * @param owners 拥有者地址列表
+ * @param accounts 特定账户地址列表
+ * @returns 订阅配置
+ */
+export declare function createAccountSubscribeConfig(owners?: string[], accounts?: string[]): GeyserSubscribeConfig;
+/**
+ * 创建默认交易订阅配置
+ *
+ * @param accountInclude 包含涉及这些账户的交易
+ * @param accountRequired 交易必须涉及这些账户
+ * @returns 订阅配置
+ */
+export declare function createTransactionSubscribeConfig(accountInclude?: string[], accountRequired?: string[]): GeyserSubscribeConfig;
+/**
+ * 创建默认区块订阅配置
+ *
+ * @param accountInclude 包含涉及这些账户的区块
+ * @param includeTransactions 是否包含交易
+ * @returns 订阅配置
+ */
+export declare function createBlockSubscribeConfig(accountInclude?: string[], includeTransactions?: boolean): GeyserSubscribeConfig;
+/**
+ * 创建 Geyser 订阅（需要 @grpc/grpc-js 和 @grpc/proto-loader）
+ *
+ * 注意：此函数需要安装 gRPC 依赖：
+ * ```bash
+ * npm install @grpc/grpc-js @grpc/proto-loader
+ * ```
+ *
+ * @param clientConfig 客户端配置
+ * @param subscribeConfig 订阅配置
+ * @param handlers 事件处理器
+ * @returns 流控制对象
+ *
+ * @example
+ * ```typescript
+ * import { Sol } from 'four-flap-meme-sdk'
+ * import bs58 from 'bs58'
+ *
+ * const stream = await Sol.createGeyserSubscription(
+ *   {
+ *     host: Sol.getGeyserEndpoint('tokyo'),
+ *     token: 'your-auth-token',
+ *   },
+ *   Sol.createTransactionSubscribeConfig(
+ *     ['your-account-address'], // 监听涉及此账户的交易
+ *   ),
+ *   {
+ *     onTransaction: (update, raw) => {
+ *       console.log(`交易: ${bs58.encode(update.transaction.signature)}`)
+ *     },
+ *     onError: (err) => console.error('错误:', err),
+ *     onEnd: () => console.log('流结束'),
+ *   },
+ * )
+ *
+ * // 关闭流
+ * stream.close()
+ * ```
+ */
+export declare function createGeyserSubscription(clientConfig: GeyserClientConfig, subscribeConfig: GeyserSubscribeConfig, handlers: GeyserEventHandlers): Promise<GeyserStreamControl>;
+/**
+ * 简化版：订阅账户更新
+ *
+ * @param token 认证 Token
+ * @param accounts 账户地址列表
+ * @param onUpdate 更新回调
+ * @param region 区域（默认 tokyo）
+ * @returns 流控制对象
+ */
+export declare function subscribeGeyserAccounts(token: string, accounts: string[], onUpdate: (pubkey: string, lamports: string, slot: string) => void, region?: GeyserRegion): Promise<{
+    close: () => void;
+}>;
+/**
+ * 简化版：订阅交易更新
+ *
+ * @param token 认证 Token
+ * @param accountInclude 包含涉及这些账户的交易
+ * @param onUpdate 更新回调
+ * @param region 区域（默认 tokyo）
+ * @returns 流控制对象
+ */
+export declare function subscribeGeyserTransactions(token: string, accountInclude: string[], onUpdate: (signature: string, isVote: boolean, slot: string) => void, region?: GeyserRegion): Promise<{
+    close: () => void;
+}>;
+/**
+ * 简化版：订阅区块更新
+ *
+ * @param token 认证 Token
+ * @param onUpdate 更新回调
+ * @param region 区域（默认 tokyo）
+ * @returns 流控制对象
+ */
+export declare function subscribeGeyserBlocks(token: string, onUpdate: (slot: string, blockhash: string, txCount: number) => void, region?: GeyserRegion): Promise<{
+    close: () => void;
+}>;