four-flap-meme-sdk 1.9.24 → 1.9.26

package/dist/chains/bsc/constants.d.ts

@@ -26,6 +26,7 @@ export declare const BSC_ADDRESSES: {
     readonly BlockRazorBuilder: "0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20";
     readonly IroSwapV2Factory: "0x637D87a4165C5fF8f6cdDa8EC8cA394b1f0CEcdf";
     readonly IroSwapV2Router: "0xe90fb729E458092592a79EdaFefB3404ecb3C463";
+    readonly IroFactory: "0x421D0B1a848E0f71E0bBa79275E4aB0A1fA0cc8b";
 };
 export declare const WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
 export declare const USDT: "0x55d398326f99059fF775485246999027B3197955";
@@ -40,6 +41,9 @@ export declare const PANCAKE_V2_FACTORY: "0xcA143Ce32Fe78f1f7019d7d551a6402fC535
 export declare const PANCAKE_V3_ROUTER: "0x13f4EA83D0bd40E75C8222255bc855a974568Dd4";
 export declare const PANCAKE_V3_QUOTER: "0xB048Bbc1Ee6b733FFfCFb9e9CeF7375518e25997";
 export declare const BLOCKRAZOR_BUILDER: "0x1266C6bE60392A8Ff346E8d5ECCd3E69dD9c5F20";
+export declare const IROSWAP_V2_FACTORY: "0x637D87a4165C5fF8f6cdDa8EC8cA394b1f0CEcdf";
+export declare const IROSWAP_V2_ROUTER: "0xe90fb729E458092592a79EdaFefB3404ecb3C463";
+export declare const IRO_FACTORY: "0x421D0B1a848E0f71E0bBa79275E4aB0A1fA0cc8b";
 /** BSC 原生代币转账 Gas Limit */
 export declare const NATIVE_TRANSFER_GAS_LIMIT: 21055n;
 /** BSC ERC20 转账 Gas Limit */

package/dist/chains/bsc/constants.js

@@ -33,6 +33,11 @@ export const PANCAKE_V3_ROUTER = ADDRESSES.BSC.PancakeV3Router;
 export const PANCAKE_V3_QUOTER = ADDRESSES.BSC.PancakeV3Quoter;
 // BlockRazor Builder
 export const BLOCKRAZOR_BUILDER = ADDRESSES.BSC.BlockRazorBuilder;
+// IROSwap
+export const IROSWAP_V2_FACTORY = ADDRESSES.BSC.IroSwapV2Factory;
+export const IROSWAP_V2_ROUTER = ADDRESSES.BSC.IroSwapV2Router;
+// IRO 发币平台
+export const IRO_FACTORY = ADDRESSES.BSC.IroFactory;
 // ============================================================================
 // Gas 配置
 // ============================================================================

package/dist/chains/bsc/index.d.ts

@@ -7,3 +7,4 @@ export * from './constants.js';
 export * as platforms from './platforms/index.js';
 export { disperseWithBundleMerkle, sweepWithBundleMerkle, pairwiseTransferWithBundleMerkle, fourBundleSwapMerkle, fourBatchSwapMerkle, fourQuickBatchSwapMerkle, fourBundleBuyFirstMerkle, submitBundleToMerkle, submitBundleToBlockRazor, submitDirectToRpc, submitDirectToRpcSmart, approveFourTokenManagerBatch, } from './platforms/four/index.js';
 export { pancakeBundleSwapMerkle, pancakeBatchSwapMerkle, pancakeQuickBatchSwapMerkle, pancakeCrossSwapMerkle, pancakeBundleBuyFirstMerkle, } from './platforms/pancake/index.js';
+export { IroFactoryQuery, createProject as iroCreateProject, encodeCreateProjectCall as iroEncodeCreateProjectCall, parseCreateProjectEvent as iroParseCreateProjectEvent, IroTokenQuery, subscribe as iroSubscribe, pledge as iroPledge, batchSubscribe as iroBatchSubscribe, batchSubscribeForSubmit as iroBatchSubscribeForSubmit, IroPoolQuery, poolRemovePledge as iroPoolRemovePledge, poolExtract as iroPoolExtract, poolTransferAwards as iroPoolTransferAwards, batchExtract as iroBatchExtract, IRO_FACTORY_ADDRESS, IRO_FACTORY_ABI, IRO_TOKEN_ABI, IRO_POOL_ABI, IRO_PLATFORM_URL, iroApiCreateProject, iroApiUploadImage, } from './platforms/iro/index.js';

