four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/bundle/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Bundle 共享核心逻辑（Four / TM-Merkle / Flap Portal 共用）
+ */
+export { getErc20Decimals, getErc20DecimalsMerkle, generateHopWallets, normalizeAmounts, batchGetBalances, estimateErc20TransferGas, estimateMaxErc20TransferGas, calculateGasLimit, isNativeTokenAddress, type AmountLike, type BundleGasConfig, } from './internal.js';
+export { resolveChainName, createSignProvider, createSignWallet, resolveSignContext, normalizeItemsOrRecipientsAmounts, resolveProvidedHops, resolveHopCountInput, signBribeTransaction, type SignConfigInput, type HopItem, } from './sign-context-helpers.js';
+export { BUNDLE_ERRORS, ERRORS, getBundleErrorMessage, getErrorMessage } from './errors.js';
+export { getTxType, getGasPriceMultiplier, getBundleOptions, getGasPriceConfig, shouldExtractProfit, getProfitRateBps, getProfitRecipient, calculateProfit, calculateBatchProfit, getBribeAmount, type BundleGasConfigInput, type BundleMerkleConfigInput, } from './config-helpers.js';
+export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, type MerkleSubmitConfig, type SubmitBundleResult, type BlockRazorSubmitConfig, type BlockRazorSubmitResult, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult, } from './submit.js';

package/dist/bundle/index.js

@@ -0,0 +1,8 @@
+/**
+ * Bundle 共享核心逻辑（Four / TM-Merkle / Flap Portal 共用）
+ */
+export { getErc20Decimals, getErc20DecimalsMerkle, generateHopWallets, normalizeAmounts, batchGetBalances, estimateErc20TransferGas, estimateMaxErc20TransferGas, calculateGasLimit, isNativeTokenAddress, } from './internal.js';
+export { resolveChainName, createSignProvider, createSignWallet, resolveSignContext, normalizeItemsOrRecipientsAmounts, resolveProvidedHops, resolveHopCountInput, signBribeTransaction, } from './sign-context-helpers.js';
+export { BUNDLE_ERRORS, ERRORS, getBundleErrorMessage, getErrorMessage } from './errors.js';
+export { getTxType, getGasPriceMultiplier, getBundleOptions, getGasPriceConfig, shouldExtractProfit, getProfitRateBps, getProfitRecipient, calculateProfit, calculateBatchProfit, getBribeAmount, } from './config-helpers.js';
+export { submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, submitDirectToRpc, submitDirectToRpcSequential, submitDirectToRpcSequentialNoWait, submitDirectToRpcParallel, submitDirectToRpcSmart, } from './submit.js';

package/dist/bundle/internal.d.ts

@@ -0,0 +1,16 @@
+import { JsonRpcProvider } from 'ethers';
+import type { GeneratedWallet } from '../utils/wallet.js';
+import type { AmountLike, BundleGasConfig } from './types.js';
+export { getErc20Decimals, getErc20DecimalsMerkle } from '../core/erc20/decimals.js';
+/** 生成多跳中间钱包（地址 + 私钥） */
+export declare function generateHopWallets(recipientCount: number, hopCount: number | number[]): GeneratedWallet[][] | null;
+export declare function normalizeAmounts(recipients: string[], amount?: AmountLike, amounts?: AmountLike[]): string[];
+/**
+ * 批量获取余额（原生代币或 ERC20，优先 Multicall3）
+ */
+export declare function batchGetBalances(provider: JsonRpcProvider, addresses: string[], tokenAddress?: string, chainId?: number): Promise<bigint[]>;
+export declare function estimateErc20TransferGas(provider: JsonRpcProvider, tokenAddress: string, from: string, to: string, amount: bigint, bufferPercent?: number): Promise<bigint>;
+export declare function estimateMaxErc20TransferGas(provider: JsonRpcProvider, tokenAddress: string, from: string, recipients: string[], amounts: bigint[], bufferPercent?: number): Promise<bigint>;
+export declare function calculateGasLimit(config: BundleGasConfig, isNative: boolean, hasHops: boolean, hopCount?: number): bigint;
+export declare function isNativeTokenAddress(tokenAddress?: string): boolean;
+export type { AmountLike, BundleGasConfig } from './types.js';

package/dist/bundle/internal.js

