four-flap-meme-sdk 1.7.3 → 1.7.5

package/dist/eip7702/xlayer/create-to-dex.d.ts

@@ -0,0 +1,103 @@
+/**
+ * X-Layer Bundle 发币 + 内盘买到外盘
+ *
+ * 功能：在一个 Type 4 交易中完成：
+ * 1. 发币（创建新代币）
+ * 2. 多个钱包在 Bonding Curve（内盘）买入代币
+ * 3. 买到毕业（代币上 DEX）
+ * 4. 多个钱包在 PotatoSwap（外盘）继续买入
+ *
+ * ✅ 与 BSC 链 create-to-dex.ts 功能对齐
+ * ✅ 使用 Type 4 交易（EIP-7702），所有操作原子化
+ */
+/** 用户类型 */
+export type UserType = 'v0' | 'v1' | 'normal';
+/** 代币信息 */
+export interface CreateTokenInfo {
+    name: string;
+    symbol: string;
+    meta: string;
+}
+/** 内盘买入钱包配置 */
+export interface CurveBuyerConfig {
+    privateKey: string;
+    /** 买入金额（OKB），为空则自动分配 */
+    buyAmount?: string;
+}
+/** 外盘买入钱包配置 */
+export interface DexBuyerConfig {
+    privateKey: string;
+    /** 买入金额（OKB），为空则自动分配 */
+    buyAmount?: string;
+}
+/** 发币 + 一键到外盘参数 */
+export interface CreateToDexParams {
+    /** RPC URL */
+    rpcUrl: string;
+    /** Gas Price (可选) */
+    gasPrice?: bigint;
+    /** 用户类型（影响利润率） */
+    userType?: UserType;
+    /** Dev 钱包私钥（发币者） */
+    devPrivateKey: string;
+    /** 代币信息 */
+    tokenInfo: CreateTokenInfo;
+    /** 预计算的代币地址 */
+    tokenAddress: string;
+    /** 内盘买入钱包 */
+    curveBuyers: CurveBuyerConfig[];
+    /** 内盘总买入金额（OKB） */
+    curveTotalBuyAmount: string;
+    /** 是否启用外盘买入 */
+    enableDexBuy?: boolean;
+    /** 外盘买入钱包（与内盘钱包可相同或不同） */
+    dexBuyers?: DexBuyerConfig[];
+    /** 外盘总买入金额（OKB） */
+    dexTotalBuyAmount?: string;
+    /** 外盘池类型（V2 或 V3），默认 V2 */
+    dexPoolType?: 'v2' | 'v3';
+    /** V3 费率（100/500/2500/10000），默认 2500 */
+    v3Fee?: number;
+    /** 发币扩展参数 */
+    dexThresh?: number;
+    migratorType?: number;
+    taxRate?: number;
+    salt?: string;
+    /** V4 参数 */
+    dexId?: number;
+    lpFeeProfile?: number;
+    extensionID?: string;
+    extensionData?: string;
+}
+/** 签名结果 */
+export interface CreateToDexSignedResult {
+    /** 签名后的 Type 4 交易 */
+    signedTx: string;
+    /** 交易哈希 */
+    txHash: string;
+    /** Sponsor 地址 */
+    sponsorAddress: string;
+    /** 代币地址 */
+    tokenAddress: string;
+    /** 元数据 */
+    metadata: {
+        curveBuyerCount: number;
+        curveTotalBuy: string;
+        enableDexBuy: boolean;
+        dexBuyerCount: number;
+        dexTotalBuy: string;
+        profitAmount: string;
+    };
+    /** 时间戳 */
+    timestamp: number;
+}
+/**
+ * 发币 + 一键买到外盘（Type 4 原子交易）
+ *
+ * 交易顺序：
+ * 1. Dev 发币（创建代币）
+ * 2. 内盘买入（多个钱包在 Bonding Curve 买入，买到毕业）
+ * 3. 外盘买入（多个钱包在 PotatoSwap 买入）
+ * 4. 利润转账
+ */
+export declare function signCreateToDex(params: CreateToDexParams): Promise<CreateToDexSignedResult>;

package/dist/eip7702/xlayer/create-to-dex.js