package/dist/chains/bsc/index.js

@@ -25,3 +25,17 @@ approveFourTokenManagerBatch, } from './platforms/four/index.js';
 // 快捷导出 - PancakeSwap
 // ============================================================================
 export { pancakeBundleSwapMerkle, pancakeBatchSwapMerkle, pancakeQuickBatchSwapMerkle, pancakeCrossSwapMerkle, pancakeBundleBuyFirstMerkle, } from './platforms/pancake/index.js';
+// ============================================================================
+// 快捷导出 - IRO 发币平台
+// ============================================================================
+export { 
+// Factory
+IroFactoryQuery, createProject as iroCreateProject, encodeCreateProjectCall as iroEncodeCreateProjectCall, parseCreateProjectEvent as iroParseCreateProjectEvent, 
+// Token
+IroTokenQuery, subscribe as iroSubscribe, pledge as iroPledge, batchSubscribe as iroBatchSubscribe, batchSubscribeForSubmit as iroBatchSubscribeForSubmit, 
+// Pool
+IroPoolQuery, poolRemovePledge as iroPoolRemovePledge, poolExtract as iroPoolExtract, poolTransferAwards as iroPoolTransferAwards, batchExtract as iroBatchExtract, 
+// 常量
+IRO_FACTORY_ADDRESS, IRO_FACTORY_ABI, IRO_TOKEN_ABI, IRO_POOL_ABI, 
+// API (IRO 平台后端)
+IRO_PLATFORM_URL, iroApiCreateProject, iroApiUploadImage, } from './platforms/iro/index.js';

package/dist/chains/bsc/platforms/index.d.ts

@@ -3,3 +3,4 @@
  */
 export * as four from './four/index.js';
 export * as pancake from './pancake/index.js';
+export * as iro from './iro/index.js';

package/dist/chains/bsc/platforms/index.js

@@ -5,3 +5,5 @@
 export * as four from './four/index.js';
 // PancakeSwap 平台
 export * as pancake from './pancake/index.js';
+// IRO 发币平台
+export * as iro from './iro/index.js';

package/dist/chains/bsc/platforms/iro/api.d.ts

@@ -0,0 +1,53 @@
+/**
+ * IRO 平台后端 API
+ *
+ * Base URL: https://dapp-iro.ironetwork.com
+ * 无需 X-Signature 校验
+ */
+export declare const IRO_PLATFORM_URL = "https://dapp-iro.ironetwork.com";
+export interface IroApiCreateProjectRequest {
+    /** 代币 LOGO 图片 URL (先通过上传接口获取) */
+    logo: string;
+    /** 代币名称 */
+    name: string;
+    /** 代币符号 */
+    symbol: string;
+    /** 总供应量 */
+    totalSupply: string;
+    /** 代币描述 */
+    description: string;
+    /** 硬顶 */
+    hardCap: string;
+    /** 初始价格 */
+    initPrice: string;
+}
+export interface IroApiCreateProjectResponse {
+    status: number;
+    message: string;
+    data: {
+        projectID: string;
+    };
+}
+export interface IroApiUploadImageResponse {
+    status: number;
+    message: string;
+    data: {
+        /** 图片路径 */
+        path: string;
+    };
+}
+/**
+ * 发布项目 — 获取 projectID
+ *
+ * POST /api/community/create/open
+ * @returns projectID 字符串 (如 "20241009014234831377")
+ */
+export declare function iroApiCreateProject(params: IroApiCreateProjectRequest): Promise<string>;
+/**
+ * 上传图片 — 获取 LOGO URL
+ *
+ * POST /api/upload/image
+ * 参数: img (file binary, 必填)
+ * @returns 图片 URL (data.path)
+ */
+export declare function iroApiUploadImage(file: File | Blob, filename?: string): Promise<string>;

package/dist/chains/bsc/platforms/iro/api.js

