four-flap-meme-sdk 2.0.0 → 2.2.0

package/dist/shared/flap/portal/writer.js

@@ -1,265 +0,0 @@
-import { Contract, JsonRpcProvider, Wallet } from 'ethers';
-import { PORTAL_ABI } from '../../../abis/flap/portal.js';
-import { FLAP_PORTAL_ADDRESSES } from '../constants.js';
-import { FlapPortal } from './portal.js';
-export class FlapPortalWriter extends FlapPortal {
-    constructor(cfg, privateKey) {
-        super(cfg);
-        // 使用 ethers v6 创建钱包
-        const provider = new JsonRpcProvider(cfg.rpcUrl);
-        this.wallet = new Wallet(privateKey, provider);
-        // 重新创建可写合约实例
-        this.contract = new Contract(this.portal, PORTAL_ABI, this.wallet);
-    }
-    // 买入代币
-    async buy(token, to, minAmount, msgValue) {
-        const tx = await this.contract.buy(token, to, minAmount, { value: msgValue });
-        return await tx.wait();
-    }
-    // 创建代币时同时买入
-    // buyOnCreation 已从合约端移除，SDK 同步移除
-    // 卖出代币
-    async sell(token, amount, minEth) {
-        const tx = await this.contract.sell(token, amount, minEth);
-        return await tx.wait();
-    }
-    // 发送 swap 交易
-    async swapExactInput(params, msgValue) {
-        const tx = await this.contract.swapExactInput({
-            inputToken: params.inputToken,
-            outputToken: params.outputToken,
-            inputAmount: params.inputAmount,
-            minOutputAmount: params.minOutputAmount,
-            permitData: params.permitData ?? '0x',
-        }, { value: msgValue });
-        return await tx.wait();
-    }
-    // 发送显式买入交易
-    async swapExactInputBuy(params, msgValue) {
-        const tx = await this.contract.swapExactInputBuy({
-            inputToken: params.inputToken,
-            outputToken: params.outputToken,
-            inputAmount: params.inputAmount,
-            minOutputAmount: params.minOutputAmount,
-            permitData: params.permitData ?? '0x',
-        }, { value: msgValue });
-        return await tx.wait();
-    }
-    // 发送显式卖出交易
-    async swapExactInputSell(params) {
-        const tx = await this.contract.swapExactInputSell({
-            inputToken: params.inputToken,
-            outputToken: params.outputToken,
-            inputAmount: params.inputAmount,
-            minOutputAmount: params.minOutputAmount,
-            permitData: params.permitData ?? '0x',
-        });
-        return await tx.wait();
-    }
-    // 发送 swap 交易（V3，支持扩展数据）
-    async swapExactInputV3(params, msgValue) {
-        const tx = await this.contract.swapExactInputV3({
-            inputToken: params.inputToken,
-            outputToken: params.outputToken,
-            inputAmount: params.inputAmount,
-            minOutputAmount: params.minOutputAmount,
-            permitData: params.permitData ?? '0x',
-            extensionData: params.extensionData ?? '0x',
-        }, { value: msgValue });
-        return await tx.wait();
-    }
-    async newTokenV2(args) {
-        const tx = await this.contract.newTokenV2({
-            name: args.name,
-            symbol: args.symbol,
-            meta: args.meta,
-            dexThresh: args.dexThresh,
-            salt: args.salt,
-            taxRate: args.taxRate,
-            migratorType: args.migratorType,
-            quoteToken: args.quoteToken,
-            quoteAmt: args.quoteAmt,
-            beneficiary: args.beneficiary,
-            permitData: args.permitData ?? '0x',
-        }, { value: args.msgValue });
-        return await tx.wait();
-    }
-    async newTokenV3(args) {
-        const tx = await this.contract.newTokenV3({
-            name: args.name,
-            symbol: args.symbol,
-            meta: args.meta,
-            dexThresh: args.dexThresh,
-            salt: args.salt,
-            taxRate: args.taxRate,
-            migratorType: args.migratorType,
-            quoteToken: args.quoteToken,
-            quoteAmt: args.quoteAmt,
-            beneficiary: args.beneficiary,
-            permitData: args.permitData ?? '0x',
-            extensionID: args.extensionID,
-            extensionData: args.extensionData ?? '0x',
-        }, { value: args.msgValue });
-        return await tx.wait();
-    }
-    /**
-     * 创建代币 V4 版本
-     * 相比 V3 新增了 DEX 选择和 LP 费率配置
-     *
-     * @param args 创建代币参数
-     * @param args.dexId DEX ID，选择迁移到哪个 DEX（使用 DEXId 枚举）
-     * @param args.lpFeeProfile LP 费率档位（使用 V3LPFeeProfile 枚举）
-     *
-     * @example
-     * ```typescript
-     * await portal.newTokenV4({
-     *   name: 'My Token',
-     *   symbol: 'MTK',
-     *   meta: 'bafkreicwlkpvrcqg4bbhyp2fnhdwbqos5ghka6gdjra3tdkgxxs74hqsze',
-     *   dexThresh: DexThreshType.FOUR_FIFTHS,
-     *   salt: '0x...',
-     *   taxRate: 0,
-     *   migratorType: MigratorType.V3_MIGRATOR,
-     *   quoteToken: '0x0000000000000000000000000000000000000000',
-     *   quoteAmt: 0n,
-     *   beneficiary: '0x...',
-     *   extensionID: '0x0000000000000000000000000000000000000000000000000000000000000000',
-     *   dexId: DEXId.DEX0,
-     *   lpFeeProfile: V3LPFeeProfile.LP_FEE_PROFILE_STANDARD,
-     *   msgValue: parseEther('0.01'),
-     * });
-     * ```
-     *
-     * @note BNB 链上使用 LP_FEE_PROFILE_LOW (0.01%) 需要白名单地址
-     */
-    async newTokenV4(args) {
-        const tx = await this.contract.newTokenV4({
-            name: args.name,
-            symbol: args.symbol,
-            meta: args.meta,
-            dexThresh: args.dexThresh,
-            salt: args.salt,
-            taxRate: args.taxRate,
-            migratorType: args.migratorType,
-            quoteToken: args.quoteToken,
-            quoteAmt: args.quoteAmt,
-            beneficiary: args.beneficiary,
-            permitData: args.permitData ?? '0x',
-            extensionID: args.extensionID,
-            extensionData: args.extensionData ?? '0x',
-            dexId: args.dexId,
-            lpFeeProfile: args.lpFeeProfile,
-        }, { value: args.msgValue });
-        return await tx.wait();
-    }
-    /**
-     * 创建 Token V5（支持 Tax Token V2 高级税收分配）
-     *
-     * 当 taxRate > 0 时，支持以下税收分配：
-     * - mktBps: 营销分配（发送到 beneficiary 地址）
-     * - deflationBps: 通缩销毁（直接销毁）
-     * - dividendBps: 持有者分红（发送到分红合约）
-     * - lpBps: 流动性提供（LP 发送到 dead address）
-     *
-     * 注意：mktBps + deflationBps + dividendBps + lpBps 必须等于 10000 (100%)
-     *
-     * @example
-     * ```typescript
-     * // 创建一个 3% 税率的代币，税收分配：40% 营销，30% 销毁，20% 分红，10% 流动性
-     * await portal.newTokenV5({
-     *   name: 'My Tax Token',
-     *   symbol: 'MTT',
-     *   meta: 'bafkrei...',
-     *   dexThresh: DexThreshType.FOUR_FIFTHS,
-     *   salt: '0x...',
-     *   taxRate: 300,  // 3%
-     *   migratorType: MigratorType.V2_MIGRATOR,  // 税代币必须使用 V2 迁移器
-     *   quoteToken: '0x0000000000000000000000000000000000000000',
-     *   quoteAmt: 0n,
-     *   beneficiary: '0x...',
-     *   extensionID: '0x0000000000000000000000000000000000000000000000000000000000000000',
-     *   dexId: DEXId.DEX0,
-     *   lpFeeProfile: V3LPFeeProfile.LP_FEE_PROFILE_STANDARD,
-     *   taxDuration: 365n * 24n * 60n * 60n,  // 1 年
-     *   antiFarmerDuration: 60n * 60n,  // 1 小时
-     *   mktBps: 4000,  // 40%
-     *   deflationBps: 3000,  // 30%
-     *   dividendBps: 2000,  // 20%
-     *   lpBps: 1000,  // 10%
-     *   minimumShareBalance: 10000n * 10n ** 18n,  // 10K 代币
-     *   msgValue: parseEther('0.01'),
-     * });
-     * ```
-     *
-     * @note 税代币（taxRate > 0）必须使用 V2_MIGRATOR
-     */
-    async newTokenV5(args) {
-        // 验证税收分配
-        if (args.taxRate > 0) {
-            const total = args.mktBps + args.deflationBps + args.dividendBps + args.lpBps;
-            if (total !== 10000) {
-                throw new Error(`税收分配总计必须为 10000 (100%)，当前为 ${total}`);
-            }
-            if (args.dividendBps > 0 && args.minimumShareBalance < 10000n * 10n ** 18n) {
-                throw new Error('启用分红时，最低持仓门槛必须至少为 10,000 个代币');
-            }
-        }
-        const tx = await this.contract.newTokenV5({
-            name: args.name,
-            symbol: args.symbol,
-            meta: args.meta,
-            dexThresh: args.dexThresh,
-            salt: args.salt,
-            taxRate: args.taxRate,
-            migratorType: args.migratorType,
-            quoteToken: args.quoteToken,
-            quoteAmt: args.quoteAmt,
-            beneficiary: args.beneficiary,
-            permitData: args.permitData ?? '0x',
-            extensionID: args.extensionID,
-            extensionData: args.extensionData ?? '0x',
-            dexId: args.dexId,
-            lpFeeProfile: args.lpFeeProfile,
-            taxDuration: args.taxDuration,
-            antiFarmerDuration: args.antiFarmerDuration,
-            mktBps: args.mktBps,
-            deflationBps: args.deflationBps,
-            dividendBps: args.dividendBps,
-            lpBps: args.lpBps,
-            minimumShareBalance: args.minimumShareBalance,
-        }, { value: args.msgValue });
-        return await tx.wait();
-    }
-    // 受益人领取收益
-    async claim(token) {
-        const tx = await this.contract.claim(token);
-        const receipt = await tx.wait();
-        // 这里返回 hash，具体的 tokenAmount 和 ethAmount 需要从事件中解析
-        return { txHash: receipt.hash, tokenAmount: 0n, ethAmount: 0n };
-    }
-    // 受益人委托领取收益
-    async delegateClaim(token) {
-        const tx = await this.contract.delegateClaim(token);
-        const receipt = await tx.wait();
-        return { txHash: receipt.hash, tokenAmount: 0n, ethAmount: 0n };
-    }
-    /**
-     * 获取当前使用的 Portal 合约地址
-     * 用于事件监听等场景
-     */
-    getContractAddress() {
-        return this.portal;
-    }
-}
-/**
- * 获取 Flap Portal 合约地址（内部使用）
- * 注意：此方法不对外导出，用户应使用 FlapPortal 实例而非直接获取地址
- * @internal
- */
-function getFlapPortalAddress(chain) {
-    const address = FLAP_PORTAL_ADDRESSES[chain];
-    if (!address) {
-        throw new Error(`Flap Portal not deployed on ${chain}`);
-    }
-    return address;
-}

