four-flap-meme-sdk 1.6.7 → 1.6.9

package/dist/index.d.ts

@@ -54,4 +54,4 @@ submitDirectToRpcSequentialNoWait, // ✅ 顺序广播但不等待确认（用
 submitDirectToRpcParallel, type DirectSubmitConfig, type DirectSubmitResult, type DirectTxResult } from './contracts/tm-bundle-merkle/submit.js';
 export { directV2BatchBuy, directV2BatchSell, directV3BatchBuy, directV3BatchSell, getRouterAddress, DIRECT_ROUTERS, type DirectV2BuyParams, type DirectV2SellParams, type DirectV3BuyParams, type DirectV3SellParams, type DirectRouterResult, type DirectRouterSignConfig, type DexKey, type RouterVersion, } from './dex/index.js';
 export * as XLayer from './xlayer/index.js';
-export { bundleBuy as xlayerBundleBuy, bundleSell as xlayerBundleSell, bundleBuySell as xlayerBundleBuySell, bundleCreateBuySign as xlayerBundleCreateBuySign, bundleCreateToDexSign as xlayerBundleCreateToDexSign, bundleGraduateBuy as xlayerBundleGraduateBuy, bundleSwapSign as xlayerBundleSwapSign, bundleBatchSwapSign as xlayerBundleBatchSwapSign, createBundleExecutor as xlayerCreateBundleExecutor, BundleExecutor as XLayerBundleExecutor, makeVolume as xlayerMakeVolume, singleRoundVolume as xlayerSingleRoundVolume, createVolumeExecutor as xlayerCreateVolumeExecutor, VolumeExecutor as XLayerVolumeExecutor, makeBuyFirstVolume as xlayerMakeBuyFirstVolume, BuyFirstVolumeExecutor as XLayerBuyFirstVolumeExecutor, AAPortalBuyFirstExecutor as XLayerAAPortalBuyFirstExecutor, AADexBuyFirstExecutor as XLayerAADexBuyFirstExecutor, AAVolumeBuyFirstExecutor as XLayerAAVolumeBuyFirstExecutor, createAAVolumeBuyFirstExecutor as xlayerCreateAAVolumeBuyFirstExecutor, type VolumeBuyFirstParams as XLayerVolumeBuyFirstParams, type VolumeBuyFirstResult as XLayerVolumeBuyFirstResult, type VolumeContinuousParams as XLayerVolumeContinuousParams, type VolumeContinuousResult as XLayerVolumeContinuousResult, type VolumeProgress as XLayerVolumeProgress, createDexExecutor as xlayerCreateDexExecutor, createDexQuery as xlayerCreateDexQuery, quoteOkbToToken as xlayerQuoteOkbToToken, quoteTokenToOkb as xlayerQuoteTokenToOkb, DexExecutor as XLayerDexExecutor, DexQuery as XLayerDexQuery, buildDexBatchBuyOps, buildDexBatchBuyOpsV3, type DexBatchBuyParams, type DexBatchBuyV3Params, type DexBatchBuyResult, buildDexBatchSellOps, buildDexBatchSellOpsV3, type DexBatchSellParams, type DexBatchSellV3Params, type DexBatchSellResult, createAAAccountManager as xlayerCreateAAAccountManager, predictSender as xlayerPredictSender, createWallet as xlayerCreateWallet, AAAccountManager as XLayerAAAccountManager, generateAAWallets as xlayerGenerateAAWallets, generateAAWalletsFromMnemonic as xlayerGenerateAAWalletsFromMnemonic, predictSendersFromPrivateKeys as xlayerPredictSendersFromPrivateKeys, createBundlerClient as xlayerCreateBundlerClient, BundlerClient as XLayerBundlerClient, createPortalQuery as xlayerCreatePortalQuery, PortalQuery as XLayerPortalQuery, encodeBuyCall as xlayerEncodeBuyCall, encodeSellCall as xlayerEncodeSellCall, encodeApproveCall as xlayerEncodeApproveCall, parseOkb as xlayerParseOkb, formatOkb as xlayerFormatOkb, XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, type XLayerConfig, type BundleBuyParams as XLayerBundleBuyParams, type BundleSellParams as XLayerBundleSellParams, type BundleBuySellParams as XLayerBundleBuySellParams, type BundleSwapParams as XLayerBundleSwapParams, type BundleSwapSignParams as XLayerBundleSwapSignParams, type BundleBatchSwapParams as XLayerBundleBatchSwapParams, type BundleBatchSwapSignParams as XLayerBundleBatchSwapSignParams, type VolumeParams as XLayerVolumeParams, type BundleBuyResult as XLayerBundleBuyResult, type BundleSellResult as XLayerBundleSellResult, type BundleBuySellResult as XLayerBundleBuySellResult, type BundleCreateBuySignParams as XLayerBundleCreateBuySignParams, type BundleCreateBuySignResult as XLayerBundleCreateBuySignResult, type BundleCreateToDexSignParams as XLayerBundleCreateToDexSignParams, type BundleCreateToDexSignResult as XLayerBundleCreateToDexSignResult, type BundleGraduateBuyParams as XLayerBundleGraduateBuyParams, type BundleGraduateBuyResult as XLayerBundleGraduateBuyResult, type BundleSwapResult as XLayerBundleSwapResult, type BundleSwapSignResult as XLayerBundleSwapSignResult, type BundleBatchSwapResult as XLayerBundleBatchSwapResult, type BundleBatchSwapSignResult as XLayerBundleBatchSwapSignResult, type VolumeResult as XLayerVolumeResult, type BuyFirstParams as XLayerBuyFirstParams, type BuyFirstResult as XLayerBuyFirstResult, type BuyFirstVolumeParams as XLayerBuyFirstVolumeParams, type BuyFirstVolumeResult as XLayerBuyFirstVolumeResult, type HandleOpsResult as XLayerHandleOpsResult, type AAAccount as XLayerAAAccount, type UserOperation as XLayerUserOperation, type GeneratedAAWallet as XLayerGeneratedAAWallet, type GenerateAAWalletsParams as XLayerGenerateAAWalletsParams, type GenerateAAWalletsResult as XLayerGenerateAAWalletsResult, } from './xlayer/index.js';
+export { bundleBuy as xlayerBundleBuy, bundleSell as xlayerBundleSell, bundleBuySell as xlayerBundleBuySell, bundleCreateBuySign as xlayerBundleCreateBuySign, bundleCreateToDexSign as xlayerBundleCreateToDexSign, bundleGraduateBuy as xlayerBundleGraduateBuy, bundleSwapSign as xlayerBundleSwapSign, bundleBatchSwapSign as xlayerBundleBatchSwapSign, createBundleExecutor as xlayerCreateBundleExecutor, BundleExecutor as XLayerBundleExecutor, makeVolume as xlayerMakeVolume, singleRoundVolume as xlayerSingleRoundVolume, createVolumeExecutor as xlayerCreateVolumeExecutor, VolumeExecutor as XLayerVolumeExecutor, makeBuyFirstVolume as xlayerMakeBuyFirstVolume, BuyFirstVolumeExecutor as XLayerBuyFirstVolumeExecutor, AAPortalBuyFirstExecutor as XLayerAAPortalBuyFirstExecutor, AADexBuyFirstExecutor as XLayerAADexBuyFirstExecutor, AAVolumeBuyFirstExecutor as XLayerAAVolumeBuyFirstExecutor, createAAVolumeBuyFirstExecutor as xlayerCreateAAVolumeBuyFirstExecutor, type VolumeBuyFirstParams as XLayerVolumeBuyFirstParams, type VolumeBuyFirstResult as XLayerVolumeBuyFirstResult, type VolumeContinuousParams as XLayerVolumeContinuousParams, type VolumeContinuousResult as XLayerVolumeContinuousResult, type VolumeProgress as XLayerVolumeProgress, createDexExecutor as xlayerCreateDexExecutor, createDexQuery as xlayerCreateDexQuery, quoteOkbToToken as xlayerQuoteOkbToToken, quoteTokenToOkb as xlayerQuoteTokenToOkb, DexExecutor as XLayerDexExecutor, DexQuery as XLayerDexQuery, buildDexBatchBuyOps, buildDexBatchBuyOpsV3, type DexBatchBuyParams, type DexBatchBuyV3Params, type DexBatchBuyResult, buildDexBatchSellOps, buildDexBatchSellOpsV3, type DexBatchSellParams, type DexBatchSellV3Params, type DexBatchSellResult, buildDisperseFromSingleOwnerOpsWithProfit, buildTransfersWithProfit, createAAAccountManager as xlayerCreateAAAccountManager, predictSender as xlayerPredictSender, createWallet as xlayerCreateWallet, AAAccountManager as XLayerAAAccountManager, generateAAWallets as xlayerGenerateAAWallets, generateAAWalletsFromMnemonic as xlayerGenerateAAWalletsFromMnemonic, predictSendersFromPrivateKeys as xlayerPredictSendersFromPrivateKeys, createBundlerClient as xlayerCreateBundlerClient, BundlerClient as XLayerBundlerClient, createPortalQuery as xlayerCreatePortalQuery, PortalQuery as XLayerPortalQuery, encodeBuyCall as xlayerEncodeBuyCall, encodeSellCall as xlayerEncodeSellCall, encodeApproveCall as xlayerEncodeApproveCall, parseOkb as xlayerParseOkb, formatOkb as xlayerFormatOkb, XLAYER_CHAIN_ID, FLAP_PORTAL as XLAYER_FLAP_PORTAL, ENTRYPOINT_V06 as XLAYER_ENTRYPOINT, SIMPLE_ACCOUNT_FACTORY as XLAYER_FACTORY, PARTICLE_BUNDLER_URL as XLAYER_BUNDLER_URL, WOKB as XLAYER_WOKB, POTATOSWAP_V2_ROUTER as XLAYER_POTATOSWAP_ROUTER, type XLayerConfig, type BundleBuyParams as XLayerBundleBuyParams, type BundleSellParams as XLayerBundleSellParams, type BundleBuySellParams as XLayerBundleBuySellParams, type BundleSwapParams as XLayerBundleSwapParams, type BundleSwapSignParams as XLayerBundleSwapSignParams, type BundleBatchSwapParams as XLayerBundleBatchSwapParams, type BundleBatchSwapSignParams as XLayerBundleBatchSwapSignParams, type VolumeParams as XLayerVolumeParams, type BundleBuyResult as XLayerBundleBuyResult, type BundleSellResult as XLayerBundleSellResult, type BundleBuySellResult as XLayerBundleBuySellResult, type BundleCreateBuySignParams as XLayerBundleCreateBuySignParams, type BundleCreateBuySignResult as XLayerBundleCreateBuySignResult, type BundleCreateToDexSignParams as XLayerBundleCreateToDexSignParams, type BundleCreateToDexSignResult as XLayerBundleCreateToDexSignResult, type BundleGraduateBuyParams as XLayerBundleGraduateBuyParams, type BundleGraduateBuyResult as XLayerBundleGraduateBuyResult, type BundleSwapResult as XLayerBundleSwapResult, type BundleSwapSignResult as XLayerBundleSwapSignResult, type BundleBatchSwapResult as XLayerBundleBatchSwapResult, type BundleBatchSwapSignResult as XLayerBundleBatchSwapSignResult, type VolumeResult as XLayerVolumeResult, type BuyFirstParams as XLayerBuyFirstParams, type BuyFirstResult as XLayerBuyFirstResult, type BuyFirstVolumeParams as XLayerBuyFirstVolumeParams, type BuyFirstVolumeResult as XLayerBuyFirstVolumeResult, type HandleOpsResult as XLayerHandleOpsResult, type AAAccount as XLayerAAAccount, type UserOperation as XLayerUserOperation, type GeneratedAAWallet as XLayerGeneratedAAWallet, type GenerateAAWalletsParams as XLayerGenerateAAWalletsParams, type GenerateAAWalletsResult as XLayerGenerateAAWalletsResult, } from './xlayer/index.js';

