four-flap-meme-sdk 1.2.52 → 1.2.54

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 export * as Abis from './abis/index.js';
 export { ADDRESSES, CHAIN } from './utils/constants.js';
 export { isExclusiveOnChain, isExclusiveOffChain } from './utils/mpcExclusive.js';
-export { ensureSellApprovalV1, checkSellApprovalV1, ensureSellApprovalV2, checkSellApprovalV2, ensureSellApproval, checkSellApproval, ensureFlapSellApproval, checkFlapSellApproval, ensureFlapSellApprovalBatch, checkFlapSellApprovalBatch, type EnsureAllowanceBatchItemResult } from './utils/erc20.js';
+export { ensureSellApprovalV1, checkSellApprovalV1, ensureSellApprovalV2, checkSellApprovalV2, ensureSellApproval, checkSellApproval, ensureFlapSellApproval, checkFlapSellApproval, ensureFlapSellApprovalBatch, checkFlapSellApprovalBatch, checkAllowance, approveToken, checkAllowanceBatch, approveTokenBatch, type EnsureAllowanceBatchItemResult, type ApproveTokenBatchParams, type ApproveTokenBatchResult } from './utils/erc20.js';
 export { parseFourError, type FourErrorCode } from './utils/errors.js';
 export { getTokenManagerV1, getTokenManagerV2, getTokenManagerHelper3, getTokenManagerV1Writer, getTokenManagerV2Writer, getTokenManagerHelper3Writer, getTokenManagerAddress, type ChainName } from './utils/contract-factory.js';
 export { FourClient, buildLoginMessage, type FourConfig, type GenerateNonceReq, type LoginReq, type CreateTokenReq, type CreateTokenResp } from './clients/four.js';

package/dist/index.js

@@ -9,7 +9,9 @@ ensureSellApprovalV2, checkSellApprovalV2,
 // Four.meme 通用授权（默认 V2）
 ensureSellApproval, checkSellApproval, 
 // Flap Protocol 授权
-ensureFlapSellApproval, checkFlapSellApproval, ensureFlapSellApprovalBatch, checkFlapSellApprovalBatch } from './utils/erc20.js';
+ensureFlapSellApproval, checkFlapSellApproval, ensureFlapSellApprovalBatch, checkFlapSellApprovalBatch, 
+// ✅ 通用授权方法（适用于 Flap、Four、V2、V3 等所有场景）
+checkAllowance, approveToken, checkAllowanceBatch, approveTokenBatch } from './utils/erc20.js';
 export { parseFourError } from './utils/errors.js';
 export { getTokenManagerV1, getTokenManagerV2, getTokenManagerHelper3, getTokenManagerV1Writer, getTokenManagerV2Writer, getTokenManagerHelper3Writer, getTokenManagerAddress } from './utils/contract-factory.js';
 export { FourClient, buildLoginMessage } from './clients/four.js';

package/dist/utils/erc20.d.ts