@@ -0,0 +1,74 @@
+/**
+ * IRO 平台后端 API
+ *
+ * Base URL: https://dapp-iro.ironetwork.com
+ * 无需 X-Signature 校验
+ */
+// ============================================================================
+// 常量
+// ============================================================================
+export const IRO_PLATFORM_URL = 'https://dapp-iro.ironetwork.com';
+const IRO_API_BASE = IRO_PLATFORM_URL;
+// ============================================================================
+// 内部请求工具
+// ============================================================================
+async function request(path, options = {}) {
+    const url = `${IRO_API_BASE}${path}`;
+    const res = await fetch(url, {
+        ...options,
+        headers: {
+            ...options.headers,
+        },
+    });
+    if (!res.ok) {
+        const text = await res.text().catch(() => '');
+        throw new Error(`IRO API error (${res.status}): ${text || res.statusText}`);
+    }
+    return (await res.json());
+}
+// ============================================================================
+// 公开 API
+// ============================================================================
+/**
+ * 发布项目 — 获取 projectID
+ *
+ * POST /api/community/create/open
+ * @returns projectID 字符串 (如 "20241009014234831377")
+ */
+export async function iroApiCreateProject(params) {
+    const body = new FormData();
+    body.append('logo', params.logo);
+    body.append('name', params.name);
+    body.append('symbol', params.symbol);
+    body.append('totalSupply', params.totalSupply);
+    body.append('description', params.description);
+    body.append('hardCap', params.hardCap);
+    body.append('initPrice', params.initPrice);
+    const res = await request('/api/community/create/open', {
+        method: 'POST',
+        body,
+    });
+    if (res.status !== 200 || !res.data?.projectID) {
+        throw new Error(`IRO API createProject failed: ${res.message || 'unknown'}`);
+    }
+    return res.data.projectID;
+}
+/**
+ * 上传图片 — 获取 LOGO URL
+ *
+ * POST /api/upload/image
+ * 参数: img (file binary, 必填)
+ * @returns 图片 URL (data.path)
+ */
+export async function iroApiUploadImage(file, filename) {
+    const body = new FormData();
+    body.append('img', file, filename || 'logo.png');
+    const res = await request('/api/upload/image', {
+        method: 'POST',
+        body,
+    });
+    if (res.status !== 200 || !res.data?.path) {
+        throw new Error(`IRO API uploadImage failed: ${res.message || 'unknown'}`);
+    }
+    return res.data.path;
+}

package/dist/chains/bsc/platforms/iro/constants.d.ts

@@ -0,0 +1,20 @@
+/**
+ * IRO 平台常量 — 合约地址 + ABI
+ */
+/** IRO 工厂合约地址 (BSC) — 已验证: IROFactory */
+export declare const IRO_FACTORY_ADDRESS: "0x421D0B1a848E0f71E0bBa79275E4aB0A1fA0cc8b";
+/** IROSwap V2 Router */
+export declare const IROSWAP_V2_ROUTER: "0xe90fb729E458092592a79EdaFefB3404ecb3C463";
+/** IROSwap V2 Factory */
+export declare const IROSWAP_V2_FACTORY: "0x637D87a4165C5fF8f6cdDa8EC8cA394b1f0CEcdf";
+/** USDT on BSC */
+export declare const USDT_BSC: "0x55d398326f99059fF775485246999027B3197955";
+export declare const IRO_FACTORY_ABI: readonly ["function createProject(uint256 _projectID, uint256 _totalSupply, uint256 _initPrice, string memory _symbol, uint256[2] memory softAndHardCap, address coinAddr, uint256 pledgeDays, tuple(address account, uint256 quota)[] memory _addressList) returns (address pool)", "function projectIDToken(uint256) view returns (address)", "function getPool(address token) view returns (address poolAddress)", "function allToken(uint256) view returns (address token)", "function allTokensLength() view returns (uint256)", "function tokenInfo(address token) view returns (string name, uint256 totalSupply, uint256 initPrice, address creator, uint256 softCap, uint256 hardCap, bool isWhitelisted, uint256 pledgeDays)", "event CreateProject(uint256 indexed projectID, address indexed token, address indexed pool, address TKAAddr, uint256 len)"];
+export declare const IRO_TOKEN_ABI: readonly ["function name() view returns (string)", "function symbol() view returns (string)", "function decimals() view returns (uint8)", "function totalSupply() view returns (uint256)", "function balanceOf(address account) view returns (uint256)", "function allowance(address owner, address spender) view returns (uint256)", "function approve(address spender, uint256 amount) returns (bool)", "function transfer(address to, uint256 amount) returns (bool)", "function transferFrom(address from, address to, uint256 amount) returns (bool)", "function subscribe(address _user, uint256 amount) payable", "function pledge(address _user, uint256 amount) payable", "function price() view returns (uint256)", "function creator() view returns (address)", "function isOpen() view returns (bool)", "function isWhitelisted() view returns (bool)", "function isWXOC() view returns (bool)", "function tradingLimit() view returns (uint256)", "function totalCreatorFee() view returns (uint256)", "function POOL() view returns (address)", "function TKA() view returns (address)", "function getTokenPrice() view returns (uint256 pairToken, uint256 pairTKA, uint256 newPrice)", "function dayProduce(uint256 day) view returns (bool)"];
+export declare const IRO_POOL_ABI: readonly ["function pledge(address _user, uint256 amount, uint256 share) external", "function removePledge() external", "function extract(uint256 amount) external", "function transferAwards(address[] recipients, uint256[] TKAAmounts) external", "function token() view returns (address)", "function totalShare() view returns (uint256)", "function produceNum() view returns (uint256)", "function produceLpNum() view returns (uint256)", "function produceLimit() view returns (uint256)", "function lastAddProduce() view returns (uint256)", "function getDeposit(address account) view returns (uint256)", "function getUserPledgeLpForUsdt(address _user) view returns (uint256 lpForUsdt)", "function getLPValueForUSDTValue(uint256 targetTKAValue) view returns (uint256 valueInTKA)", "function increaseRateMap(uint256) view returns (bool status, uint256 rate)"];
+/** 默认 Gas Limit — createProject */
+export declare const CREATE_PROJECT_GAS_LIMIT = 5000000n;
+/** 默认 Gas Limit — subscribe / pledge (内含 addLiquidity + swap) */
+export declare const SUBSCRIBE_GAS_LIMIT = 1500000n;
+/** 默认 Gas Limit — Pool 操作 */
+export declare const POOL_OPERATION_GAS_LIMIT = 300000n;