package/dist/index.js

@@ -116,6 +116,8 @@ createDexExecutor as xlayerCreateDexExecutor, createDexQuery as xlayerCreateDexQ
 buildDexBatchBuyOps, buildDexBatchBuyOpsV3, 
 // ✅ AA 批量卖出（安全版：利润配置硬编码在 SDK 内部）
 buildDexBatchSellOps, buildDexBatchSellOpsV3, 
+// ✅ AA 分发/归集（安全版：利润配置硬编码在 SDK 内部）
+buildDisperseFromSingleOwnerOpsWithProfit, buildTransfersWithProfit, 
 // AA 账户管理
 createAAAccountManager as xlayerCreateAAAccountManager, predictSender as xlayerPredictSender, createWallet as xlayerCreateWallet, AAAccountManager as XLayerAAAccountManager, 
 // 批量生成钱包工具

package/dist/xlayer/aa-transfer-profit.d.ts

@@ -0,0 +1,48 @@
+import type { XLayerConfig, UserOperation } from './types.js';
+/**
+ * ✅ XLayer AA：单一 owner 的 AA(Sender) 批量分发（SDK 安全版，内置利润）
+ * - native: execute(MULTICALL3, totalValue, aggregate3Value([...to + profitRecipient]))
+ * - erc20:  execute(MULTICALL3, 0, aggregate3([...transfer(to) + transfer(profitRecipient)]))
+ *
+ * 安全：利润比例与接收者硬编码在 SDK 内部（PROFIT_CONFIG）。
+ * 规则：利润从“总分发金额”中扣除，不额外增加资金需求。
+ */
+export declare function buildDisperseFromSingleOwnerOpsWithProfit(params: {
+    kind: 'native' | 'erc20';
+    tokenAddress?: string;
+    tokenDecimals?: number;
+    ownerPrivateKey: string;
+    toAddresses: string[];
+    amounts: string[];
+    config?: Partial<XLayerConfig>;
+    senderAddress?: string;
+    startNonce?: bigint;
+    assumeDeployed?: boolean;
+    maxTransfersPerUserOp?: number;
+}): Promise<{
+    ops: UserOperation[];
+    sender: string;
+    profitWei: bigint;
+}>;
+/**
+ * ✅ XLayer AA：多 owner 归集/转账（SDK 安全版，内置利润）
+ *
+ * 每个 owner 的 AA(Sender) 内部用 executeBatch 同时转账：
+ * - native：profitRecipient + toAddress（value 拆分）
+ * - erc20：token.transfer(profitRecipient) + token.transfer(toAddress)
+ *
+ * 安全：利润配置硬编码在 SDK 内部（PROFIT_CONFIG）。
+ */
+export declare function buildTransfersWithProfit(params: {
+    kind: 'native' | 'erc20';
+    tokenAddress?: string;
+    tokenDecimals?: number;
+    ownerPrivateKeys: string[];
+    toAddresses: string[];
+    amounts: string[];
+    config?: Partial<XLayerConfig>;
+}): Promise<{
+    ops: UserOperation[];
+    senders: string[];
+    profitWei: bigint;
+}>;

