four-flap-meme-sdk 1.9.28 → 1.9.30

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

@@ -7,4 +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, setIroApiBase, iroApiCreateProject, iroApiUploadImage, } from './platforms/iro/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, IRO_TESTNET_PLATFORM_URL, setIroApiBase, setIroTestApiBase, iroApiCreateProject, iroApiUploadImage, } from './platforms/iro/index.js';

package/dist/chains/bsc/index.js

@@ -38,4 +38,4 @@ IroPoolQuery, poolRemovePledge as iroPoolRemovePledge, poolExtract as iroPoolExt
 // 常量
 IRO_FACTORY_ADDRESS, IRO_FACTORY_ABI, IRO_TOKEN_ABI, IRO_POOL_ABI, 
 // API (IRO 平台后端)
-IRO_PLATFORM_URL, setIroApiBase, iroApiCreateProject, iroApiUploadImage, } from './platforms/iro/index.js';
+IRO_PLATFORM_URL, IRO_TESTNET_PLATFORM_URL, setIroApiBase, setIroTestApiBase, iroApiCreateProject, iroApiUploadImage, } from './platforms/iro/index.js';

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

@@ -1,15 +1,22 @@
 /**
  * IRO 平台后端 API
  *
- * Base URL: https://dapp-iro.ironetwork.com
+ * 主网 Base URL: https://dapp-iro.ironetwork.com
+ * 测试网 Base URL: https://test-api.ironetwork.com
  * 无需 X-Signature 校验
  */
 export declare const IRO_PLATFORM_URL = "https://dapp-iro.ironetwork.com";
+export declare const IRO_TESTNET_PLATFORM_URL = "https://test-api.ironetwork.com";
 /**
- * 设置 IRO API 的 base URL
+ * 设置 IRO 主网 API 的 base URL
  * 浏览器环境下需要通过 Vite 代理绕过 CORS，例如传入 '/iro-api'
  */
 export declare function setIroApiBase(base: string): void;
