four-flap-meme-sdk 1.5.55 → 1.5.56

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * as Abis from './abis/index.js';
+export * as Sol from './sol/index.js';
 export { ERC20_ABI, ERC20_BALANCE_ABI, ERC20_ALLOWANCE_ABI, MULTICALL3_ABI, V2_ROUTER_ABI, V2_ROUTER_QUOTE_ABI, V3_ROUTER02_ABI, V3_ROUTER_LEGACY_ABI, V3_QUOTER_ABI, V2_FACTORY_ABI, V2_PAIR_ABI, V3_FACTORY_ABI, V3_POOL_ABI, FLAP_PORTAL_ABI, TM2_ABI, HELPER3_ABI, } from './abis/common.js';
 export { ADDRESSES, CHAIN, BLOCKRAZOR_BUILDER_EOA as BUILDER_EOA, ZERO_ADDRESS as COMMON_ZERO_ADDRESS, DEFAULT_DEADLINE_MINUTES, V3_FEE_TIERS as COMMON_V3_FEE_TIERS, } from './utils/constants.js';
 export { isExclusiveOnChain, isExclusiveOffChain } from './utils/mpcExclusive.js';

package/dist/index.js

@@ -2,7 +2,7 @@
 // 公共 ABI（统一管理）
 // ============================================================================
 export * as Abis from './abis/index.js';
-// export * as Sol from './sol/index.js';
+export * as Sol from './sol/index.js';
 export { ERC20_ABI, ERC20_BALANCE_ABI, ERC20_ALLOWANCE_ABI, MULTICALL3_ABI, V2_ROUTER_ABI, V2_ROUTER_QUOTE_ABI, V3_ROUTER02_ABI, V3_ROUTER_LEGACY_ABI, V3_QUOTER_ABI, V2_FACTORY_ABI, V2_PAIR_ABI, V3_FACTORY_ABI, V3_POOL_ABI, FLAP_PORTAL_ABI, TM2_ABI, HELPER3_ABI, } from './abis/common.js';
 // ============================================================================
 // 公共常量（统一管理）

package/dist/sol/constants.d.ts

