four-flap-meme-sdk 1.9.49 → 2.0.0

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,20 +23,15 @@ async function validateContractAddress(provider, address, label) {
         }
     }
     catch (error) {
-        if (error instanceof Error ? error.message : String(error).includes('无效或未部署')) {
-            throw error;
+        const msg = getErrorMessageFromUnknown(error);
+        if (msg.includes('无效或未部署')) {
+            throw error instanceof Error ? error : new Error(msg);
         }
-        const errMsg = error instanceof Error ? error instanceof Error ? error.message : String(error) : String(error);
-        const errCode = error.code;
-        // ✅ 如果是 checksum 错误，提供更友好的提示
-        if (errMsg.includes('bad address checksum') || errCode === 'INVALID_ARGUMENT') {
-            const formatErr = new Error(`❌ ${label} 地址格式错误，请使用正确的 checksum 格式: ${address}`);
-            Object.assign(formatErr, { cause: error });
-            throw formatErr;
+        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}`);
         }
-        const verifyErr = new Error(`❌ 无法验证 ${label} 地址 ${address}: ${errMsg}`);
-        Object.assign(verifyErr, { cause: error });
-        throw verifyErr;
+        throw new Error(`❌ 无法验证 ${label} 地址 ${address}: ${msg}`);
     }
 }
 /**
@@ -55,10 +51,7 @@ async function ensureAllowance(rpcUrl, privateKey, token, owner, spender, requir
         current = await erc20.allowance(owner, spender);
     }
     catch (error) {
-        const msg2 = error instanceof Error ? error instanceof Error ? error.message : String(error) : String(error);
-        const allowErr = new Error(`❌ 调用 allowance 失败（Token 可能不是 ERC20）: ${msg2}`);
-        Object.assign(allowErr, { cause: error });
-        throw allowErr;
+        throw new Error(`❌ 调用 allowance 失败（Token 可能不是 ERC20）: ${getErrorMessageFromUnknown(error)}`);
     }
     if (current >= required) {
         return {
@@ -76,30 +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) {
-        const msg = error instanceof Error ? error.message : String(error);
-        const e = new Error(`❌ 调用 allowance 失败（Token 可能不是 ERC20）: ${msg}`);
-        Object.assign(e, { cause: error });
-        throw e;
+        throw new Error(`❌ 调用 allowance 失败（Token 可能不是 ERC20）: ${getErrorMessageFromUnknown(error)}`);
     }
     return {
         isApproved: current >= amount,
@@ -107,64 +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) {
-        const msg = error instanceof Error ? error.message : String(error);
-        const e = new Error(`❌ 调用 allowance 失败（Token 可能不是 ERC20）: ${msg}`);
-        Object.assign(e, { cause: error });
-        throw e;
-    }
-    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）
@@ -186,32 +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) {
-        const msg = error instanceof Error ? error.message : String(error);
-        const e = new Error(`❌ 调用 allowance 失败（Token 可能不是 ERC20）: ${msg}`);
-        Object.assign(e, { cause: error });
-        throw e;
-    }
-    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 代理合约
@@ -263,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]);
@@ -271,7 +210,7 @@ export async function checkFlapSellApprovalBatch(chain, rpcUrl, token, owners, r
         owner,
         isApproved: allowances[i] >= required,
         currentAllowance: allowances[i],
-        requiredAllowance: required
+        requiredAllowance: required,
     }));
 }
 /**
@@ -288,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;
         }
@@ -408,10 +347,7 @@ export async function checkAllowanceRaw(rpcUrl, tokenAddress, ownerAddress, spen
         return allowance;
     }
     catch (error) {
-        const qMsg = error instanceof Error ? error.message : String(error);
-        const qErr = new Error(`❌ 查询授权额度失败: ${qMsg}`);
-        Object.assign(qErr, { cause: error });
-        throw qErr;
+        throw new Error(`❌ 查询授权额度失败: ${getErrorMessageFromUnknown(error)}`);
     }
 }
 /**
@@ -459,18 +395,15 @@ export async function approveTokenRaw(rpcUrl, privateKey, tokenAddress, spenderA
         currentAllowance = await erc20.allowance(ownerAddress, normalizedSpender);
     }
     catch (error) {
-        const qMsg = error instanceof Error ? error.message : String(error);
-        const qErr = new Error(`❌ 查询授权额度失败: ${qMsg}`);
-        Object.assign(qErr, { cause: error });
-        throw qErr;
+        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,
         };
     }
     // 发送授权交易
@@ -481,14 +414,11 @@ export async function approveTokenRaw(rpcUrl, privateKey, tokenAddress, spenderA
             alreadyApproved: false,
             currentAllowance,
             requiredAllowance: requiredAmount,
-            txReceipt: receipt
+            txReceipt: receipt,
         };
     }
     catch (error) {
-        const aMsg = error instanceof Error ? error.message : String(error);
-        const aErr = new Error(`❌ 授权交易失败: ${aMsg}`);
-        Object.assign(aErr, { cause: error });
-        throw aErr;
+        throw new Error(`❌ 授权交易失败: ${getErrorMessageFromUnknown(error)}`);
     }
 }
 /**
@@ -519,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');
@@ -527,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('❌ 私钥数量和授权数量必须匹配');
     }
@@ -546,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（和买卖交易一样）
@@ -560,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);
@@ -574,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,
                 };
             }
             // 构建并签名交易
@@ -592,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（默认）：直接发送交易 ====================
@@ -628,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,
                 };
             }
             // 发送授权交易
@@ -645,29 +587,28 @@ export async function approveTokenBatchRaw(params) {
                 alreadyApproved: false,
                 currentAllowance,
                 requiredAllowance: requiredAmount,
-                txHash: receipt.hash
+                txHash: receipt.hash,
             };
         }
         catch (error) {
-            const msg = error instanceof Error ? error.message : String(error);
             return {
                 owner: ownerAddress,
                 alreadyApproved: false,
                 currentAllowance,
                 requiredAllowance: requiredAmount,
-                error: msg,
+                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,28 +1,16 @@
-/**
- * 统一 SDK 错误处理
- *
- * 提供 SdkError 类和 parseSdkError 函数，作为所有错误类型的统一入口。
- * parseFourError 作为向后兼容的包装器。
- */
 import { SdkErrorCode } from '../types/errors.js';
+import type { FourErrorCode } from './types/errors.js';
 export { SdkErrorCode } from '../types/errors.js';
-/**
- * SDK 统一错误类
- */
-export declare class SdkError extends Error {
-    readonly code: SdkErrorCode;
-    readonly cause?: unknown | undefined;
-    constructor(code: SdkErrorCode, message: string, cause?: unknown | undefined);
-}
-/**
- * 统一错误解析入口
- */
-export declare function parseSdkError(error: unknown): SdkError;
-export type FourErrorCode = 'GW' | 'ZA' | 'TO' | 'Slippage' | 'More BNB' | 'FR' | 'SO';
-/**
- * @deprecated 使用 parseSdkError 替代
- */
+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,78 +1,7 @@
-/**
- * 统一 SDK 错误处理
- *
- * 提供 SdkError 类和 parseSdkError 函数，作为所有错误类型的统一入口。
- * parseFourError 作为向后兼容的包装器。
- */
+import { getErrorMessageFromUnknown } from '../shared/foundation/normalize-unknown.js';
 import { SdkErrorCode } from '../types/errors.js';
 export { SdkErrorCode } from '../types/errors.js';
-/**
- * SDK 统一错误类
- */
-export class SdkError extends Error {
-    constructor(code, message, cause) {
-        super(message);
-        this.code = code;
-        this.cause = cause;
-        this.name = 'SdkError';
-    }
-}
-/**
- * 统一错误解析入口
- */
-export function parseSdkError(error) {
-    if (error instanceof SdkError)
-        return error;
-    const errObj = error;
-    const rawMsg = errObj?.reason ||
-        errObj?.message ||
-        errObj?.data?.message ||
-        String(error ?? '');
-    const msg = String(rawMsg);
-    const msgLower = msg.toLowerCase();
-    // ---- Four.meme 错误模式 ----
-    if (msg.includes('GW'))
-        return new SdkError(SdkErrorCode.FOUR_GWEI_PRECISION, 'Amount precision is not aligned to GWEI', error);
-    if (msg.includes('ZA'))
-        return new SdkError(SdkErrorCode.FOUR_ZERO_ADDRESS, "The 'to' address should not be address(0)", error);
-    if (msg.includes('TO'))
-        return new SdkError(SdkErrorCode.INVALID_TOKEN, 'The to address should not be set to the PancakePair address', error);
-    if (msg.includes('Slippage'))
-        return new SdkError(SdkErrorCode.FOUR_SLIPPAGE, 'Slippage exceeded limit', error);
-    if (msg.includes('More BNB'))
-        return new SdkError(SdkErrorCode.FOUR_INSUFFICIENT_FUNDS, 'Insufficient BNB sent in msg.value', error);
-    if (msg.includes('FR'))
-        return new SdkError(SdkErrorCode.FOUR_FEE_TOO_HIGH, 'Fee rate exceeds 5%', error);
-    if (msg.includes('SO'))
-        return new SdkError(SdkErrorCode.FOUR_ORDER_TOO_SMALL, 'Order amount is too small', error);
-    // ---- Flap Protocol 错误模式 ----
-    if (msgLower.includes('token already exists') || msgLower.includes('already created'))
-        return new SdkError(SdkErrorCode.TOKEN_ALREADY_EXISTS, 'Token already exists', error);
-    if (msgLower.includes('token not found') || msgLower.includes('invalid token'))
-        return new SdkError(SdkErrorCode.TOKEN_NOT_FOUND, 'Token not found', error);
-    if (msgLower.includes('not tradable') || msgLower.includes('trading disabled'))
-        return new SdkError(SdkErrorCode.TOKEN_NOT_TRADABLE, 'Token is not tradable', error);
-    if (msgLower.includes('already on dex') || msgLower.includes('already migrated'))
-        return new SdkError(SdkErrorCode.ALREADY_ON_DEX, 'Token already on DEX', error);
-    if (msgLower.includes('insufficient balance') || msgLower.includes('insufficient funds'))
-        return new SdkError(SdkErrorCode.INSUFFICIENT_BALANCE, 'Insufficient balance', error);
-    if (msgLower.includes('slippage') || msgLower.includes('min output'))
-        return new SdkError(SdkErrorCode.SLIPPAGE_EXCEEDED, 'Slippage exceeded', error);
-    if (msgLower.includes('invalid amount') || msgLower.includes('amount too small'))
-        return new SdkError(SdkErrorCode.INVALID_AMOUNT, 'Invalid amount', error);
-    if (msgLower.includes('invalid quote token') || msgLower.includes('quote token not supported'))
-        return new SdkError(SdkErrorCode.INVALID_QUOTE_TOKEN, 'Invalid quote token', error);
-    if (msgLower.includes('tax rate') && msgLower.includes('too high'))
-        return new SdkError(SdkErrorCode.TAX_RATE_TOO_HIGH, 'Tax rate too high', error);
-    if (msgLower.includes('permit expired') || msgLower.includes('deadline'))
-        return new SdkError(SdkErrorCode.PERMIT_EXPIRED, 'Permit expired', error);
-    if (msgLower.includes('permit') && (msgLower.includes('invalid') || msgLower.includes('signature')))
-        return new SdkError(SdkErrorCode.PERMIT_INVALID, 'Invalid permit signature', error);
-    if (msgLower.includes('user rejected') || msgLower.includes('user denied'))
-        return new SdkError(SdkErrorCode.TRANSACTION_FAILED, 'Transaction was rejected by user', error);
-    return new SdkError(SdkErrorCode.UNKNOWN_ERROR, msg.slice(0, 300), error);
-}
-const FOUR_MESSAGES = {
+const MESSAGES = {
     GW: 'Amount precision is not aligned to GWEI',
     ZA: "The 'to' address should not be address(0)",
     TO: 'The to address should not be set to the PancakePair address',
@@ -81,13 +10,66 @@ const FOUR_MESSAGES = {
     FR: 'Fee rate exceeds 5%',
     SO: 'Order amount is too small',
 };
-/**
- * @deprecated 使用 parseSdkError 替代
- */
 export function parseFourError(err) {
-    const raw = String(err?.message ?? err);
-    const found = Object.keys(FOUR_MESSAGES).find((k) => raw.includes(k));
+    const raw = getErrorMessageFromUnknown(err);
+    const found = Object.keys(MESSAGES).find((k) => raw.includes(k));
     if (found)
-        return { code: found, message: FOUR_MESSAGES[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);
+}