@@ -0,0 +1,348 @@
+/**
+ * X-Layer Bundle 发币 + 内盘买到外盘
+ *
+ * 功能：在一个 Type 4 交易中完成：
+ * 1. 发币（创建新代币）
+ * 2. 多个钱包在 Bonding Curve（内盘）买入代币
+ * 3. 买到毕业（代币上 DEX）
+ * 4. 多个钱包在 PotatoSwap（外盘）继续买入
+ *
+ * ✅ 与 BSC 链 create-to-dex.ts 功能对齐
+ * ✅ 使用 Type 4 交易（EIP-7702），所有操作原子化
+ */
+import { ethers, Wallet, JsonRpcProvider, Interface } from 'ethers';
+import { XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, EXECUTOR_ABI, WOKB, POTATOSWAP_V2_ROUTER, POTATOSWAP_V3_ROUTER, FLAP_PORTAL, DEFAULT_GAS_PRICE, GAS_LIMIT_MULTIPLIER, XLAYER_PROFIT_CONFIG, } from './constants.js';
+import { buildNativeTransfer } from './builders.js';
+// ==================== Flap Portal ABI ====================
+const PORTAL_ABI = [
+    'function newTokenV4((string name, string symbol, string meta, uint8 dexThresh, bytes32 salt, uint16 taxRate, uint8 migratorType, address quoteToken, uint256 quoteAmt, address beneficiary, bytes permitData, bytes32 extensionID, bytes extensionData, uint8 dexId, uint8 lpFeeProfile)) payable returns (address)',
+    'function newTokenV3((string name, string symbol, string meta, uint8 dexThresh, bytes32 salt, uint16 taxRate, uint8 migratorType, address quoteToken, uint256 quoteAmt, address beneficiary, bytes permitData, bytes32 extensionID, bytes extensionData)) payable returns (address)',
+    'function newTokenV2((string name, string symbol, string meta, uint8 dexThresh, bytes32 salt, uint16 taxRate, uint8 migratorType, address quoteToken, uint256 quoteAmt, address beneficiary, bytes permitData)) payable returns (address)',
+    'function swapExactInputV3((address inputToken, address outputToken, uint256 inputAmount, uint256 minOutputAmount, bytes permitData, bytes extensionData)) payable returns (uint256)',
+    'function swapExactInput((address inputToken, address outputToken, uint256 inputAmount, uint256 minOutputAmount, bytes permitData)) payable returns (uint256)',
+];
+// ==================== PotatoSwap Router ABI ====================
+const V2_ROUTER_ABI = [
+    'function swapExactETHForTokens(uint256 amountOutMin, address[] path, address to, uint256 deadline) payable returns (uint256[] amounts)',
+];
+const V3_ROUTER_ABI = [
+    'function exactInputSingle((address tokenIn, address tokenOut, uint24 fee, address recipient, uint256 amountIn, uint256 amountOutMinimum, uint160 sqrtPriceLimitX96)) payable returns (uint256 amountOut)',
+];
+// ==================== 利润计算 ====================
+function getProfitRateBps(userType = 'v0') {
+    switch (userType) {
+        case 'v0':
+            return XLAYER_PROFIT_CONFIG.RATE_BPS_V0_DOUBLE;
+        case 'v1':
+            return XLAYER_PROFIT_CONFIG.RATE_BPS_V1_DOUBLE;
+        default:
+            return XLAYER_PROFIT_CONFIG.RATE_BPS_SWAP;
+    }
+}
+function calculateProfitWei(amount, txCount, userType = 'v0') {
+    const bpsPerTx = getProfitRateBps(userType);
+    const totalBps = bpsPerTx * txCount;
+    return (amount * BigInt(totalBps)) / 10000n;
+}
+// ==================== 授权签名 ====================
+function hashAuthorization(chainId, executorAddress, nonce) {
+    const encoded = ethers.encodeRlp([
+        ethers.toBeHex(chainId),
+        executorAddress,
+        ethers.toBeHex(nonce),
+    ]);
+    const prefixed = ethers.concat([new Uint8Array([0x05]), encoded]);
+    return ethers.keccak256(prefixed);
+}
+function signAuthorization(wallet, nonce = 0) {
+    const messageHash = hashAuthorization(XLAYER_CHAIN_ID, EXECUTOR_ADDRESS, nonce);
+    const signature = wallet.signingKey.sign(messageHash);
+    return {
+        chainId: XLAYER_CHAIN_ID,
+        address: EXECUTOR_ADDRESS,
+        nonce,
+        v: signature.v,
+        r: signature.r,
+        s: signature.s,
+    };
+}
+// ==================== 金额拆分 ====================
+function splitAmount(totalAmount, count) {
+    if (count <= 0)
+        throw new Error('拆分份数必须大于 0');
+    if (count === 1)
+        return [totalAmount];
+    const weights = [];
+    for (let i = 0; i < count; i++) {
+        weights.push(0.5 + Math.random());
+    }
+    const totalWeight = weights.reduce((a, b) => a + b, 0);
+    const amounts = [];
+    let allocated = 0n;
+    for (let i = 0; i < count - 1; i++) {
+        const ratio = weights[i] / totalWeight;
+        const amount = BigInt(Math.floor(Number(totalAmount) * ratio));
+        amounts.push(amount);
+        allocated += amount;
+    }
+    amounts.push(totalAmount - allocated);
+    return amounts;
+}
+// ==================== 构建调用 ====================
+function buildPortalCreate(portal, tokenInfo, devAddress, params) {
+    const useV4 = params.dexId !== undefined || params.lpFeeProfile !== undefined;
+    const useV3 = !useV4 && !!params.extensionID;
+    let data;
+    if (useV4) {
+        data = portal.encodeFunctionData('newTokenV4', [{
+                name: tokenInfo.name,
+                symbol: tokenInfo.symbol,
+                meta: tokenInfo.meta,
+                dexThresh: (params.dexThresh ?? 1) & 0xff,
+                salt: params.salt ?? '0x' + '00'.repeat(32),
+                taxRate: (params.taxRate ?? 0) & 0xffff,
+                migratorType: (params.migratorType ?? 0) & 0xff,
+                quoteToken: ethers.ZeroAddress,
+                quoteAmt: 0n,
+                beneficiary: devAddress,
+                permitData: '0x',
+                extensionID: params.extensionID ?? '0x' + '00'.repeat(32),
+                extensionData: params.extensionData ?? '0x',
+                dexId: (params.dexId ?? 0) & 0xff,
+                lpFeeProfile: (params.lpFeeProfile ?? 0) & 0xff,
+            }]);
+    }
+    else if (useV3) {
+        data = portal.encodeFunctionData('newTokenV3', [{
+                name: tokenInfo.name,
+                symbol: tokenInfo.symbol,
+                meta: tokenInfo.meta,
+                dexThresh: (params.dexThresh ?? 1) & 0xff,
+                salt: params.salt ?? '0x' + '00'.repeat(32),
+                taxRate: (params.taxRate ?? 0) & 0xffff,
+                migratorType: (params.migratorType ?? 0) & 0xff,
+                quoteToken: ethers.ZeroAddress,
+                quoteAmt: 0n,
+                beneficiary: devAddress,
+                permitData: '0x',
+                extensionID: params.extensionID,
+                extensionData: params.extensionData ?? '0x',
+            }]);
+    }
+    else {
+        data = portal.encodeFunctionData('newTokenV2', [{
+                name: tokenInfo.name,
+                symbol: tokenInfo.symbol,
+                meta: tokenInfo.meta,
+                dexThresh: (params.dexThresh ?? 1) & 0xff,
+                salt: params.salt ?? '0x' + '00'.repeat(32),
+                taxRate: (params.taxRate ?? 0) & 0xffff,
+                migratorType: (params.migratorType ?? 0) & 0xff,
+                quoteToken: ethers.ZeroAddress,
+                quoteAmt: 0n,
+                beneficiary: devAddress,
+                permitData: '0x',
+            }]);
+    }
+    return {
+        target: FLAP_PORTAL,
+        value: 0n,
+        data,
+    };
+}
+function buildPortalBuy(portal, tokenAddress, amountOkb, extensionData) {
+    const data = portal.encodeFunctionData('swapExactInputV3', [{
+            inputToken: ethers.ZeroAddress,
+            outputToken: tokenAddress,
+            inputAmount: amountOkb,
+            minOutputAmount: 0n,
+            permitData: '0x',
+            extensionData: extensionData ?? '0x',
+        }]);
+    return {
+        target: FLAP_PORTAL,
+        value: amountOkb,
+        data,
+    };
+}
+function buildDexBuyV2(tokenAddress, amountOkb, recipient) {
+    const iface = new Interface(V2_ROUTER_ABI);
+    const deadline = Math.floor(Date.now() / 1000) + 1200;
+    const data = iface.encodeFunctionData('swapExactETHForTokens', [
+        0n,
+        [WOKB, tokenAddress],
+        recipient,
+        deadline,
+    ]);
+    return {
+        target: POTATOSWAP_V2_ROUTER,
+        value: amountOkb,
+        data,
+    };
+}
+function buildDexBuyV3(tokenAddress, amountOkb, recipient, fee = 2500) {
+    const iface = new Interface(V3_ROUTER_ABI);
+    const data = iface.encodeFunctionData('exactInputSingle', [{
+            tokenIn: WOKB,
+            tokenOut: tokenAddress,
+            fee,
+            recipient,
+            amountIn: amountOkb,
+            amountOutMinimum: 0n,
+            sqrtPriceLimitX96: 0n,
+        }]);
+    return {
+        target: POTATOSWAP_V3_ROUTER,
+        value: amountOkb,
+        data,
+    };
+}
+// ==================== 核心签名函数 ====================
+async function buildAndSignType4Transaction(rpcUrl, gasPrice, participants) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    const executorInterface = new Interface(EXECUTOR_ABI);
+    const sponsor = participants[0].wallet;
+    const authorizations = [];
+    const allCalls = [];
+    for (const p of participants) {
+        const auth = signAuthorization(p.wallet);
+        authorizations.push(auth);
+        allCalls.push(...p.calls);
+    }
+    const executeData = executorInterface.encodeFunctionData('execute', [
+        allCalls.map(c => ({
+            target: c.target,
+            value: c.value || 0n,
+            data: c.data,
+        })),
+    ]);
+    const totalValue = allCalls.reduce((sum, c) => sum + (c.value || 0n), 0n);
+    const gasLimit = BigInt(Math.ceil(Number(500000n + BigInt(allCalls.length) * 300000n) * GAS_LIMIT_MULTIPLIER));
+    const sponsorNonce = await provider.getTransactionCount(sponsor.address);
+    const tx = {
+        type: 4,
+        chainId: XLAYER_CHAIN_ID,
+        to: sponsor.address,
+        data: executeData,
+        value: totalValue,
+        authorizationList: authorizations,
+        gasLimit,
+        gasPrice,
+        nonce: sponsorNonce,
+    };
+    const fields = [
+        ethers.toBeHex(tx.chainId),
+        ethers.toBeHex(tx.nonce),
+        ethers.toBeHex(tx.gasPrice),
+        ethers.toBeHex(tx.gasLimit),
+        tx.to,
+        ethers.toBeHex(tx.value),
+        tx.data,
+        tx.authorizationList.map((auth) => [
+            ethers.toBeHex(auth.chainId),
+            auth.address,
+            ethers.toBeHex(auth.nonce),
+            ethers.toBeHex(auth.v),
+            auth.r,
+            auth.s,
+        ]),
+    ];
+    const unsigned = ethers.concat([new Uint8Array([0x04]), ethers.encodeRlp(fields)]);
+    const txHashToSign = ethers.keccak256(unsigned);
+    const signature = sponsor.signingKey.sign(txHashToSign);
+    const signedFields = [...fields, ethers.toBeHex(signature.v), signature.r, signature.s];
+    const signedTx = ethers.hexlify(ethers.concat([new Uint8Array([0x04]), ethers.encodeRlp(signedFields)]));
+    const txHash = ethers.keccak256(signedTx);
+    return { signedTx, txHash, sponsorAddress: sponsor.address };
+}
+// ==================== 主函数 ====================
+/**
+ * 发币 + 一键买到外盘（Type 4 原子交易）
+ *
+ * 交易顺序：
+ * 1. Dev 发币（创建代币）
+ * 2. 内盘买入（多个钱包在 Bonding Curve 买入，买到毕业）
+ * 3. 外盘买入（多个钱包在 PotatoSwap 买入）
+ * 4. 利润转账
+ */
+export async function signCreateToDex(params) {
+    const { rpcUrl, gasPrice = DEFAULT_GAS_PRICE, userType = 'v0', devPrivateKey, tokenInfo, tokenAddress, curveBuyers, curveTotalBuyAmount, enableDexBuy = false, dexBuyers = [], dexTotalBuyAmount, dexPoolType = 'v2', v3Fee = 2500, } = params;
+    if (curveBuyers.length === 0) {
+        throw new Error('至少需要一个内盘买入钱包');
+    }
+    const provider = new JsonRpcProvider(rpcUrl);
+    const portalInterface = new Interface(PORTAL_ABI);
+    // 创建钱包
+    const devWallet = new Wallet(devPrivateKey, provider);
+    const curveWallets = curveBuyers.map(b => new Wallet(b.privateKey, provider));
+    const dexWalletsList = (enableDexBuy ? dexBuyers : []).map(b => new Wallet(b.privateKey, provider));
+    // 计算买入金额
+    const curveTotalWei = ethers.parseEther(curveTotalBuyAmount);
+    const curveBuyAmounts = curveBuyers.every(b => b.buyAmount)
+        ? curveBuyers.map(b => ethers.parseEther(b.buyAmount))
+        : splitAmount(curveTotalWei, curveBuyers.length);
+    let dexBuyAmounts = [];
+    let dexTotalWei = 0n;
+    if (enableDexBuy && dexBuyers.length > 0 && dexTotalBuyAmount) {
+        dexTotalWei = ethers.parseEther(dexTotalBuyAmount);
+        dexBuyAmounts = dexBuyers.every(b => b.buyAmount)
+            ? dexBuyers.map(b => ethers.parseEther(b.buyAmount))
+            : splitAmount(dexTotalWei, dexBuyers.length);
+    }
+    // 计算利润
+    const totalBuyAmount = curveTotalWei + dexTotalWei;
+    const txCount = curveBuyers.length + (enableDexBuy ? dexBuyers.length : 0) + 1; // +1 for create
+    const profitWei = calculateProfitWei(totalBuyAmount, txCount, userType);
+    const profitRecipient = XLAYER_PROFIT_CONFIG.RECIPIENT;
+    console.log(`[Bundle发币] 内盘买入: ${curveBuyers.length} 个钱包, 总金额=${curveTotalBuyAmount} OKB`);
+    if (enableDexBuy) {
+        console.log(`[Bundle发币] 外盘买入: ${dexBuyers.length} 个钱包, 总金额=${dexTotalBuyAmount} OKB`);
+    }
+    console.log(`[Bundle发币] 利润: ${ethers.formatEther(profitWei)} OKB`);
+    // 构建参与者
+    const participants = [];
+    // 1. Dev 钱包：发币 + 利润转账
+    const devCalls = [];
+    // 发币
+    devCalls.push(buildPortalCreate(portalInterface, tokenInfo, devWallet.address, params));
+    // 利润转账（从 Dev 支付）
+    if (profitWei > 0n) {
+        devCalls.push(buildNativeTransfer(profitRecipient, profitWei));
+    }
+    participants.push({ wallet: devWallet, calls: devCalls });
+    // 2. 内盘买入钱包
+    for (let i = 0; i < curveWallets.length; i++) {
+        const wallet = curveWallets[i];
+        const buyAmount = curveBuyAmounts[i];
+        const calls = [
+            buildPortalBuy(portalInterface, tokenAddress, buyAmount, params.extensionData),
+        ];
+        participants.push({ wallet, calls });
+    }
+    // 3. 外盘买入钱包
+    if (enableDexBuy && dexWalletsList.length > 0) {
+        for (let i = 0; i < dexWalletsList.length; i++) {
+            const wallet = dexWalletsList[i];
+            const buyAmount = dexBuyAmounts[i];
+            const call = dexPoolType === 'v3'
+                ? buildDexBuyV3(tokenAddress, buyAmount, wallet.address, v3Fee)
+                : buildDexBuyV2(tokenAddress, buyAmount, wallet.address);
+            participants.push({ wallet, calls: [call] });
+        }
+    }
+    // 签名 Type 4 交易
+    const result = await buildAndSignType4Transaction(rpcUrl, gasPrice, participants);
+    return {
+        ...result,
+        tokenAddress,
+        metadata: {
+            curveBuyerCount: curveBuyers.length,
+            curveTotalBuy: curveTotalBuyAmount,
+            enableDexBuy,
+            dexBuyerCount: dexBuyers.length,
+            dexTotalBuy: dexTotalBuyAmount || '0',
+            profitAmount: ethers.formatEther(profitWei),
+        },
+        timestamp: Date.now(),
+    };
+}

