four-flap-meme-sdk 2.0.0 → 2.1.0

package/dist/utils/erc20/index.d.ts

@@ -1,242 +0,0 @@
-import { JsonRpcProvider } from 'ethers';
-import type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult } from './types.js';
-export type { EnsureAllowanceResult, EnsureAllowanceBatchItemResult, ApproveTokenBatchParams, ApproveTokenBatchRawParams, ApproveTokenBatchResult, ApproveTokenBatchSignResult, } from './types.js';
-/**
- * 检查代币授权状态 - Four.meme V1（只读，不发送交易）
- * @returns 是否已授权足够的额度
- */
-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: '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: '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: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
-/**
- * 检查代币授权状态 - Four.meme（通用，默认使用 V2）
- * @deprecated 建议使用明确版本的方法：checkSellApprovalV1 或 checkSellApprovalV2
- */
-export declare function checkSellApproval(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
-    isApproved: boolean;
-    currentAllowance: bigint;
-    requiredAllowance: bigint;
-}>;
-/**
- * 确保代币已授权给 Four.meme 代理合约（通用，默认使用 V2）
- * @deprecated 建议使用明确版本的方法：ensureSellApprovalV1 或 ensureSellApprovalV2
- */
-export declare function ensureSellApproval(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
-/**
- * 检查代币授权状态 - Flap Protocol（只读，不发送交易）
- * @returns 是否已授权足够的额度
- */
-export declare function checkFlapSellApproval(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', rpcUrl: string, token: string, owner: string, amount: bigint): Promise<{
-    isApproved: boolean;
-    currentAllowance: bigint;
-    requiredAllowance: bigint;
-}>;
-/**
- * 确保代币已授权给 Flap Protocol 代理合约
- * 用于 Flap Protocol 代币的卖出操作
- * @returns 授权结果，包含是否已授权、当前额度、交易回执等信息
- */
-export declare function ensureFlapSellApproval(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', rpcUrl: string, privateKey: string, token: string, owner: string, amount: bigint): Promise<EnsureAllowanceResult>;
-/**
- * 批量确保代币已授权给 Flap Protocol 代理合约（默认授权上限 2^256-1）
- * @param privateKeys 拥有者私钥数组（每个地址需自行签名）
- * @returns 每个地址的授权结果（包含 owner 与交易回执等信息）
- */
-export declare function ensureFlapSellApprovalBatch(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', rpcUrl: string, privateKeys: string[], token: string, required?: bigint): Promise<EnsureAllowanceBatchItemResult[]>;
-/**
- * 批量检查 Flap Protocol 授权状态（默认按上限 2^256-1 判断）
- * ✅ 使用 Multicall3 批量查询，减少 RPC 调用次数
- */
-export declare function checkFlapSellApprovalBatch(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', rpcUrl: string, token: string, owners: string[], required?: bigint): Promise<Array<{
-    owner: string;
-    isApproved: boolean;
-    currentAllowance: bigint;
-    requiredAllowance: bigint;
-}>>;
-/**
- * 使用 Multicall3 批量查询 ERC20 授权额度
- * @param provider - Provider 实例
- * @param tokenAddress - ERC20 代币地址
- * @param owners - 所有者地址数组
- * @param spender - 被授权的 spender 地址
- * @returns 每个地址的授权额度数组
- */
-export declare function batchCheckAllowances(provider: JsonRpcProvider, tokenAddress: string, owners: string[], spender: string): Promise<bigint[]>;
-/**
- * ✅ 智能路由：检查单个 ERC20 授权额度（自动选择 spender）
- *
- * @param chain - 链名称 ('BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD')
- * @param platform - 平台名称 ('flap' | 'four' | 'pancake-v2' | 'pancake-v3')
- * @param rpcUrl - RPC 节点地址
- * @param tokenAddress - 代币合约地址
- * @param ownerAddress - 代币持有者地址
- * @returns 当前授权额度（bigint）
- */
-export declare function checkAllowance(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', platform: 'flap' | 'four' | 'pancake-v2' | 'pancake-v3', rpcUrl: string, tokenAddress: string, ownerAddress: string): Promise<bigint>;
-/**
- * ✅ 底层方法：检查 ERC20 代币授权额度（手动指定 spender）
- * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
- *
- * @param rpcUrl - RPC 节点地址
- * @param tokenAddress - 代币合约地址
- * @param ownerAddress - 代币持有者地址
- * @param spenderAddress - 被授权的合约地址（如 Router、Portal、TokenManager 等）
- * @returns 当前授权额度（bigint）
- */
-export declare function checkAllowanceRaw(rpcUrl: string, tokenAddress: string, ownerAddress: string, spenderAddress: string): Promise<bigint>;
-/**
- * ✅ 智能路由：授权 ERC20 代币（自动选择 spender，自动检查，只在不足时才发送交易）
- *
- * @param chain - 链名称 ('BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD')
- * @param platform - 平台名称 ('flap' | 'four' | 'pancake-v2' | 'pancake-v3')
- * @param rpcUrl - RPC 节点地址
- * @param privateKey - 私钥
- * @param tokenAddress - 代币合约地址
- * @param amount - 授权数量（bigint），传 'max' 表示最大授权
- * @returns 授权结果
- */
-export declare function approveToken(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', platform: 'flap' | 'four' | 'pancake-v2' | 'pancake-v3', rpcUrl: string, privateKey: string, tokenAddress: string, amount: bigint | 'max'): Promise<EnsureAllowanceResult>;
-/**
- * ✅ 底层方法：授权 ERC20 代币给指定合约（手动指定 spender）
- * 适用于任意 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 approveTokenRaw(rpcUrl: string, privateKey: string, tokenAddress: string, spenderAddress: string, amount: bigint | 'max'): Promise<EnsureAllowanceResult>;
-/**
- * ✅ 智能路由：批量检查多个钱包的授权额度（自动选择 spender）
- *
- * @param chain - 链名称 ('BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD')
- * @param platform - 平台名称 ('flap' | 'four' | 'pancake-v2' | 'pancake-v3')
- * @param rpcUrl - RPC 节点地址
- * @param tokenAddress - 代币合约地址
- * @param ownerAddresses - 代币持有者地址数组
- * @returns 每个地址的授权额度数组
- */
-export declare function checkAllowanceBatch(chain: 'BSC' | 'BASE' | 'XLAYER' | 'MORPH' | 'MONAD', platform: 'flap' | 'four' | 'pancake-v2' | 'pancake-v3', rpcUrl: string, tokenAddress: string, ownerAddresses: string[]): Promise<bigint[]>;
-/**
- * ✅ 底层方法：批量检查多个钱包的授权额度（手动指定 spender）
- * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
- *
- * @param rpcUrl - RPC 节点地址
- * @param tokenAddress - 代币合约地址
- * @param ownerAddresses - 代币持有者地址数组
- * @param spenderAddress - 被授权的合约地址
- * @returns 每个地址的授权额度数组
- */
-export declare function checkAllowanceBatchRaw(rpcUrl: string, tokenAddress: string, ownerAddresses: string[], spenderAddress: string): Promise<bigint[]>;
-/** signOnly=false 时的返回结果（直接发送交易） */
-/** signOnly=true 时的返回结果（仅签名） */
-/**
- * ✅ 智能路由：批量授权 ERC20 代币（自动选择 spender，自动检查，只在不足时才发送交易）
- *
- * @param params - 批量授权参数
- * @param params.signOnly - 是否只签名不提交（默认 false）
- *   - false: 直接发送交易并等待确认，返回 ApproveTokenBatchResult
- *   - true: 只签名不提交，返回 ApproveTokenBatchSignResult，前端可通过 submitBundleToBlockRazor 提交
- * @returns 批量授权结果
- *
- * @example
- * ```typescript
- * // 模式1：直接发送交易（默认）
- * const result = await approveTokenBatch({
- *   chain: 'BSC',
- *   platform: 'four',
- *   rpcUrl: 'https://bsc-dataseed.binance.org',
- *   privateKeys: [key1, key2],
- *   tokenAddress: '0x...',
- *   amounts: ['max', 'max']
- * });
- *
- * // 模式2：只签名，前端提交
- * const signResult = await approveTokenBatch({
- *   chain: 'BSC',
- *   platform: 'four',
- *   rpcUrl: 'https://bsc-dataseed.binance.org',
- *   privateKeys: [key1, key2],
- *   tokenAddress: '0x...',
- *   amounts: ['max', 'max'],
- *   signOnly: true
- * });
- * // 提交到 BlockRazor
- * if (signResult.signedTransactions.length > 0) {
- *   await submitBundleToBlockRazor(signResult.signedTransactions, { blockOffset: 10 });
- * }
- * ```
- */
-export declare function approveTokenBatch(params: ApproveTokenBatchParams & {
-    signOnly: true;
-}): Promise<ApproveTokenBatchSignResult>;
-export declare function approveTokenBatch(params: ApproveTokenBatchParams & {
-    signOnly?: false;
-}): Promise<ApproveTokenBatchResult>;
-/**
- * ✅ 底层方法：批量授权 ERC20 代币（手动指定 spender）
- * 适用于任意 spender 地址（Flap、Four、PancakeSwap V2/V3 等）
- *
- * @param params - 批量授权参数
- * @param params.signOnly - 是否只签名不提交（默认 false）
- *   - false: 直接发送交易并等待确认，返回 ApproveTokenBatchResult
- *   - true: 只签名不提交，返回 ApproveTokenBatchSignResult，前端可通过 submitBundleToBlockRazor 提交
- * @returns 批量授权结果
- *
- * @example
- * ```typescript
- * // 模式1：直接发送交易（默认）
- * const result = await approveTokenBatchRaw({
- *   rpcUrl: 'https://bsc-dataseed.binance.org',
- *   privateKeys: [key1, key2],
- *   tokenAddress: '0x...',
- *   spenderAddress: '0x...',
- *   amounts: ['max', 'max']
- * });
- *
- * // 模式2：只签名，前端提交
- * const signResult = await approveTokenBatchRaw({
- *   rpcUrl: 'https://bsc-dataseed.binance.org',
- *   privateKeys: [key1, key2],
- *   tokenAddress: '0x...',
- *   spenderAddress: '0x...',
- *   amounts: ['max', 'max'],
- *   signOnly: true
- * });
- * // 提交到 BlockRazor
- * if (signResult.signedTransactions.length > 0) {
- *   await submitBundleToBlockRazor(signResult.signedTransactions, { blockOffset: 10 });
- * }
- * ```
- */
-export declare function approveTokenBatchRaw(params: ApproveTokenBatchRawParams & {
-    signOnly: true;
-}): Promise<ApproveTokenBatchSignResult>;
-export declare function approveTokenBatchRaw(params: ApproveTokenBatchRawParams & {
-    signOnly?: false;
-}): Promise<ApproveTokenBatchResult>;