four-flap-meme-sdk 2.2.2 → 2.2.3

package/dist/utils/erc20.js

@@ -1,7 +1,8 @@
 import { Contract, Wallet, JsonRpcProvider, Interface, parseUnits } from 'ethers';
-import { ADDRESSES, ZERO_ADDRESS, getMulticall3Address } from './constants.js';
+import { ADDRESSES, ZERO_ADDRESS, getMulticall3Address } from '../shared/constants/index.js';
 import { NonceManager } from './bundle-helpers.js';
-import { ERC20_ABI, MULTICALL3_ABI } from '../shared/abis/common.js';
+import { ERC20_ABI, MULTICALL3_ABI } from '../abis/common.js';
+import { getErrorMessageFromUnknown } from '../shared/foundation/index.js';
 // ============================================================================
 // ✅ Max approval（与 BSC 策略一致：阈值判断，避免频繁重复授权）
 // ============================================================================
@@ -22,14 +23,15 @@ async function validateContractAddress(provider, address, label) {
         }
     }
     catch (error) {
-        if (error.message.includes('无效或未部署')) {
-            throw error;
+        const msg = getErrorMessageFromUnknown(error);
+        if (msg.includes('无效或未部署')) {
+            throw error instanceof Error ? error : new Error(msg);
         }
-        // ✅ 如果是 checksum 错误，提供更友好的提示
-        if (error.message.includes('bad address checksum') || error.code === 'INVALID_ARGUMENT') {
+        const code = error !== null && typeof error === 'object' && 'code' in error ? error.code : undefined;
+        if (msg.includes('bad address checksum') || code === 'INVALID_ARGUMENT') {
             throw new Error(`❌ ${label} 地址格式错误，请使用正确的 checksum 格式: ${address}`);
         }
-        throw new Error(`❌ 无法验证 ${label} 地址 ${address}: ${error.message}`);
+        throw new Error(`❌ 无法验证 ${label} 地址 ${address}: ${msg}`);
     }
 }
 /**
@@ -49,7 +51,7 @@ async function ensureAllowance(rpcUrl, privateKey, token, owner, spender, requir
         current = await erc20.allowance(owner, spender);
     }
     catch (error) {
-        throw new Error(`❌ 调用 allowance 失败（Token 可能不是 ERC20）: ${error.message}`);
+        throw new Error(`❌ 调用 allowance 失败（Token 可能不是 ERC20）: ${getErrorMessageFromUnknown(error)}`);
     }
     if (current >= required) {
         return {
@@ -67,27 +69,17 @@ async function ensureAllowance(rpcUrl, privateKey, token, owner, spender, requir
         txReceipt: receipt,
     };
 }
-/**
- * 检查代币授权状态 - Four.meme V1（只读，不发送交易）
- * @returns 是否已授权足够的额度
- */
-export async function checkSellApprovalV1(chain, rpcUrl, token, owner, amount) {
-    const proxyAddresses = {
-        BSC: ADDRESSES.BSC.TokenManagerV1, // FourMeme 代理合约 V1 (BSC)
-        BASE: ADDRESSES.BASE.TokenManagerHelper3, // FourMeme 代理合约 (BASE)
-        ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3, // FourMeme 代理合约 (ARBITRUM)
-    };
+async function checkAllowanceForSpender(rpcUrl, token, owner, amount, spender, spenderLabel) {
     const provider = new JsonRpcProvider(rpcUrl);
-    // ✅ 验证 token 和代理合约地址
     await validateContractAddress(provider, token, 'Token');
-    await validateContractAddress(provider, proxyAddresses[chain], `Four.meme V1 Proxy (${chain})`);
+    await validateContractAddress(provider, spender, spenderLabel);
     const erc20 = new Contract(token, ERC20_ABI, provider);
     let current;
     try {
-        current = await erc20.allowance(owner, proxyAddresses[chain]);
+        current = await erc20.allowance(owner, spender);
     }
     catch (error) {
-        throw new Error(`❌ 调用 allowance 失败（Token 可能不是 ERC20）: ${error.message}`);
+        throw new Error(`❌ 调用 allowance 失败（Token 可能不是 ERC20）: ${getErrorMessageFromUnknown(error)}`);
     }
     return {
         isApproved: current >= amount,
@@ -95,61 +87,42 @@ export async function checkSellApprovalV1(chain, rpcUrl, token, owner, amount) {
         requiredAllowance: amount,
     };
 }
+async function checkSellApprovalForProxy(_chain, rpcUrl, token, owner, amount, proxyAddress, proxyLabel) {
+    return checkAllowanceForSpender(rpcUrl, token, owner, amount, proxyAddress, proxyLabel);
+}
+const FOUR_MEME_V1_PROXY = {
+    BSC: ADDRESSES.BSC.TokenManagerV1,
+    BASE: ADDRESSES.BASE.TokenManagerHelper3,
+    ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3,
+};
+const FOUR_MEME_V2_PROXY = {
+    BSC: ADDRESSES.BSC.TokenManagerV2,
+    BASE: ADDRESSES.BASE.TokenManagerHelper3,
+    ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3,
+};
+/**
+ * 检查代币授权状态 - Four.meme V1（只读，不发送交易）
+ */
+export async function checkSellApprovalV1(chain, rpcUrl, token, owner, amount) {
+    return checkSellApprovalForProxy(chain, rpcUrl, token, owner, amount, FOUR_MEME_V1_PROXY[chain], `Four.meme V1 Proxy (${chain})`);
+}
 /**
  * 确保代币已授权给 Four.meme V1 代理合约
- * 用于 Four.meme V1 代币的卖出操作
- * @returns 授权结果，包含是否已授权、当前额度、交易回执等信息
  */
 export async function ensureSellApprovalV1(chain, rpcUrl, privateKey, token, owner, amount) {
-    // ✅ 授权给 FourMeme 代理合约 V1（收费版）
-    const proxyAddresses = {
-        BSC: ADDRESSES.BSC.TokenManagerV1, // FourMeme 代理合约 V1 (BSC)
-        BASE: ADDRESSES.BASE.TokenManagerHelper3, // FourMeme 代理合约 (BASE)
-        ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3, // FourMeme 代理合约 (ARBITRUM)
-    };
-    return await ensureAllowance(rpcUrl, privateKey, token, owner, proxyAddresses[chain], amount);
+    return ensureAllowance(rpcUrl, privateKey, token, owner, FOUR_MEME_V1_PROXY[chain], amount);
 }
 /**
  * 检查代币授权状态 - Four.meme V2（只读，不发送交易）
- * @returns 是否已授权足够的额度
  */
 export async function checkSellApprovalV2(chain, rpcUrl, token, owner, amount) {
-    const proxyAddresses = {
-        BSC: ADDRESSES.BSC.TokenManagerV2, // FourMeme 代理合约 V2 (BSC)
-        BASE: ADDRESSES.BASE.TokenManagerHelper3, // FourMeme 代理合约 (BASE)
-        ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3, // FourMeme 代理合约 (ARBITRUM)
-    };
-    const provider = new JsonRpcProvider(rpcUrl);
-    // ✅ 验证 token 和代理合约地址
-    await validateContractAddress(provider, token, 'Token');
-    await validateContractAddress(provider, proxyAddresses[chain], `Four.meme V2 Proxy (${chain})`);
-    const erc20 = new Contract(token, ERC20_ABI, provider);
-    let current;
-    try {
-        current = await erc20.allowance(owner, proxyAddresses[chain]);
-    }
-    catch (error) {
-        throw new Error(`❌ 调用 allowance 失败（Token 可能不是 ERC20）: ${error.message}`);
-    }
-    return {
-        isApproved: current >= amount,
-        currentAllowance: current,
-        requiredAllowance: amount,
-    };
+    return checkSellApprovalForProxy(chain, rpcUrl, token, owner, amount, FOUR_MEME_V2_PROXY[chain], `Four.meme V2 Proxy (${chain})`);
 }
 /**
  * 确保代币已授权给 Four.meme V2 代理合约
- * 用于 Four.meme V2 代币的卖出操作
- * @returns 授权结果，包含是否已授权、当前额度、交易回执等信息
  */
 export async function ensureSellApprovalV2(chain, rpcUrl, privateKey, token, owner, amount) {
-    // ✅ 授权给 FourMeme 代理合约 V2（收费版）
-    const proxyAddresses = {
-        BSC: ADDRESSES.BSC.TokenManagerV2, // FourMeme 代理合约 V2 (BSC)
-        BASE: ADDRESSES.BASE.TokenManagerHelper3, // FourMeme 代理合约 (BASE)
-        ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3, // FourMeme 代理合约 (ARBITRUM)
-    };
-    return await ensureAllowance(rpcUrl, privateKey, token, owner, proxyAddresses[chain], amount);
+    return ensureAllowance(rpcUrl, privateKey, token, owner, FOUR_MEME_V2_PROXY[chain], amount);
 }
 /**
  * 检查代币授权状态 - Four.meme（通用，默认使用 V2）
@@ -171,29 +144,13 @@ export async function ensureSellApproval(chain, rpcUrl, privateKey, token, owner
  */
 export async function checkFlapSellApproval(chain, rpcUrl, token, owner, amount) {
     const proxyAddresses = {
-        BSC: ADDRESSES.BSC.FlapPortal, // Flap Portal 代理合约 (BSC)
-        BASE: ADDRESSES.BASE.FlapPortal, // Flap Portal 代理合约 (BASE)
-        XLAYER: ADDRESSES.XLAYER.FlapPortal, // Flap Portal 代理合约 (XLAYER)
-        MORPH: ADDRESSES.MORPH.FlapPortal, // Flap Portal 代理合约 (MORPH)
-        MONAD: ADDRESSES.MONAD.FlapPortal, // Flap Portal 代理合约 (MONAD)
-    };
-    const provider = new JsonRpcProvider(rpcUrl);
-    // ✅ 验证 token 和代理合约地址
-    await validateContractAddress(provider, token, 'Token');
-    await validateContractAddress(provider, proxyAddresses[chain], `Flap Portal (${chain})`);
-    const erc20 = new Contract(token, ERC20_ABI, provider);
-    let current;
-    try {
-        current = await erc20.allowance(owner, proxyAddresses[chain]);
-    }
-    catch (error) {
-        throw new Error(`❌ 调用 allowance 失败（Token 可能不是 ERC20）: ${error.message}`);
-    }
-    return {
-        isApproved: current >= amount,
-        currentAllowance: current,
-        requiredAllowance: amount,
+        BSC: ADDRESSES.BSC.FlapPortal,
+        BASE: ADDRESSES.BASE.FlapPortal,
+        XLAYER: ADDRESSES.XLAYER.FlapPortal,
+        MORPH: ADDRESSES.MORPH.FlapPortal,
+        MONAD: ADDRESSES.MONAD.FlapPortal,
     };
+    return checkAllowanceForSpender(rpcUrl, token, owner, amount, proxyAddresses[chain], `Flap Portal (${chain})`);
 }
 /**
  * 确保代币已授权给 Flap Protocol 代理合约
@@ -245,7 +202,7 @@ export async function checkFlapSellApprovalBatch(chain, rpcUrl, token, owners, r
     // ✅ 并行验证 token 和代理合约地址
     await Promise.all([
         validateContractAddress(provider, token, 'Token'),
-        validateContractAddress(provider, proxyAddresses[chain], `Flap Portal (${chain})`)
+        validateContractAddress(provider, proxyAddresses[chain], `Flap Portal (${chain})`),
     ]);
     // ✅ 使用 batchCheckAllowances 批量查询（Multicall3）
     const allowances = await batchCheckAllowances(provider, token, owners, proxyAddresses[chain]);
@@ -253,7 +210,7 @@ export async function checkFlapSellApprovalBatch(chain, rpcUrl, token, owners, r
         owner,
         isApproved: allowances[i] >= required,
         currentAllowance: allowances[i],
-        requiredAllowance: required
+        requiredAllowance: required,
     }));
 }
 /**
@@ -270,15 +227,15 @@ export async function batchCheckAllowances(provider, tokenAddress, owners, spend
     const multicall3 = new Contract(multicall3Address, MULTICALL3_ABI, provider);
     // 编码 allowance(owner, spender) 调用数据
     const erc20Interface = new Contract(tokenAddress, ERC20_ABI, provider).interface;
-    const calls = owners.map(owner => ({
+    const calls = owners.map((owner) => ({
         target: tokenAddress,
         allowFailure: true,
-        callData: erc20Interface.encodeFunctionData('allowance', [owner, spender])
+        callData: erc20Interface.encodeFunctionData('allowance', [owner, spender]),
     }));
     // 批量调用
     const results = await multicall3.aggregate3(calls);
     // 解析结果
-    return results.map((result, index) => {
+    return results.map((result) => {
         if (!result.success) {
             return 0n;
         }
@@ -286,7 +243,7 @@ export async function batchCheckAllowances(provider, tokenAddress, owners, spend
             const decoded = erc20Interface.decodeFunctionResult('allowance', result.returnData);
             return decoded[0];
         }
-        catch (error) {
+        catch {
             return 0n;
         }
     });
@@ -390,7 +347,7 @@ export async function checkAllowanceRaw(rpcUrl, tokenAddress, ownerAddress, spen
         return allowance;
     }
     catch (error) {
-        throw new Error(`❌ 查询授权额度失败: ${error.message}`);
+        throw new Error(`❌ 查询授权额度失败: ${getErrorMessageFromUnknown(error)}`);
     }
 }
 /**
@@ -438,15 +395,15 @@ export async function approveTokenRaw(rpcUrl, privateKey, tokenAddress, spenderA
         currentAllowance = await erc20.allowance(ownerAddress, normalizedSpender);
     }
     catch (error) {
-        throw new Error(`❌ 查询授权额度失败: ${error.message}`);
+        throw new Error(`❌ 查询授权额度失败: ${getErrorMessageFromUnknown(error)}`);
     }
     // 如果已经授权足够，直接返回
     // ✅ max 授权：使用阈值判断，避免每次消耗一点 allowance 都重新授权
-    if (isMax ? (currentAllowance >= MAX_APPROVAL_THRESHOLD) : (currentAllowance >= requiredAmount)) {
+    if (isMax ? currentAllowance >= MAX_APPROVAL_THRESHOLD : currentAllowance >= requiredAmount) {
         return {
             alreadyApproved: true,
             currentAllowance,
-            requiredAllowance: requiredAmount
+            requiredAllowance: requiredAmount,
         };
     }
     // 发送授权交易
@@ -457,11 +414,11 @@ export async function approveTokenRaw(rpcUrl, privateKey, tokenAddress, spenderA
             alreadyApproved: false,
             currentAllowance,
             requiredAllowance: requiredAmount,
-            txReceipt: receipt
+            txReceipt: receipt,
         };
     }
     catch (error) {
-        throw new Error(`❌ 授权交易失败: ${error.message}`);
+        throw new Error(`❌ 授权交易失败: ${getErrorMessageFromUnknown(error)}`);
     }
 }
 /**
@@ -492,7 +449,7 @@ export async function checkAllowanceBatchRaw(rpcUrl, tokenAddress, ownerAddresse
     const provider = new JsonRpcProvider(rpcUrl);
     // ✅ 规范化地址（转为小写，避免 checksum 错误）
     const normalizedToken = tokenAddress.toLowerCase();
-    const normalizedOwners = ownerAddresses.map(addr => addr.toLowerCase());
+    const normalizedOwners = ownerAddresses.map((addr) => addr.toLowerCase());
     const normalizedSpender = spenderAddress.toLowerCase();
     // 验证地址
     await validateContractAddress(provider, normalizedToken, 'Token');
@@ -500,12 +457,26 @@ export async function checkAllowanceBatchRaw(rpcUrl, tokenAddress, ownerAddresse
     return batchCheckAllowances(provider, normalizedToken, normalizedOwners, normalizedSpender);
 }
 export async function approveTokenBatch(params) {
-    const { chain, platform, rpcUrl, privateKeys, tokenAddress, amounts, signOnly, gasPriceGwei, gasLimit, chainId, skipValidation } = params;
+    const { chain, platform, rpcUrl, privateKeys, tokenAddress, amounts, signOnly, gasPriceGwei, gasLimit, chainId, skipValidation, } = params;
     const spenderAddress = resolveSpenderAddress(chain, platform);
-    return approveTokenBatchRaw({ rpcUrl, privateKeys, tokenAddress, spenderAddress, amounts, signOnly, gasPriceGwei, gasLimit, chainId, skipValidation });
+    const rawParams = {
+        rpcUrl,
+        privateKeys,
+        tokenAddress,
+        spenderAddress,
+        amounts,
+        gasPriceGwei,
+        gasLimit,
+        chainId,
+        skipValidation,
+    };
+    if (signOnly === true) {
+        return approveTokenBatchRaw({ ...rawParams, signOnly: true });
+    }
+    return approveTokenBatchRaw({ ...rawParams, signOnly: false });
 }
 export async function approveTokenBatchRaw(params) {
-    const { rpcUrl, privateKeys, tokenAddress, spenderAddress, amounts, signOnly, gasPriceGwei, gasLimit, chainId = 56, nonceManager: externalNonceManager, skipValidation } = params;
+    const { rpcUrl, privateKeys, tokenAddress, spenderAddress, amounts, signOnly, gasPriceGwei, gasLimit, chainId = 56, nonceManager: externalNonceManager, skipValidation, } = params;
     if (privateKeys.length === 0 || amounts.length !== privateKeys.length) {
         throw new Error('❌ 私钥数量和授权数量必须匹配');
     }
@@ -519,12 +490,10 @@ export async function approveTokenBatchRaw(params) {
         await validateContractAddress(provider, normalizedSpender, 'Spender');
     }
     // ✅ 优化：批量创建钱包和合约实例
-    const wallets = privateKeys.map(key => new Wallet(key, provider));
-    const ownerAddresses = wallets.map(w => w.address);
-    const isMaxApprovals = amounts.map(a => a === 'max');
-    const requiredAmounts = amounts.map(amount => amount === 'max'
-        ? MAX_UINT256
-        : amount);
+    const wallets = privateKeys.map((key) => new Wallet(key, provider));
+    const ownerAddresses = wallets.map((w) => w.address);
+    const isMaxApprovals = amounts.map((a) => a === 'max');
+    const requiredAmounts = amounts.map((amount) => (amount === 'max' ? MAX_UINT256 : amount));
     // ==================== signOnly=true：只签名不提交 ====================
     if (signOnly) {
         // ✅ 使用 NonceManager 管理 nonce（和买卖交易一样）
@@ -533,7 +502,9 @@ export async function approveTokenBatchRaw(params) {
         const [currentAllowances, nonces, fetchedGasPrice] = await Promise.all([
             batchCheckAllowances(provider, normalizedToken, ownerAddresses, normalizedSpender),
             nonceManager.getNextNoncesForWallets(wallets), // ✅ 使用 NonceManager 批量获取 nonce
-            gasPriceGwei ? Promise.resolve(parseUnits(gasPriceGwei.toString(), 'gwei')) : provider.getFeeData().then(fee => fee.gasPrice || parseUnits('3', 'gwei'))
+            gasPriceGwei
+                ? Promise.resolve(parseUnits(gasPriceGwei.toString(), 'gwei'))
+                : provider.getFeeData().then((fee) => fee.gasPrice || parseUnits('3', 'gwei')),
         ]);
         const finalGasPrice = fetchedGasPrice;
         const finalGasLimit = BigInt(gasLimit || 100000);
@@ -547,13 +518,13 @@ export async function approveTokenBatchRaw(params) {
             const isMax = isMaxApprovals[i];
             // 如果已经授权足够，跳过
             // ✅ max 授权：使用阈值判断（与 BSC 一致）
-            if (isMax ? (currentAllowance >= MAX_APPROVAL_THRESHOLD) : (currentAllowance >= requiredAmount)) {
+            if (isMax ? currentAllowance >= MAX_APPROVAL_THRESHOLD : currentAllowance >= requiredAmount) {
                 return {
                     owner: ownerAddress,
                     alreadyApproved: true,
                     currentAllowance,
                     requiredAllowance: requiredAmount,
-                    signedTx: undefined
+                    signedTx: undefined,
                 };
             }
             // 构建并签名交易
@@ -565,28 +536,26 @@ export async function approveTokenBatchRaw(params) {
                 gasLimit: finalGasLimit,
                 gasPrice: finalGasPrice,
                 chainId,
-                type: 0 // Legacy 交易
+                type: 0, // Legacy 交易
             });
             return {
                 owner: ownerAddress,
                 alreadyApproved: false,
                 currentAllowance,
                 requiredAllowance: requiredAmount,
-                signedTx
+                signedTx,
             };
         });
         const results = await Promise.all(signPromises);
         // ✅ 提取所有签名交易（过滤掉已授权的）
-        const signedTransactions = results
-            .filter(r => !r.alreadyApproved && r.signedTx)
-            .map(r => r.signedTx);
-        const alreadyApprovedCount = results.filter(r => r.alreadyApproved).length;
-        const needApproveCount = results.filter(r => !r.alreadyApproved).length;
+        const signedTransactions = results.filter((r) => !r.alreadyApproved && r.signedTx).map((r) => r.signedTx);
+        const alreadyApprovedCount = results.filter((r) => r.alreadyApproved).length;
+        const needApproveCount = results.filter((r) => !r.alreadyApproved).length;
         return {
             signedTransactions,
             results,
             needApproveCount,
-            alreadyApprovedCount
+            alreadyApprovedCount,
         };
     }
     // ==================== signOnly=false（默认）：直接发送交易 ====================
@@ -601,12 +570,12 @@ export async function approveTokenBatchRaw(params) {
         try {
             // 如果已经授权足够，跳过
             // ✅ max 授权：使用阈值判断（与 BSC 一致）
-            if (isMax ? (currentAllowance >= MAX_APPROVAL_THRESHOLD) : (currentAllowance >= requiredAmount)) {
+            if (isMax ? currentAllowance >= MAX_APPROVAL_THRESHOLD : currentAllowance >= requiredAmount) {
                 return {
                     owner: ownerAddress,
                     alreadyApproved: true,
                     currentAllowance,
-                    requiredAllowance: requiredAmount
+                    requiredAllowance: requiredAmount,
                 };
             }
             // 发送授权交易
@@ -618,7 +587,7 @@ export async function approveTokenBatchRaw(params) {
                 alreadyApproved: false,
                 currentAllowance,
                 requiredAllowance: requiredAmount,
-                txHash: receipt.hash
+                txHash: receipt.hash,
             };
         }
         catch (error) {
@@ -627,19 +596,19 @@ export async function approveTokenBatchRaw(params) {
                 alreadyApproved: false,
                 currentAllowance,
                 requiredAllowance: requiredAmount,
-                error: error.message
+                error: getErrorMessageFromUnknown(error),
             };
         }
     });
     // ✅ 优化：并行等待所有授权交易完成
     const results = await Promise.all(approvalPromises);
     // 统计结果
-    const approvedCount = results.filter(r => !r.alreadyApproved && !r.error).length;
-    const errorCount = results.filter(r => r.error).length;
+    const approvedCount = results.filter((r) => !r.alreadyApproved && !r.error).length;
+    const errorCount = results.filter((r) => r.error).length;
     // ✅ 只要没有错误，就算成功（包括所有钱包都已授权的情况）
     return {
         success: errorCount === 0,
         approvedCount,
-        results
+        results,
     };
 }

package/dist/utils/errors.d.ts

@@ -1,5 +1,16 @@
-export type FourErrorCode = 'GW' | 'ZA' | 'TO' | 'Slippage' | 'More BNB' | 'FR' | 'SO';
+import { SdkErrorCode } from '../types/errors.js';
+import type { FourErrorCode } from './types/errors.js';
+export { SdkErrorCode } from '../types/errors.js';
+export type { FourErrorCode } from './types/errors.js';
 export declare function parseFourError(err: unknown): {
     code?: FourErrorCode;
     message: string;
 };
+/** 统一结构化错误（含错误码，便于上层分支处理） */
+export declare class SdkError extends Error {
+    readonly code: SdkErrorCode;
+    cause?: unknown;
+    constructor(code: SdkErrorCode, message: string, cause?: unknown);
+}
+/** 将任意异常归一为 SdkError */
+export declare function parseSdkError(err: unknown): SdkError;

package/dist/utils/errors.js

@@ -1,3 +1,6 @@
+import { getErrorMessageFromUnknown } from '../shared/foundation/normalize-unknown.js';
+import { SdkErrorCode } from '../types/errors.js';
+export { SdkErrorCode } from '../types/errors.js';
 const MESSAGES = {
     GW: 'Amount precision is not aligned to GWEI',
     ZA: "The 'to' address should not be address(0)",
@@ -8,9 +11,65 @@ const MESSAGES = {
     SO: 'Order amount is too small',
 };
 export function parseFourError(err) {
-    const raw = String(err?.message ?? err);
+    const raw = getErrorMessageFromUnknown(err);
     const found = Object.keys(MESSAGES).find((k) => raw.includes(k));
     if (found)
         return { code: found, message: MESSAGES[found] };
     return { message: raw };
 }
+function mapFourCodeToSdk(code) {
+    switch (code) {
+        case 'GW':
+            return SdkErrorCode.FOUR_GWEI_PRECISION;
+        case 'ZA':
+            return SdkErrorCode.FOUR_ZERO_ADDRESS;
+        case 'TO':
+            return SdkErrorCode.FOUR_ZERO_ADDRESS;
+        case 'Slippage':
+            return SdkErrorCode.FOUR_SLIPPAGE;
+        case 'More BNB':
+            return SdkErrorCode.FOUR_INSUFFICIENT_FUNDS;
+        case 'FR':
+            return SdkErrorCode.FOUR_FEE_TOO_HIGH;
+        case 'SO':
+            return SdkErrorCode.FOUR_ORDER_TOO_SMALL;
+        default:
+            return SdkErrorCode.UNKNOWN_ERROR;
+    }
+}
+/** 统一结构化错误（含错误码，便于上层分支处理） */
+export class SdkError extends Error {
+    code;
+    constructor(code, message, cause) {
+        super(message, cause !== undefined ? { cause } : undefined);
+        this.name = 'SdkError';
+        this.code = code;
+    }
+}
+/** 将任意异常归一为 SdkError */
+export function parseSdkError(err) {
+    if (err instanceof SdkError)
+        return err;
+    if (err === null || err === undefined) {
+        return new SdkError(SdkErrorCode.UNKNOWN_ERROR, 'Unknown error');
+    }
+    const raw = getErrorMessageFromUnknown(err);
+    const rawLower = raw.toLowerCase();
+    const four = parseFourError(err);
+    if (four.code) {
+        return new SdkError(mapFourCodeToSdk(four.code), four.message);
+    }
+    if (rawLower.includes('token already exists')) {
+        return new SdkError(SdkErrorCode.TOKEN_ALREADY_EXISTS, raw);
+    }
+    if (rawLower.includes('slippage')) {
+        return new SdkError(SdkErrorCode.SLIPPAGE_EXCEEDED, raw);
+    }
+    if (rawLower.includes('insufficient funds') || rawLower.includes('insufficient balance')) {
+        return new SdkError(SdkErrorCode.INSUFFICIENT_BALANCE, raw);
+    }
+    if (rawLower.includes('permit expired')) {
+        return new SdkError(SdkErrorCode.PERMIT_EXPIRED, raw);
+    }
+    return new SdkError(SdkErrorCode.UNKNOWN_ERROR, raw);
+}

package/dist/utils/holders-maker/addresses.d.ts

@@ -0,0 +1,12 @@
+export declare const FOUR_TM2_ABI: string[];
+export declare const PANCAKE_V2_ROUTER_ADDRESS: "0x10ED43C718714eb63d5aA57B78B54704E256024E";
+export declare const PANCAKE_V3_ROUTER_ADDRESS: "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
+export declare const WBNB_ADDRESS: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
+export declare const USDT_ADDRESS: "0x55d398326f99059fF775485246999027B3197955";
+export declare const USDC_ADDRESS: "0x8AC76a51cc950d9822D68b83fE1Ad97B32Cd580d";
+export declare const XLAYER_V2_ROUTER_ADDRESS: "0x881fb2f98c13d521009464e7d1cbf16e1b394e8e";
+export declare const XLAYER_V3_ROUTER_ADDRESS: "0xBB069e9465BcabC4F488d21e793BDEf0F2d41D41";
+export declare const WOKB_ADDRESS: "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
+export declare const ENI_V2_ROUTER_ADDRESS: "0x97ed8be49d9a8b86247090aa41e908e76b8fcf22";
+export declare const ENI_DAOAAS_PORTAL_ADDRESS: "0x0078341F4CD09D7E6D3125ef6eb4cB2F46CA8310";
+export declare const WEGAS_ADDRESS: "0x6d1e851446f4d004ae2a72f9afed85e8829a205e";

package/dist/utils/holders-maker/addresses.js

@@ -0,0 +1,15 @@
+import { ADDRESSES } from '../constants.js';
+export const FOUR_TM2_ABI = [
+    'function buyTokenAMAP(uint256 origin, address token, address to, uint256 funds, uint256 minAmount) payable',
+];
+export const PANCAKE_V2_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV2Router;
+export const PANCAKE_V3_ROUTER_ADDRESS = ADDRESSES.BSC.PancakeV3Router;
+export const WBNB_ADDRESS = ADDRESSES.BSC.WBNB;
+export const USDT_ADDRESS = ADDRESSES.BSC.USDT;
+export const USDC_ADDRESS = ADDRESSES.BSC.USDC;
+export const XLAYER_V2_ROUTER_ADDRESS = ADDRESSES.XLAYER.PotatoSwapV2Router;
+export const XLAYER_V3_ROUTER_ADDRESS = ADDRESSES.XLAYER.PotatoSwapV3Router;
+export const WOKB_ADDRESS = ADDRESSES.XLAYER.WOKB;
+export const ENI_V2_ROUTER_ADDRESS = ADDRESSES.ENI.DswapV2Router;
+export const ENI_DAOAAS_PORTAL_ADDRESS = ADDRESSES.ENI.DaoaasPortal;
+export const WEGAS_ADDRESS = ADDRESSES.ENI.WEGAS;

package/dist/utils/holders-maker/buy-tx.d.ts

@@ -0,0 +1,44 @@
+import { Wallet } from 'ethers';
+import type { HoldersMakerChain } from '../../shared/foundation/types/holders-maker.js';
+/**
+ * 构建 Flap 买入交易
+ * 使用 swapExactInput 方法
+ */
+export declare function buildFlapBuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, chain: HoldersMakerChain): Promise<string>;
+/**
+ * 构建 Four 内盘买入交易
+ * 使用 buyTokenAMAP 方法
+ */
+export declare function buildFourBuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2): Promise<string>;
+/**
+ * 构建 DAOaaS 内盘买入交易 (ENI 链)
+ * EGAS → Token (使用 DAOaaS Portal buy)
+ */
+export declare function buildDaoaasBuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number): Promise<string>;
+/**
+ * 构建 V2 买入交易
+ * BNB/OKB → Token (使用 swapExactETHForTokensSupportingFeeOnTransferTokens)
+ */
+export declare function buildV2BuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, v2Path?: string[], chain?: HoldersMakerChain, v2RouterOverride?: string): Promise<string>;
+/**
+ * 构建 V3 单跳买入交易
+ * BNB/OKB → Token (使用 exactInputSingle + multicall)
+ *
+ * ✅ 修复：根据链类型选择正确的 Router ABI 版本
+ * - XLayer/Monad: 旧版 Router（exactInputSingle 包含 deadline，multicall(bytes[])）
+ * - BSC: 新版 SwapRouter02（exactInputSingle 不含 deadline，multicall(uint256,bytes[])）
+ */
+export declare function buildV3BuyTx(wallet: Wallet, tokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, v3Fee?: number, // 默认 0.25% 手续费
+chain?: HoldersMakerChain): Promise<string>;
+/**
+ * 构建 V2 买入交易（ERC20 输入）
+ * USDT/USDC → Token (使用 swapExactTokensForTokensSupportingFeeOnTransferTokens)
+ */
+export declare function buildV2BuyTxWithERC20(wallet: Wallet, tokenAddress: string, baseTokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, v2RouterOverride?: string, chain?: HoldersMakerChain): Promise<string>;
+/**
+ * 构建 V3 买入交易（ERC20 输入）
+ * USDT/USDC → Token (使用 exactInputSingle + multicall)
+ *
+ * ✅ 修复：使用 ethers.Interface 手动编码 calldata，避免 multicall 重载问题
+ */
+export declare function buildV3BuyTxWithERC20(wallet: Wallet, tokenAddress: string, baseTokenAddress: string, buyAmount: bigint, nonce: number, gasPrice: bigint, gasLimit: number, chainId: number, txType: 0 | 2, v3Fee?: number): Promise<string>;