four-flap-meme-sdk 1.4.90 → 1.4.92

package/dist/flap/portal-bundle-merkle/create-to-dex.d.ts

@@ -9,7 +9,7 @@
  */
 import { type FlapSignConfig } from './config.js';
 import type { MerkleSignedResult } from './types.js';
-export type CreateToDexChain = 'bsc';
+export type CreateToDexChain = 'bsc' | 'xlayer';
 export type DexPoolType = 'v2' | 'v3';
 /** 签名配置 */
 export interface CreateToDexSignConfig extends FlapSignConfig {

package/dist/flap/portal-bundle-merkle/create-to-dex.js

@@ -26,9 +26,39 @@ const ERC20_ABI = [
     }
 ];
 // ==================== 链常量 ====================
+// BSC
 const BSC_PANCAKE_V2_ROUTER = ADDRESSES.BSC.PancakeV2Router;
 const BSC_PANCAKE_V3_ROUTER = ADDRESSES.BSC.PancakeV3Router;
 const BSC_WBNB = ADDRESSES.BSC.WBNB;
+// XLAYER
+const XLAYER_POTATOSWAP_V2_ROUTER = '0x881fb2f98c13d521009464e7d1cbf16e1b394e8e';
+const XLAYER_POTATOSWAP_V3_ROUTER = '0xB45D0149249488333E3F3f9F359807F4b810C1FC';
+const XLAYER_WOKB = '0xe538905cf8410324e03a5a23c1c177a474d59b2b';
+// 链 ID 映射
+const CHAIN_ID_MAP = {
+    bsc: 56,
+    xlayer: 196,
+};
+// 获取链配置
+function getChainConfig(chain) {
+    if (chain === 'xlayer') {
+        return {
+            chainId: 196,
+            v2Router: XLAYER_POTATOSWAP_V2_ROUTER,
+            v3Router: XLAYER_POTATOSWAP_V3_ROUTER,
+            wrappedNative: XLAYER_WOKB,
+            nativeSymbol: 'OKB',
+        };
+    }
+    // 默认 BSC
+    return {
+        chainId: 56,
+        v2Router: BSC_PANCAKE_V2_ROUTER,
+        v3Router: BSC_PANCAKE_V3_ROUTER,
+        wrappedNative: BSC_WBNB,
+        nativeSymbol: 'BNB',
+    };
+}
 // PancakeSwap Router ABI
 const PANCAKE_V3_ROUTER_ABI = [
     {
@@ -78,7 +108,8 @@ const USD1_V3_FEE = 100;
 const DEFAULT_V3_FEE = 2500;
 // ==================== 工具函数 ====================
 /** 构建 ERC20 approve 交易 */
-async function buildApproveTransaction(wallet, tokenAddress, spenderAddress, amount, nonce, gasPrice, txType) {
+async function buildApproveTransaction(wallet, tokenAddress, spenderAddress, amount, nonce, gasPrice, txType, chainId = 56 // ✅ 添加 chainId 参数
+) {
     const erc20Interface = new ethers.Interface(ERC20_ABI);
     const data = erc20Interface.encodeFunctionData('approve', [spenderAddress, amount]);
     const tx = {
@@ -87,7 +118,7 @@ async function buildApproveTransaction(wallet, tokenAddress, spenderAddress, amo
         from: wallet.address,
         nonce,
         gasLimit: BigInt(100000), // approve 交易 gas 较低
-        chainId: 56,
+        chainId,
         type: txType
     };
     if (txType === 2) {
@@ -154,9 +185,12 @@ export async function flapBundleCreateToDex(params) {
     // 判断是否使用原生代币
     const useNativeToken = !quoteToken || quoteToken === ZERO_ADDRESS;
     const inputToken = useNativeToken ? ZERO_ADDRESS : quoteToken;
+    // ✅ 获取链配置
+    const chainConfig = getChainConfig(chain);
+    const chainId = chainConfig.chainId;
     // 创建 Provider
     const provider = new ethers.JsonRpcProvider(config.rpcUrl, {
-        chainId: chain === 'bsc' ? 56 : 56,
+        chainId,
         name: chain.toUpperCase()
     });
     const portalAddress = FLAP_PORTAL_ADDRESSES[chain.toUpperCase()];
@@ -228,7 +262,7 @@ export async function flapBundleCreateToDex(params) {
             nonce: bribeNonce,
             gasPrice,
             gasLimit: 21000n,
-            chainId: 56,
+            chainId,
             type: txType
         });
         allTransactions.push(bribeTx);
@@ -305,7 +339,7 @@ export async function flapBundleCreateToDex(params) {
             from: devWallet.address,
             nonce: devNonce,
             gasLimit: finalGasLimit,
-            chainId: 56,
+            chainId,
             type: txType
         };
         if (txType === 2) {
@@ -328,7 +362,8 @@ export async function flapBundleCreateToDex(params) {
         if (!useNativeToken) {
             const approveNonce = noncesMap.get(addr);
             noncesMap.set(addr, approveNonce + 1);
-            const approveTx = await buildApproveTransaction(wallet, quoteToken, portalAddress, curveBuyAmounts[i], approveNonce, gasPrice, txType);
+            const approveTx = await buildApproveTransaction(wallet, quoteToken, portalAddress, curveBuyAmounts[i], approveNonce, gasPrice, txType, chainId // ✅ 传递 chainId
+            );
             signedTxs.push(approveTx);
         }
         // 构建买入交易
@@ -350,7 +385,7 @@ export async function flapBundleCreateToDex(params) {
             from: wallet.address,
             nonce: buyNonce,
             gasLimit: buyGasLimit,
-            chainId: 56,
+            chainId,
             type: txType,
             value: useNativeToken ? curveBuyAmounts[i] : 0n
         };
@@ -375,14 +410,17 @@ export async function flapBundleCreateToDex(params) {
             const addr = wallet.address.toLowerCase();
             const signedTxs = [];
             const buyAmount = dexBuyAmounts[i];
-            const smartRouter = dexPoolType === 'v3' ? BSC_PANCAKE_V3_ROUTER : BSC_PANCAKE_V2_ROUTER;
+            // ✅ 使用动态 Router 地址
+            const smartRouter = dexPoolType === 'v3' ? chainConfig.v3Router : chainConfig.v2Router;
+            const wrappedNative = chainConfig.wrappedNative;
             // ✅ 根据 quoteToken 选择 V3 费率
             const actualV3Fee = v3Fee || (useNativeToken ? DEFAULT_V3_FEE : USD1_V3_FEE);
             // ✅ ERC20: 先构建 approve 交易
             if (!useNativeToken) {
                 const approveNonce = noncesMap.get(addr);
                 noncesMap.set(addr, approveNonce + 1);
-                const approveTx = await buildApproveTransaction(wallet, quoteToken, smartRouter, buyAmount, approveNonce, gasPrice, txType);
+                const approveTx = await buildApproveTransaction(wallet, quoteToken, smartRouter, buyAmount, approveNonce, gasPrice, txType, chainId // ✅ 传递 chainId
+                );
                 signedTxs.push(approveTx);
             }
             // 构建买入交易
@@ -394,7 +432,7 @@ export async function flapBundleCreateToDex(params) {
             if (dexPoolType === 'v3') {
                 // V3: exactInputSingle
                 const params = {
-                    tokenIn: useNativeToken ? BSC_WBNB : quoteToken,
+                    tokenIn: useNativeToken ? wrappedNative : quoteToken,
                     tokenOut: tokenAddress,
                     fee: actualV3Fee,
                     recipient: wallet.address,
@@ -407,7 +445,7 @@ export async function flapBundleCreateToDex(params) {
             }
             else {
                 // V2: swapExactTokensForTokens
-                const path = useNativeToken ? [BSC_WBNB, tokenAddress] : [quoteToken, tokenAddress];
+                const path = useNativeToken ? [wrappedNative, tokenAddress] : [quoteToken, tokenAddress];
                 const swapData = routerInterface.encodeFunctionData('swapExactTokensForTokens', [buyAmount, 0n, path, wallet.address]);
                 multicallData = [swapData];
                 value = useNativeToken ? buyAmount : 0n;
@@ -419,7 +457,7 @@ export async function flapBundleCreateToDex(params) {
                 from: wallet.address,
                 nonce: buyNonce,
                 gasLimit: BigInt(500000),
-                chainId: 56,
+                chainId,
                 type: txType,
                 value
             };
@@ -450,7 +488,7 @@ export async function flapBundleCreateToDex(params) {
             profitRecipient: getProfitRecipient(),
             hopCount: PROFIT_HOP_COUNT,
             gasPrice,
-            chainId: 56,
+            chainId,
             txType,
             startNonce: profitNonce
         });

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';
@@ -52,3 +53,5 @@ export { quoteV2, quoteV3, quote, getTokenToNativeQuote, getNativeToTokenQuote,
 export { submitDirectToRpc, submitDirectToRpcSequential, // ✅ 新增：顺序广播并等待确认（用于多跳）
 submitDirectToRpcParallel, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult } from './contracts/tm-bundle-merkle/submit.js';
 export { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSell, getRouterAddress, DIRECT_ROUTERS, type DirectV2BuyParams, type DirectV2SellParams, type DirectV3BuyParams, type DirectV3SellParams, type DirectRouterResult, type DirectRouterSignConfig, type DexKey, type RouterVersion, } from './dex/index.js';
+export * as XLayer from './xlayer/index.js';
+export { bundleBuy as xlayerBundleBuy, bundleSell as xlayerBundleSell, bundleBuySell as xlayerBundleBuySell, createBundleExecutor as xlayerCreateBundleExecutor, BundleExecutor as XLayerBundleExecutor, makeVolume as xlayerMakeVolume, singleRoundVolume as xlayerSingleRoundVolume, createVolumeExecutor as xlayerCreateVolumeExecutor, VolumeExecutor as XLayerVolumeExecutor, createDexExecutor as xlayerCreateDexExecutor, createDexQuery as xlayerCreateDexQuery, quoteOkbToToken as xlayerQuoteOkbToToken, quoteTokenToOkb as xlayerQuoteTokenToOkb, DexExecutor as XLayerDexExecutor, DexQuery as XLayerDexQuery, createAAAccountManager as xlayerCreateAAAccountManager, predictSender as xlayerPredictSender, createWallet as xlayerCreateWallet, AAAccountManager as XLayerAAAccountManager, generateAAWallets as xlayerGenerateAAWallets, generateAAWalletsFromMnemonic as xlayerGenerateAAWalletsFromMnemonic, predictSendersFromPrivateKeys as xlayerPredictSendersFromPrivateKeys, createBundlerClient as xlayerCreateBundlerClient, BundlerClient as XLayerBundlerClient, createPortalQuery as xlayerCreatePortalQuery, PortalQuery as XLayerPortalQuery, encodeBuyCall as xlayerEncodeBuyCall, encodeSellCall as xlayerEncodeSellCall, encodeApproveCall as xlayerEncodeApproveCall, parseOkb as xlayerParseOkb, formatOkb as xlayerFormatOkb, XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, type XLayerConfig, type BundleBuyParams as XLayerBundleBuyParams, type BundleSellParams as XLayerBundleSellParams, type BundleBuySellParams as XLayerBundleBuySellParams, type VolumeParams as XLayerVolumeParams, type BundleBuyResult as XLayerBundleBuyResult, type BundleSellResult as XLayerBundleSellResult, type BundleBuySellResult as XLayerBundleBuySellResult, type VolumeResult as XLayerVolumeResult, type HandleOpsResult as XLayerHandleOpsResult, type AAAccount as XLayerAAAccount, type UserOperation as XLayerUserOperation, type GeneratedAAWallet as XLayerGeneratedAAWallet, type GenerateAAWalletsParams as XLayerGenerateAAWalletsParams, type GenerateAAWalletsResult as XLayerGenerateAAWalletsResult, } from './xlayer/index.js';

package/dist/index.js

@@ -2,6 +2,7 @@
 // 公共 ABI（统一管理）
 // ============================================================================
 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';
 // ============================================================================
 // 公共常量（统一管理）
@@ -95,3 +96,26 @@ directV3BatchBuy, directV3BatchSell,
 getRouterAddress, 
 // 常量
 DIRECT_ROUTERS, } from './dex/index.js';
+// ============================================================
+// ✅ XLayer SDK（ERC-4337 AA 钱包模式）
+// ============================================================
+export * as XLayer from './xlayer/index.js';
+export { 
+// 捆绑交易
+bundleBuy as xlayerBundleBuy, bundleSell as xlayerBundleSell, bundleBuySell as xlayerBundleBuySell, createBundleExecutor as xlayerCreateBundleExecutor, BundleExecutor as XLayerBundleExecutor, 
+// 刷量
+makeVolume as xlayerMakeVolume, singleRoundVolume as xlayerSingleRoundVolume, createVolumeExecutor as xlayerCreateVolumeExecutor, VolumeExecutor as XLayerVolumeExecutor, 
+// DEX 交易
+createDexExecutor as xlayerCreateDexExecutor, createDexQuery as xlayerCreateDexQuery, quoteOkbToToken as xlayerQuoteOkbToToken, quoteTokenToOkb as xlayerQuoteTokenToOkb, DexExecutor as XLayerDexExecutor, DexQuery as XLayerDexQuery, 
+// AA 账户管理
+createAAAccountManager as xlayerCreateAAAccountManager, predictSender as xlayerPredictSender, createWallet as xlayerCreateWallet, AAAccountManager as XLayerAAAccountManager, 
+// 批量生成钱包工具
+generateAAWallets as xlayerGenerateAAWallets, generateAAWalletsFromMnemonic as xlayerGenerateAAWalletsFromMnemonic, predictSendersFromPrivateKeys as xlayerPredictSendersFromPrivateKeys, 
+// Bundler 客户端
+createBundlerClient as xlayerCreateBundlerClient, BundlerClient as XLayerBundlerClient, 
+// Portal 操作
+createPortalQuery as xlayerCreatePortalQuery, PortalQuery as XLayerPortalQuery, encodeBuyCall as xlayerEncodeBuyCall, encodeSellCall as xlayerEncodeSellCall, encodeApproveCall as xlayerEncodeApproveCall, 
+// 工具函数
+parseOkb as xlayerParseOkb, formatOkb as xlayerFormatOkb, 
+// 常量
+XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, } from './xlayer/index.js';

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";
+};