four-flap-meme-sdk 2.2.19 → 3.0.0

package/dist/{contracts → domains/four/contracts}/tm.d.ts

@@ -1,5 +1,7 @@
-import { BytesLike, JsonRpcProvider, Wallet } from 'ethers';
-export type Providerish = JsonRpcProvider;
+import { BytesLike, Wallet } from 'ethers';
+import type { ContractTransactionReceipt } from 'ethers';
+import { createBscProvider } from '../../../utils/provider-factory.js';
+export type Providerish = ReturnType<typeof createBscProvider>;
 export type Signerish = Wallet;
 export type CreateOnChainParams = {
     chain: 'BSC';
@@ -10,8 +12,8 @@ export type CreateOnChainParams = {
     valueWei?: bigint;
 };
 export declare function createTokenOnChain(params: CreateOnChainParams): Promise<{
-    receipt: any;
-    tokenAddress: string | undefined;
+    receipt: ContractTransactionReceipt | null;
+    tokenAddress?: string;
 }>;
 export type TryBuyResult = {
     tokenManager: string;
@@ -31,8 +33,8 @@ export type TrySellResult = {
     fee: bigint;
 };
 export declare function trySell(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, amount: bigint, proxyAddressOverride?: string): Promise<TrySellResult>;
-export declare function buyTokenWithFunds(chain: 'BSC', rpcUrl: string, signerPrivateKey: string, token: string, funds: bigint, minAmount: bigint, to?: string, origin?: bigint): Promise<any>;
-export declare function sellToken(chain: 'BSC', rpcUrl: string, signerPrivateKey: string, token: string, amount: bigint, minFunds: bigint, origin?: bigint): Promise<any>;
+export declare function buyTokenWithFunds(chain: 'BSC', rpcUrl: string, signerPrivateKey: string, token: string, funds: bigint, minAmount: bigint, to?: string, origin?: bigint): Promise<ContractTransactionReceipt | null>;
+export declare function sellToken(chain: 'BSC', rpcUrl: string, signerPrivateKey: string, token: string, amount: bigint, minFunds: bigint, origin?: bigint): Promise<ContractTransactionReceipt | null>;
 export declare function tradeBuy(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, params: {
     type: 'funds';
     funds: bigint;
@@ -45,7 +47,7 @@ export declare function tradeBuy(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl:
     maxFunds: bigint;
     to?: string;
     origin?: bigint;
-}): Promise<any>;
+}): Promise<ContractTransactionReceipt | null>;
 export declare function tradeSell(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl: string, token: string, params: {
     type: 'direct';
     amount: bigint;
@@ -59,4 +61,4 @@ export declare function tradeSell(chain: 'BSC' | 'BASE' | 'ARBITRUM_ONE', rpcUrl
     origin?: bigint;
     feeRate?: bigint;
     feeRecipient?: string;
-}): Promise<any>;
+}): Promise<ContractTransactionReceipt | null>;

package/dist/{contracts → domains/four/contracts}/tm.js

@@ -1,17 +1,18 @@
-import { Contract, JsonRpcProvider, Wallet } from 'ethers';
-import TM2Abi from '../shared/abis/TokenManager2.json' with { type: 'json' };
-import Helper3Abi from '../shared/abis/TokenManagerHelper3.json' with { type: 'json' };
-import { Contract as EContract } from 'ethers';
-import { ADDRESSES } from '../utils/constants.js';
+import { Contract, Wallet } from 'ethers';
+import TM2Abi from '../../../abis/contracts/TokenManager2.json' with { type: 'json' };
+import Helper3Abi from '../../../abis/contracts/TokenManagerHelper3.json' with { type: 'json' };
+import { ADDRESSES, ZERO_ADDRESS } from '../../../core/constants/index.js';
+import { createBscProvider } from '../../../utils/provider-factory.js';
 import { TM1 } from './tm1.js';
 import { TM2 } from './tm2.js';