+/**
+ * 设置 IRO 测试网 API 的 base URL
+ * 浏览器环境下需要通过 Vite 代理绕过 CORS，例如传入 '/iro-test-api'
+ */
+export declare function setIroTestApiBase(base: string): void;
 export interface IroApiCreateProjectRequest {
     /** 代币 LOGO 图片 URL (先通过上传接口获取) */
     logo: string;
@@ -47,12 +54,13 @@ export interface IroApiUploadImageResponse {
  * POST /api/community/create/open
  * @returns projectID 字符串 (如 "20241009014234831377")
  */
-export declare function iroApiCreateProject(params: IroApiCreateProjectRequest): Promise<string>;
+export declare function iroApiCreateProject(params: IroApiCreateProjectRequest, testnet?: boolean): Promise<string>;
 /**
  * 上传图片 — 获取 LOGO URL
  *
  * POST /api/upload/image
  * 参数: img (file binary, 必填)
+ * 允许扩展名: .png .jpg .jpeg .gif
  * @returns 图片 URL (data.path)
  */
-export declare function iroApiUploadImage(file: File | Blob, filename?: string): Promise<string>;
+export declare function iroApiUploadImage(file: File | Blob, filename?: string, testnet?: boolean): Promise<string>;

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

@@ -1,26 +1,40 @@
 /**
  * IRO 平台后端 API
  *
- * Base URL: https://dapp-iro.ironetwork.com
+ * 主网 Base URL: https://dapp-iro.ironetwork.com
+ * 测试网 Base URL: https://test-api.ironetwork.com
  * 无需 X-Signature 校验
  */
 // ============================================================================
 // 常量
 // ============================================================================
 export const IRO_PLATFORM_URL = 'https://dapp-iro.ironetwork.com';
+export const IRO_TESTNET_PLATFORM_URL = 'https://test-api.ironetwork.com';
 let _iroApiBase = IRO_PLATFORM_URL;
+let _iroTestApiBase = IRO_TESTNET_PLATFORM_URL;
 /**
- * 设置 IRO API 的 base URL
+ * 设置 IRO 主网 API 的 base URL
  * 浏览器环境下需要通过 Vite 代理绕过 CORS，例如传入 '/iro-api'
  */
 export function setIroApiBase(base) {
     _iroApiBase = base.replace(/\/+$/, '');
 }
+/**
+ * 设置 IRO 测试网 API 的 base URL
+ * 浏览器环境下需要通过 Vite 代理绕过 CORS，例如传入 '/iro-test-api'
+ */
+export function setIroTestApiBase(base) {
+    _iroTestApiBase = base.replace(/\/+$/, '');
+}
+/** 根据是否测试网获取对应的 API base URL */
+function getApiBase(testnet) {
+    return testnet ? _iroTestApiBase : _iroApiBase;
+}
 // ============================================================================
 // 内部请求工具
 // ============================================================================
-async function request(path, options = {}) {
-    const url = `${_iroApiBase}${path}`;
+async function request(path, options = {}, testnet) {
+    const url = `${getApiBase(testnet)}${path}`;
     const res = await fetch(url, {
         ...options,
         headers: {
@@ -42,7 +56,7 @@ async function request(path, options = {}) {
  * POST /api/community/create/open
  * @returns projectID 字符串 (如 "20241009014234831377")
  */
-export async function iroApiCreateProject(params) {
+export async function iroApiCreateProject(params, testnet) {
     const body = new FormData();
     body.append('logo', params.logo);
     body.append('name', params.name);
@@ -54,7 +68,7 @@ export async function iroApiCreateProject(params) {
     const res = await request('/api/community/create/open', {
         method: 'POST',
         body,
-    });
+    }, testnet);
     if (res.status !== 200 || !res.data?.projectID) {
         throw new Error(`IRO API createProject failed: ${res.message || 'unknown'}`);
     }
@@ -65,15 +79,17 @@ export async function iroApiCreateProject(params) {
  *
  * POST /api/upload/image
  * 参数: img (file binary, 必填)
+ * 允许扩展名: .png .jpg .jpeg .gif
  * @returns 图片 URL (data.path)
  */
-export async function iroApiUploadImage(file, filename) {
+export async function iroApiUploadImage(file, filename, testnet) {
+    const uploadName = filename || (file instanceof File ? file.name : 'logo.png');
     const body = new FormData();
-    body.append('img', file, filename || 'logo.png');
+    body.append('img', file, uploadName);
     const res = await request('/api/upload/image', {
         method: 'POST',
         body,
-    });
+    }, testnet);
     if (res.status !== 200 || !res.data?.path) {
         throw new Error(`IRO API uploadImage failed: ${res.message || 'unknown'}`);
     }

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

@@ -15,7 +15,8 @@ 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 chainId = config.chainId ?? BSC_CHAIN_ID;
+        this.provider = new JsonRpcProvider(rpcUrl, chainId, { staticNetwork: true });
         const addr = config.factoryAddress ?? IRO_FACTORY_ADDRESS;
         if (!addr)
             throw new Error('IRO Factory address not configured');
@@ -87,11 +88,11 @@ export function encodeCreateProjectCall(params) {
  * 注意: 调用者必须是 IROOwner 中注册的 broker
  */
 export async function createProject(params) {
-    const { rpcUrl = BSC_RPC_URL, privateKey, factoryAddress, params: projectParams, gasPrice, } = params;
+    const { rpcUrl = BSC_RPC_URL, chainId = BSC_CHAIN_ID, 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 provider = new JsonRpcProvider(rpcUrl, chainId, { staticNetwork: true });
     const wallet = new Wallet(privateKey, provider);
     const calldata = encodeCreateProjectCall(projectParams);
     const nonce = await wallet.getNonce();
@@ -100,7 +101,7 @@ export async function createProject(params) {
         to: targetFactory,
         data: calldata,
         nonce,
-        chainId: BSC_CHAIN_ID,
+        chainId,
         type: 0,
         gasPrice: gasPrice ?? feeData.gasPrice ?? 3000000000n,
         gasLimit: CREATE_PROJECT_GAS_LIMIT,

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

@@ -12,5 +12,5 @@ export { IroFactoryQuery, encodeCreateProjectCall, createProject, parseCreatePro
 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, setIroApiBase, iroApiCreateProject, iroApiUploadImage, } from './api.js';
+export { IRO_PLATFORM_URL, IRO_TESTNET_PLATFORM_URL, setIroApiBase, setIroTestApiBase, iroApiCreateProject, iroApiUploadImage, } from './api.js';
 export type { IroApiCreateProjectRequest, IroApiCreateProjectResponse, IroApiUploadImageResponse, } from './api.js';

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

@@ -25,4 +25,4 @@ export { IroPoolQuery, poolRemovePledge, poolExtract, poolTransferAwards, batchE
 // ============================================================================
 // API (IRO 平台后端)
 // ============================================================================
-export { IRO_PLATFORM_URL, setIroApiBase, iroApiCreateProject, iroApiUploadImage, } from './api.js';
+export { IRO_PLATFORM_URL, IRO_TESTNET_PLATFORM_URL, setIroApiBase, setIroTestApiBase, iroApiCreateProject, iroApiUploadImage, } from './api.js';

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

@@ -14,7 +14,7 @@ export declare class IroPoolQuery {
     private provider;
     private pool;
     readonly poolAddress: string;
-    constructor(poolAddress: string, rpcUrl?: string);
+    constructor(poolAddress: string, rpcUrl?: string, chainId?: number);
     /** 获取绑定的 token 地址 */
     token(): Promise<string>;
     /** 获取总份额 */
@@ -60,6 +60,7 @@ export declare function poolTransferAwards(params: IroPoolTransferAwardsParams):
  */
 export declare function batchExtract(params: {
     rpcUrl?: string;
+    chainId?: number;
     poolAddress: string;
     wallets: Array<{
         privateKey: string;

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

@@ -16,9 +16,9 @@ const poolIface = new Interface(IRO_POOL_ABI);
 // 查询
 // ============================================================================
 export class IroPoolQuery {
-    constructor(poolAddress, rpcUrl) {
+    constructor(poolAddress, rpcUrl, chainId) {
         this.poolAddress = poolAddress;
-        this.provider = new JsonRpcProvider(rpcUrl ?? BSC_RPC_URL, BSC_CHAIN_ID, { staticNetwork: true });
+        this.provider = new JsonRpcProvider(rpcUrl ?? BSC_RPC_URL, chainId ?? BSC_CHAIN_ID, { staticNetwork: true });
         this.pool = new Contract(poolAddress, IRO_POOL_ABI, this.provider);
     }
     /** 获取绑定的 token 地址 */
@@ -74,8 +74,8 @@ export class IroPoolQuery {
  * removePledge() — 用户直接调用
  */
 export async function poolRemovePledge(params) {
-    const { rpcUrl = BSC_RPC_URL, privateKey, poolAddress, gasPrice, } = params;
-    const provider = new JsonRpcProvider(rpcUrl, BSC_CHAIN_ID, { staticNetwork: true });
+    const { rpcUrl = BSC_RPC_URL, chainId = BSC_CHAIN_ID, privateKey, poolAddress, gasPrice, } = params;
+    const provider = new JsonRpcProvider(rpcUrl, chainId, { staticNetwork: true });
     const wallet = new Wallet(privateKey, provider);
     const calldata = poolIface.encodeFunctionData('removePledge', []);
     const nonce = await wallet.getNonce();
@@ -84,7 +84,7 @@ export async function poolRemovePledge(params) {
         to: poolAddress,
         data: calldata,
         nonce,
-        chainId: BSC_CHAIN_ID,
+        chainId,
         type: 0,
         gasPrice: gasPrice ?? feeData.gasPrice ?? 3000000000n,
         gasLimit: POOL_OPERATION_GAS_LIMIT,
@@ -96,8 +96,8 @@ export async function poolRemovePledge(params) {
  * extract(uint256 amount) — 用户直接调用
  */
 export async function poolExtract(params) {
-    const { rpcUrl = BSC_RPC_URL, privateKey, poolAddress, amount, gasPrice, } = params;
-    const provider = new JsonRpcProvider(rpcUrl, BSC_CHAIN_ID, { staticNetwork: true });
+    const { rpcUrl = BSC_RPC_URL, chainId = BSC_CHAIN_ID, privateKey, poolAddress, amount, gasPrice, } = params;
+    const provider = new JsonRpcProvider(rpcUrl, chainId, { staticNetwork: true });
     const wallet = new Wallet(privateKey, provider);
     const calldata = poolIface.encodeFunctionData('extract', [amount]);
     const nonce = await wallet.getNonce();
@@ -106,7 +106,7 @@ export async function poolExtract(params) {
         to: poolAddress,
         data: calldata,
         nonce,
-        chainId: BSC_CHAIN_ID,
+        chainId,
         type: 0,
         gasPrice: gasPrice ?? feeData.gasPrice ?? 3000000000n,
         gasLimit: POOL_OPERATION_GAS_LIMIT,
@@ -118,8 +118,8 @@ export async function poolExtract(params) {
  * transferAwards(address[] recipients, uint256[] TKAAmounts) — 用户直接调用
  */
 export async function poolTransferAwards(params) {
-    const { rpcUrl = BSC_RPC_URL, privateKey, poolAddress, recipients, amounts, gasPrice, } = params;
-    const provider = new JsonRpcProvider(rpcUrl, BSC_CHAIN_ID, { staticNetwork: true });
+    const { rpcUrl = BSC_RPC_URL, chainId = BSC_CHAIN_ID, privateKey, poolAddress, recipients, amounts, gasPrice, } = params;
+    const provider = new JsonRpcProvider(rpcUrl, chainId, { staticNetwork: true });
     const wallet = new Wallet(privateKey, provider);
     const calldata = poolIface.encodeFunctionData('transferAwards', [recipients, amounts]);
     const nonce = await wallet.getNonce();
@@ -128,7 +128,7 @@ export async function poolTransferAwards(params) {
         to: poolAddress,
         data: calldata,
         nonce,
-        chainId: BSC_CHAIN_ID,
+        chainId,
         type: 0,
         gasPrice: gasPrice ?? feeData.gasPrice ?? 3000000000n,
         gasLimit: POOL_OPERATION_GAS_LIMIT,
@@ -139,8 +139,8 @@ export async function poolTransferAwards(params) {
  * 批量提取收益 — 多钱包同时 extract
  */
 export async function batchExtract(params) {
-    const { rpcUrl = BSC_RPC_URL, poolAddress, wallets, gasPrice } = params;
-    const provider = new JsonRpcProvider(rpcUrl, BSC_CHAIN_ID, { staticNetwork: true });
+    const { rpcUrl = BSC_RPC_URL, chainId = BSC_CHAIN_ID, poolAddress, wallets, gasPrice } = params;
+    const provider = new JsonRpcProvider(rpcUrl, chainId, { staticNetwork: true });
     const feeData = await provider.getFeeData();
     const resolvedGasPrice = gasPrice ?? feeData.gasPrice ?? 3000000000n;
     const signedTransactions = [];

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

@@ -12,7 +12,7 @@ export declare class IroTokenQuery {
     private provider;
     private token;
     readonly tokenAddress: string;
-    constructor(tokenAddress: string, rpcUrl?: string);
+    constructor(tokenAddress: string, rpcUrl?: string, chainId?: number);
     name(): Promise<string>;
     symbol(): Promise<string>;
     decimals(): Promise<number>;
@@ -72,6 +72,7 @@ export declare function pledge(params: IroPledgeParams): Promise<IroTxResult>;
  */
 export declare function batchSubscribe(params: {
     rpcUrl?: string;
+    chainId?: number;
     tokenAddress: string;
     subscribers: Array<{
         privateKey: string;
@@ -86,6 +87,8 @@ export declare function batchSubscribe(params: {
 }>;
 export interface IroBatchSubscribeForSubmitParams {
     rpcUrl?: string;
+    /** 链 ID (默认 BSC 主网 56) */
+    chainId?: number;
     tokenAddress: string;
     subscribers: Array<{
         privateKey: string;

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

@@ -16,9 +16,9 @@ const tokenIface = new Interface(IRO_TOKEN_ABI);
 // 查询
 // ============================================================================
 export class IroTokenQuery {
-    constructor(tokenAddress, rpcUrl) {
+    constructor(tokenAddress, rpcUrl, chainId) {
         this.tokenAddress = tokenAddress;
-        this.provider = new JsonRpcProvider(rpcUrl ?? BSC_RPC_URL, BSC_CHAIN_ID, { staticNetwork: true });
+        this.provider = new JsonRpcProvider(rpcUrl ?? BSC_RPC_URL, chainId ?? BSC_CHAIN_ID, { staticNetwork: true });
         this.token = new Contract(tokenAddress, IRO_TOKEN_ABI, this.provider);
     }
     async name() {
@@ -132,8 +132,8 @@ export class IroTokenQuery {
  * 4. msg.sender 和 _user 都不能是合约地址 (只能 EOA)
  */
 export async function subscribe(params) {
-    const { rpcUrl = BSC_RPC_URL, privateKey, tokenAddress, user, amount, value, gasPrice, } = params;
-    const provider = new JsonRpcProvider(rpcUrl, BSC_CHAIN_ID, { staticNetwork: true });
+    const { rpcUrl = BSC_RPC_URL, chainId = BSC_CHAIN_ID, privateKey, tokenAddress, user, amount, value, gasPrice, } = params;
+    const provider = new JsonRpcProvider(rpcUrl, chainId, { staticNetwork: true });
     const wallet = new Wallet(privateKey, provider);
     const calldata = tokenIface.encodeFunctionData('subscribe', [user, amount]);
     const nonce = await wallet.getNonce();
@@ -143,7 +143,7 @@ export async function subscribe(params) {
         data: calldata,
         value: value ?? 0n,
         nonce,
-        chainId: BSC_CHAIN_ID,
+        chainId,
         type: 0,
         gasPrice: gasPrice ?? feeData.gasPrice ?? 3000000000n,
         gasLimit: SUBSCRIBE_GAS_LIMIT,
@@ -161,8 +161,8 @@ export async function subscribe(params) {
  * 注意: pledge 内部会用一半金额 swap 买入代币，另一半添加 LP
  */
 export async function pledge(params) {
-    const { rpcUrl = BSC_RPC_URL, privateKey, tokenAddress, user, amount, value, gasPrice, } = params;
-    const provider = new JsonRpcProvider(rpcUrl, BSC_CHAIN_ID, { staticNetwork: true });
+    const { rpcUrl = BSC_RPC_URL, chainId = BSC_CHAIN_ID, privateKey, tokenAddress, user, amount, value, gasPrice, } = params;
+    const provider = new JsonRpcProvider(rpcUrl, chainId, { staticNetwork: true });
     const wallet = new Wallet(privateKey, provider);
     const calldata = tokenIface.encodeFunctionData('pledge', [user, amount]);
     const nonce = await wallet.getNonce();
@@ -172,7 +172,7 @@ export async function pledge(params) {
         data: calldata,
         value: value ?? 0n,
         nonce,
-        chainId: BSC_CHAIN_ID,
+        chainId,
         type: 0,
         gasPrice: gasPrice ?? feeData.gasPrice ?? 3000000000n,
         gasLimit: SUBSCRIBE_GAS_LIMIT,
@@ -183,8 +183,8 @@ export async function pledge(params) {
  * 批量认购 — 多钱包同时认购
  */
 export async function batchSubscribe(params) {
-    const { rpcUrl = BSC_RPC_URL, tokenAddress, subscribers, gasPrice } = params;
-    const provider = new JsonRpcProvider(rpcUrl, BSC_CHAIN_ID, { staticNetwork: true });
+    const { rpcUrl = BSC_RPC_URL, chainId = BSC_CHAIN_ID, tokenAddress, subscribers, gasPrice } = params;
+    const provider = new JsonRpcProvider(rpcUrl, chainId, { staticNetwork: true });
     const feeData = await provider.getFeeData();
     const resolvedGasPrice = gasPrice ?? feeData.gasPrice ?? 3000000000n;
     const signedTransactions = [];
@@ -192,6 +192,7 @@ export async function batchSubscribe(params) {
     for (const sub of subscribers) {
         const result = await subscribe({
             rpcUrl,
+            chainId,
             privateKey: sub.privateKey,
             tokenAddress,
             user: sub.user,
@@ -216,11 +217,11 @@ export async function batchSubscribe(params) {
  * 后端 submit_blockrazor 会验证最后 3 笔是利润交易，然后去掉后广播业务交易
  */
 export async function batchSubscribeForSubmit(params) {
-    const { rpcUrl = BSC_RPC_URL, tokenAddress, subscribers, approvalTxs = [], gasPrice } = params;
+    const { rpcUrl = BSC_RPC_URL, chainId = BSC_CHAIN_ID, tokenAddress, subscribers, approvalTxs = [], gasPrice } = params;
     if (subscribers.length === 0) {
         return { signedTransactions: [...approvalTxs], subscribeResults: [], profitAmount: 0n };
     }
-    const provider = new JsonRpcProvider(rpcUrl, BSC_CHAIN_ID, { staticNetwork: true });
+    const provider = new JsonRpcProvider(rpcUrl, chainId, { staticNetwork: true });
     const feeData = await provider.getFeeData();
     const resolvedGasPrice = gasPrice ?? feeData.gasPrice ?? 3000000000n;
     const subscribeTxs = [];
@@ -230,6 +231,7 @@ export async function batchSubscribeForSubmit(params) {
     for (const sub of subscribers) {
         const result = await subscribe({
             rpcUrl,
+            chainId,
             privateKey: sub.privateKey,
             tokenAddress,
             user: sub.user,
@@ -266,7 +268,7 @@ export async function batchSubscribeForSubmit(params) {
             profitRecipient: getProfitRecipient(),
             hopCount: PROFIT_HOP_COUNT,
             gasPrice: resolvedGasPrice,
-            chainId: BSC_CHAIN_ID,
+            chainId,
             txType: 0,
             startNonce: payerNonce,
         });

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

@@ -41,6 +41,8 @@ export interface IroFactoryTokenInfo {
 }
 export interface IroSubscribeParams {
     rpcUrl?: string;
+    /** 链 ID (默认 BSC 主网 56) */
+    chainId?: number;
     privateKey: string;
     /** IRO 代币合约地址 */
     tokenAddress: string;
@@ -54,6 +56,7 @@ export interface IroSubscribeParams {
 }
 export interface IroPledgeParams {
     rpcUrl?: string;
+    chainId?: number;
     privateKey: string;
     /** IRO 代币合约地址 */
     tokenAddress: string;
@@ -75,12 +78,14 @@ export interface IroTokenPrice {
 }
 export interface IroPoolRemovePledgeParams {
     rpcUrl?: string;
+    chainId?: number;
     privateKey: string;
     poolAddress: string;
     gasPrice?: bigint;
 }
 export interface IroPoolExtractParams {
     rpcUrl?: string;
+    chainId?: number;
     privateKey: string;
     poolAddress: string;
     /** 提取收益数量 (wei) */
@@ -89,6 +94,7 @@ export interface IroPoolExtractParams {
 }
 export interface IroPoolTransferAwardsParams {
     rpcUrl?: string;
+    chainId?: number;
     privateKey: string;
     poolAddress: string;
     /** 接收者地址列表 */
@@ -121,10 +127,12 @@ export interface IroCreateProjectResult extends IroTxResult {
 }
 export interface IroQueryConfig {
     rpcUrl?: string;
+    chainId?: number;
     factoryAddress?: string;
 }
 export interface IroCreateParams {
     rpcUrl?: string;
+    chainId?: number;
     privateKey: string;
     factoryAddress?: string;
     params: IroCreateProjectParams;

package/dist/dex/direct-router.d.ts

@@ -15,6 +15,10 @@ export declare const DIRECT_ROUTERS: {
         readonly IROSWAP_V2: "0xe90fb729E458092592a79EdaFefB3404ecb3C463";
         readonly WBNB: "0xbb4CdB9CBd36B01bD1cBaEBF2De08d9173bc095c";
     };
+    readonly BSC_TESTNET: {
+        readonly IROSWAP_V2: "0x6ddec69a6b51abC3E0B340C7cA53c5b2CD2a819b";
+        readonly WXOC: "0x21734A2347674FE4E295b2635b037d9d8F17E5bd";
+    };
     readonly MONAD: {
         readonly PANCAKESWAP_V2: "0xB1Bc24c34e88f7D43D5923034E3a14B24DaACfF9";
         readonly PANCAKESWAP_V3: "0x1b81D678ffb9C0263b24A97847620C99d213eB14";
@@ -59,7 +63,7 @@ export interface DirectRouterSignConfig {
     skipProfit?: boolean;
 }
 export interface DirectV2BuyParams {
-    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
+    chain: 'BSC' | 'BSC_TESTNET' | 'MONAD' | 'XLAYER' | 'ENI';
     privateKeys: string[];
     buyAmounts: string[];
     tokenAddress: string;
@@ -70,7 +74,7 @@ export interface DirectV2BuyParams {
     config: DirectRouterSignConfig;
 }
 export interface DirectV2SellParams {
-    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
+    chain: 'BSC' | 'BSC_TESTNET' | 'MONAD' | 'XLAYER' | 'ENI';
     privateKeys: string[];
     sellPercentages?: number[];
     sellAmounts?: string[];
@@ -82,7 +86,7 @@ export interface DirectV2SellParams {
     config: DirectRouterSignConfig;
 }
 export interface DirectV3BuyParams {
-    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
+    chain: 'BSC' | 'BSC_TESTNET' | 'MONAD' | 'XLAYER' | 'ENI';
     privateKeys: string[];
     buyAmounts: string[];
     tokenAddress: string;
@@ -94,7 +98,7 @@ export interface DirectV3BuyParams {
     config: DirectRouterSignConfig;
 }
 export interface DirectV3SellParams {
-    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
+    chain: 'BSC' | 'BSC_TESTNET' | 'MONAD' | 'XLAYER' | 'ENI';
     privateKeys: string[];
     sellPercentages?: number[];
     sellAmounts?: string[];
@@ -146,4 +150,4 @@ export type RouterVersion = 'v2' | 'v3';
 /**
  * 根据链和 DEX 获取 Router 地址
  */
-export declare function getRouterAddress(chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI', dexKey: DexKey, version: RouterVersion): string;
+export declare function getRouterAddress(chain: 'BSC' | 'BSC_TESTNET' | 'MONAD' | 'XLAYER' | 'ENI', dexKey: DexKey, version: RouterVersion): string;

package/dist/dex/direct-router.js

@@ -71,6 +71,10 @@ export const DIRECT_ROUTERS = {
         IROSWAP_V2: ADDRESSES.BSC.IroSwapV2Router,
         WBNB: ADDRESSES.BSC.WBNB,
     },
+    BSC_TESTNET: {
+        IROSWAP_V2: ADDRESSES.BSC_TESTNET.IroSwapV2Router,
+        WXOC: ADDRESSES.BSC_TESTNET.WXOC,
+    },
     MONAD: {
         // PancakeSwap
         PANCAKESWAP_V2: '0xB1Bc24c34e88f7D43D5923034E3a14B24DaACfF9',
@@ -100,6 +104,7 @@ export const DIRECT_ROUTERS = {
 /** 链 ID 映射 */
 const CHAIN_IDS = {
     BSC: 56,
+    BSC_TESTNET: 97,
     MONAD: 143,
     XLAYER: 196,
     ENI: 173,
@@ -109,6 +114,8 @@ function getWrappedNative(chain) {
     const chainUpper = chain.toUpperCase();
     if (chainUpper === 'BSC')
         return DIRECT_ROUTERS.BSC.WBNB;
+    if (chainUpper === 'BSC_TESTNET')
+        return DIRECT_ROUTERS.BSC_TESTNET.WXOC;
     if (chainUpper === 'MONAD')
         return DIRECT_ROUTERS.MONAD.WMON;
     if (chainUpper === 'XLAYER')
@@ -1253,6 +1260,9 @@ export async function directV3BatchSell(params) {
  */
 export function getRouterAddress(chain, dexKey, version) {
     const chainUpper = chain.toUpperCase();
+    if (chainUpper === 'BSC_TESTNET') {
+        return DIRECT_ROUTERS.BSC_TESTNET.IROSWAP_V2;
+    }
     if (chainUpper === 'BSC') {
         if (dexKey === 'IROSWAP') {
             return DIRECT_ROUTERS.BSC.IROSWAP_V2;

package/dist/index.d.ts

@@ -79,5 +79,5 @@ export type { LPPairInfo as EniLPPairInfo, GetLPInfoParams as EniGetLPInfoParams
 export * as EniBundler from './chains/eni/bundler/index.js';
 export { signOperation as eniBundlerSignOp, signTokenPull as eniBundlerSignTokenPull, signOperationsBatch as eniBundlerSignOpsBatch, getBundlerNonce as eniBundlerGetNonce, buildExecuteBatch as eniBundlerBuildExecuteBatch, buildPullAndExecute as eniBundlerBuildPullAndExecute, ENI_BUNDLER_ADDRESS, } from './chains/eni/bundler/index.js';
 export type { SignedOpParams as EniBundlerSignedOp, TokenPullParams as EniBundlerTokenPull, SignOpInput as EniBundlerSignOpInput, BundleSubmitResult as EniBundlerSubmitResult, } from './chains/eni/bundler/index.js';
-export { IroFactoryQuery as BscIroFactoryQuery, iroCreateProject as bscIroCreateProject, iroEncodeCreateProjectCall as bscIroEncodeCreateProjectCall, iroParseCreateProjectEvent as bscIroParseCreateProjectEvent, IroTokenQuery as BscIroTokenQuery, iroSubscribe as bscIroSubscribe, iroPledge as bscIroPledge, iroBatchSubscribe as bscIroBatchSubscribe, iroBatchSubscribeForSubmit as bscIroBatchSubscribeForSubmit, IroPoolQuery as BscIroPoolQuery, iroPoolRemovePledge as bscIroPoolRemovePledge, iroPoolExtract as bscIroPoolExtract, iroPoolTransferAwards as bscIroPoolTransferAwards, iroBatchExtract as bscIroBatchExtract, IRO_FACTORY_ADDRESS as BSC_IRO_FACTORY_ADDRESS, IRO_FACTORY_ABI as BSC_IRO_FACTORY_ABI, IRO_TOKEN_ABI as BSC_IRO_TOKEN_ABI, IRO_POOL_ABI as BSC_IRO_POOL_ABI, IRO_PLATFORM_URL as BSC_IRO_PLATFORM_URL, setIroApiBase as setBscIroApiBase, iroApiCreateProject as bscIroApiCreateProject, iroApiUploadImage as bscIroApiUploadImage, } from './chains/bsc/index.js';
+export { IroFactoryQuery as BscIroFactoryQuery, iroCreateProject as bscIroCreateProject, iroEncodeCreateProjectCall as bscIroEncodeCreateProjectCall, iroParseCreateProjectEvent as bscIroParseCreateProjectEvent, IroTokenQuery as BscIroTokenQuery, iroSubscribe as bscIroSubscribe, iroPledge as bscIroPledge, iroBatchSubscribe as bscIroBatchSubscribe, iroBatchSubscribeForSubmit as bscIroBatchSubscribeForSubmit, IroPoolQuery as BscIroPoolQuery, iroPoolRemovePledge as bscIroPoolRemovePledge, iroPoolExtract as bscIroPoolExtract, iroPoolTransferAwards as bscIroPoolTransferAwards, iroBatchExtract as bscIroBatchExtract, IRO_FACTORY_ADDRESS as BSC_IRO_FACTORY_ADDRESS, IRO_FACTORY_ABI as BSC_IRO_FACTORY_ABI, IRO_TOKEN_ABI as BSC_IRO_TOKEN_ABI, IRO_POOL_ABI as BSC_IRO_POOL_ABI, IRO_PLATFORM_URL as BSC_IRO_PLATFORM_URL, IRO_TESTNET_PLATFORM_URL as BSC_IRO_TESTNET_PLATFORM_URL, setIroApiBase as setBscIroApiBase, setIroTestApiBase as setBscIroTestApiBase, iroApiCreateProject as bscIroApiCreateProject, iroApiUploadImage as bscIroApiUploadImage, } from './chains/bsc/index.js';
 export type { WhiteListQuota as BscIroWhiteListQuota, IroCreateProjectParams as BscIroCreateProjectParams, IroFactoryTokenInfo as BscIroFactoryTokenInfo, IroSubscribeParams as BscIroSubscribeParams, IroPledgeParams as BscIroPledgeParams, IroTokenPrice as BscIroTokenPrice, IroPoolRemovePledgeParams as BscIroPoolRemovePledgeParams, IroPoolExtractParams as BscIroPoolExtractParams, IroPoolTransferAwardsParams as BscIroPoolTransferAwardsParams, IroTokenInfo as BscIroTokenInfo, IroTxResult as BscIroTxResult, IroCreateProjectResult as BscIroCreateProjectResult, IroQueryConfig as BscIroQueryConfig, IroCreateParams as BscIroCreateParams, IroApiCreateProjectRequest as BscIroApiCreateProjectRequest, IroBatchSubscribeForSubmitParams as BscIroBatchSubscribeForSubmitParams, IroBatchSubscribeForSubmitResult as BscIroBatchSubscribeForSubmitResult, } from './chains/bsc/platforms/iro/index.js';

package/dist/index.js

@@ -210,4 +210,4 @@ IroPoolQuery as BscIroPoolQuery, iroPoolRemovePledge as bscIroPoolRemovePledge,
 // 常量
 IRO_FACTORY_ADDRESS as BSC_IRO_FACTORY_ADDRESS, IRO_FACTORY_ABI as BSC_IRO_FACTORY_ABI, IRO_TOKEN_ABI as BSC_IRO_TOKEN_ABI, IRO_POOL_ABI as BSC_IRO_POOL_ABI, 
 // API (IRO 平台后端)
-IRO_PLATFORM_URL as BSC_IRO_PLATFORM_URL, setIroApiBase as setBscIroApiBase, iroApiCreateProject as bscIroApiCreateProject, iroApiUploadImage as bscIroApiUploadImage, } from './chains/bsc/index.js';
+IRO_PLATFORM_URL as BSC_IRO_PLATFORM_URL, IRO_TESTNET_PLATFORM_URL as BSC_IRO_TESTNET_PLATFORM_URL, setIroApiBase as setBscIroApiBase, setIroTestApiBase as setBscIroTestApiBase, iroApiCreateProject as bscIroApiCreateProject, iroApiUploadImage as bscIroApiUploadImage, } from './chains/bsc/index.js';

package/dist/shared/constants/addresses.d.ts

@@ -33,6 +33,14 @@ export declare const ADDRESSES: {
         /** IRO 工厂合约 (IROFactory — 已验证源码) */
         readonly IroFactory: "0x421D0B1a848E0f71E0bBa79275E4aB0A1fA0cc8b";
     };
+    readonly BSC_TESTNET: {
+        readonly WXOC: "0x21734A2347674FE4E295b2635b037d9d8F17E5bd";
+        readonly USDT: "0xC9FFb5b5b53B7d6843fd04e85A3F2f1F998CC3dA";
+        readonly IroSwapV2Factory: "0xf71F3127eb4455e635a7a307A88fA4A04878201C";
+        readonly IroSwapV2Router: "0x6ddec69a6b51abC3E0B340C7cA53c5b2CD2a819b";
+        readonly IroFactory: "0x180F25bA4c6981793C1b0c2aDb16ee92636a0E1D";
+        readonly Multicall3: "0xcA11bde05977b3631167028862bE2a173976CA11";
+    };
     readonly XLAYER: {
         readonly WOKB: "0xe538905cf8410324e03a5a23c1c177a474d59b2b";
         /** USDT (6位精度) - 不一定被 Flap 内盘支持 */

package/dist/shared/constants/addresses.js

@@ -52,6 +52,17 @@ export const ADDRESSES = {
         IroFactory: '0x421D0B1a848E0f71E0bBa79275E4aB0A1fA0cc8b',
     },
     // ========================================================================
+    // BSC Testnet (Chain ID: 97)
+    // ========================================================================
+    BSC_TESTNET: {
+        WXOC: '0x21734A2347674FE4E295b2635b037d9d8F17E5bd',
+        USDT: '0xC9FFb5b5b53B7d6843fd04e85A3F2f1F998CC3dA',
+        IroSwapV2Factory: '0xf71F3127eb4455e635a7a307A88fA4A04878201C',
+        IroSwapV2Router: '0x6ddec69a6b51abC3E0B340C7cA53c5b2CD2a819b',
+        IroFactory: '0x180F25bA4c6981793C1b0c2aDb16ee92636a0E1D',
+        Multicall3: '0xcA11bde05977b3631167028862bE2a173976CA11',
+    },
+    // ========================================================================
     // XLayer (Chain ID: 196)
     // ========================================================================
     XLAYER: {

package/dist/shared/constants/profit.js

@@ -92,12 +92,13 @@ export function calculateProfitHopGasCost(gasPrice) {
  * - 所有代币（原生币/ERC20）统一按地址执行次数收取原生币
  */
 export const TRANSFER_FEE_PER_ADDRESS = {
-    56: 1000000000000000n, // BSC:    0.001 BNB
-    196: 10000000000000000n, // XLayer: 0.01  OKB
-    143: 1000000000000000n, // Monad:  0.001 MON
-    8453: 1000000000000000n, // Base:   0.001 ETH
-    2818: 1000000000000000n, // Morph:  0.001 ETH
-    173: 1000000000000000n, // ENI:    0.001 EGAS
+    56: 1000000000000000n, // BSC:         0.001 BNB
+    97: 1000000000000000n, // BSC Testnet: 0.001 tBNB
+    196: 10000000000000000n, // XLayer:      0.01  OKB
+    143: 1000000000000000n, // Monad:       0.001 MON
+    8453: 1000000000000000n, // Base:        0.001 ETH
+    2818: 1000000000000000n, // Morph:       0.001 ETH
+    173: 1000000000000000n, // ENI:         0.001 EGAS
 };
 /**
  * 获取每个地址的转账费用（原生代币 wei）

package/dist/utils/lp-inspect.d.ts

@@ -97,7 +97,7 @@ export interface LPInfo {
 }
 /** 查询选项 */
 export interface InspectOptions {
-    chain: 'BSC' | 'MONAD' | 'XLAYER' | 'ENI';
+    chain: 'BSC' | 'BSC_TESTNET' | 'MONAD' | 'XLAYER' | 'ENI';
     rpcUrl: string;
     flapChain?: FlapChain;
     v3FeeTiers?: number[];

package/dist/utils/lp-inspect.js

@@ -32,6 +32,21 @@ const CHAIN_DEX_CONFIGS = {
             },
         }
     },
+    BSC_TESTNET: {
+        wrappedNative: ADDRESSES.BSC_TESTNET.WXOC,
+        wrappedNativeSymbol: 'WXOC',
+        stableCoins: [
+            { address: ADDRESSES.BSC_TESTNET.USDT, symbol: 'USDT', decimals: 18 },
+        ],
+        dexes: {
+            IROSWAP: {
+                name: 'IROSwap',
+                v2Factory: ADDRESSES.BSC_TESTNET.IroSwapV2Factory,
+                v2Router: ADDRESSES.BSC_TESTNET.IroSwapV2Router,
+                enabled: true,
+            },
+        }
+    },
     MONAD: {
         wrappedNative: '0x3bd359c1119da7da1d913d1c4d2b7c461115433a',
         wrappedNativeSymbol: 'WMON',

package/package.json

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