@@ -91,3 +91,64 @@ export declare function checkFlapSellApprovalBatch(chain: 'BSC' | 'BASE' | 'XLAY
  * @returns 每个地址的授权额度数组
  */
 export declare function batchCheckAllowances(provider: JsonRpcProvider, tokenAddress: string, owners: string[], spender: string): Promise<bigint[]>;
+/**
+ * ✅ 通用方法：检查 ERC20 代币授权额度（只读，不发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param rpcUrl - RPC 节点地址
+ * @param tokenAddress - 代币合约地址
+ * @param ownerAddress - 代币持有者地址
+ * @param spenderAddress - 被授权的合约地址（如 Router、Portal、TokenManager 等）
+ * @returns 当前授权额度（bigint）
+ */
+export declare function checkAllowance(rpcUrl: string, tokenAddress: string, ownerAddress: string, spenderAddress: string): Promise<bigint>;
+/**
+ * ✅ 通用方法：授权 ERC20 代币给指定合约（自动检查，只在不足时才发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param rpcUrl - RPC 节点地址
+ * @param privateKey - 私钥
+ * @param tokenAddress - 代币合约地址
+ * @param spenderAddress - 被授权的合约地址（如 Router、Portal、TokenManager 等）
+ * @param amount - 授权数量（bigint），传 'max' 或 ethers.MaxUint256 表示最大授权
+ * @returns 授权结果
+ */
+export declare function approveToken(rpcUrl: string, privateKey: string, tokenAddress: string, spenderAddress: string, amount: bigint | 'max'): Promise<EnsureAllowanceResult>;
+/**
+ * ✅ 通用方法：批量检查多个钱包的授权额度（只读，不发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param rpcUrl - RPC 节点地址
+ * @param tokenAddress - 代币合约地址
+ * @param ownerAddresses - 代币持有者地址数组
+ * @param spenderAddress - 被授权的合约地址
+ * @returns 每个地址的授权额度数组
+ */
+export declare function checkAllowanceBatch(rpcUrl: string, tokenAddress: string, ownerAddresses: string[], spenderAddress: string): Promise<bigint[]>;
+export type ApproveTokenBatchParams = {
+    rpcUrl: string;
+    privateKeys: string[];
+    tokenAddress: string;
+    spenderAddress: string;
+    amounts: (bigint | 'max')[];
+};
+export type ApproveTokenBatchResult = {
+    success: boolean;
+    approvedCount: number;
+    results: Array<{
+        owner: string;
+        alreadyApproved: boolean;
+        currentAllowance: bigint;
+        requiredAllowance: bigint;
+        txHash?: string;
+        error?: string;
+    }>;
+};
+/**
+ * ✅ 通用方法：批量授权 ERC20 代币（自动检查，只在不足时才发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param params - 批量授权参数
+ * @returns 批量授权结果
+ */
+export declare function approveTokenBatch(params: ApproveTokenBatchParams): Promise<ApproveTokenBatchResult>;

package/dist/utils/erc20.js

@@ -205,7 +205,7 @@ export async function ensureFlapSellApproval(chain, rpcUrl, privateKey, token, o
  * @param privateKeys 拥有者私钥数组（每个地址需自行签名）
  * @returns 每个地址的授权结果（包含 owner 与交易回执等信息）
  */
-export async function ensureFlapSellApprovalBatch(chain, rpcUrl, privateKeys, token, required = ((1n << 256n) - 1n)) {
+export async function ensureFlapSellApprovalBatch(chain, rpcUrl, privateKeys, token, required = BigInt('0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff')) {
     const results = [];
     for (const pk of privateKeys || []) {
         const owner = new Wallet(pk).address;
@@ -217,7 +217,7 @@ export async function ensureFlapSellApprovalBatch(chain, rpcUrl, privateKeys, to
 /**
  * 批量检查 Flap Protocol 授权状态（默认按上限 2^256-1 判断）
  */
-export async function checkFlapSellApprovalBatch(chain, rpcUrl, token, owners, required = ((1n << 256n) - 1n)) {
+export async function checkFlapSellApprovalBatch(chain, rpcUrl, token, owners, required = BigInt('0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff')) {
     const proxyAddresses = {
         BSC: ADDRESSES.BSC.FlapPortal,
         BASE: ADDRESSES.BASE.FlapPortal,
@@ -279,3 +279,160 @@ export async function batchCheckAllowances(provider, tokenAddress, owners, spend
         }
     });
 }
+/**
+ * ✅ 通用方法：检查 ERC20 代币授权额度（只读，不发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param rpcUrl - RPC 节点地址
+ * @param tokenAddress - 代币合约地址
+ * @param ownerAddress - 代币持有者地址
+ * @param spenderAddress - 被授权的合约地址（如 Router、Portal、TokenManager 等）
+ * @returns 当前授权额度（bigint）
+ */
+export async function checkAllowance(rpcUrl, tokenAddress, ownerAddress, spenderAddress) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    // 验证地址
+    await validateContractAddress(provider, tokenAddress, 'Token');
+    await validateContractAddress(provider, spenderAddress, 'Spender');
+    const erc20 = new Contract(tokenAddress, ERC20_ABI, provider);
+    try {
+        const allowance = await erc20.allowance(ownerAddress, spenderAddress);
+        return allowance;
+    }
+    catch (error) {
+        throw new Error(`❌ 查询授权额度失败: ${error.message}`);
+    }
+}
+/**
+ * ✅ 通用方法：授权 ERC20 代币给指定合约（自动检查，只在不足时才发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param rpcUrl - RPC 节点地址
+ * @param privateKey - 私钥
+ * @param tokenAddress - 代币合约地址
+ * @param spenderAddress - 被授权的合约地址（如 Router、Portal、TokenManager 等）
+ * @param amount - 授权数量（bigint），传 'max' 或 ethers.MaxUint256 表示最大授权
+ * @returns 授权结果
+ */
+export async function approveToken(rpcUrl, privateKey, tokenAddress, spenderAddress, amount) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    const signer = new Wallet(privateKey, provider);
+    const ownerAddress = signer.address;
+    // 验证地址
+    await validateContractAddress(provider, tokenAddress, 'Token');
+    await validateContractAddress(provider, spenderAddress, 'Spender');
+    const erc20 = new Contract(tokenAddress, ERC20_ABI, signer);
+    const requiredAmount = amount === 'max' ? BigInt('0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff') : amount;
+    // 检查当前授权额度
+    let currentAllowance;
+    try {
+        currentAllowance = await erc20.allowance(ownerAddress, spenderAddress);
+    }
+    catch (error) {
+        throw new Error(`❌ 查询授权额度失败: ${error.message}`);
+    }
+    // 如果已经授权足够，直接返回
+    if (currentAllowance >= requiredAmount) {
+        return {
+            alreadyApproved: true,
+            currentAllowance,
+            requiredAllowance: requiredAmount
+        };
+    }
+    // 发送授权交易
+    try {
+        const tx = await erc20.approve(spenderAddress, requiredAmount);
+        const receipt = await tx.wait();
+        return {
+            alreadyApproved: false,
+            currentAllowance,
+            requiredAllowance: requiredAmount,
+            txReceipt: receipt
+        };
+    }
+    catch (error) {
+        throw new Error(`❌ 授权交易失败: ${error.message}`);
+    }
+}
+/**
+ * ✅ 通用方法：批量检查多个钱包的授权额度（只读，不发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param rpcUrl - RPC 节点地址
+ * @param tokenAddress - 代币合约地址
+ * @param ownerAddresses - 代币持有者地址数组
+ * @param spenderAddress - 被授权的合约地址
+ * @returns 每个地址的授权额度数组
+ */
+export async function checkAllowanceBatch(rpcUrl, tokenAddress, ownerAddresses, spenderAddress) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    // 验证地址
+    await validateContractAddress(provider, tokenAddress, 'Token');
+    await validateContractAddress(provider, spenderAddress, 'Spender');
+    return batchCheckAllowances(provider, tokenAddress, ownerAddresses, spenderAddress);
+}
+/**
+ * ✅ 通用方法：批量授权 ERC20 代币（自动检查，只在不足时才发送交易）
+ * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
+ *
+ * @param params - 批量授权参数
+ * @returns 批量授权结果
+ */
+export async function approveTokenBatch(params) {
+    const { rpcUrl, privateKeys, tokenAddress, spenderAddress, amounts } = params;
+    if (privateKeys.length === 0 || amounts.length !== privateKeys.length) {
+        throw new Error('❌ 私钥数量和授权数量必须匹配');
+    }
+    const provider = new JsonRpcProvider(rpcUrl);
+    // 验证地址
+    await validateContractAddress(provider, tokenAddress, 'Token');
+    await validateContractAddress(provider, spenderAddress, 'Spender');
+    const results = [];
+    let approvedCount = 0;
+    for (let i = 0; i < privateKeys.length; i++) {
+        const signer = new Wallet(privateKeys[i], provider);
+        const ownerAddress = signer.address;
+        const requiredAmount = amounts[i] === 'max'
+            ? BigInt('0xffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff')
+            : amounts[i];
+        try {
+            const erc20 = new Contract(tokenAddress, ERC20_ABI, signer);
+            // 检查当前授权
+            const currentAllowance = await erc20.allowance(ownerAddress, spenderAddress);
+            if (currentAllowance >= requiredAmount) {
+                results.push({
+                    owner: ownerAddress,
+                    alreadyApproved: true,
+                    currentAllowance,
+                    requiredAllowance: requiredAmount
+                });
+                continue;
+            }
+            // 发送授权交易
+            const tx = await erc20.approve(spenderAddress, requiredAmount);
+            const receipt = await tx.wait();
+            results.push({
+                owner: ownerAddress,
+                alreadyApproved: false,
+                currentAllowance,
+                requiredAllowance: requiredAmount,
+                txHash: receipt.hash
+            });
+            approvedCount++;
+        }
+        catch (error) {
+            results.push({
+                owner: ownerAddress,
+                alreadyApproved: false,
+                currentAllowance: 0n,
+                requiredAllowance: requiredAmount,
+                error: error.message
+            });
+        }
+    }
+    return {
+        success: approvedCount > 0,
+        approvedCount,
+        results
+    };
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "four-flap-meme-sdk",
-  "version": "1.2.52",
+  "version": "1.2.54",
   "description": "SDK for Flap bonding curve and four.meme TokenManager",
   "type": "module",
   "main": "dist/index.js",