+const TM2_ABI = TM2Abi;
+const HELPER3_ABI = Helper3Abi;
 export async function createTokenOnChain(params) {
-    const { chain, rpcUrl, signerPrivateKey, args, signature, valueWei } = params;
-    const provider = new JsonRpcProvider(rpcUrl);
+    const { rpcUrl, signerPrivateKey, args, signature, valueWei } = params;
+    const provider = createBscProvider(rpcUrl);
     const signer = new Wallet(signerPrivateKey, provider);
     // 使用 Four.meme 平台原始合约地址（API 签名是给原始合约的）
-    const FOUR_ORIGINAL_TM2 = '0x5c952063c7fc8610FFDB798152D69F0B9550762b';
-    const tm2 = new Contract(FOUR_ORIGINAL_TM2, TM2Abi, signer);
+    const tm2 = new Contract(ADDRESSES.BSC.TokenManagerOriginal, TM2_ABI, signer);
     const tx = await tm2.createToken(args, signature, { value: valueWei ?? 0n });
     const receipt = await tx.wait();
     // 解析 TokenCreate 事件获取代币地址
@@ -25,7 +26,7 @@ export async function createTokenOnChain(params) {
                     break;
                 }
             }
-            catch (e) {
+            catch (_e) {
                 // 忽略无法解析的日志
             }
         }
@@ -38,17 +39,15 @@ export async function tryBuy(chain, rpcUrl, token, amount, funds, proxyAddressOv
         BASE: ADDRESSES.BASE.TokenManagerHelper3,
         ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3,
     };