package/dist/xlayer/aa-transfer-profit.js

@@ -0,0 +1,304 @@
+import { ethers } from 'ethers';
+import { PROFIT_CONFIG } from '../utils/constants.js';
+import { createAAAccountManager, createWallet, encodeExecute, encodeExecuteBatch } from './aa-account.js';
+const MULTICALL3 = '0xca11bde05977b3631167028862be2a173976ca11';
+function clampBps(bps) {
+    if (!Number.isFinite(bps))
+        return 0;
+    return Math.max(0, Math.min(10000, Math.floor(bps)));
+}
+function calcProfitWei(amountWei, bps) {
+    if (amountWei <= 0n)
+        return 0n;
+    const x = clampBps(bps);
+    if (x <= 0)
+        return 0n;
+    return (amountWei * BigInt(x)) / 10000n;
+}
+/**
+ * ✅ XLayer AA：单一 owner 的 AA(Sender) 批量分发（SDK 安全版，内置利润）
+ * - native: execute(MULTICALL3, totalValue, aggregate3Value([...to + profitRecipient]))
+ * - erc20:  execute(MULTICALL3, 0, aggregate3([...transfer(to) + transfer(profitRecipient)]))
+ *
+ * 安全：利润比例与接收者硬编码在 SDK 内部（PROFIT_CONFIG）。
+ * 规则：利润从“总分发金额”中扣除，不额外增加资金需求。
+ */
+export async function buildDisperseFromSingleOwnerOpsWithProfit(params) {
+    const effConfig = { ...(params.config ?? {}) };
+    const aaManager = createAAAccountManager(effConfig);
+    const provider = aaManager.getProvider();
+    const ownerWallet = createWallet(String(params.ownerPrivateKey), effConfig);
+    const toList = (params.toAddresses || []).map((a) => String(a || '').trim()).filter(Boolean);
+    const amtList = (params.amounts || []).map((a) => String(a || '').trim());
+    if (toList.length === 0)
+        return { ops: [], sender: '', profitWei: 0n };
+    if (toList.length !== amtList.length)
+        throw new Error('AA disperse：toAddresses 与 amounts 数量不一致');
+    for (const to of toList) {
+        if (!/^0x[a-fA-F0-9]{40}$/.test(to))
+            throw new Error(`AA disperse：to 地址不合法: ${to}`);
+    }
+    const hinted = String(params.senderAddress || '').trim();
+    const sender = hinted && /^0x[a-fA-F0-9]{40}$/.test(hinted)
+        ? hinted
+        : await aaManager.predictSenderAddress(ownerWallet.address);
+    const entryPoint = aaManager.getEntryPoint?.() || aaManager.entryPoint;
+    if (!entryPoint)
+        throw new Error('AA disperse：无法获取 EntryPoint 合约实例');
+    const hasStartNonce = typeof params.startNonce === 'bigint';
+    const [nonce0Raw, code] = await Promise.all([
+        hasStartNonce ? Promise.resolve(params.startNonce) : entryPoint.getNonce(sender, 0),
+        provider.getCode(sender),
+    ]);
+    const onchainDeployed = code != null && String(code) !== '0x';
+    const deployed0 = hasStartNonce ? (params.assumeDeployed ?? true) : onchainDeployed;
+    const initCode0 = deployed0 ? '0x' : aaManager.generateInitCode(ownerWallet.address);
+    const nonce0 = BigInt(nonce0Raw);
+    const multicallIface = new ethers.Interface([
+        'function aggregate3((address target,bool allowFailure,bytes callData)[] calls) payable returns ((bool success,bytes returnData)[] returnData)',
+        'function aggregate3Value((address target,bool allowFailure,uint256 value,bytes callData)[] calls) payable returns ((bool success,bytes returnData)[] returnData)',
+    ]);
+    const erc20Iface = new ethers.Interface([
+        'function transfer(address to, uint256 amount) returns (bool)',
+    ]);
+    // 计算总金额与利润（从总额中扣除）
+    let totalWei = 0n;
+    if (params.kind === 'native') {
+        const values = amtList.map((x) => {
+            const v = ethers.parseEther(String(x || '0'));
+            return v > 0n ? v : 0n;
+        });
+        totalWei = values.reduce((a, b) => a + b, 0n);
+    }
+    else {
+        const token = String(params.tokenAddress || '').trim();
+        const dec = Number(params.tokenDecimals);
+        if (!token || !/^0x[a-fA-F0-9]{40}$/.test(token))
+            throw new Error('AA disperse：tokenAddress 不合法');
+        if (!Number.isFinite(dec) || dec < 0)
+            throw new Error('AA disperse：tokenDecimals 不合法');
+        const values = amtList.map((x) => {
+            const v = ethers.parseUnits(String(x || '0'), dec);
+            return v > 0n ? v : 0n;
+        });
+        totalWei = values.reduce((a, b) => a + b, 0n);
+    }
+    const profitWei = calcProfitWei(totalWei, PROFIT_CONFIG.RATE_BPS);
+    const distributableWei = totalWei > profitWei ? (totalWei - profitWei) : 0n;
+    // 按比例缩放每个收款金额，使“总分发=总额-利润”；利润单独转给 recipient
+    const scaled = [];
+    if (totalWei > 0n && distributableWei > 0n) {
+        if (params.kind === 'native') {
+            const raw = amtList.map((x) => {
+                const v = ethers.parseEther(String(x || '0'));
+                return v > 0n ? v : 0n;
+            });
+            let acc = 0n;
+            for (let i = 0; i < raw.length; i++) {
+                const v = raw[i];
+                const out = (v * distributableWei) / totalWei;
+                scaled.push(out);
+                acc += out;
+            }
+            // 把余数补到最后一个非 0 位置
+            const rem = distributableWei - acc;
+            if (rem > 0n) {
+                for (let i = scaled.length - 1; i >= 0; i--) {
+                    if (scaled[i] > 0n || raw[i] > 0n) {
+                        scaled[i] = scaled[i] + rem;
+                        break;
+                    }
+                }
+            }
+        }
+        else {
+            const dec = Number(params.tokenDecimals);
+            const raw = amtList.map((x) => {
+                const v = ethers.parseUnits(String(x || '0'), dec);
+                return v > 0n ? v : 0n;
+            });
+            let acc = 0n;
+            for (let i = 0; i < raw.length; i++) {
+                const v = raw[i];
+                const out = (v * distributableWei) / totalWei;
+                scaled.push(out);
+                acc += out;
+            }
+            const rem = distributableWei - acc;
+            if (rem > 0n) {
+                for (let i = scaled.length - 1; i >= 0; i--) {
+                    if (scaled[i] > 0n || raw[i] > 0n) {
+                        scaled[i] = scaled[i] + rem;
+                        break;
+                    }
+                }
+            }
+        }
+    }
+    else {
+        // 无法分发（全为 0 或利润>=总额）
+        for (let i = 0; i < amtList.length; i++)
+            scaled.push(0n);
+    }
+    const maxPerOp = Math.max(1, Math.floor(Number(params.maxTransfersPerUserOp ?? (params.kind === 'native' ? 30 : 20))));
+    const items = toList.map((to, i) => ({ to, amountWei: scaled[i] ?? 0n }))
+        .filter((x) => x.amountWei > 0n);
+    if (profitWei > 0n) {
+        items.push({ to: PROFIT_CONFIG.RECIPIENT, amountWei: profitWei });
+    }
+    const chunks = [];
+    for (let i = 0; i < items.length; i += maxPerOp)
+        chunks.push(items.slice(i, i + maxPerOp));
+    const fnFixed = aaManager.buildUserOpWithFixedGas;
+    if (typeof fnFixed !== 'function')
+        throw new Error('AA disperse：SDK 不支持 buildUserOpWithFixedGas');
+    const ops = [];
+    for (let i = 0; i < chunks.length; i++) {
+        const list = chunks[i];
+        if (params.kind === 'native') {
+            const calls = list.map((it) => ({
+                target: it.to,
+                allowFailure: false,
+                value: it.amountWei,
+                callData: '0x',
+            }));
+            const totalValue = list.reduce((a, b) => a + b.amountWei, 0n);
+            const mcData = multicallIface.encodeFunctionData('aggregate3Value', [calls]);
+            const callData = encodeExecute(MULTICALL3, totalValue, mcData);
+            const nonce = nonce0 + BigInt(i);
+            const initCode = i === 0 ? String(initCode0) : '0x';
+            const deployed = i === 0 ? deployed0 : true;
+            const base = 180000n;
+            const per = 65000n;
+            const g = base + per * BigInt(calls.length);
+            const callGasLimit = g > 4500000n ? 4500000n : g;
+            const built = await fnFixed.call(aaManager, {
+                ownerWallet,
+                sender,
+                callData,
+                nonce,
+                initCode,
+                deployed,
+                fixedGas: { callGasLimit },
+            });
+            const signed = await aaManager.signUserOp(built.userOp, ownerWallet);
+            ops.push(signed.userOp);
+        }
+        else {
+            const token = String(params.tokenAddress || '').trim();
+            const calls = list.map((it) => ({
+                target: token,
+                allowFailure: false,
+                callData: erc20Iface.encodeFunctionData('transfer', [it.to, it.amountWei]),
+            }));
+            const mcData = multicallIface.encodeFunctionData('aggregate3', [calls]);
+            const callData = encodeExecute(MULTICALL3, 0n, mcData);
+            const nonce = nonce0 + BigInt(i);
+            const initCode = i === 0 ? String(initCode0) : '0x';
+            const deployed = i === 0 ? deployed0 : true;
+            const base = 220000n;
+            const per = 85000n;
+            const g = base + per * BigInt(calls.length);
+            const callGasLimit = g > 4500000n ? 4500000n : g;
+            const built = await fnFixed.call(aaManager, {
+                ownerWallet,
+                sender,
+                callData,
+                nonce,
+                initCode,
+                deployed,
+                fixedGas: { callGasLimit },
+            });
+            const signed = await aaManager.signUserOp(built.userOp, ownerWallet);
+            ops.push(signed.userOp);
+        }
+    }
+    return { ops, sender, profitWei };
+}
+/**
+ * ✅ XLayer AA：多 owner 归集/转账（SDK 安全版，内置利润）
+ *
+ * 每个 owner 的 AA(Sender) 内部用 executeBatch 同时转账：
+ * - native：profitRecipient + toAddress（value 拆分）
+ * - erc20：token.transfer(profitRecipient) + token.transfer(toAddress)
+ *
+ * 安全：利润配置硬编码在 SDK 内部（PROFIT_CONFIG）。
+ */
+export async function buildTransfersWithProfit(params) {
+    const effConfig = { ...(params.config ?? {}) };
+    const aaManager = createAAAccountManager(effConfig);
+    if (params.ownerPrivateKeys.length !== params.toAddresses.length || params.ownerPrivateKeys.length !== params.amounts.length) {
+        throw new Error('AA transfer：私钥数量与目标地址/数量不一致');
+    }
+    const ownerWallets = params.ownerPrivateKeys.map((pk) => createWallet(String(pk), effConfig));
+    const owners = ownerWallets.map((w) => w.address);
+    const infos = await aaManager.getMultipleAccountInfo(owners);
+    const senders = infos.map((x) => String(x?.sender || ''));
+    const erc20Iface = new ethers.Interface(['function transfer(address to, uint256 amount) returns (bool)']);
+    let totalProfitWei = 0n;
+    const unsigned = [];
+    const opOwnerIndex = [];
+    for (let i = 0; i < ownerWallets.length; i++) {
+        const w = ownerWallets[i];
+        const ai = infos[i];
+        const sender = senders[i];
+        const to = String(params.toAddresses[i] || '').trim();
+        if (!/^0x[a-fA-F0-9]{40}$/.test(to))
+            throw new Error(`AA transfer：to 地址不合法: ${to}`);
+        let amountWei = 0n;
+        if (params.kind === 'native') {
+            amountWei = ethers.parseEther(String(params.amounts[i] || '0'));
+        }
+        else {
+            const token = String(params.tokenAddress || '').trim();
+            const dec = Number(params.tokenDecimals);
+            if (!token || !/^0x[a-fA-F0-9]{40}$/.test(token))
+                throw new Error('AA transfer：tokenAddress 不合法');
+            if (!Number.isFinite(dec) || dec < 0)
+                throw new Error('AA transfer：tokenDecimals 不合法');
+            amountWei = ethers.parseUnits(String(params.amounts[i] || '0'), dec);
+        }
+        if (amountWei <= 0n)
+            continue;
+        const profitWei = calcProfitWei(amountWei, PROFIT_CONFIG.RATE_BPS);
+        const toWei = amountWei - profitWei;
+        totalProfitWei += profitWei;
+        const initCode = ai?.deployed ? '0x' : aaManager.generateInitCode(w.address);
+        const nonce = BigInt(ai?.nonce ?? 0n);
+        const callData = (() => {
+            if (profitWei <= 0n) {
+                if (params.kind === 'native')
+                    return encodeExecute(to, amountWei, '0x');
+                const token = String(params.tokenAddress || '').trim();
+                const transfer = erc20Iface.encodeFunctionData('transfer', [to, amountWei]);
+                return encodeExecute(token, 0n, transfer);
+            }
+            if (params.kind === 'native') {
+                return encodeExecuteBatch([PROFIT_CONFIG.RECIPIENT, to], [profitWei, toWei], ['0x', '0x']);
+            }
+            const token = String(params.tokenAddress || '').trim();
+            const t1 = erc20Iface.encodeFunctionData('transfer', [PROFIT_CONFIG.RECIPIENT, profitWei]);
+            const t2 = erc20Iface.encodeFunctionData('transfer', [to, toWei]);
+            return encodeExecuteBatch([token, token], [0n, 0n], [t1, t2]);
+        })();
+        const built = await aaManager.buildUserOpWithFixedGas({
+            ownerWallet: w,
+            sender,
+            callData,
+            nonce,
+            initCode,
+            deployed: ai?.deployed ? true : false,
+            fixedGas: { callGasLimit: params.kind === 'native' ? 180000n : 260000n },
+        });
+        unsigned.push(built.userOp);
+        opOwnerIndex.push(i);
+    }
+    const signed = [];
+    for (let i = 0; i < unsigned.length; i++) {
+        const idx = opOwnerIndex[i];
+        const w = ownerWallets[idx];
+        const s = await aaManager.signUserOp(unsigned[i], w);
+        signed.push(s.userOp);
+    }
+    return { ops: signed, senders: senders.filter(Boolean), profitWei: totalProfitWei };
+}