@@ -0,0 +1,150 @@
+/**
+ * Solana SDK 常量配置
+ * @module sol/constants
+ */
+/**
+ * Nozomi 配置
+ * Temporal Nozomi 交易加速服务
+ */
+export declare const NOZOMI_CONFIG: {
+    /** Tip 账户列表（随机选择一个） */
+    readonly TIP_ACCOUNTS: readonly ["TEMPaMeCRFAS9EKF53Jd6KpHxgL47uWLcpFArU1Fanq", "noz3jAjPiHuBPqiSPkkugaJDkJscPuRhYnSpbi8UvC4", "noz3str9KXfpKknefHji8L1mPgimezaiUyCHYMDv1GE", "noz6uoYCDijhu1V7cutCpwxNiSovEwLdRHPwmgCGDNo", "noz9EPNcT7WH6Sou3sr3GGjHQYVkN3DNirpbvDkv9YJ", "nozc5yT15LazbLTFVZzoNZCwjh3yUtW86LoUyqsBu4L", "nozFrhfnNGoyqwVuwPAW4aaGqempx4PU6g6D9CJMv7Z", "nozievPk7HyK1Rqy1MPJwVQ7qQg2QoJGyP71oeDwbsu", "noznbgwYnBLDHu8wcQVCEw6kDrXkPdKkydGJGNXGvL7", "nozNVWs5N8mgzuD3qigrCG2UoKxZttxzZ85pvAQVrbP", "nozpEGbwx4BcGp6pvEdAh1JoC2CQGZdU6HbNP1v2p6P", "nozrhjhkCr3zXT3BiT4WCodYCUFeQvcdUkM7MqhKqge", "nozrwQtWhEdrA6W8dkbt9gnUaMs52PdAv5byipnadq3", "nozUacTVWub3cL4mJmGCYjKZTnE9RbdY5AP46iQgbPJ", "nozWCyTPppJjRuw2fpzDhhWbW355fzosWSzrrMYB1Qk", "nozWNju6dY353eMkMqURqwQEoM3SFgEKC6psLCSfUne", "nozxNBgWohjR75vdspfxR5H9ceC7XXH99xpxhVGt3Bb"];
+    /** 最小 Tip（lamports）- 0.001 SOL */
+    readonly MIN_TIP_LAMPORTS: 1000000;
+    /** 默认 Tip（lamports）- 0.001 SOL */
+    readonly DEFAULT_TIP_LAMPORTS: 1000000;
+    /** 建议的 Priority Fee（microlamports） */
+    readonly RECOMMENDED_PRIORITY_FEE: 1000000;
+    /** 区域端点 */
+    readonly REGIONS: {
+        readonly auto: "nozomi.temporal.xyz";
+        readonly pit: "pit1.nozomi.temporal.xyz";
+        readonly tyo: "tyo1.nozomi.temporal.xyz";
+        readonly sgp: "sgp1.nozomi.temporal.xyz";
+        readonly ewr: "ewr1.nozomi.temporal.xyz";
+        readonly ams: "ams1.nozomi.temporal.xyz";
+        readonly fra: "fra2.nozomi.temporal.xyz";
+    };
+};
+/**
+ * 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,188 @@
+/**
+ * Solana SDK 常量配置
+ * @module sol/constants
+ */
+// ==================== Nozomi 配置 ====================
+/**
+ * Nozomi 配置
+ * Temporal Nozomi 交易加速服务
+ */
+export const NOZOMI_CONFIG = {
+    /** Tip 账户列表（随机选择一个） */
+    TIP_ACCOUNTS: [
+        'TEMPaMeCRFAS9EKF53Jd6KpHxgL47uWLcpFArU1Fanq',
+        'noz3jAjPiHuBPqiSPkkugaJDkJscPuRhYnSpbi8UvC4',
+        'noz3str9KXfpKknefHji8L1mPgimezaiUyCHYMDv1GE',
+        'noz6uoYCDijhu1V7cutCpwxNiSovEwLdRHPwmgCGDNo',
+        'noz9EPNcT7WH6Sou3sr3GGjHQYVkN3DNirpbvDkv9YJ',
+        'nozc5yT15LazbLTFVZzoNZCwjh3yUtW86LoUyqsBu4L',
+        'nozFrhfnNGoyqwVuwPAW4aaGqempx4PU6g6D9CJMv7Z',
+        'nozievPk7HyK1Rqy1MPJwVQ7qQg2QoJGyP71oeDwbsu',
+        'noznbgwYnBLDHu8wcQVCEw6kDrXkPdKkydGJGNXGvL7',
+        'nozNVWs5N8mgzuD3qigrCG2UoKxZttxzZ85pvAQVrbP',
+        'nozpEGbwx4BcGp6pvEdAh1JoC2CQGZdU6HbNP1v2p6P',
+        'nozrhjhkCr3zXT3BiT4WCodYCUFeQvcdUkM7MqhKqge',
+        'nozrwQtWhEdrA6W8dkbt9gnUaMs52PdAv5byipnadq3',
+        'nozUacTVWub3cL4mJmGCYjKZTnE9RbdY5AP46iQgbPJ',
+        'nozWCyTPppJjRuw2fpzDhhWbW355fzosWSzrrMYB1Qk',
+        'nozWNju6dY353eMkMqURqwQEoM3SFgEKC6psLCSfUne',
+        'nozxNBgWohjR75vdspfxR5H9ceC7XXH99xpxhVGt3Bb',
+    ],
+    /** 最小 Tip（lamports）- 0.001 SOL */
+    MIN_TIP_LAMPORTS: 1000000,
+    /** 默认 Tip（lamports）- 0.001 SOL */
+    DEFAULT_TIP_LAMPORTS: 1000000,
+    /** 建议的 Priority Fee（microlamports） */
+    RECOMMENDED_PRIORITY_FEE: 1000000,
+    /** 区域端点 */
+    REGIONS: {
+        auto: 'nozomi.temporal.xyz',
+        pit: 'pit1.nozomi.temporal.xyz',
+        tyo: 'tyo1.nozomi.temporal.xyz',
+        sgp: 'sgp1.nozomi.temporal.xyz',
+        ewr: 'ewr1.nozomi.temporal.xyz',
+        ams: 'ams1.nozomi.temporal.xyz',
+        fra: 'fra2.nozomi.temporal.xyz',
+    },
+};
+// ==================== 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',
+};