package/dist/shared/flap/portal-bundle-merkle/core/index.d.ts

@@ -1,18 +0,0 @@
-import { FlapCreateWithBundleBuySignParams, FlapCreateWithBundleBuyMerkleResult, FlapBatchBuySignParams, FlapBatchBuyMerkleResult, FlapBatchSellSignParams, FlapBatchSellMerkleResult } from '../types.js';
-/**
- * Flap Protocol: 创建代币 + 捆绑购买（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- */
-export declare function createTokenWithBundleBuyMerkle(params: FlapCreateWithBundleBuySignParams): Promise<FlapCreateWithBundleBuyMerkleResult>;
-/**
- * Flap Protocol: 批量购买（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 支持 quoteToken：传入 USDC 等地址时使用该代币购买，否则使用原生代币
- */
-export declare function batchBuyWithBundleMerkle(params: FlapBatchBuySignParams): Promise<FlapBatchBuyMerkleResult>;
-/**
- * Flap Protocol: 批量卖出（仅签名版本 - 不依赖 Merkle）
- * ✅ 精简版：只负责签名交易，不提交到 Merkle
- * ✅ 支持 quoteToken：传入 USDC 等地址时卖出为该代币，否则卖出为原生代币
- */
-export declare function batchSellWithBundleMerkle(params: FlapBatchSellSignParams): Promise<FlapBatchSellMerkleResult>;