-    const provider = new JsonRpcProvider(rpcUrl);
+    const provider = createBscProvider(rpcUrl);
     // 优先用代理预览（若提供）
     if (proxyAddressOverride) {
-        const proxyAbi = [
-            'function previewBuy(address token, uint256 funds) view returns (uint256)',
-        ];
-        const proxy = new EContract(proxyAddressOverride, proxyAbi, provider);
+        const proxyAbi = ['function previewBuy(address token, uint256 funds) view returns (uint256)'];
+        const proxy = new Contract(proxyAddressOverride, proxyAbi, provider);
         const estimatedAmount = await proxy.previewBuy(token, funds);
         return {
             tokenManager: 'proxy',
-            quote: '0x0000000000000000000000000000000000000000',
+            quote: ZERO_ADDRESS,
             estimatedAmount,
             estimatedCost: funds,
             estimatedFee: 0n,
@@ -57,7 +56,7 @@ export async function tryBuy(chain, rpcUrl, token, amount, funds, proxyAddressOv
             amountFunds: funds,
         };
     }
-    const helper = new Contract(helper3Addresses[chain], Helper3Abi, provider);
+    const helper = new Contract(helper3Addresses[chain], HELPER3_ABI, provider);
     const r = await helper.tryBuy(token, amount, funds);
     return {
         tokenManager: r.tokenManager,
@@ -76,22 +75,20 @@ export async function trySell(chain, rpcUrl, token, amount, proxyAddressOverride
         BASE: ADDRESSES.BASE.TokenManagerHelper3,
         ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3,
     };
-    const provider = new JsonRpcProvider(rpcUrl);
+    const provider = createBscProvider(rpcUrl);
     // 优先用代理预览（若提供）
     if (proxyAddressOverride) {
-        const proxyAbi = [
-            'function previewSell(address token, uint256 amount) view returns (uint256)',
-        ];
-        const proxy = new EContract(proxyAddressOverride, proxyAbi, provider);
+        const proxyAbi = ['function previewSell(address token, uint256 amount) view returns (uint256)'];
+        const proxy = new Contract(proxyAddressOverride, proxyAbi, provider);
         const funds = await proxy.previewSell(token, amount);
         return {
             tokenManager: 'proxy',
-            quote: '0x0000000000000000000000000000000000000000',
+            quote: ZERO_ADDRESS,
             funds,
             fee: 0n,
         };
     }
-    const helper = new Contract(helper3Addresses[chain], Helper3Abi, provider);
+    const helper = new Contract(helper3Addresses[chain], HELPER3_ABI, provider);
     const r = await helper.trySell(token, amount);
     return {
         tokenManager: r.tokenManager,
@@ -101,9 +98,9 @@ export async function trySell(chain, rpcUrl, token, amount, proxyAddressOverride
     };
 }
 export async function buyTokenWithFunds(chain, rpcUrl, signerPrivateKey, token, funds, minAmount, to, origin = 0n) {
-    const provider = new JsonRpcProvider(rpcUrl);
+    const provider = createBscProvider(rpcUrl);
     const signer = new Wallet(signerPrivateKey, provider);
-    const tm2 = new Contract(ADDRESSES[chain].TokenManagerV2, TM2Abi, signer);
+    const tm2 = new Contract(ADDRESSES[chain].TokenManagerV2, TM2_ABI, signer);
     if (to) {
         const tx = await tm2.buyTokenAMAP(origin, token, to, funds, minAmount, { value: funds });
         return await tx.wait();
@@ -114,9 +111,9 @@ export async function buyTokenWithFunds(chain, rpcUrl, signerPrivateKey, token,
     }
 }
 export async function sellToken(chain, rpcUrl, signerPrivateKey, token, amount, minFunds, origin = 0n) {
-    const provider = new JsonRpcProvider(rpcUrl);
+    const provider = createBscProvider(rpcUrl);
     const signer = new Wallet(signerPrivateKey, provider);
-    const tm2 = new Contract(ADDRESSES[chain].TokenManagerV2, TM2Abi, signer);
+    const tm2 = new Contract(ADDRESSES[chain].TokenManagerV2, TM2_ABI, signer);
     // 使用明确的函数签名避免歧义
     const tx = await tm2['sellToken(uint256,address,uint256,uint256)'](origin, token, amount, minFunds);
     return await tx.wait();
@@ -128,8 +125,8 @@ export async function tradeBuy(chain, rpcUrl, token, params) {
         BASE: ADDRESSES.BASE.TokenManagerHelper3,
         ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3,
     };
-    const provider = new JsonRpcProvider(rpcUrl);
-    const helper = new Contract(helper3Addresses[chain], Helper3Abi, provider);
+    const provider = createBscProvider(rpcUrl);
+    const helper = new Contract(helper3Addresses[chain], HELPER3_ABI, provider);
     const info = await helper.getTokenInfo(token);
     const version = info.version;
     if (version === 1n) {
@@ -143,9 +140,16 @@ export async function tradeBuy(chain, rpcUrl, token, params) {
     if (chain !== 'BSC')
         throw new Error('TokenManager V2 only supported on BSC');
     const tm2 = TM2.connectByChain('BSC', rpcUrl);
-    if (params.type === 'funds')
-        return await tm2.buyTokenAMAP(params.origin ?? 0n, token, params.to ?? undefined, params.funds, params.minAmount);
-    return await tm2.buyToken(params.origin ?? 0n, token, params.to ?? undefined, params.amount, params.maxFunds);
+    if (params.type === 'funds') {
+        const o = params.origin ?? 0n;
+        return params.to !== undefined
+            ? await tm2.buyTokenAMAP(o, token, params.to, params.funds, params.minAmount)
+            : await tm2.buyTokenAMAP(o, token, params.funds, params.minAmount);
+    }
+    const o = params.origin ?? 0n;
+    return params.to !== undefined
+        ? await tm2.buyToken(o, token, params.to, params.amount, params.maxFunds)
+        : await tm2.buyToken(o, token, params.amount, params.maxFunds);
 }
 export async function tradeSell(chain, rpcUrl, token, params) {
     const helper3Addresses = {
@@ -153,8 +157,8 @@ export async function tradeSell(chain, rpcUrl, token, params) {
         BASE: ADDRESSES.BASE.TokenManagerHelper3,
         ARBITRUM_ONE: ADDRESSES.ARBITRUM_ONE.TokenManagerHelper3,
     };
-    const provider = new JsonRpcProvider(rpcUrl);
-    const helper = new Contract(helper3Addresses[chain], Helper3Abi, provider);
+    const provider = createBscProvider(rpcUrl);
+    const helper = new Contract(helper3Addresses[chain], HELPER3_ABI, provider);
     const info = await helper.getTokenInfo(token);
     const version = info.version;
     if (version === 1n) {

package/dist/{contracts → domains/four/contracts}/tm1.js

@@ -1,7 +1,10 @@
 import { Contract, JsonRpcProvider } from 'ethers';
-import TM1Abi from '../shared/abis/TokenManager.json' with { type: 'json' };
-import { ADDRESSES } from '../utils/constants.js';
+import TM1Abi from '../../../abis/contracts/TokenManager.json' with { type: 'json' };
+import { ADDRESSES } from '../../../core/constants/index.js';
+const TM1_ABI = TM1Abi;
 export class TM1 {
+    address;
+    provider;
     constructor(address, provider) {
         this.address = address;
         this.provider = provider;
@@ -14,9 +17,11 @@ export class TM1 {
         return new TM1(address, new JsonRpcProvider(rpcUrl));
     }
     get c() {
-        return new Contract(this.address, TM1Abi, this.provider);
+        return new Contract(this.address, TM1_ABI, this.provider);
+    }
+    async lastPrice(token) {
+        return await this.c.lastPrice(token);
     }
-    async lastPrice(token) { return await this.c.lastPrice(token); }
     async purchaseToken(token, amount, maxFunds, origin, to) {
         if (origin !== undefined && to)
             return await this.c.purchaseToken(origin, token, to, amount, maxFunds, { value: maxFunds });

package/dist/{contracts → domains/four/contracts}/tm2.js

@@ -1,7 +1,10 @@
 import { Contract, JsonRpcProvider, Wallet } from 'ethers';
-import TM2Abi from '../shared/abis/TokenManager2.json' with { type: 'json' };
-import { ADDRESSES } from '../utils/constants.js';
+import TM2Abi from '../../../abis/contracts/TokenManager2.json' with { type: 'json' };
+import { ADDRESSES, ZERO_ADDRESS } from '../../../core/constants/index.js';
+const TM2_ABI = TM2Abi;
 export class TM2 {
+    address;
+    provider;
     constructor(address, provider) {
         this.address = address;
         this.provider = provider;
@@ -20,9 +23,11 @@ export class TM2 {
         const address = ADDRESSES[chain].TokenManagerV2;
         const provider = new JsonRpcProvider(rpcUrl);
         const signer = new Wallet(privateKey, provider);
-        return new Contract(address, TM2Abi, signer);
+        return new Contract(address, TM2_ABI, signer);
+    }
+    get c() {
+        return new Contract(this.address, TM2_ABI, this.provider);
     }
-    get c() { return new Contract(this.address, TM2Abi, this.provider); }
     async buyToken(originOrToken, tokenOrTo, toOrAmount, amountOrMaxFunds, maxFunds) {
         if (typeof originOrToken === 'bigint') {
             const origin = originOrToken;
@@ -104,6 +109,6 @@ export class TM2 {
             return await this.c['sellToken(uint256,address,address,uint256,uint256,uint256,address)'](origin, token, from, amount, minFunds, feeRate, feeRecipient);
         }
         // 7参数版本，feeRate=0，feeRecipient=0地址
-        return await this.c['sellToken(uint256,address,address,uint256,uint256,uint256,address)'](origin, token, from, amount, minFunds, 0, '0x0000000000000000000000000000000000000000');
+        return await this.c['sellToken(uint256,address,address,uint256,uint256,uint256,address)'](origin, token, from, amount, minFunds, 0, ZERO_ADDRESS);
     }
 }

package/dist/domains/four/index.d.ts

@@ -0,0 +1,7 @@
+/** four.meme domain facade */
+export * from './tax-token.js';
+export * from './contracts/tm.js';
+export * from './contracts/tm1.js';
+export * from './contracts/tm2.js';
+export * from './contracts/helper3.js';
+export * from './contracts/tm-bundle.js';

package/dist/domains/four/index.js

@@ -0,0 +1,7 @@
+/** four.meme domain facade */
+export * from './tax-token.js';
+export * from './contracts/tm.js';
+export * from './contracts/tm1.js';
+export * from './contracts/tm2.js';
+export * from './contracts/helper3.js';
+export * from './contracts/tm-bundle.js';

package/dist/{shared → domains}/four/tax-token.d.ts

@@ -1,4 +1,4 @@
-import TaxTokenAbi from '../abis/TaxToken.json';
+import TaxTokenAbi from '../../abis/contracts/TaxToken.json';
 /** TaxToken 转账模式 */
 export declare enum TransferMode {
     /** 正常转账模式 - 允许所有转账 */

package/dist/{shared → domains}/four/tax-token.js

@@ -5,12 +5,13 @@
  * 基于 Four.meme 官方文档: API-Contract-TaxToken.md
  */
 import { ethers, Contract, Wallet, JsonRpcProvider } from 'ethers';
-import TaxTokenAbi from '../abis/TaxToken.json' with { type: 'json' };
+import TaxTokenAbi from '../../abis/contracts/TaxToken.json' with { type: 'json' };
+import { ADDRESSES, CHAINS } from '../../core/constants/index.js';
 // ============================================================================
 // 常量
 // ============================================================================
 /** Four.meme TokenManager2 合约地址（BSC） */
-const TOKEN_MANAGER_2_ADDRESS = '0x5c952063c7fc8610FFDB798152D69F0B9550762b';
+const TOKEN_MANAGER_2_ADDRESS = ADDRESSES.BSC.TokenManagerOriginal;
 /** TaxToken 的 creatorType 值 */
 const TOKEN_TYPE_TAX = 5;
 /** TokenManager2 最小 ABI（用于查询 _tokenInfos 和 _tokenInfoEx1s） */
@@ -123,11 +124,28 @@ export async function getTaxTokenInfo(tokenAddress, rpcUrl) {
     const token = new Contract(tokenAddress, TAX_TOKEN_READ_ABI, provider);
     // 批量查询所有状态（利用 Promise.all 减少 RPC 调用轮次）
     const [feeRate, rateFounder, rateHolder, rateBurn, rateLiquidity, founder, quote, pair, mode, minDispatch, minShare, totalShares, feePerShare, feeAccumulated, feeDispatched, feeFounderVal, feeHolderVal, feeBurnVal, feeLiquidityVal, quoteFounderVal, quoteHolderVal, quoteClaimed,] = await Promise.all([
-        token.feeRate(), token.rateFounder(), token.rateHolder(), token.rateBurn(), token.rateLiquidity(),
-        token.founder(), token.quote(), token.pair(), token._mode(), token.minDispatch(), token.minShare(),
-        token.totalShares(), token.feePerShare(), token.feeAccumulated(), token.feeDispatched(),
-        token.feeFounder(), token.feeHolder(), token.feeBurn(), token.feeLiquidity(),
-        token.quoteFounder(), token.quoteHolder(), token.quoteClaimed(),
+        token.feeRate(),
+        token.rateFounder(),
+        token.rateHolder(),
+        token.rateBurn(),
+        token.rateLiquidity(),
+        token.founder(),
+        token.quote(),
+        token.pair(),
+        token._mode(),
+        token.minDispatch(),
+        token.minShare(),
+        token.totalShares(),
+        token.feePerShare(),
+        token.feeAccumulated(),
+        token.feeDispatched(),
+        token.feeFounder(),
+        token.feeHolder(),
+        token.feeBurn(),
+        token.feeLiquidity(),
+        token.quoteFounder(),
+        token.quoteHolder(),
+        token.quoteClaimed(),
     ]);
     return {
         config: {
@@ -230,7 +248,7 @@ export async function buildClaimFeeTx(tokenAddress, privateKey, rpcUrl) {
         nonce,
         gasLimit: 200000n,
         gasPrice: feeData.gasPrice ?? ethers.parseUnits('3', 'gwei'),
-        chainId: 56,
+        chainId: CHAINS.BSC.chainId,
         type: 0,
     });
     return signedTx;
@@ -258,7 +276,7 @@ export async function buildBatchClaimFeeTxs(tokenAddress, privateKeys, rpcUrl) {
             nonce,
             gasLimit: 200000n,
             gasPrice,
-            chainId: 56,
+            chainId: CHAINS.BSC.chainId,
             type: 0,
         });
     }));
@@ -281,7 +299,10 @@ export function validateFourTokenTaxInfo(info) {
     // 四项比例之和必须为 100
     const rateSum = info.burnRate + info.divideRate + info.liquidityRate + info.recipientRate;
     if (rateSum !== 100) {
-        return { valid: false, error: `burnRate + divideRate + liquidityRate + recipientRate 必须等于 100，当前: ${rateSum}` };
+        return {
+            valid: false,
+            error: `burnRate + divideRate + liquidityRate + recipientRate 必须等于 100，当前: ${rateSum}`,
+        };
     }
     // 每项比例 >= 0
     if (info.burnRate < 0 || info.divideRate < 0 || info.liquidityRate < 0 || info.recipientRate < 0) {

package/dist/domains/holders/holders-maker-helpers.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 刷持有人 helpers — facade re-export（实现见 internal/）
+ */
+export * from './internal/addresses.js';
+export * from './internal/constants.js';
+export { generateDisperseHopPaths, buildDisperseHopChainNative, buildDisperseHopChainERC20, calculateMaxWalletsPerBatch, DEFAULT_MAX_WALLETS_PER_BATCH_NATIVE, DEFAULT_MAX_WALLETS_PER_BATCH_ERC20, chunkArray, } from './internal/disperse.js';
+export { buildERC20TransferTx, buildERC20ApproveTx, buildNativeTransferTx } from './internal/transfer-tx.js';
+export { getBaseTokenAddress, getRouterAddress, getWrappedNativeAddress } from './internal/routing.js';
+export { buildFlapBuyTx, buildFourBuyTx, buildDaoaasBuyTx, buildV2BuyTx, buildV3BuyTx, buildV2BuyTxWithERC20, buildV3BuyTxWithERC20, } from './internal/buy-tx.js';

package/dist/domains/holders/holders-maker-helpers.js

@@ -0,0 +1,9 @@
+/**
+ * 刷持有人 helpers — facade re-export（实现见 internal/）
+ */
+export * from './internal/addresses.js';
+export * from './internal/constants.js';
+export { generateDisperseHopPaths, buildDisperseHopChainNative, buildDisperseHopChainERC20, calculateMaxWalletsPerBatch, DEFAULT_MAX_WALLETS_PER_BATCH_NATIVE, DEFAULT_MAX_WALLETS_PER_BATCH_ERC20, chunkArray, } from './internal/disperse.js';
+export { buildERC20TransferTx, buildERC20ApproveTx, buildNativeTransferTx } from './internal/transfer-tx.js';
+export { getBaseTokenAddress, getRouterAddress, getWrappedNativeAddress } from './internal/routing.js';
+export { buildFlapBuyTx, buildFourBuyTx, buildDaoaasBuyTx, buildV2BuyTx, buildV3BuyTx, buildV2BuyTxWithERC20, buildV3BuyTxWithERC20, } from './internal/buy-tx.js';

package/dist/domains/holders/holders-maker.d.ts

@@ -0,0 +1,18 @@
+import type { BaseTokenType, HoldersMakerParams, HoldersMakerResult } from './types.js';
+export declare function holdersMaker(params: HoldersMakerParams): Promise<HoldersMakerResult>;
+/**
+ * 获取刷持有人预估费用
+ */
+export declare function estimateHoldersMakerCost(params: {
+    holdersCount: number;
+    buyAmountPerHolder: string;
+    baseToken?: BaseTokenType;
+    gasLimit?: number;
+    gasPriceGwei?: number;
+}): {
+    totalNativeCost: string;
+    totalERC20Cost?: string;
+    gasEstimate: string;
+    batchCount: number;
+};
+export type { HoldersMakerChain, HoldersMakerTradeType, BaseTokenType, HoldersMakerConfig, HoldersMakerParams, TransactionLayer, BatchResult, HoldersMakerResult, } from './types.js';