package/dist/chains/bsc/platforms/iro/constants.js

@@ -0,0 +1,90 @@
+/**
+ * IRO 平台常量 — 合约地址 + ABI
+ */
+import { ADDRESSES } from '../../../../shared/constants/index.js';
+// ============================================================================
+// 合约地址
+// ============================================================================
+/** IRO 工厂合约地址 (BSC) — 已验证: IROFactory */
+export const IRO_FACTORY_ADDRESS = ADDRESSES.BSC.IroFactory;
+/** IROSwap V2 Router */
+export const IROSWAP_V2_ROUTER = ADDRESSES.BSC.IroSwapV2Router;
+/** IROSwap V2 Factory */
+export const IROSWAP_V2_FACTORY = ADDRESSES.BSC.IroSwapV2Factory;
+/** USDT on BSC */
+export const USDT_BSC = ADDRESSES.BSC.USDT;
+// ============================================================================
+// IRO Factory ABI
+// ============================================================================
+const WHITE_LIST_QUOTA_TUPLE = 'tuple(address account, uint256 quota)';
+export const IRO_FACTORY_ABI = [
+    `function createProject(uint256 _projectID, uint256 _totalSupply, uint256 _initPrice, string memory _symbol, uint256[2] memory softAndHardCap, address coinAddr, uint256 pledgeDays, ${WHITE_LIST_QUOTA_TUPLE}[] memory _addressList) returns (address pool)`,
+    'function projectIDToken(uint256) view returns (address)',
+    'function getPool(address token) view returns (address poolAddress)',
+    'function allToken(uint256) view returns (address token)',
+    'function allTokensLength() view returns (uint256)',
+    `function tokenInfo(address token) view returns (string name, uint256 totalSupply, uint256 initPrice, address creator, uint256 softCap, uint256 hardCap, bool isWhitelisted, uint256 pledgeDays)`,
+    'event CreateProject(uint256 indexed projectID, address indexed token, address indexed pool, address TKAAddr, uint256 len)',
+];
+// ============================================================================
+// IRO Token ABI (ERC20 + subscribe/pledge)
+// ============================================================================
+export const IRO_TOKEN_ABI = [
+    // 标准 ERC20
+    'function name() view returns (string)',
+    'function symbol() view returns (string)',
+    'function decimals() view returns (uint8)',
+    'function totalSupply() view returns (uint256)',
+    'function balanceOf(address account) view returns (uint256)',
+    'function allowance(address owner, address spender) view returns (uint256)',
+    'function approve(address spender, uint256 amount) returns (bool)',
+    'function transfer(address to, uint256 amount) returns (bool)',
+    'function transferFrom(address from, address to, uint256 amount) returns (bool)',
+    // IRO 认购（预售阶段）
+    'function subscribe(address _user, uint256 amount) payable',
+    // IRO 认购（开盘后）
+    'function pledge(address _user, uint256 amount) payable',
+    // IRO 查询
+    'function price() view returns (uint256)',
+    'function creator() view returns (address)',
+    'function isOpen() view returns (bool)',
+    'function isWhitelisted() view returns (bool)',
+    'function isWXOC() view returns (bool)',
+    'function tradingLimit() view returns (uint256)',
+    'function totalCreatorFee() view returns (uint256)',
+    'function POOL() view returns (address)',
+    'function TKA() view returns (address)',
+    'function getTokenPrice() view returns (uint256 pairToken, uint256 pairTKA, uint256 newPrice)',
+    'function dayProduce(uint256 day) view returns (bool)',
+];
+// ============================================================================
+// IRO Pool ABI
+// ============================================================================
+export const IRO_POOL_ABI = [
+    // 写入 — 由 Token 合约内部调用
+    'function pledge(address _user, uint256 amount, uint256 share) external',
+    // 写入 — 用户直接调用
+    'function removePledge() external',
+    'function extract(uint256 amount) external',
+    'function transferAwards(address[] recipients, uint256[] TKAAmounts) external',
+    // 查询
+    'function token() view returns (address)',
+    'function totalShare() view returns (uint256)',
+    'function produceNum() view returns (uint256)',
+    'function produceLpNum() view returns (uint256)',
+    'function produceLimit() view returns (uint256)',
+    'function lastAddProduce() view returns (uint256)',
+    'function getDeposit(address account) view returns (uint256)',
+    'function getUserPledgeLpForUsdt(address _user) view returns (uint256 lpForUsdt)',
+    'function getLPValueForUSDTValue(uint256 targetTKAValue) view returns (uint256 valueInTKA)',
+    'function increaseRateMap(uint256) view returns (bool status, uint256 rate)',
+];
+// ============================================================================
+// 通用常量
+// ============================================================================
+/** 默认 Gas Limit — createProject */
+export const CREATE_PROJECT_GAS_LIMIT = 5000000n;
+/** 默认 Gas Limit — subscribe / pledge (内含 addLiquidity + swap) */
+export const SUBSCRIBE_GAS_LIMIT = 1500000n;
+/** 默认 Gas Limit — Pool 操作 */
+export const POOL_OPERATION_GAS_LIMIT = 300000n;