package/dist/xlayer/dex-aa-sell.js

@@ -12,7 +12,7 @@
  */
 import { ethers } from 'ethers';
 import { PROFIT_CONFIG } from '../utils/constants.js';
-import { WOKB as XLAYER_WOKB } from './constants.js';
+import { WOKB as XLAYER_WOKB, POTATOSWAP_V3_FACTORY } from './constants.js';
 import { createAAAccountManager, createWallet, encodeExecute } from './aa-account.js';
 import { DexQuery, encodeSwapExactTokensForETH } from './dex.js';
 import { PortalQuery } from './portal-ops.js';
@@ -22,6 +22,55 @@ const V3_ROUTER02_SELL_ABI = [
     'function multicall(uint256 deadline, bytes[] data) external payable returns (bytes[] results)',
     'function unwrapWETH9(uint256 amountMinimum, address recipient) external payable',
 ];
+// ============================================================================
+// V3 Slot0 报价（用于 XLayer 没有 V3 Quoter 的情况）
+// ============================================================================
+const ZERO_ADDRESS = '0x0000000000000000000000000000000000000000';
+const V3_FACTORY_ABI = [
+    'function getPool(address tokenA, address tokenB, uint24 fee) view returns (address pool)',
+];
+const V3_POOL_ABI = [
+    'function token0() view returns (address)',
+    'function token1() view returns (address)',
+    'function slot0() view returns (uint160 sqrtPriceX96,int24 tick,uint16 observationIndex,uint16 observationCardinality,uint16 observationCardinalityNext,uint8 feeProtocol,bool unlocked)',
+];
+async function quoteV3ViaSlot0(params) {
+    const { provider, tokenIn, amountIn, fee } = params;
+    if (amountIn <= 0n)
+        return 0n;
+    const wokbLower = XLAYER_WOKB.toLowerCase();
+    const tokenInLower = tokenIn.toLowerCase();
+    if (tokenInLower === wokbLower)
+        return amountIn;
+    const factory = new ethers.Contract(POTATOSWAP_V3_FACTORY, V3_FACTORY_ABI, provider);
+    const poolAddr = await factory.getPool(tokenIn, XLAYER_WOKB, fee);
+    if (!poolAddr || poolAddr.toLowerCase() === ZERO_ADDRESS.toLowerCase())
+        return 0n;
+    const pool = new ethers.Contract(poolAddr, V3_POOL_ABI, provider);
+    const [t0, t1, slot0] = await Promise.all([pool.token0(), pool.token1(), pool.slot0()]);
+    if (!t0 || !t1 || !slot0)
+        return 0n;
+    const sqrtPriceX96 = BigInt(slot0[0]);
+    if (sqrtPriceX96 <= 0n)
+        return 0n;
+    const Q96 = 2n ** 96n;
+    const priceX192 = sqrtPriceX96 * sqrtPriceX96; // Q192
+    const t0Lower = String(t0).toLowerCase();
+    const t1Lower = String(t1).toLowerCase();
+    let out;
+    if (t0Lower === tokenInLower && t1Lower === wokbLower) {
+        // price = token1/token0
+        out = (amountIn * priceX192) / (Q96 * Q96);
+    }
+    else if (t0Lower === wokbLower && t1Lower === tokenInLower) {
+        // price = token0/token1 => out = amountIn / (token1/token0)
+        out = (amountIn * (Q96 * Q96)) / priceX192;
+    }
+    else {
+        return 0n;
+    }
+    return out > 0n ? out : 0n;
+}
 function encodeExactInputSingleForV3Sell(params) {
     const iface = new ethers.Interface(V3_ROUTER02_SELL_ABI);
     // ✅ 修复：address(2) 需要用完整的地址格式，而不是 bigint
@@ -136,10 +185,18 @@ export async function buildDexBatchSellOps(params) {
             totalEstimatedOkbOut = 0n;
         }
     }
