four-flap-meme-sdk 1.9.49 → 2.0.0

package/dist/utils/constants.js

@@ -1,84 +1,9 @@
 /**
- * 公共常量 - 向后兼容层
+ * 公共常量 - 向后兼容 re-export 层
  *
- * ⚠️ 此文件为向后兼容保留，新代码请使用 shared/constants
+ * 新代码请直接使用 `shared/constants`：
+ * `import { CHAINS, ADDRESSES, getProfitRateBps } from '../shared/constants/index.js'`
  *
- * 推荐用法：
- * import { CHAINS, GAS_LIMITS, ADDRESSES } from '../shared/constants';
+ * v2：不再导出 `CHAIN` / `DEFAULT_DEADLINE_MINUTES` / `PROFIT_CONFIG` / 报价 `V3_FEE_TIERS`。
  */
-// ============================================================================
-// 从 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,
-};
+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';

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

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

package/dist/utils/contract-factory.js

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

package/dist/utils/erc20-types.d.ts

@@ -0,0 +1 @@
+export type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult, } from '../shared/foundation/types/erc20.js';

package/dist/utils/erc20-types.js

@@ -0,0 +1 @@
+export {};

package/dist/utils/erc20.d.ts

@@ -1,44 +1,31 @@
-import { JsonRpcProvider, type TransactionReceipt } from 'ethers';
-import { NonceManager } from './bundle-helpers.js';
-export type EnsureAllowanceResult = {
-    alreadyApproved: boolean;
-    currentAllowance: bigint;
-    requiredAllowance: bigint;
-    txReceipt?: TransactionReceipt | null;
-};
-export type EnsureAllowanceBatchItemResult = EnsureAllowanceResult & {
-    owner: string;
-};
+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';
 /**
  * 检查代币授权状态 - Four.meme V1（只读，不发送交易）
- * @returns 是否已授权足够的额度
  */
-export declare function checkSellApprovalV1(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
+export declare function checkSellApprovalV1(chain: SellApprovalChain, 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: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
+export declare function ensureSellApprovalV1(chain: SellApprovalChain, rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
 /**
  * 检查代币授权状态 - Four.meme V2（只读，不发送交易）
- * @returns 是否已授权足够的额度
  */
-export declare function checkSellApprovalV2(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
+export declare function checkSellApprovalV2(chain: SellApprovalChain, 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: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
+export declare function ensureSellApprovalV2(chain: SellApprovalChain, rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
 /**
  * 检查代币授权状态 - Four.meme（通用，默认使用 V2）
  * @deprecated 建议使用明确版本的方法：checkSellApprovalV1 或 checkSellApprovalV2
@@ -161,75 +148,6 @@ 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，自动检查，只在不足时才发送交易）
  *