package/dist/chains/bsc/platforms/iro/factory.d.ts

@@ -0,0 +1,59 @@
+/**
+ * IRO Factory — 创建项目 (部署代币 + 资金池)
+ *
+ * 核心功能:
+ * - createProject: 创建 IRO 项目
+ * - 查询: 通过 projectId / token 地址获取信息
+ */
+import { JsonRpcProvider } from 'ethers';
+import type { IroCreateParams, IroCreateProjectResult, IroQueryConfig, IroFactoryTokenInfo } from './types.js';
+export declare class IroFactoryQuery {
+    private provider;
+    private factory;
+    constructor(config?: IroQueryConfig);
+    /** 通过 projectId 获取代币合约地址 */
+    getTokenByProjectId(projectId: bigint): Promise<string>;
+    /** 通过 token 地址获取 Pool 合约地址 */
+    getPool(tokenAddress: string): Promise<string>;
+    /** 获取指定 index 的 token 地址 */
+    allToken(index: bigint): Promise<string>;
+    /** 获取已创建的 token 总数 */
+    allTokensLength(): Promise<bigint>;
+    /** 获取代币的完整链上信息 */
+    tokenInfo(tokenAddress: string): Promise<IroFactoryTokenInfo>;
+    /** 获取项目的完整信息 (token + pool) */
+    getProjectInfo(projectId: bigint): Promise<{
+        tokenAddress: string;
+        poolAddress: string;
+    }>;
+    get providerInstance(): JsonRpcProvider;
+}
+/**
+ * 编码 createProject calldata
+ */
+export declare function encodeCreateProjectCall(params: import('./types.js').IroCreateProjectParams): string;
+/**
+ * 创建 IRO 项目 — 签名交易
+ *
+ * 前置条件: 调用者需先将 USDT approve 给 Factory 合约
+ * 注意: 调用者必须是 IROOwner 中注册的 broker
+ */
+export declare function createProject(params: IroCreateParams): Promise<IroCreateProjectResult>;
+/**
+ * 从交易回执中解析 CreateProject 事件
+ *
+ * 链上事件签名:
+ * event CreateProject(uint256 indexed projectID, address indexed token, address indexed pool, address TKAAddr, uint256 len)
+ */
+export declare function parseCreateProjectEvent(receipt: {
+    logs: Array<{
+        topics: string[];
+        data: string;
+    }>;
+}): {
+    projectId: bigint;
+    tokenAddress: string;
+    poolAddress: string;
+    coinAddr: string;
+    allTokensLength: bigint;
+} | null;