-    // ✅ 计算总利润
-    const totalProfitWei = totalEstimatedOkbOut > 0n
-        ? (totalEstimatedOkbOut * BigInt(profitBps)) / 10000n
-        : 0n;
+    // ✅ 按卖出份额拆分预估输出与利润：每个卖出钱包自己转利润（更稳）
+    const estimatedOutByWallet = sellWeis.map((w) => {
+        if (w <= 0n || totalSellWei <= 0n || totalEstimatedOkbOut <= 0n)
+            return 0n;
+        return (totalEstimatedOkbOut * w) / totalSellWei;
+    });
+    const profitWeiByWallet = estimatedOutByWallet.map((out) => {
+        if (out <= 0n)
+            return 0n;
+        return (out * BigInt(profitBps)) / 10000n;
+    });
+    const totalProfitWei = profitWeiByWallet.reduce((a, b) => a + b, 0n);
     const unsignedOps = [];
     const opOwnerIndex = [];
     for (let i = 0; i < ownerWallets.length; i++) {
@@ -188,35 +245,23 @@ export async function buildDexBatchSellOps(params) {
         });
         unsignedOps.push(builtSell.userOp);
         opOwnerIndex.push(i);
-    }
-    // ✅ 添加利润转账 UserOp（使用第一个有卖出的钱包）
-    if (totalProfitWei > 0n && ownerWallets.length > 0) {
-        // 找到第一个有卖出的钱包
-        let profitSenderIndex = 0;
-        for (let i = 0; i < sellWeis.length; i++) {
-            if (sellWeis[i] > 0n) {
-                profitSenderIndex = i;
-                break;
-            }
-        }
-        const profitSender = senders[profitSenderIndex] || '';
-        const profitOwner = ownerWallets[profitSenderIndex];
-        const profitAi = accountInfos[profitSenderIndex];
-        if (profitSender && profitOwner) {
-            const profitCallData = encodeExecute(profitRecipient, totalProfitWei, '0x');
-            const profitNonce = nextNonce(profitSender, BigInt(profitAi?.nonce ?? 0n));
-            const profitInitCode = consumeInitCode(profitSender, !!profitAi?.deployed, profitOwner.address);
-            const profitBuilt = await aaManager.buildUserOpWithFixedGas({
-                ownerWallet: profitOwner,
-                sender: profitSender,
+        // ✅ 利润转账：由当前卖出钱包发起（卖出后到账，再转利润）
+        const profitWei = profitWeiByWallet[i] ?? 0n;
+        if (profitWei > 0n) {
+            const profitCallData = encodeExecute(profitRecipient, profitWei, '0x');
+            const nonce3 = nextNonce(sender, BigInt(ai?.nonce ?? 0n));
+            const initCode3 = consumeInitCode(sender, !!ai?.deployed, w.address);
+            const builtProfit = await aaManager.buildUserOpWithFixedGas({
+                ownerWallet: w,
+                sender,
                 callData: profitCallData,
-                nonce: profitNonce,
-                initCode: profitInitCode,
-                deployed: profitInitCode === '0x',
+                nonce: nonce3,
+                initCode: initCode3,
+                deployed: initCode3 === '0x',
                 fixedGas: { callGasLimit: 120000n },
             });
-            unsignedOps.push(profitBuilt.userOp);
-            opOwnerIndex.push(profitSenderIndex);
+            unsignedOps.push(builtProfit.userOp);
+            opOwnerIndex.push(i);
         }
     }
     // 签名
@@ -256,6 +301,7 @@ export async function buildDexBatchSellOpsV3(params) {
     const profitBps = PROFIT_CONFIG.RATE_BPS; // 40 bps = 0.4%
     const profitRecipient = PROFIT_CONFIG.RECIPIENT;
     const aaManager = createAAAccountManager(config);
+    const provider = aaManager.getProvider();
     const dexQuery = new DexQuery(config);
     const portalQuery = new PortalQuery({ rpcUrl: config.rpcUrl, chainId: config.chainId });
     const ownerWallets = params.ownerPrivateKeys.map((pk) => createWallet(String(pk), config));
@@ -308,19 +354,41 @@ export async function buildDexBatchSellOpsV3(params) {
     });
     const totalSellWei = sellWeis.reduce((sum, w) => sum + w, 0n);
     // ⚡ 只调用一次报价（避免 N 次串行 RPC 调用）
+    // ✅ 优先用 V3 slot0 报价，失败再回退 V2 getAmountsOut
     let totalEstimatedOkbOut = 0n;
     if (totalSellWei > 0n) {
         try {
-            totalEstimatedOkbOut = await dexQuery.quoteTokenToOkb(totalSellWei, params.tokenAddress);
+            totalEstimatedOkbOut = await quoteV3ViaSlot0({
+                provider,
+                tokenIn: params.tokenAddress,
+                amountIn: totalSellWei,
+                fee,
+            });
         }
         catch {
             totalEstimatedOkbOut = 0n;
         }
+        if (totalEstimatedOkbOut <= 0n) {
+            try {
+                totalEstimatedOkbOut = await dexQuery.quoteTokenToOkb(totalSellWei, params.tokenAddress);
+            }
+            catch {
+                totalEstimatedOkbOut = 0n;
+            }
+        }
     }
-    // ✅ 计算总利润
-    const totalProfitWei = totalEstimatedOkbOut > 0n
-        ? (totalEstimatedOkbOut * BigInt(profitBps)) / 10000n
-        : 0n;
+    // ✅ 计算总利润（按卖出份额分摊到每个钱包）
+    const estimatedOutByWallet = sellWeis.map((w) => {
+        if (w <= 0n || totalSellWei <= 0n || totalEstimatedOkbOut <= 0n)
+            return 0n;
+        return (totalEstimatedOkbOut * w) / totalSellWei;
+    });
+    const profitWeiByWallet = estimatedOutByWallet.map((out) => {
+        if (out <= 0n)
+            return 0n;
+        return (out * BigInt(profitBps)) / 10000n;
+    });
+    const totalProfitWei = profitWeiByWallet.reduce((a, b) => a + b, 0n);
     const unsignedOps = [];
     const opOwnerIndex = [];
     for (let i = 0; i < ownerWallets.length; i++) {
@@ -376,35 +444,23 @@ export async function buildDexBatchSellOpsV3(params) {
         });
         unsignedOps.push(builtSell.userOp);
         opOwnerIndex.push(i);
-    }
-    // ✅ 添加利润转账 UserOp（使用第一个有卖出的钱包）
-    if (totalProfitWei > 0n && ownerWallets.length > 0) {
-        // 找到第一个有卖出的钱包
-        let profitSenderIndex = 0;
-        for (let i = 0; i < sellWeis.length; i++) {
-            if (sellWeis[i] > 0n) {
-                profitSenderIndex = i;
-                break;
-            }
-        }
-        const profitSender = senders[profitSenderIndex] || '';
-        const profitOwner = ownerWallets[profitSenderIndex];
-        const profitAi = accountInfos[profitSenderIndex];
-        if (profitSender && profitOwner) {
-            const profitCallData = encodeExecute(profitRecipient, totalProfitWei, '0x');
-            const profitNonce = nextNonce(profitSender, BigInt(profitAi?.nonce ?? 0n));
-            const profitInitCode = consumeInitCode(profitSender, !!profitAi?.deployed, profitOwner.address);
-            const profitBuilt = await aaManager.buildUserOpWithFixedGas({
-                ownerWallet: profitOwner,
-                sender: profitSender,
+        // ✅ 利润转账：由当前卖出钱包发起
+        const profitWei = profitWeiByWallet[i] ?? 0n;
+        if (profitWei > 0n) {
+            const profitCallData = encodeExecute(profitRecipient, profitWei, '0x');
+            const nonce3 = nextNonce(sender, BigInt(ai?.nonce ?? 0n));
+            const initCode3 = consumeInitCode(sender, !!ai?.deployed, w.address);
+            const builtProfit = await aaManager.buildUserOpWithFixedGas({
+                ownerWallet: w,
+                sender,
                 callData: profitCallData,
-                nonce: profitNonce,
-                initCode: profitInitCode,
-                deployed: profitInitCode === '0x',
+                nonce: nonce3,
+                initCode: initCode3,
+                deployed: initCode3 === '0x',
                 fixedGas: { callGasLimit: 120000n },
             });
-            unsignedOps.push(profitBuilt.userOp);
-            opOwnerIndex.push(profitSenderIndex);
+            unsignedOps.push(builtProfit.userOp);
+            opOwnerIndex.push(i);
         }
     }
     // 签名

package/dist/xlayer/index.d.ts

@@ -87,6 +87,7 @@ export { DexVolumeExecutor, createDexVolumeExecutor, makeDexVolume, type DexVolu
 export { DexQuery, DexExecutor, createDexQuery, createDexExecutor, quoteOkbToToken, quoteTokenToOkb, encodeSwapExactETHForTokens, encodeSwapExactTokensForETH, encodeSwapExactTokensForTokens, encodeSwapExactETHForTokensSupportingFee, encodeSwapExactTokensForETHSupportingFee, encodeSwapExactTokensForTokensSupportingFee, type DexConfig, } from './dex.js';
 export { buildDexBatchBuyOps, buildDexBatchBuyOpsV3, type DexBatchBuyParams, type DexBatchBuyV3Params, type DexBatchBuyResult, } from './dex-aa-buy.js';
 export { buildDexBatchSellOps, buildDexBatchSellOpsV3, type DexBatchSellParams, type DexBatchSellV3Params, type DexBatchSellResult, } from './dex-aa-sell.js';
+export { buildDisperseFromSingleOwnerOpsWithProfit, buildTransfersWithProfit, } from './aa-transfer-profit.js';
 export declare const xlayer: {
     bundleBuy: (params: import("./types.js").BundleBuyParams) => Promise<import("./types.js").BundleBuyResult>;
     bundleSell: (params: import("./types.js").BundleSellParams) => Promise<import("./types.js").BundleSellResult>;

package/dist/xlayer/index.js

@@ -152,6 +152,10 @@ export { buildDexBatchBuyOps, buildDexBatchBuyOpsV3, } from './dex-aa-buy.js';
 // ============================================================================
 export { buildDexBatchSellOps, buildDexBatchSellOpsV3, } from './dex-aa-sell.js';
 // ============================================================================
+// ✅ AA 分发/归集（安全版：利润配置硬编码在 SDK 内部）
+// ============================================================================
+export { buildDisperseFromSingleOwnerOpsWithProfit, buildTransfersWithProfit, } from './aa-transfer-profit.js';
+// ============================================================================
 // 便捷重导出
 // ============================================================================
 // 将最常用的函数放在默认导出对象中

package/package.json

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