@@ -0,0 +1,160 @@
+import { ethers, Wallet } from 'ethers';
+import { MULTICALL3_ABI, ERC20_BALANCE_ABI } from '../abis/common.js';
+import { CHAINS, GAS_LIMITS, getMulticall3Address } from '../core/constants/index.js';
+export { getErc20Decimals, getErc20DecimalsMerkle } from '../core/erc20/decimals.js';
+function mapAggregate3Results(results, decode, fallback) {
+    return results.map((result) => {
+        if (result.success && result.returnData && result.returnData !== '0x') {
+            try {
+                return decode(result.returnData);
+            }
+            catch {
+                return fallback;
+            }
+        }
+        return fallback;
+    });
+}
+/** 生成多跳中间钱包（地址 + 私钥） */
+export function generateHopWallets(recipientCount, hopCount) {
+    const hopCounts = Array.isArray(hopCount) ? hopCount : new Array(recipientCount).fill(hopCount);
+    if (hopCounts.every((h) => h <= 0))
+        return null;
+    const result = [];
+    for (let i = 0; i < recipientCount; i++) {
+        const chain = [];
+        for (let j = 0; j < hopCounts[i]; j++) {
+            const wallet = Wallet.createRandom();
+            chain.push({
+                address: wallet.address,
+                privateKey: wallet.privateKey,
+            });
+        }
+        result.push(chain);
+    }
+    return result;
+}
+export function normalizeAmounts(recipients, amount, amounts) {
+    if (amounts && amounts.length > 0) {
+        if (amounts.length !== recipients.length) {
+            throw new Error(`amounts length (${amounts.length}) must match recipients length (${recipients.length})`);
+        }
+        return amounts.map((a) => (typeof a === 'bigint' ? a.toString() : String(a)));
+    }
+    if (amount !== undefined && String(amount).trim().length > 0) {
+        return new Array(recipients.length).fill(typeof amount === 'bigint' ? amount.toString() : String(amount));
+    }
+    throw new Error('Either amount or amounts must be provided');
+}
+/**
+ * 批量获取余额（原生代币或 ERC20，优先 Multicall3）
+ */
+export async function batchGetBalances(provider, addresses, tokenAddress, chainId) {
+    if (addresses.length === 0)
+        return [];
+    const resolvedChainId = chainId ?? Number((await provider.getNetwork()).chainId);
+    const multicall3Address = getMulticall3Address(resolvedChainId);
+    const multicall = new ethers.Contract(multicall3Address, MULTICALL3_ABI, provider);
+    if (!tokenAddress) {
+        const multicallIface = new ethers.Interface(MULTICALL3_ABI);
+        const calls = addresses.map((addr) => ({
+            target: multicall3Address,
+            allowFailure: true,
+            callData: multicallIface.encodeFunctionData('getEthBalance', [addr]),
+        }));
+        try {
+            const results = await multicall.aggregate3(calls);
+            return mapAggregate3Results(results, (returnData) => {
+                const decoded = multicallIface.decodeFunctionResult('getEthBalance', returnData);
+                return decoded[0];
+            }, 0n);
+        }
+        catch {
+            return Promise.all(addresses.map((addr) => provider.getBalance(addr).catch(() => 0n)));
+        }
+    }
+    const iface = new ethers.Interface(ERC20_BALANCE_ABI);
+    const calls = addresses.map((addr) => ({
+        target: tokenAddress,
+        allowFailure: true,
+        callData: iface.encodeFunctionData('balanceOf', [addr]),
+    }));
+    try {
+        const results = await multicall.aggregate3(calls);
+        return mapAggregate3Results(results, (returnData) => {
+            return iface.decodeFunctionResult('balanceOf', returnData)[0];
+        }, 0n);
+    }
+    catch {
+        const fallbackCalls = addresses.map((addr) => provider
+            .call({ to: tokenAddress, data: iface.encodeFunctionData('balanceOf', [addr]) })
+            .then((raw) => iface.decodeFunctionResult('balanceOf', raw)[0])
+            .catch(() => 0n));
+        return Promise.all(fallbackCalls);
+    }
+}
+export async function estimateErc20TransferGas(provider, tokenAddress, from, to, amount, bufferPercent = 5) {
+    try {
+        const iface = new ethers.Interface(['function transfer(address,uint256) returns (bool)']);
+        const data = iface.encodeFunctionData('transfer', [to, amount]);
+        const estimatedGas = await provider.estimateGas({
+            from,
+            to: tokenAddress,
+            data,
+            value: 0n,
+        });
+        const buffer = (estimatedGas * BigInt(bufferPercent)) / 100n;
+        return estimatedGas + buffer;
+    }
+    catch {
+        return 52000n;
+    }
+}
+export async function estimateMaxErc20TransferGas(provider, tokenAddress, from, recipients, amounts, bufferPercent = 5) {
+    if (recipients.length === 0)
+        return 52000n;
+    const sampleIndices = [0];
+    if (recipients.length > 1)
+        sampleIndices.push(Math.min(1, recipients.length - 1));
+    if (recipients.length > 2)
+        sampleIndices.push(Math.min(2, recipients.length - 1));
+    if (recipients.length > 3)
+        sampleIndices.push(recipients.length - 1);
+    const uniqueIndices = [...new Set(sampleIndices)];
+    try {
+        const estimates = await Promise.all(uniqueIndices.map((i) => estimateErc20TransferGas(provider, tokenAddress, from, recipients[i], amounts[i], bufferPercent)));
+        return estimates.reduce((max, gas) => (gas > max ? gas : max), 0n);
+    }
+    catch {
+        return 52000n;
+    }
+}
+export function calculateGasLimit(config, isNative, hasHops, hopCount = 0) {
+    if (config.gasLimit !== undefined) {
+        return BigInt(config.gasLimit);
+    }
+    const isXLayer = config.chainId === CHAINS.XLAYER.chainId;
+    const baseGas = isNative
+        ? isXLayer
+            ? Number(GAS_LIMITS.XLAYER_NATIVE_TRANSFER)
+            : Number(GAS_LIMITS.NATIVE_TRANSFER)
+        : 46815;
+    if (hasHops && hopCount > 0) {
+        const multiplier = config.gasLimitMultiplier ?? 1.1;
+        return BigInt(Math.ceil(baseGas * multiplier));
+    }
+    const multiplier = config.gasLimitMultiplier ?? 1.1;
+    return BigInt(Math.ceil(baseGas * multiplier));
+}
+export function isNativeTokenAddress(tokenAddress) {
+    if (!tokenAddress)
+        return true;
+    const v = tokenAddress.trim().toLowerCase();
+    if (!v)
+        return true;
+    if (v === 'native')
+        return true;
+    if (v === '0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee')
+        return true;
+    return false;
+}