package/dist/chains/bsc/platforms/iro/factory.js

@@ -0,0 +1,135 @@
+/**
+ * IRO Factory — 创建项目 (部署代币 + 资金池)
+ *
+ * 核心功能:
+ * - createProject: 创建 IRO 项目
+ * - 查询: 通过 projectId / token 地址获取信息
+ */
+import { Contract, Interface, Wallet, JsonRpcProvider } from 'ethers';
+import { BSC_CHAIN_ID, BSC_RPC_URL } from '../../constants.js';
+import { IRO_FACTORY_ADDRESS, IRO_FACTORY_ABI, CREATE_PROJECT_GAS_LIMIT, } from './constants.js';
+const factoryIface = new Interface(IRO_FACTORY_ABI);
+// ============================================================================
+// 只读查询
+// ============================================================================
+export class IroFactoryQuery {
+    constructor(config = {}) {
+        const rpcUrl = config.rpcUrl ?? BSC_RPC_URL;
+        this.provider = new JsonRpcProvider(rpcUrl, BSC_CHAIN_ID, { staticNetwork: true });
+        const addr = config.factoryAddress ?? IRO_FACTORY_ADDRESS;
+        if (!addr)
+            throw new Error('IRO Factory address not configured');
+        this.factory = new Contract(addr, IRO_FACTORY_ABI, this.provider);
+    }
+    /** 通过 projectId 获取代币合约地址 */
+    async getTokenByProjectId(projectId) {
+        return this.factory.projectIDToken(projectId);
+    }
+    /** 通过 token 地址获取 Pool 合约地址 */
+    async getPool(tokenAddress) {
+        return this.factory.getPool(tokenAddress);
+    }
+    /** 获取指定 index 的 token 地址 */
+    async allToken(index) {
+        return this.factory.allToken(index);
+    }
+    /** 获取已创建的 token 总数 */
+    async allTokensLength() {
+        return this.factory.allTokensLength();
+    }
+    /** 获取代币的完整链上信息 */
+    async tokenInfo(tokenAddress) {
+        const raw = await this.factory.tokenInfo(tokenAddress);
+        return {
+            name: raw[0],
+            totalSupply: BigInt(raw[1]),
+            initPrice: BigInt(raw[2]),
+            creator: raw[3],
+            softCap: BigInt(raw[4]),
+            hardCap: BigInt(raw[5]),
+            isWhitelisted: raw[6],
+            pledgeDays: BigInt(raw[7]),
+        };
+    }
+    /** 获取项目的完整信息 (token + pool) */
+    async getProjectInfo(projectId) {
+        const tokenAddress = await this.getTokenByProjectId(projectId);
+        const poolAddress = await this.getPool(tokenAddress);
+        return { tokenAddress, poolAddress };
+    }
+    get providerInstance() {
+        return this.provider;
+    }
+}
+// ============================================================================
+// 写入操作
+// ============================================================================
+/**
+ * 编码 createProject calldata
+ */
+export function encodeCreateProjectCall(params) {
+    const whiteListTuples = params.whiteList.map((w) => [w.addr, w.quota]);
+    return factoryIface.encodeFunctionData('createProject', [
+        params.projectId,
+        params.totalSupply,
+        params.initPrice,
+        params.symbol,
+        [params.softCap, params.hardCap],
+        params.coinAddr,
+        params.pledgeDays,
+        whiteListTuples,
+    ]);
+}
+/**
+ * 创建 IRO 项目 — 签名交易
+ *
+ * 前置条件: 调用者需先将 USDT approve 给 Factory 合约
+ * 注意: 调用者必须是 IROOwner 中注册的 broker
+ */
+export async function createProject(params) {
+    const { rpcUrl = BSC_RPC_URL, privateKey, factoryAddress, params: projectParams, gasPrice, } = params;
+    const targetFactory = factoryAddress ?? IRO_FACTORY_ADDRESS;
+    if (!targetFactory)
+        throw new Error('IRO Factory address not configured');
+    const provider = new JsonRpcProvider(rpcUrl, BSC_CHAIN_ID, { staticNetwork: true });
+    const wallet = new Wallet(privateKey, provider);
+    const calldata = encodeCreateProjectCall(projectParams);
+    const nonce = await wallet.getNonce();
+    const feeData = await provider.getFeeData();
+    const signedTx = await wallet.signTransaction({
+        to: targetFactory,
+        data: calldata,
+        nonce,
+        chainId: BSC_CHAIN_ID,
+        type: 0,
+        gasPrice: gasPrice ?? feeData.gasPrice ?? 3000000000n,
+        gasLimit: CREATE_PROJECT_GAS_LIMIT,
+    });
+    return { signedTx, from: wallet.address, nonce };
+}
+/**
+ * 从交易回执中解析 CreateProject 事件
+ *
+ * 链上事件签名:
+ * event CreateProject(uint256 indexed projectID, address indexed token, address indexed pool, address TKAAddr, uint256 len)
+ */
+export function parseCreateProjectEvent(receipt) {
+    for (const log of receipt.logs) {
+        try {
+            const parsed = factoryIface.parseLog({ topics: [...log.topics], data: log.data });
+            if (parsed && parsed.name === 'CreateProject') {
+                return {
+                    projectId: BigInt(parsed.args[0]),
+                    tokenAddress: parsed.args[1],
+                    poolAddress: parsed.args[2],
+                    coinAddr: parsed.args[3],
+                    allTokensLength: BigInt(parsed.args[4]),
+                };
+            }
+        }
+        catch {
+            continue;
+        }
+    }
+    return null;
+}