package/dist/eip7702/xlayer/curve-to-dex.d.ts

@@ -0,0 +1,87 @@
+/**
+ * X-Layer Bundle 内盘买到外盘
+ *
+ * 功能：在一个 Type 4 交易中完成：
+ * 1. 多个钱包在 Bonding Curve（内盘）买入代币
+ * 2. 最后一个买家触发毕业（代币上 DEX）
+ * 3. 多个钱包在 PotatoSwap（外盘）继续买入
+ *
+ * ✅ 与 BSC 链 curve-to-dex.ts 功能对齐
+ * ✅ 使用 Type 4 交易（EIP-7702），所有操作原子化
+ */
+/** 用户类型 */
+export type UserType = 'v0' | 'v1' | 'normal';
+/** 内盘买入钱包配置 */
+export interface CurveBuyerConfig {
+    privateKey: string;
+    /** 买入金额（OKB），为空则自动分配 */
+    buyAmount?: string;
+}
+/** 外盘买入钱包配置 */
+export interface DexBuyerConfig {
+    privateKey: string;
+    /** 买入金额（OKB），为空则自动分配 */
+    buyAmount?: string;
+}
+/** 内盘买到外盘参数 */
+export interface CurveToDexParams {
+    /** RPC URL */
+    rpcUrl: string;
+    /** Gas Price (可选) */
+    gasPrice?: bigint;
+    /** 用户类型（影响利润率） */
+    userType?: UserType;
+    /** 代币地址（已存在的代币） */
+    tokenAddress: string;
+    /** 内盘买入钱包（这些钱包会在 Bonding Curve 上买入） */
+    curveBuyers: CurveBuyerConfig[];
+    /** 内盘总买入金额（用于自动分配） */
+    curveTotalBuyAmount?: string;
+    /** 是否触发毕业（上 DEX） */
+    triggerGraduate?: boolean;
+    /** 毕业触发者（内盘最后一个买家） */
+    graduateWallet?: {
+        privateKey: string;
+        buyAmount: string;
+    };
+    /** 外盘买入钱包（这些钱包会在 PotatoSwap 上买入） */
+    dexBuyers?: DexBuyerConfig[];
+    /** 外盘总买入金额（用于自动分配） */
+    dexTotalBuyAmount?: string;
+    /** 外盘池类型（V2 或 V3），默认 V2 */
+    dexPoolType?: 'v2' | 'v3';
+    /** V3 费率（100/500/2500/10000），默认 2500 */
+    v3Fee?: number;
+    /** 扩展数据 */
+    extensionData?: string;
+}
+/** 签名结果 */
+export interface CurveToDexSignedResult {
+    /** 签名后的 Type 4 交易 */
+    signedTx: string;
+    /** 交易哈希 */
+    txHash: string;
+    /** Sponsor 地址 */
+    sponsorAddress: string;
+    /** 元数据 */
+    metadata: {
+        curveBuyerCount: number;
+        curveTotalBuy: string;
+        graduated: boolean;
+        dexBuyerCount: number;
+        dexTotalBuy: string;
+        profitAmount: string;
+    };
+    /** 时间戳 */
+    timestamp: number;
+}
+/**
+ * 内盘买到外盘（Type 4 原子交易）
+ *
+ * 交易顺序：
+ * 1. 内盘买入（多个钱包在 Bonding Curve 买入）
+ * 2. 毕业触发（最后一个买家买入触发上 DEX）
+ * 3. 外盘买入（多个钱包在 PotatoSwap 买入）
+ * 4. 利润转账
+ */
+export declare function signCurveToDex(params: CurveToDexParams): Promise<CurveToDexSignedResult>;