four-flap-meme-sdk 2.2.0 → 2.2.2

package/dist/utils/constants.js

@@ -1,9 +1,84 @@
 /**
- * 公共常量 - 向后兼容 re-export 层
+ * 公共常量 - 向后兼容层
  *
- * 新代码请直接使用 `shared/constants`：
- * `import { CHAINS, ADDRESSES, getProfitRateBps } from '../shared/constants/index.js'`
+ * ⚠️ 此文件为向后兼容保留，新代码请使用 shared/constants
  *
- * v2：不再导出 `CHAIN` / `DEFAULT_DEADLINE_MINUTES` / `PROFIT_CONFIG` / 报价 `V3_FEE_TIERS`。
+ * 推荐用法：
+ * import { CHAINS, GAS_LIMITS, ADDRESSES } from '../shared/constants';
  */
-export { CHAINS, CHAIN_ID_MAP, getChainById, getChainName, getDefaultRpcUrl, isKnownChain, isBscChain, isXLayerChain, isMonadChain, isEniChain, getConfirmationTimeout, GAS_LIMITS, GAS_CONFIG, calculateGasLimit, getTransferGasLimit, ZERO_ADDRESS, BLOCKRAZOR_BUILDER_EOA, ADDRESSES, getAddress, getWrappedNativeAddress, getMulticall3Address, getFlapPortalAddress, isZeroAddress, isNativeToken, getProfitRecipient, getAllProfitRecipients, getProfitRateBps, calculateProfitAmount, calculateProfitHopGasCost, TRANSFER_FEE_PER_ADDRESS, getTransferFeePerAddress, calculateTransferFee, QUOTE_CONFIG, QUOTE_V3_FEE_TIERS, } from '../shared/constants/index.js';
+// ============================================================================
+// 从 shared/constants 重新导出（新的标准入口）
+// ============================================================================
+export { 
+// 链配置
+CHAINS, CHAIN_ID_MAP, getChainById, getChainName, getDefaultRpcUrl, isKnownChain, isBscChain, isXLayerChain, isMonadChain, getConfirmationTimeout, 
+// Gas 常量
+GAS_LIMITS, GAS_CONFIG, V3_FEE_TIERS, calculateGasLimit, getTransferGasLimit, 
+// 合约地址
+ZERO_ADDRESS, BLOCKRAZOR_BUILDER_EOA, ADDRESSES, getAddress, getWrappedNativeAddress, getMulticall3Address, getFlapPortalAddress, isZeroAddress, isNativeToken, 
+// 利润配置
+PROFIT_CONFIG as PROFIT_CONFIG_NEW, getProfitRecipient, getAllProfitRecipients, getProfitRateBps, calculateProfitAmount, calculateProfitHopGasCost, 
+// ✅ 钱包转账按地址收费
+TRANSFER_FEE_PER_ADDRESS, getTransferFeePerAddress, calculateTransferFee, } from '../shared/constants/index.js';
+import { CHAINS, PROFIT_CONFIG as PROFIT_CONFIG_NEW } from '../shared/constants/index.js';
+// ============================================================================
+// 向后兼容：旧格式常量（标记为 @deprecated）
+// ============================================================================
+/**
+ * @deprecated 使用 GAS_CONFIG.DEFAULT_DEADLINE_MINUTES 替代
+ */
+export const DEFAULT_DEADLINE_MINUTES = 20;
+/**
+ * @deprecated 使用 CHAINS 替代
+ *
+ * 旧格式的链配置，仅包含 chainId 和 name
+ */
+export const CHAIN = {
+    BSC: {
+        chainId: CHAINS.BSC.chainId,
+        name: CHAINS.BSC.name,
+    },
+    BASE: {
+        chainId: CHAINS.BASE.chainId,
+        name: CHAINS.BASE.name
+    },
+    XLAYER: {
+        chainId: CHAINS.XLAYER.chainId,
+        name: CHAINS.XLAYER.name
+    },
+    MORPH: {
+        chainId: CHAINS.MORPH.chainId,
+        name: CHAINS.MORPH.name
+    },
+    ARBITRUM_ONE: {
+        chainId: CHAINS.ARBITRUM_ONE.chainId,
+        name: CHAINS.ARBITRUM_ONE.name
+    },
+    MONAD: {
+        chainId: CHAINS.MONAD.chainId,
+        name: CHAINS.MONAD.name
+    },
+};
+/**
+ * @deprecated 使用 PROFIT_CONFIG_NEW 替代
+ *
+ * 旧格式的利润配置（扁平结构）
+ */
+export const PROFIT_CONFIG = {
+    /** @deprecated 使用 getProfitRecipient() 随机获取 */
+    get RECIPIENT() {
+        return PROFIT_CONFIG_NEW.RECIPIENTS[Math.floor(Math.random() * PROFIT_CONFIG_NEW.RECIPIENTS.length)];
+    },
+    /** 利润比例（基点）：40 bps = 0.4%（普通模式） */
+    RATE_BPS: PROFIT_CONFIG_NEW.RATES.NORMAL,
+    /** 利润比例（基点）：6 bps = 0.06%（捆绑换手模式） */
+    RATE_BPS_SWAP: PROFIT_CONFIG_NEW.RATES.BUNDLE_SWAP,
+    /** 利润比例（单边基点）：8 bps = 0.08%（用户类型 v0） */
+    RATE_BPS_V0: PROFIT_CONFIG_NEW.RATES.V0_SINGLE,
+    /** 利润比例（双边基点）：4 bps = 0.04%（用户类型 v0） */
+    RATE_BPS_V0_DOUBLE: PROFIT_CONFIG_NEW.RATES.V0_DOUBLE,
+    /** 利润比例（单边基点）：10 bps = 0.10%（用户类型 v1） */
+    RATE_BPS_V1: PROFIT_CONFIG_NEW.RATES.V1_SINGLE,
+    /** 利润比例（双边基点）：5 bps = 0.05%（用户类型 v1） */
+    RATE_BPS_V1_DOUBLE: PROFIT_CONFIG_NEW.RATES.V1_DOUBLE,
+};