package/dist/chains/bsc/platforms/iro/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * IRO (Initial Rights Offering) 发币平台模块入口
+ *
+ * 三大合约 (已验证源码):
+ * - IROFactory (0x421D0B1a...): 创建项目 (部署代币 + 资金池)
+ * - IROToken:   ERC20 + 认购 (subscribe / pledge)
+ * - IROPool:    LP 质押、挖矿、收益提取
+ */
+export type { WhiteListQuota, IroCreateProjectParams, IroFactoryTokenInfo, IroSubscribeParams, IroPledgeParams, IroTokenPrice, IroPoolRemovePledgeParams, IroPoolExtractParams, IroPoolTransferAwardsParams, IroTokenInfo, IroTxResult, IroCreateProjectResult, IroQueryConfig, IroCreateParams, } from './types.js';
+export { IRO_FACTORY_ADDRESS, IROSWAP_V2_ROUTER, IROSWAP_V2_FACTORY, USDT_BSC, IRO_FACTORY_ABI, IRO_TOKEN_ABI, IRO_POOL_ABI, CREATE_PROJECT_GAS_LIMIT, SUBSCRIBE_GAS_LIMIT, POOL_OPERATION_GAS_LIMIT, } from './constants.js';
+export { IroFactoryQuery, encodeCreateProjectCall, createProject, parseCreateProjectEvent, } from './factory.js';
+export { IroTokenQuery, subscribe, pledge, batchSubscribe, batchSubscribeForSubmit, } from './token.js';
+export type { IroBatchSubscribeForSubmitParams, IroBatchSubscribeForSubmitResult, } from './token.js';
+export { IroPoolQuery, poolRemovePledge, poolExtract, poolTransferAwards, batchExtract, } from './pool.js';
+export { IRO_PLATFORM_URL, iroApiCreateProject, iroApiUploadImage, } from './api.js';
+export type { IroApiCreateProjectRequest, IroApiCreateProjectResponse, IroApiUploadImageResponse, } from './api.js';

package/dist/chains/bsc/platforms/iro/index.js

