four-flap-meme-sdk 1.9.49 → 2.1.0

package/dist/shared/flap/portal-bundle.js

@@ -8,7 +8,7 @@ const PORTAL_ABI = [
     'function newTokenV2((string name,string symbol,string meta,uint8 dexThresh,bytes32 salt,uint16 taxRate,uint8 migratorType,address quoteToken,uint256 quoteAmt,address beneficiary,bytes permitData)) external payable returns (address)',
     'function swapExactInputBuy((address inputToken,address outputToken,uint256 inputAmount,uint256 minOutputAmount,bytes permitData)) external payable returns (uint256)',
     'function swapExactInputSell((address inputToken,address outputToken,uint256 inputAmount,uint256 minOutputAmount,bytes permitData)) external returns (uint256)',
-    'function quoteExactInput((address inputToken,address outputToken,uint256 inputAmount)) external returns (uint256)'
+    'function quoteExactInput((address inputToken,address outputToken,uint256 inputAmount)) external returns (uint256)',
 ];
 /**
  * Flap Protocol Bundle 交易方法
@@ -18,20 +18,20 @@ const PORTAL_ABI = [
 const ERRORS = {
     NO_PRIVATE_KEY: {
         en: 'At least 1 private key (creator) is required',
-        zh: '至少需要 1 个私钥（创建者）'
+        zh: '至少需要 1 个私钥（创建者）',
     },
     AMOUNT_MISMATCH: {
         en: (buyCount, buyerCount) => `Buy amount count (${buyCount}) must equal buyer count (${buyerCount})`,
-        zh: (buyCount, buyerCount) => `购买金额数量(${buyCount})必须等于买家数量(${buyerCount})`
+        zh: (buyCount, buyerCount) => `购买金额数量(${buyCount})必须等于买家数量(${buyerCount})`,
     },
     KEY_AMOUNT_MISMATCH: {
         en: 'Private key count and amount count must match',
-        zh: '私钥和购买金额数量必须一致'
+        zh: '私钥和购买金额数量必须一致',
     },
     SELL_KEY_AMOUNT_MISMATCH: {
         en: 'Private key count and sell amount count must match',
-        zh: '私钥和卖出数量必须一致'
-    }
+        zh: '私钥和卖出数量必须一致',
+    },
 };
 // 获取错误信息（根据环境语言）
 function getErrorMessage(key, ...args) {
@@ -71,7 +71,7 @@ export async function createTokenWithBundleBuy(params) {
     const devWallet = new Wallet(privateKeys[0], provider);
     const club48 = new Club48Client({
         endpoint: config.club48Endpoint,
-        explorerEndpoint: config.club48ExplorerEndpoint
+        explorerEndpoint: config.club48ExplorerEndpoint,
     });
     const blockOffset = config.bundleBlockOffset ?? 100;
     // 1. 构建交易（为重复地址分配顺序 nonce）
@@ -105,7 +105,7 @@ export async function createTokenWithBundleBuy(params) {
         quoteToken: params.quoteToken || '0x0000000000000000000000000000000000000000',
         quoteAmt: 0n,
         beneficiary: new Wallet(privateKeys[0]).address,
-        permitData: '0x'
+        permitData: '0x',
     });
     // 估算 gas 并应用用户配置的安全余量
     const createGasLimit = await estimateGasWithMultiplier(provider, { ...createTxUnsigned, from: devWallet.address }, config.gasLimitMultiplier);
@@ -116,7 +116,7 @@ export async function createTokenWithBundleBuy(params) {
         gasLimit: createGasLimit,
         gasPrice: gasPrice,
         chainId: 56, // BSC
-        type: getTxType(config) // 用户可配置：0=Legacy（默认），2=EIP-1559
+        type: getTxType(config), // 用户可配置：0=Legacy（默认），2=EIP-1559
     };
     const signedCreateTx = await devWallet.signTransaction(createTxRequest);
     signedTxs.push(signedCreateTx);
@@ -129,7 +129,7 @@ export async function createTokenWithBundleBuy(params) {
             gasLimit: GAS_LIMITS.BRIBE,
             chainId: 56,
             type: 0, // Legacy transaction
-            nonce: await getNextNonce(devWallet)
+            nonce: await getNextNonce(devWallet),
         });
         signedTxs.push(tipTx);
     }
@@ -146,14 +146,12 @@ export async function createTokenWithBundleBuy(params) {
             const exactOut = await quote.quoteExactInput.staticCall({
                 inputToken: '0x0000000000000000000000000000000000000000',
                 outputToken: tokenAddress,
-                inputAmount: amountIn
+                inputAmount: amountIn,
             });
             const keep = BigInt(10000 - slippageBps);
             minAmountOut = (exactOut * keep) / 10000n;
         }
-        catch {
-            void 0;
-        }
+        catch { }
         const buyPortal = new ethers.Contract(portalAddr, PORTAL_ABI, buyerWallet);
         const buyTxUnsigned = await buyPortal.swapExactInputBuy.populateTransaction({
             inputToken: '0x0000000000000000000000000000000000000000',
@@ -178,7 +176,7 @@ export async function createTokenWithBundleBuy(params) {
             gasLimit: buyGasLimit,
             gasPrice: gasPrice,
             chainId: 56, // BSC
-            type: getTxType(config) // 用户可配置
+            type: getTxType(config), // 用户可配置
         };
         const signedBuyTx = await buyerWallet.signTransaction(buyTxRequest);
         signedTxs.push(signedBuyTx);
@@ -188,11 +186,11 @@ export async function createTokenWithBundleBuy(params) {
     const bundleUuid = await club48.sendBundle({
         txs: signedTxs,
         maxBlockNumber: (await provider.getBlockNumber()) + blockOffset,
-        noMerge: config.noMerge
+        noMerge: config.noMerge,
     }, {
         spMode: params.config.spMode ?? 'timestampPersonalSign',
         spPrivateKey: params.config.spPrivateKey || privateKeys[0],
-        spVMode: params.config.spVMode
+        spVMode: params.config.spVMode,
     });
     // 3. 等待完成
     const status = await club48.waitForBundle(bundleUuid, params.config.waitTimeoutMs ?? 60000);
@@ -201,7 +199,7 @@ export async function createTokenWithBundleBuy(params) {
         tokenAddress,
         status,
         createTx: signedCreateTx,
-        buyTxs
+        buyTxs,
     };
 }
 /**
@@ -215,7 +213,7 @@ export async function batchBuyWithBundle(params) {
     const provider = new JsonRpcProvider(config.rpcUrl);
     const club48 = new Club48Client({
         endpoint: config.club48Endpoint,
-        explorerEndpoint: config.club48ExplorerEndpoint
+        explorerEndpoint: config.club48ExplorerEndpoint,
     });
     const blockOffset = config.bundleBlockOffset ?? 100;
     const portalAddr = FLAP_PORTAL_ADDRESSES[chain];
@@ -244,7 +242,7 @@ export async function batchBuyWithBundle(params) {
             gasLimit: GAS_LIMITS.BRIBE,
             chainId: 56,
             type: 0, // Legacy transaction
-            nonce: await getNextNonce(tipWallet)
+            nonce: await getNextNonce(tipWallet),
         });
         signedTxs.unshift(tipTx);
     }
@@ -259,14 +257,12 @@ export async function batchBuyWithBundle(params) {
             const exactOut = await quote.quoteExactInput.staticCall({
                 inputToken: '0x0000000000000000000000000000000000000000',
                 outputToken: tokenAddress,
-                inputAmount: amountIn
+                inputAmount: amountIn,
             });
             const keep = BigInt(10000 - slippageBps);
             minAmountOut = (exactOut * keep) / 10000n;
         }
-        catch {
-            void 0;
-        }
+        catch { }
         const portal = new ethers.Contract(portalAddr, PORTAL_ABI, buyerWallet);
         const buyTxUnsigned = await portal.swapExactInputBuy.populateTransaction({
             inputToken: '0x0000000000000000000000000000000000000000',
@@ -279,7 +275,7 @@ export async function batchBuyWithBundle(params) {
         const estimatedGas = await provider.estimateGas({
             ...buyTxUnsigned,
             from: buyerWallet.address,
-            value: amountIn
+            value: amountIn,
         });
         const gasLimit = (estimatedGas * 120n) / 100n;
         const buyTxRequest = {
@@ -289,7 +285,7 @@ export async function batchBuyWithBundle(params) {
             gasLimit: gasLimit,
             gasPrice: gasPrice,
             chainId: 56, // BSC
-            type: 0 // Legacy transaction
+            type: 0, // Legacy transaction
         };
         const signedBuyTx = await buyerWallet.signTransaction(buyTxRequest);
         signedTxs.push(signedBuyTx);
@@ -297,11 +293,11 @@ export async function batchBuyWithBundle(params) {
     const bundleUuid = await club48.sendBundle({
         txs: signedTxs,
         maxBlockNumber: (await provider.getBlockNumber()) + blockOffset,
-        noMerge: config.noMerge
+        noMerge: config.noMerge,
     }, {
         spMode: params.config.spMode ?? 'timestampPersonalSign',
         spPrivateKey: params.config.spPrivateKey || privateKeys[0],
-        spVMode: params.config.spVMode
+        spVMode: params.config.spVMode,
     });
     const status = await club48.waitForBundle(bundleUuid);
     return { bundleUuid, status, buyTxs: signedTxs };
@@ -317,7 +313,7 @@ export async function batchSellWithBundle(params) {
     const provider = new JsonRpcProvider(config.rpcUrl);
     const club48 = new Club48Client({
         endpoint: config.club48Endpoint,
-        explorerEndpoint: config.club48ExplorerEndpoint
+        explorerEndpoint: config.club48ExplorerEndpoint,
     });
     const blockOffset = config.bundleBlockOffset ?? 100;
     const portalAddr = FLAP_PORTAL_ADDRESSES[chain];
@@ -346,7 +342,7 @@ export async function batchSellWithBundle(params) {
             gasLimit: GAS_LIMITS.BRIBE,
             chainId: 56,
             type: 0, // Legacy transaction
-            nonce: await getNextNonce(tipWallet)
+            nonce: await getNextNonce(tipWallet),
         });
         signedTxs.unshift(tipTx);
     }
@@ -365,7 +361,7 @@ export async function batchSellWithBundle(params) {
         // 估算 gas 并添加 20% 安全余量
         const estimatedGas = await provider.estimateGas({
             ...sellTxUnsigned,
-            from: sellerWallet.address
+            from: sellerWallet.address,
         });
         const gasLimit = (estimatedGas * 120n) / 100n;
         const sellTxRequest = {
@@ -375,7 +371,7 @@ export async function batchSellWithBundle(params) {
             gasLimit: gasLimit,
             gasPrice: gasPrice,
             chainId: 56, // BSC
-            type: 0 // Legacy transaction
+            type: 0, // Legacy transaction
         };
         const signedSellTx = await sellerWallet.signTransaction(sellTxRequest);
         signedTxs.push(signedSellTx);
@@ -383,11 +379,11 @@ export async function batchSellWithBundle(params) {
     const bundleUuid = await club48.sendBundle({
         txs: signedTxs,
         maxBlockNumber: (await provider.getBlockNumber()) + blockOffset,
-        noMerge: config.noMerge
+        noMerge: config.noMerge,
     }, {
         spMode: params.config.spMode ?? 'timestampPersonalSign',
         spPrivateKey: params.config.spPrivateKey || privateKeys[0],
-        spVMode: params.config.spVMode
+        spVMode: params.config.spVMode,
     });
     const status = await club48.waitForBundle(bundleUuid);
     return { bundleUuid, status, sellTxs: signedTxs };
@@ -413,7 +409,7 @@ export async function flapPrivateBuy(params) {
     const estimatedGas = await provider.estimateGas({
         ...unsigned,
         from: wallet.address,
-        value: amountWei
+        value: amountWei,
     });
     const gasLimit = (estimatedGas * 120n) / 100n;
     const req = {
@@ -423,7 +419,7 @@ export async function flapPrivateBuy(params) {
         gasLimit: gasLimit,
         gasPrice,
         chainId: 56,
-        type: 0 // Legacy transaction
+        type: 0, // Legacy transaction
     };
     const signed = await wallet.signTransaction(req);
     if (spPrivateKey)
@@ -450,7 +446,7 @@ export async function flapPrivateSell(params) {
     // 估算 gas 并添加 20% 安全余量
     const estimatedGas = await provider.estimateGas({
         ...unsigned,
-        from: wallet.address
+        from: wallet.address,
     });
     const gasLimit = (estimatedGas * 120n) / 100n;
     const req = {
@@ -460,7 +456,7 @@ export async function flapPrivateSell(params) {
         gasLimit: gasLimit,
         gasPrice,
         chainId: 56,
-        type: 0 // Legacy transaction
+        type: 0, // Legacy transaction
     };
     const signed = await wallet.signTransaction(req);
     if (spPrivateKey)
@@ -503,7 +499,15 @@ export async function flapBatchPrivateBuy(params) {
         // 估算 gas 并添加 20% 安全余量
         const estimatedGas = await provider.estimateGas({ ...unsigned, from: w.address, value: amountWei });
         const gasLimit = (estimatedGas * 120n) / 100n;
-        const req = { ...unsigned, from: w.address, nonce: await getNextNonce(w), gasLimit, gasPrice, chainId: 56, type: 0 };
+        const req = {
+            ...unsigned,
+            from: w.address,
+            nonce: await getNextNonce(w),
+            gasLimit,
+            gasPrice,
+            chainId: 56,
+            type: 0,
+        };
         signedTxs.push(await w.signTransaction(req));
     }
     return await sendBatchPrivateTransactions(signedTxs, spPrivateKey, config.club48Endpoint || 'https://puissant-bsc.48.club');
@@ -545,7 +549,15 @@ export async function flapBatchPrivateSell(params) {
         // 估算 gas 并添加 20% 安全余量
         const estimatedGas = await provider.estimateGas({ ...unsigned, from: w.address });
         const gasLimit = (estimatedGas * 120n) / 100n;
-        const req = { ...unsigned, from: w.address, nonce: await getNextNonce(w), gasLimit, gasPrice, chainId: 56, type: 0 };
+        const req = {
+            ...unsigned,
+            from: w.address,
+            nonce: await getNextNonce(w),
+            gasLimit,
+            gasPrice,
+            chainId: 56,
+            type: 0,
+        };
         signedTxs.push(await w.signTransaction(req));
     }
     // 使用 bundle 通道提交（统一与捆绑买保持一致）
@@ -553,12 +565,12 @@ export async function flapBatchPrivateSell(params) {
     const bundleUuid = await club48.sendBundle({
         txs: signedTxs,
         maxBlockNumber: (await provider.getBlockNumber()) + blockOffset,
-        noMerge: config.noMerge
+        noMerge: config.noMerge,
     }, {
         // 若传入 sp 配置，则用于生成 48SP 签名提升打包优先级（与批量买一致）
         spMode: params.config.spMode ?? 'timestampPersonalSign',
         spPrivateKey: params.config.spPrivateKey || 'https://puissant-bsc.48.club',
-        spVMode: params.config.spVMode
+        spVMode: params.config.spVMode,
     });
     try {
         const status = await club48.waitForBundle(bundleUuid);

package/dist/shared/flap/portal.js

@@ -90,17 +90,21 @@ const PORTAL_ABI = [
     'function getFeeRate() external view returns (uint256,uint256)',
     'function nonce() external view returns (uint256)',
     'function version() external pure returns (string)',
-    'function getLocks(address token) external view returns (uint256[])'
+    'function getLocks(address token) external view returns (uint256[])',
 ];
 /**
  * 将 lpFeeProfile 转换为 V3 fee 值
  */
 export function lpFeeProfileToV3Fee(profile) {
     switch (profile) {
-        case V3LPFeeProfile.LP_FEE_PROFILE_STANDARD: return 2500;
-        case V3LPFeeProfile.LP_FEE_PROFILE_LOW: return 100;
-        case V3LPFeeProfile.LP_FEE_PROFILE_HIGH: return 10000;
-        default: return 2500; // 默认 STANDARD
+        case V3LPFeeProfile.LP_FEE_PROFILE_STANDARD:
+            return 2500;
+        case V3LPFeeProfile.LP_FEE_PROFILE_LOW:
+            return 100;
+        case V3LPFeeProfile.LP_FEE_PROFILE_HIGH:
+            return 10000;
+        default:
+            return 2500; // 默认 STANDARD
     }
 }
 /**
@@ -117,6 +121,11 @@ export function validateTaxDistribution(config) {
     return { valid: true };
 }
 export class FlapPortal {
+    rpcUrl;
+    portal;
+    contract;
+    buyFeeRate;
+    sellFeeRate;
     constructor(cfg) {
         this.rpcUrl = cfg.rpcUrl;
         this.portal = cfg.addressOverride ?? FLAP_PORTAL_ADDRESSES[cfg.chain];
@@ -131,13 +140,27 @@ export class FlapPortal {
     async getTokenV2(token) {
         const r = await this.contract.getTokenV2(token);
         return {
-            status: r[0], reserve: r[1], circulatingSupply: r[2], price: r[3], tokenVersion: r[4], r: r[5], dexSupplyThresh: r[6],
+            status: r[0],
+            reserve: r[1],
+            circulatingSupply: r[2],
+            price: r[3],
+            tokenVersion: r[4],
+            r: r[5],
+            dexSupplyThresh: r[6],
         };
     }
     async getTokenV3(token) {
         const r = await this.contract.getTokenV3(token);
         return {
-            status: r[0], reserve: r[1], circulatingSupply: r[2], price: r[3], tokenVersion: r[4], r: r[5], dexSupplyThresh: r[6], quoteTokenAddress: r[7], nativeToQuoteSwapEnabled: r[8],
+            status: r[0],
+            reserve: r[1],
+            circulatingSupply: r[2],
+            price: r[3],
+            tokenVersion: r[4],
+            r: r[5],
+            dexSupplyThresh: r[6],
+            quoteTokenAddress: r[7],
+            nativeToQuoteSwapEnabled: r[8],
         };
     }
     async getTokenV4(token) {
@@ -220,9 +243,7 @@ export class FlapPortal {
         // 含手续费（1% buy fee）
         const remainingWithFee = remainingNet / (1 - this.buyFeeRate);
         // 计算进度
-        const progressPercent = isGraduated
-            ? '100.00'
-            : (currentReserveNum / graduationReserveNum * 100).toFixed(2);
+        const progressPercent = isGraduated ? '100.00' : ((currentReserveNum / graduationReserveNum) * 100).toFixed(2);
         return {
             remainingOkb: remainingWithFee.toFixed(6),
             graduationReserve: graduationReserveNum.toFixed(6),
@@ -330,6 +351,7 @@ export class FlapPortal {
     }
 }
 export class FlapPortalWriter extends FlapPortal {
+    wallet;
     constructor(cfg, privateKey) {
         super(cfg);
         // 使用 ethers v6 创建钱包

package/dist/shared/flap/vanity.js

@@ -6,9 +6,7 @@ import { FLAP_ORIGINAL_PORTAL_ADDRESSES, FLAP_TOKEN_IMPL_ADDRESSES, getVanitySuf
  */
 export function predictVanityTokenAddress(salt, portal, tokenImpl) {
     // 规范化 salt 到 bytes32（避免前端传入的短字符串导致不可预期行为）
-    const normalizedSalt = /^0x[0-9a-fA-F]{64}$/.test(salt)
-        ? salt.toLowerCase()
-        : keccak256(salt);
+    const normalizedSalt = /^0x[0-9a-fA-F]{64}$/.test(salt) ? salt.toLowerCase() : keccak256(salt);
     // 构建 EIP-1167 minimal proxy bytecode
     const bytecode = '0x3d602d80600a3d3981f3363d3d373d3d3d363d73' + tokenImpl.slice(2).toLowerCase() + '5af43d82803e903d91602b57fd5bf3';
     const bytecodeHash = keccak256(bytecode);
@@ -21,8 +19,7 @@ export function predictVanityTokenAddress(salt, portal, tokenImpl) {
  * BSC/MONAD 默认使用 NORMAL 实现（非税版）
  * @param taxedV5 - 是否使用 V5 高级税代币实现 (mkt/deflation/dividend/lp)
  */
-export function predictVanityTokenAddressByChain(chain, salt, taxed = false, taxedV5 = false // ✅ 新增：V5 高级税代币标识
-) {
+export function predictVanityTokenAddressByChain(chain, salt, taxed = false, taxedV5 = false) {
     // 使用 Flap 平台的原始 Portal 地址（用于 CREATE2）
     const portal = FLAP_ORIGINAL_PORTAL_ADDRESSES[chain];
     let tokenImpl;
@@ -56,7 +53,7 @@ export async function findSaltEnding(opts) {
     // 若未提供 seed，默认使用随机种子，避免每次结果都相同
     let salt = opts.seed ?? keccak256(randomBytes(32));
     let iterations = 0;
-    const limit = opts.maxIterations ?? 1000000;
+    const limit = opts.maxIterations ?? 1_000_000;
     while (iterations < limit) {
         const addr = predictVanityTokenAddress(salt, opts.portal, opts.tokenImpl);
         if (addr.toLowerCase().endsWith(suffix)) {
@@ -105,6 +102,6 @@ export async function findSaltEndingByChain(opts) {
         tokenImpl,
         suffix,
         maxIterations: opts.maxIterations,
-        seed: opts.seed
+        seed: opts.seed,
     });
 }

package/dist/shared/flap/vault.d.ts

@@ -361,7 +361,7 @@ export declare function buildVaultParams(config?: TaxVaultConfig, chain?: string
  * 金库参数通过 VaultPortal 的 vaultFactory/vaultData 传递
  * 此函数仅用于向后兼容
  */
-export declare function buildVaultExtensionParams(_config?: TaxVaultConfig): {
+export declare function buildVaultExtensionParams(): {
     extensionID: string;
     extensionData: string;
 };

package/dist/shared/flap/vault.js

@@ -28,6 +28,32 @@
  * @module vault
  */
 import { Contract, AbiCoder, ZeroAddress } from 'ethers';
+function mapFieldDescriptor(f) {
+    return {
+        name: f.name,
+        fieldType: f.fieldType,
+        description: f.description,
+        decimals: Number(f.decimals),
+    };
+}
+function mapApproveAction(a) {
+    return {
+        tokenType: a.tokenType,
+        amountFieldName: a.amountFieldName,
+    };
+}
+function mapVaultMethodSchema(m) {
+    return {
+        name: m.name,
+        description: m.description,
+        inputs: m.inputs.map(mapFieldDescriptor),
+        outputs: m.outputs.map(mapFieldDescriptor),
+        approvals: m.approvals.map(mapApproveAction),
+        isInputArray: m.isInputArray,
+        isOutputArray: m.isOutputArray,
+        isWriteMethod: m.isWriteMethod,
+    };
+}
 /**
  * 金库类型显示标签
  */
@@ -115,7 +141,8 @@ export const VAULT_PORTAL_ABI = [
     {
         type: 'function',
         name: 'newTaxTokenWithVault',
-        inputs: [{
+        inputs: [
+            {
                 name: 'params',
                 type: 'tuple',
                 internalType: 'struct IVaultPortalTypes.NewTaxTokenWithVaultParams',
@@ -143,8 +170,9 @@ export const VAULT_PORTAL_ABI = [
                     { name: 'minimumShareBalance', type: 'uint256', internalType: 'uint256' },
                     { name: 'vaultFactory', type: 'address', internalType: 'address' },
                     { name: 'vaultData', type: 'bytes', internalType: 'bytes' },
-                ]
-            }],
+                ],
+            },
+        ],
         outputs: [{ name: 'token', type: 'address', internalType: 'address' }],
         stateMutability: 'payable',
     },
@@ -152,7 +180,8 @@ export const VAULT_PORTAL_ABI = [
         type: 'function',
         name: 'getVault',
         inputs: [{ name: 'taxToken', type: 'address', internalType: 'address' }],
-        outputs: [{
+        outputs: [
+            {
                 name: 'info',
                 type: 'tuple',
                 internalType: 'struct IVaultPortalTypes.VaultInfo',
@@ -162,8 +191,9 @@ export const VAULT_PORTAL_ABI = [
                     { name: 'description', type: 'string', internalType: 'string' },
                     { name: 'isOfficial', type: 'bool', internalType: 'bool' },
                     { name: 'riskLevel', type: 'uint8', internalType: 'enum IVaultPortalTypes.RiskLevel' },
-                ]
-            }],
+                ],
+            },
+        ],
         stateMutability: 'view',
     },
     {
@@ -190,9 +220,7 @@ export const VAULT_FACTORY_V2_ABI = [
 /**
  * VaultBase ABI（V1）
  */
-export const VAULT_BASE_ABI = [
-    'function description() public view returns (string)',
-];
+export const VAULT_BASE_ABI = ['function description() public view returns (string)'];
 /**
  * VaultBaseV2 ABI
  */
@@ -241,16 +269,21 @@ function mapFieldTypeToAbiType(fieldType) {
 function processFieldValue(field, rawValue) {
     if (rawValue === undefined || rawValue === null) {
         switch (field.fieldType) {
-            case 'address': return ZeroAddress;
-            case 'bool': return false;
-            case 'string': return '';
+            case 'address':
+                return ZeroAddress;
+            case 'bool':
+                return false;
+            case 'string':
+                return '';
             case 'bytes':
-            case 'bytes32': return '0x' + '00'.repeat(32);
-            default: return 0;
+            case 'bytes32':
+                return '0x' + '00'.repeat(32);
+            default:
+                return 0;
         }
     }
     if (field.decimals > 0 && typeof rawValue === 'number') {
-        return BigInt(Math.round(rawValue * (10 ** field.decimals)));
+        return BigInt(Math.round(rawValue * 10 ** field.decimals));
     }
     if (field.fieldType === 'bool') {
         return Boolean(rawValue);
@@ -328,7 +361,7 @@ export function buildVaultParams(config, chain) {
  * 金库参数通过 VaultPortal 的 vaultFactory/vaultData 传递
  * 此函数仅用于向后兼容
  */
-export function buildVaultExtensionParams(_config) {
+export function buildVaultExtensionParams() {
     // 金库模式下 extensionID/extensionData 始终为零值
     return {
         extensionID: NONE_EXTENSION_ID,
@@ -344,15 +377,10 @@ export function buildVaultExtensionParams(_config) {
 export async function queryVaultDataSchema(provider, factoryAddress) {
     try {
         const factory = new Contract(factoryAddress, VAULT_FACTORY_V2_ABI, provider);
-        const raw = await factory.vaultDataSchema();
+        const raw = (await factory.vaultDataSchema());
         return {
             description: raw.description,
-            fields: raw.fields.map((f) => ({
-                name: f.name,
-                fieldType: f.fieldType,
-                description: f.description,
-                decimals: Number(f.decimals),
-            })),
+            fields: raw.fields.map(mapFieldDescriptor),
             isArray: raw.isArray,
         };
     }
@@ -366,33 +394,11 @@ export async function queryVaultDataSchema(provider, factoryAddress) {
 export async function queryVaultUISchema(provider, vaultAddress) {
     try {
         const vault = new Contract(vaultAddress, VAULT_BASE_V2_ABI, provider);
-        const raw = await vault.vaultUISchema();
+        const raw = (await vault.vaultUISchema());
         return {
             vaultType: raw.vaultType,
             description: raw.description,
-            methods: raw.methods.map((m) => ({
-                name: m.name,
-                description: m.description,
-                inputs: m.inputs.map((f) => ({
-                    name: f.name,
-                    fieldType: f.fieldType,
-                    description: f.description,
-                    decimals: Number(f.decimals),
-                })),
-                outputs: m.outputs.map((f) => ({
-                    name: f.name,
-                    fieldType: f.fieldType,
-                    description: f.description,
-                    decimals: Number(f.decimals),
-                })),
-                approvals: m.approvals.map((a) => ({
-                    tokenType: a.tokenType,
-                    amountFieldName: a.amountFieldName,
-                })),
-                isInputArray: m.isInputArray,
-                isOutputArray: m.isOutputArray,
-                isWriteMethod: m.isWriteMethod,
-            })),
+            methods: raw.methods.map(mapVaultMethodSchema),
         };
     }
     catch {
@@ -437,7 +443,7 @@ export async function validateVaultFactory(provider, factoryAddress) {
 export async function getVaultInfo(provider, vaultPortalAddress, taxTokenAddress) {
     try {
         const portal = new Contract(vaultPortalAddress, VAULT_PORTAL_ABI, provider);
-        const info = await portal.getVault(taxTokenAddress);
+        const info = (await portal.getVault(taxTokenAddress));
         return {
             vault: info.vault,
             vaultFactory: info.vaultFactory,

package/dist/shared/foundation/dex/v3-path.d.ts

@@ -0,0 +1,6 @@
+export declare function getDeadline(minutes?: number): number;
+export declare function encodeV3Path(tokens: string[], fees: number[]): string;
+export declare function decodeV3Path(path: string): {
+    tokens: string[];
+    fees: number[];
+};

package/dist/shared/foundation/dex/v3-path.js

@@ -0,0 +1,35 @@
+import { GAS_CONFIG } from '../../constants/gas.js';
+export function getDeadline(minutes = GAS_CONFIG.DEFAULT_DEADLINE_MINUTES) {
+    return Math.floor(Date.now() / 1000) + 60 * minutes;
+}
+export function encodeV3Path(tokens, fees) {
+    if (tokens.length < 2) {
+        throw new Error('V3 path 需要至少 2 个代币');
+    }
+    if (fees.length !== tokens.length - 1) {
+        throw new Error(`费率数量 (${fees.length}) 必须等于代币数量 - 1 (${tokens.length - 1})`);
+    }
+    let path = '0x';
+    for (let i = 0; i < tokens.length; i++) {
+        path += tokens[i].slice(2).toLowerCase().padStart(40, '0');
+        if (i < fees.length) {
+            path += fees[i].toString(16).padStart(6, '0');
+        }
+    }
+    return path;
+}
+export function decodeV3Path(path) {
+    const cleanPath = path.startsWith('0x') ? path.slice(2) : path;
+    const tokens = [];
+    const fees = [];
+    let offset = 0;
+    while (offset < cleanPath.length) {
+        tokens.push('0x' + cleanPath.slice(offset, offset + 40));
+        offset += 40;
+        if (offset < cleanPath.length) {
+            fees.push(parseInt(cleanPath.slice(offset, offset + 6), 16));
+            offset += 6;
+        }
+    }
+    return { tokens, fees };
+}