package/dist/utils/contract-factory.d.ts

@@ -1,6 +1,8 @@
 import { Contract } from 'ethers';
-import type { ChainName } from './types/contract-factory.js';
-export type { ChainName } from './types/contract-factory.js';
+/**
+ * 支持的链类型
+ */
+export type ChainName = 'BSC' | 'BASE' | 'ARBITRUM_ONE';
 /**
  * 创建 TokenManager V1 合约实例（只读）
  * 自动使用正确的代理合约地址

package/dist/utils/contract-factory.js

@@ -1,91 +1,84 @@
-import { Contract, Wallet } from 'ethers';
-import { TokenManager, TokenManager2, TokenManagerHelper3 } from '../abis/index.js';
-import { ADDRESSES } from '../shared/constants/index.js';
-import { createProvider } from './provider-factory.js';
-const TOKEN_MANAGER_ABI = TokenManager;
-const TOKEN_MANAGER2_ABI = TokenManager2;
-const TOKEN_MANAGER_HELPER3_ABI = TokenManagerHelper3;
-function readOnlyProvider(rpcUrl) {
-    return createProvider(rpcUrl);
-}
-function writableProvider(rpcUrl, privateKey) {
-    return new Wallet(privateKey, createProvider(rpcUrl));
-}
+import { Contract, JsonRpcProvider, Wallet } from 'ethers';
+import { TokenManager, TokenManager2, TokenManagerHelper3 } from '../shared/abis/index.js';
+import { ADDRESSES } from './constants.js';
 /**
  * 创建 TokenManager V1 合约实例（只读）
  * 自动使用正确的代理合约地址
  */
 export function getTokenManagerV1(chain, rpcUrl) {
-    const provider = readOnlyProvider(rpcUrl);
+    const provider = new JsonRpcProvider(rpcUrl, undefined); // ✅ 禁用 ENS
     const chainAddresses = ADDRESSES[chain];
     const address = 'TokenManagerV1' in chainAddresses ? chainAddresses.TokenManagerV1 : undefined;
     if (!address) {
         throw new Error(`TokenManager V1 not deployed on ${chain}`);
     }
-    return new Contract(address, TOKEN_MANAGER_ABI, provider);
+    return new Contract(address, TokenManager, provider);
 }
 /**
  * 创建 TokenManager V2 合约实例（只读）
  * 自动使用正确的代理合约地址
  */
 export function getTokenManagerV2(chain, rpcUrl) {
-    const provider = readOnlyProvider(rpcUrl);
+    const provider = new JsonRpcProvider(rpcUrl, undefined); // ✅ 禁用 ENS
     const chainAddresses = ADDRESSES[chain];
     const address = 'TokenManagerV2' in chainAddresses ? chainAddresses.TokenManagerV2 : undefined;
     if (!address) {
         throw new Error(`TokenManager V2 not deployed on ${chain}`);
     }
-    return new Contract(address, TOKEN_MANAGER2_ABI, provider);
+    return new Contract(address, TokenManager2, provider);
 }
 /**
  * 创建 TokenManagerHelper3 合约实例（只读）
  * 自动使用正确的代理合约地址
  */
 export function getTokenManagerHelper3(chain, rpcUrl) {
-    const provider = readOnlyProvider(rpcUrl);
+    const provider = new JsonRpcProvider(rpcUrl, undefined); // ✅ 禁用 ENS
     const address = ADDRESSES[chain].TokenManagerHelper3;
     if (!address) {
         throw new Error(`TokenManagerHelper3 not deployed on ${chain}`);
     }
-    return new Contract(address, TOKEN_MANAGER_HELPER3_ABI, provider);
+    return new Contract(address, TokenManagerHelper3, provider);
 }
 /**
  * 创建 TokenManager V1 合约实例（可写）
  * 自动使用正确的代理合约地址
  */
 export function getTokenManagerV1Writer(chain, rpcUrl, privateKey) {
-    const signer = writableProvider(rpcUrl, privateKey);
+    const provider = new JsonRpcProvider(rpcUrl, undefined); // ✅ 禁用 ENS
+    const signer = new Wallet(privateKey, provider);
     const chainAddresses = ADDRESSES[chain];
     const address = 'TokenManagerV1' in chainAddresses ? chainAddresses.TokenManagerV1 : undefined;
     if (!address) {
         throw new Error(`TokenManager V1 not deployed on ${chain}`);
     }
-    return new Contract(address, TOKEN_MANAGER_ABI, signer);
+    return new Contract(address, TokenManager, signer);
 }
 /**
  * 创建 TokenManager V2 合约实例（可写）
  * 自动使用正确的代理合约地址
  */
 export function getTokenManagerV2Writer(chain, rpcUrl, privateKey) {
-    const signer = writableProvider(rpcUrl, privateKey);
+    const provider = new JsonRpcProvider(rpcUrl, undefined); // ✅ 禁用 ENS
+    const signer = new Wallet(privateKey, provider);
     const chainAddresses = ADDRESSES[chain];
     const address = 'TokenManagerV2' in chainAddresses ? chainAddresses.TokenManagerV2 : undefined;
     if (!address) {
         throw new Error(`TokenManager V2 not deployed on ${chain}`);
     }
-    return new Contract(address, TOKEN_MANAGER2_ABI, signer);
+    return new Contract(address, TokenManager2, signer);
 }
 /**
  * 创建 TokenManagerHelper3 合约实例（可写）
  * 自动使用正确的代理合约地址
  */
 export function getTokenManagerHelper3Writer(chain, rpcUrl, privateKey) {
-    const signer = writableProvider(rpcUrl, privateKey);
+    const provider = new JsonRpcProvider(rpcUrl, undefined); // ✅ 禁用 ENS
+    const signer = new Wallet(privateKey, provider);
     const address = ADDRESSES[chain].TokenManagerHelper3;
     if (!address) {
         throw new Error(`TokenManagerHelper3 not deployed on ${chain}`);
     }
-    return new Contract(address, TOKEN_MANAGER_HELPER3_ABI, signer);
+    return new Contract(address, TokenManagerHelper3, signer);
 }
 /**
  * 获取链上 TokenManager 的代理合约地址

package/dist/utils/erc20.d.ts

@@ -1,31 +1,44 @@
 import { JsonRpcProvider } from 'ethers';
-import type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult } from './types/erc20.js';
-export type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult, } from './types/erc20.js';
-type SellApprovalChain = 'BSC' | 'BASE' | 'ARBITRUM_ONE';
+import { NonceManager } from './bundle-helpers.js';
+export type EnsureAllowanceResult = {
+    alreadyApproved: boolean;
+    currentAllowance: bigint;
+    requiredAllowance: bigint;
+    txReceipt?: any;
+};
+export type EnsureAllowanceBatchItemResult = EnsureAllowanceResult & {
+    owner: string;
+};
 /**
  * 检查代币授权状态 - Four.meme V1（只读，不发送交易）
+ * @returns 是否已授权足够的额度
  */