package/dist/bundle/sign-context-helpers.d.ts

@@ -0,0 +1,26 @@
+import { ethers, Wallet } from 'ethers';
+import { type BundleGasConfigInput } from './config-helpers.js';
+export type SignConfigInput = BundleGasConfigInput & {
+    rpcUrl: string;
+    chainId?: number;
+};
+export type HopItem = {
+    hopPrivateKeys?: string[];
+    hopCount?: number;
+};
+export type SignContext = {
+    chainIdNum: number;
+    provider: ethers.JsonRpcProvider;
+    mainWallet: Wallet;
+    txType: 0 | 2;
+};
+export declare function resolveChainName(chainIdNum: number): string;
+export declare function createSignProvider(rpcUrl: string, chainIdNum: number, chainName?: string): ethers.JsonRpcProvider;
+export declare function createSignWallet(fromPrivateKey: string, provider: ethers.JsonRpcProvider): Wallet;
+export declare function resolveSignContext(config: SignConfigInput, fromPrivateKey: string): SignContext;
+export declare function normalizeItemsOrRecipientsAmounts(recipients: string[], items: Array<{
+    amount: string | number | bigint;
+}> | undefined, amount: string | number | bigint | undefined, amounts: Array<string | number | bigint> | undefined, normalize: (recipients: string[], amount?: string | number | bigint, amounts?: Array<string | number | bigint>) => string[]): string[];
+export declare function resolveProvidedHops(recipientCount: number, hopPrivateKeys?: string[][], items?: HopItem[]): string[][] | null;
+export declare function resolveHopCountInput(recipientCount: number, hopCount: number | number[], items?: HopItem[]): number | number[];
+export declare function signBribeTransaction(wallet: Wallet, bribeAmount: bigint, nonce: number, gasPrice: bigint, chainIdNum: number, txType: 0 | 2): Promise<string>;

package/dist/bundle/sign-context-helpers.js