@@ -0,0 +1,28 @@
+/**
+ * IRO (Initial Rights Offering) 发币平台模块入口
+ *
+ * 三大合约 (已验证源码):
+ * - IROFactory (0x421D0B1a...): 创建项目 (部署代币 + 资金池)
+ * - IROToken:   ERC20 + 认购 (subscribe / pledge)
+ * - IROPool:    LP 质押、挖矿、收益提取
+ */
+// ============================================================================
+// 常量
+// ============================================================================
+export { IRO_FACTORY_ADDRESS, IROSWAP_V2_ROUTER, IROSWAP_V2_FACTORY, USDT_BSC, IRO_FACTORY_ABI, IRO_TOKEN_ABI, IRO_POOL_ABI, CREATE_PROJECT_GAS_LIMIT, SUBSCRIBE_GAS_LIMIT, POOL_OPERATION_GAS_LIMIT, } from './constants.js';
+// ============================================================================
+// Factory (工厂合约)
+// ============================================================================
+export { IroFactoryQuery, encodeCreateProjectCall, createProject, parseCreateProjectEvent, } from './factory.js';
+// ============================================================================
+// Token (代币合约 — 认购)
+// ============================================================================
+export { IroTokenQuery, subscribe, pledge, batchSubscribe, batchSubscribeForSubmit, } from './token.js';
+// ============================================================================
+// Pool (资金池 — 质押/挖矿)
+// ============================================================================
+export { IroPoolQuery, poolRemovePledge, poolExtract, poolTransferAwards, batchExtract, } from './pool.js';
+// ============================================================================
+// API (IRO 平台后端)
+// ============================================================================
+export { IRO_PLATFORM_URL, iroApiCreateProject, iroApiUploadImage, } from './api.js';

package/dist/chains/bsc/platforms/iro/pool.d.ts

@@ -0,0 +1,72 @@
+/**
+ * IRO Pool — LP 质押、挖矿、奖励提取
+ *
+ * 链上合约 IROPool:
+ * - pledge: 由 Token 合约内部调用 (用户通过 Token.subscribe/pledge 间接触发)
+ * - removePledge: 用户移除全部质押
+ * - extract: 用户提取挖矿收益
+ * - transferAwards: 批量转移收益
+ * - 查询: getDeposit, totalShare, getUserPledgeLpForUsdt 等
+ */
+import { JsonRpcProvider } from 'ethers';
+import type { IroPoolRemovePledgeParams, IroPoolExtractParams, IroPoolTransferAwardsParams, IroTxResult } from './types.js';
+export declare class IroPoolQuery {
+    private provider;
+    private pool;
+    readonly poolAddress: string;
+    constructor(poolAddress: string, rpcUrl?: string);
+    /** 获取绑定的 token 地址 */
+    token(): Promise<string>;
+    /** 获取总份额 */
+    totalShare(): Promise<bigint>;
+    /** 获取产出次数 */
+    produceNum(): Promise<bigint>;
+    /** 获取产出 LP 数量 */
+    produceLpNum(): Promise<bigint>;
+    /** 获取产出上限 */
+    produceLimit(): Promise<bigint>;
+    /** 获取上次增加产出的时间 */
+    lastAddProduce(): Promise<bigint>;
+    /** 获取用户可提取的收益 */
+    getDeposit(account: string): Promise<bigint>;
+    /** 获取用户质押 LP 对应的 USDT 价值 */
+    getUserPledgeLpForUsdt(user: string): Promise<bigint>;
+    /** 查询指定 USDT 价值对应的 LP 数量 */
+    getLPValueForUSDTValue(targetTKAValue: bigint): Promise<bigint>;
+    /** 查询增长率映射 */
+    increaseRateMap(index: bigint): Promise<{
+        status: boolean;
+        rate: bigint;
+    }>;
+    get providerInstance(): JsonRpcProvider;
+}
+/**
+ * 移除全部质押
+ * removePledge() — 用户直接调用
+ */
+export declare function poolRemovePledge(params: IroPoolRemovePledgeParams): Promise<IroTxResult>;
+/**
+ * 提取挖矿收益
+ * extract(uint256 amount) — 用户直接调用
+ */
+export declare function poolExtract(params: IroPoolExtractParams): Promise<IroTxResult>;
+/**
+ * 批量转移收益
+ * transferAwards(address[] recipients, uint256[] TKAAmounts) — 用户直接调用
+ */
+export declare function poolTransferAwards(params: IroPoolTransferAwardsParams): Promise<IroTxResult>;
+/**
+ * 批量提取收益 — 多钱包同时 extract
+ */
+export declare function batchExtract(params: {
+    rpcUrl?: string;
+    poolAddress: string;
+    wallets: Array<{
+        privateKey: string;
+        amount: bigint;
+    }>;
+    gasPrice?: bigint;
+}): Promise<{
+    signedTransactions: string[];
+    results: IroTxResult[];
+}>;