-export declare function checkSellApprovalV1(chain: SellApprovalChain, rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
+export declare function checkSellApprovalV1(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
     isApproved: boolean;
     currentAllowance: bigint;
     requiredAllowance: bigint;
 }>;
 /**
  * 确保代币已授权给 Four.meme V1 代理合约
+ * 用于 Four.meme V1 代币的卖出操作
+ * @returns 授权结果，包含是否已授权、当前额度、交易回执等信息
  */
-export declare function ensureSellApprovalV1(chain: SellApprovalChain, rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
+export declare function ensureSellApprovalV1(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
 /**
  * 检查代币授权状态 - Four.meme V2（只读，不发送交易）
+ * @returns 是否已授权足够的额度
  */
-export declare function checkSellApprovalV2(chain: SellApprovalChain, rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
+export declare function checkSellApprovalV2(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
     isApproved: boolean;
     currentAllowance: bigint;
     requiredAllowance: bigint;
 }>;
 /**
  * 确保代币已授权给 Four.meme V2 代理合约
+ * 用于 Four.meme V2 代币的卖出操作
+ * @returns 授权结果，包含是否已授权、当前额度、交易回执等信息
  */
-export declare function ensureSellApprovalV2(chain: SellApprovalChain, rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
+export declare function ensureSellApprovalV2(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
 /**
  * 检查代币授权状态 - Four.meme（通用，默认使用 V2）
  * @deprecated 建议使用明确版本的方法：checkSellApprovalV1 或 checkSellApprovalV2
@@ -148,6 +161,75 @@ export declare function checkAllowanceBatch(chain: 'BSC' | 'BASE' | 'XLAYER' | '
  * @returns 每个地址的授权额度数组
  */
 export declare function checkAllowanceBatchRaw(rpcUrl: string, tokenAddress: string, ownerAddresses: string[], spenderAddress: string): Promise<bigint[]>;
+export type ApproveTokenBatchParams = {
+    chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD';
+    platform: 'flap' | 'four' | 'pancake-v2' | 'pancake-v3';
+    rpcUrl: string;
+    privateKeys: string[];
+    tokenAddress: string;
+    amounts: (bigint | 'max')[];
+    /** 是否只签名不提交（默认 false，直接发送交易） */
+    signOnly?: boolean;
+    /** Gas Price（可选，单位 Gwei，signOnly=true 时生效） */
+    gasPriceGwei?: number;
+    /** Gas Limit（可选，默认 100000，signOnly=true 时生效） */
+    gasLimit?: number;
+    /** 链ID（可选，默认56=BSC，signOnly=true 时生效） */
+    chainId?: number;
+    /** 跳过合约地址验证（可选，用于某些特殊场景） */
+    skipValidation?: boolean;
+};
+export type ApproveTokenBatchRawParams = {
+    rpcUrl: string;
+    privateKeys: string[];
+    tokenAddress: string;
+    spenderAddress: string;
+    amounts: (bigint | 'max')[];
+    /** 是否只签名不提交（默认 false，直接发送交易） */
+    signOnly?: boolean;
+    /** Gas Price（可选，单位 Gwei，signOnly=true 时生效） */
+    gasPriceGwei?: number;
+    /** Gas Limit（可选，默认 100000，signOnly=true 时生效） */
+    gasLimit?: number;
+    /** 链ID（可选，默认56=BSC，signOnly=true 时生效） */
+    chainId?: number;
+    /** 外部 NonceManager（可选，用于同一钱包签多笔交易时共享 nonce 状态） */
+    nonceManager?: NonceManager;
+    /** 跳过合约地址验证（可选，用于某些特殊场景，如 RPC 返回异常时） */
+    skipValidation?: boolean;
+};
+/** signOnly=false 时的返回结果（直接发送交易） */
+export type ApproveTokenBatchResult = {
+    success: boolean;
+    approvedCount: number;
+    results: Array<{
+        owner: string;
+        alreadyApproved: boolean;
+        currentAllowance: bigint;
+        requiredAllowance: bigint;
+        txHash?: string;
+        error?: string;
+    }>;
+};
+/** signOnly=true 时的返回结果（仅签名） */
+export type ApproveTokenBatchSignResult = {
+    /** 需要授权的签名交易数组（已过滤掉已授权的钱包） */
+    signedTransactions: string[];
+    /** 详细结果 */
+    results: Array<{
+        owner: string;
+        /** 是否已授权（无需发送交易） */
+        alreadyApproved: boolean;
+        currentAllowance: bigint;
+        requiredAllowance: bigint;
+        /** 签名交易（仅当 alreadyApproved=false 时有值） */
+        signedTx?: string;
+    }>;
+    /** 需要授权的钱包数量 */
+    needApproveCount: number;
+    /** 已授权的钱包数量 */
+    alreadyApprovedCount: number;
+};
 /**
  * ✅ 智能路由：批量授权 ERC20 代币（自动选择 spender，自动检查，只在不足时才发送交易）
  *