@@ -0,0 +1,63 @@
+import { ethers, Wallet } from 'ethers';
+import { BLOCKRAZOR_BUILDER_EOA, CHAINS, getChainName } from '../core/constants/index.js';
+import { getTxType } from './config-helpers.js';
+export function resolveChainName(chainIdNum) {
+    return getChainName(chainIdNum);
+}
+export function createSignProvider(rpcUrl, chainIdNum, chainName) {
+    return new ethers.JsonRpcProvider(rpcUrl, {
+        chainId: chainIdNum,
+        name: chainName ?? resolveChainName(chainIdNum),
+        ensAddress: undefined,
+    });
+}
+export function createSignWallet(fromPrivateKey, provider) {
+    return new Wallet(fromPrivateKey, provider);
+}
+export function resolveSignContext(config, fromPrivateKey) {
+    const chainIdNum = config.chainId ?? CHAINS.BSC.chainId;
+    const provider = createSignProvider(config.rpcUrl, chainIdNum);
+    return {
+        chainIdNum,
+        provider,
+        mainWallet: createSignWallet(fromPrivateKey, provider),
+        txType: getTxType(config),
+    };
+}
+export function normalizeItemsOrRecipientsAmounts(recipients, items, amount, amounts, normalize) {
+    if (items && items.length > 0) {
+        return items.map((it) => (typeof it.amount === 'bigint' ? it.amount.toString() : String(it.amount)));
+    }
+    return normalize(recipients, amount, amounts);
+}
+export function resolveProvidedHops(recipientCount, hopPrivateKeys, items) {
+    if (hopPrivateKeys && hopPrivateKeys.length > 0) {
+        if (hopPrivateKeys.length !== recipientCount) {
+            throw new Error(`hopPrivateKeys length (${hopPrivateKeys.length}) must match recipients length (${recipientCount})`);
+        }
+        return hopPrivateKeys.every((h) => h.length === 0) ? null : hopPrivateKeys;
+    }
+    if (items && items.length > 0) {
+        const hops = items.map((it) => it.hopPrivateKeys ?? []);
+        return hops.every((h) => h.length === 0) ? null : hops;
+    }
+    return null;
+}
+export function resolveHopCountInput(recipientCount, hopCount, items) {
+    if (items && items.length > 0) {
+        const baseArray = Array.isArray(hopCount) ? hopCount : new Array(recipientCount).fill(hopCount);
+        return items.map((it, i) => (typeof it.hopCount === 'number' ? it.hopCount : (baseArray[i] ?? 0)));
+    }
+    return hopCount;
+}
+export async function signBribeTransaction(wallet, bribeAmount, nonce, gasPrice, chainIdNum, txType) {
+    return wallet.signTransaction({
+        to: BLOCKRAZOR_BUILDER_EOA,
+        value: bribeAmount,
+        nonce,
+        gasPrice,
+        gasLimit: 21000n,
+        chainId: BigInt(chainIdNum),
+        type: txType,
+    });
+}

package/dist/{contracts/tm-bundle-merkle → bundle}/submit.d.ts

@@ -283,32 +283,11 @@ export declare function submitDirectToRpcSequentialNoWait(signedTransactions: st
  * @returns 广播结果
  */
 export declare function submitDirectToRpcParallel(signedTransactions: string[], config: DirectSubmitConfig): Promise<DirectSubmitResult>;
-export interface EniBundleSubmitConfig extends DirectSubmitConfig {
-    simulationTimeout?: number;
-    blockConfirmTimeout?: number;
-}
-export interface EniBundleSubmitResult extends DirectSubmitResult {
-    sameBlock: boolean;
-    blockNumber?: number;
-    blockNumbers?: number[];
-    simulationDurationMs?: number;
-    broadcastDurationMs?: number;
-}
-/**
- * ENI 快速并行广播：业务交易并行 + 利润交易顺序跟随
- *
- * 流程：
- *   1. 解码所有签名交易，识别哪些 from 地址有多笔交易（即含利润尾随交易的 payer）
- *   2. 把交易分为 "独立交易" 和 "依赖交易"（同 from 的第 2 笔及之后的交易）
- *   3. 并行广播所有独立交易（业务交易）
- *   4. 等待 payer 的业务交易上链后，再提交其利润交易（顺序跟随）
- *   5. 返回合并结果
- */
-export declare function submitEniParallelThenProfit(signedTransactions: string[], config: DirectSubmitConfig): Promise<DirectSubmitResult>;
 /**
- * ENI Bundle 提交：模拟验证 → 快速顺序广播 → 同块确认
- *
- * 复用同一 Provider 快速顺序广播，最小化延迟、最大化同块概率。
- * ENI 出块 ~1.08s，连续 nonce 快速提交同块率极高。
+ * 智能广播到 RPC（自动选择并行或顺序）
  */
-export declare function submitBundleToEni(signedTransactions: string[], config: EniBundleSubmitConfig): Promise<EniBundleSubmitResult>;
+export declare function submitDirectToRpcSmart(signedTransactions: string[], config: DirectSubmitConfig, options?: {
+    waitConfirmation?: boolean;
+}): Promise<DirectSubmitResult & {
+    mode: 'parallel' | 'sequential';
+}>;