four-flap-meme-sdk 1.8.2 → 1.8.3

package/dist/chains/bsc/four/core.js

@@ -70,6 +70,10 @@ export async function createTokenWithBundleBuyMerkle(params) {
         telegramUrl: tokenInfo.telegramUrl,
         preSale: effectivePreSaleStr || '0',
         onlyMPC: false,
+        // ✅ AntiSniperFeeMode（开盘高税模式）
+        ...(tokenInfo.feePlan ? { feePlan: true } : {}),
+        // ✅ 税币配置（Tax Token, creatorType=5）
+        ...(tokenInfo.tokenTaxInfo ? { tokenTaxInfo: tokenInfo.tokenTaxInfo } : {}),
         lpTradingFee: 0.0025,
         symbol: 'BNB',
         totalSupply: 1000000000,

package/dist/chains/bsc/four/types.d.ts

@@ -1,4 +1,5 @@
 import type { GeneratedWallet } from '../../../utils/wallet.js';
+import type { FourTokenTaxInfo } from '../../../shared/clients/four.js';
 export type FourSignConfig = {
     rpcUrl: string;
     fourApiUrl?: string;
@@ -94,6 +95,10 @@ export type FourCreateWithBundleBuyMerkleParams = {
         webUrl?: string;
         twitterUrl?: string;
         telegramUrl?: string;
+        /** ✅ AntiSniperFeeMode（开盘高税模式） */
+        feePlan?: boolean;
+        /** ✅ 税币配置（Tax Token, creatorType=5） */
+        tokenTaxInfo?: FourTokenTaxInfo;
     };
     config: FourBundleMerkleConfig;
 };
@@ -113,6 +118,10 @@ export type FourCreateWithBundleBuySignParams = {
         webUrl?: string;
         twitterUrl?: string;
         telegramUrl?: string;
+        /** ✅ AntiSniperFeeMode（开盘高税模式） */
+        feePlan?: boolean;
+        /** ✅ 税币配置（Tax Token, creatorType=5） */
+        tokenTaxInfo?: FourTokenTaxInfo;
     };
     config: FourSignConfig;
 };

package/dist/contracts/tm-bundle-merkle/core.js

@@ -69,6 +69,10 @@ export async function createTokenWithBundleBuyMerkle(params) {
         telegramUrl: tokenInfo.telegramUrl,
         preSale: effectivePreSaleStr || '0',
         onlyMPC: false,
+        // ✅ AntiSniperFeeMode（开盘高税模式）
+        ...(tokenInfo.feePlan ? { feePlan: true } : {}),
+        // ✅ 税币配置（Tax Token, creatorType=5）
+        ...(tokenInfo.tokenTaxInfo ? { tokenTaxInfo: tokenInfo.tokenTaxInfo } : {}),
         lpTradingFee: 0.0025,
         symbol: 'BNB',
         totalSupply: 1000000000,

package/dist/contracts/tm-bundle-merkle/types.d.ts

@@ -1,4 +1,5 @@
 import type { GeneratedWallet } from '../../utils/wallet.js';
+import type { FourTokenTaxInfo } from '../../shared/clients/four.js';
 export type FourSignConfig = {
     rpcUrl: string;
     fourApiUrl?: string;
@@ -94,6 +95,10 @@ export type FourCreateWithBundleBuyMerkleParams = {
         webUrl?: string;
         twitterUrl?: string;
         telegramUrl?: string;
+        /** ✅ AntiSniperFeeMode（开盘高税模式） */
+        feePlan?: boolean;
+        /** ✅ 税币配置（Tax Token, creatorType=5） */
+        tokenTaxInfo?: FourTokenTaxInfo;
     };
     config: FourBundleMerkleConfig;
 };
@@ -113,6 +118,10 @@ export type FourCreateWithBundleBuySignParams = {
         webUrl?: string;
         twitterUrl?: string;
         telegramUrl?: string;
+        /** ✅ AntiSniperFeeMode（开盘高税模式） */
+        feePlan?: boolean;
+        /** ✅ 税币配置（Tax Token, creatorType=5） */
+        tokenTaxInfo?: FourTokenTaxInfo;
     };
     config: FourSignConfig;
 };

package/dist/index.d.ts

@@ -7,7 +7,7 @@ export { isExclusiveOnChain, isExclusiveOffChain } from './utils/mpcExclusive.js
 export { ensureSellApprovalV1, checkSellApprovalV1, ensureSellApprovalV2, checkSellApprovalV2, ensureSellApproval, checkSellApproval, ensureFlapSellApproval, checkFlapSellApproval, ensureFlapSellApprovalBatch, checkFlapSellApprovalBatch, checkAllowance, approveToken, checkAllowanceBatch, approveTokenBatch, checkAllowanceRaw, approveTokenRaw, checkAllowanceBatchRaw, approveTokenBatchRaw, type EnsureAllowanceBatchItemResult, type ApproveTokenBatchParams, type ApproveTokenBatchRawParams, type ApproveTokenBatchResult, type ApproveTokenBatchSignResult } from './utils/erc20.js';
 export { parseFourError, type FourErrorCode } from './utils/errors.js';
 export { getTokenManagerV1, getTokenManagerV2, getTokenManagerHelper3, getTokenManagerV1Writer, getTokenManagerV2Writer, getTokenManagerHelper3Writer, getTokenManagerAddress, type ChainName } from './utils/contract-factory.js';
-export { FourClient, buildLoginMessage, type FourConfig, type GenerateNonceReq, type LoginReq, type CreateTokenReq, type CreateTokenResp } from './shared/clients/four.js';
+export { FourClient, buildLoginMessage, type FourConfig, type GenerateNonceReq, type LoginReq, type CreateTokenReq, type CreateTokenResp, type FourTokenTaxInfo } from './shared/clients/four.js';
 export { createTokenOnChain, tryBuy, trySell, buyTokenWithFunds, sellToken, tradeBuy, tradeSell, type CreateOnChainParams, type TryBuyResult, type TrySellResult } from './contracts/tm.js';
 export { TM1, type FourChainV1 } from './contracts/tm1.js';
 export { TM2, type FourChainV2 } from './contracts/tm2.js';
@@ -31,6 +31,7 @@ export { fourPrivateBuy, fourPrivateSell, fourBatchPrivateBuy, fourBatchPrivateS
 export { flapPrivateBuy, flapPrivateSell, flapBatchPrivateBuy, flapBatchPrivateSell, type FlapPrivateBuyParams, type FlapPrivateSellParams, type FlapBatchPrivateBuyParams, type FlapBatchPrivateSellParams, type FlapBatchPrivateSellResult } from './shared/flap/portal-bundle.js';
 export { createTokenWithBundleBuyMerkle as flapCreateTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle as flapBatchBuyWithBundleMerkle, batchSellWithBundleMerkle as flapBatchSellWithBundleMerkle, flapPrivateBuyMerkle, flapPrivateSellMerkle, flapBatchPrivateBuyMerkle, flapBatchPrivateSellMerkle, pancakeProxyBatchBuyMerkle, pancakeProxyBatchSellMerkle, approvePancakeProxy, approvePancakeProxyBatch, flapDisperseWithBundleMerkle, flapSweepWithBundleMerkle, type FlapBundleMerkleConfig, type FlapSignConfig, type FlapProfitMode, type FlapChainForMerkleBundle, type FlapCreateWithBundleBuySignParams, type FlapCreateWithBundleBuyMerkleParams, type FlapCreateWithBundleBuyMerkleResult, type FlapBatchBuySignParams, type FlapBatchBuyMerkleParams, type FlapBatchBuyMerkleResult, type FlapBatchSellSignParams, type FlapBatchSellMerkleParams, type FlapBatchSellMerkleResult, type MerkleTransactionStatus, type MerkleBundleStatus, type FlapPrivateBuyMerkleParams, type FlapPrivateSellMerkleParams, type FlapBatchPrivateBuyMerkleParams, type FlapBatchPrivateSellMerkleParams, type FlapBatchPrivateMerkleResult, type FlapPrivateTransactionResult, type PancakeProxyBatchBuyParams, type PancakeProxyBatchBuyResult, type PancakeProxyBatchSellParams, type PancakeProxyBatchSellResult, type PancakeProxyApprovalParams, type PancakeProxyApprovalBatchParams, type PancakeProxyApprovalBatchResult, type FlapDisperseSignParams, type FlapDisperseMerkleResult, type FlapSweepSignParams, type FlapSweepMerkleResult } from './shared/flap/portal-bundle-merkle/index.js';
 export { createTokenWithBundleBuyMerkle as fourCreateTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle as fourBatchBuyWithBundleMerkle, batchSellWithBundleMerkle as fourBatchSellWithBundleMerkle, fourPrivateBuyMerkle, fourPrivateSellMerkle, fourBatchPrivateBuyMerkle, fourBatchPrivateSellMerkle, disperseWithBundleMerkle, sweepWithBundleMerkle, pairwiseTransferWithBundleMerkle, fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approveFourPancakeProxy, approveFourPancakeProxyBatch, approveFourTokenManagerBatch, submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel, type MerkleSubmitConfig, type SubmitBundleResult, type BlockRazorSubmitConfig, type BlockRazorSubmitResult, type FourBundleMerkleConfig, type FourSignConfig, type FourCreateWithBundleBuySignParams, type FourBatchBuySignParams, type FourBatchSellSignParams, type FourPrivateBuySignParams, type FourPrivateSellSignParams, type FourBatchPrivateBuySignParams, type FourBatchPrivateSellSignParams, type FourPancakeProxyBatchBuySignParams, type FourPancakeProxyBatchSellSignParams, type DisperseSignParams as FourDisperseSignParams, type SweepSignParams as FourSweepSignParams, type FourCreateWithBundleBuyMerkleParams, type FourCreateWithBundleBuyMerkleResult, type FourBatchBuyMerkleParams, type FourBatchBuyMerkleResult, type FourBatchSellMerkleParams, type FourBatchSellMerkleResult, type FourPrivateBuyMerkleParams, type FourPrivateSellMerkleParams, type FourBatchPrivateBuyMerkleParams, type FourBatchPrivateSellMerkleParams, type FourBatchPrivateMerkleResult, type FourPrivateTransactionResult, type DisperseMerkleParams, type DisperseMerkleResult, type SweepMerkleParams, type SweepMerkleResult, type FourPancakeProxyBatchBuyParams, type FourPancakeProxyBatchBuyResult, type FourPancakeProxyBatchSellParams, type FourPancakeProxyBatchSellResult, type FourPancakeProxyApprovalParams, type FourPancakeProxyApprovalBatchParams, type FourPancakeProxyApprovalBatchResult, type ApproveFourTokenManagerBatchParams, type ApproveFourTokenManagerBatchResult } from './chains/bsc/four/index.js';
+export { isTaxToken as fourIsTaxToken, isAntiSniperFeeMode as fourIsAntiSniperFeeMode, getCreatorType as fourGetCreatorType, getTaxTokenInfo as fourGetTaxTokenInfo, getClaimableFee as fourGetClaimableFee, getClaimedFee as fourGetClaimedFee, getUserRewardInfo as fourGetUserRewardInfo, buildClaimFeeTx as fourBuildClaimFeeTx, buildBatchClaimFeeTxs as fourBuildBatchClaimFeeTxs, validateFourTokenTaxInfo, TAX_TOKEN_ABI, TransferMode as FourTransferMode, type TaxTokenConfig as FourTaxTokenConfig, type TaxTokenRewardStats as FourTaxTokenRewardStats, type TaxTokenUserInfo as FourTaxTokenUserInfo, type TaxTokenInfo as FourTaxTokenInfo, } from './shared/four/index.js';
 export { PinataClient, type PinataConfig } from './shared/flap/pinata.js';
 export { pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob, type PinataPinResp } from './shared/flap/pinata.js';
 export { generateWallets, type GeneratedWallet } from './utils/wallet.js';

package/dist/index.js

@@ -64,6 +64,8 @@ export { fourPrivateBuy, fourPrivateSell, fourBatchPrivateBuy, fourBatchPrivateS
 export { flapPrivateBuy, flapPrivateSell, flapBatchPrivateBuy, flapBatchPrivateSell } from './shared/flap/portal-bundle.js';
 export { createTokenWithBundleBuyMerkle as flapCreateTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle as flapBatchBuyWithBundleMerkle, batchSellWithBundleMerkle as flapBatchSellWithBundleMerkle, flapPrivateBuyMerkle, flapPrivateSellMerkle, flapBatchPrivateBuyMerkle, flapBatchPrivateSellMerkle, pancakeProxyBatchBuyMerkle, pancakeProxyBatchSellMerkle, approvePancakeProxy, approvePancakeProxyBatch, flapDisperseWithBundleMerkle, flapSweepWithBundleMerkle } from './shared/flap/portal-bundle-merkle/index.js';
 export { createTokenWithBundleBuyMerkle as fourCreateTokenWithBundleBuyMerkle, batchBuyWithBundleMerkle as fourBatchBuyWithBundleMerkle, batchSellWithBundleMerkle as fourBatchSellWithBundleMerkle, fourPrivateBuyMerkle, fourPrivateSellMerkle, fourBatchPrivateBuyMerkle, fourBatchPrivateSellMerkle, disperseWithBundleMerkle, sweepWithBundleMerkle, pairwiseTransferWithBundleMerkle, fourPancakeProxyBatchBuyMerkle, fourPancakeProxyBatchSellMerkle, approveFourPancakeProxy, approveFourPancakeProxyBatch, approveFourTokenManagerBatch, submitBundleToMerkle, submitMultipleBundles, submitMultipleBundlesParallel, submitBundleToBlockRazor, submitMultipleBundlesToBlockRazor, submitMultipleBundlesToBlockRazorParallel } from './chains/bsc/four/index.js';
+// ✅ Four.meme TaxToken 工具（税币识别/查询/领取奖励）
+export { isTaxToken as fourIsTaxToken, isAntiSniperFeeMode as fourIsAntiSniperFeeMode, getCreatorType as fourGetCreatorType, getTaxTokenInfo as fourGetTaxTokenInfo, getClaimableFee as fourGetClaimableFee, getClaimedFee as fourGetClaimedFee, getUserRewardInfo as fourGetUserRewardInfo, buildClaimFeeTx as fourBuildClaimFeeTx, buildBatchClaimFeeTxs as fourBuildBatchClaimFeeTxs, validateFourTokenTaxInfo, TAX_TOKEN_ABI, TransferMode as FourTransferMode, } from './shared/four/index.js';
 export { PinataClient } from './shared/flap/pinata.js';
 export { pinFileToIPFSWithJWT, pinImageByPath, pinFileToIPFSWithJWTWeb, pinDataURLWithJWTWeb, dataURLToBlob } from './shared/flap/pinata.js';
 export { generateWallets } from './utils/wallet.js';

package/dist/shared/abis/TaxToken.json

@@ -0,0 +1,105 @@
+[
+    {
+        "anonymous": false,
+        "inputs": [
+            { "indexed": true, "internalType": "address", "name": "owner", "type": "address" },
+            { "indexed": true, "internalType": "address", "name": "spender", "type": "address" },
+            { "indexed": false, "internalType": "uint256", "name": "value", "type": "uint256" }
+        ],
+        "name": "Approval",
+        "type": "event"
+    },
+    {
+        "anonymous": false,
+        "inputs": [
+            { "indexed": false, "internalType": "address", "name": "account", "type": "address" },
+            { "indexed": false, "internalType": "uint256", "name": "amount", "type": "uint256" }
+        ],
+        "name": "FeeClaimed",
+        "type": "event"
+    },
+    {
+        "anonymous": false,
+        "inputs": [
+            { "indexed": false, "internalType": "uint256", "name": "amountFounder", "type": "uint256" },
+            { "indexed": false, "internalType": "uint256", "name": "amountHolder", "type": "uint256" },
+            { "indexed": false, "internalType": "uint256", "name": "amountBurn", "type": "uint256" },
+            { "indexed": false, "internalType": "uint256", "name": "amountLiquidity", "type": "uint256" },
+            { "indexed": false, "internalType": "uint256", "name": "quoteFounder", "type": "uint256" },
+            { "indexed": false, "internalType": "uint256", "name": "quoteHolder", "type": "uint256" }
+        ],
+        "name": "FeeDispatched",
+        "type": "event"
+    },
+    {
+        "anonymous": false,
+        "inputs": [
+            { "indexed": true, "internalType": "address", "name": "previousOwner", "type": "address" },
+            { "indexed": true, "internalType": "address", "name": "newOwner", "type": "address" }
+        ],
+        "name": "OwnershipTransferred",
+        "type": "event"
+    },
+    {
+        "anonymous": false,
+        "inputs": [
+            { "indexed": true, "internalType": "address", "name": "from", "type": "address" },
+            { "indexed": true, "internalType": "address", "name": "to", "type": "address" },
+            { "indexed": false, "internalType": "uint256", "name": "value", "type": "uint256" }
+        ],
+        "name": "Transfer",
+        "type": "event"
+    },
+    { "inputs": [], "name": "DEAD", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "MODE_NORMAL", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "MODE_TRANSFER_CONTROLLED", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "MODE_TRANSFER_RESTRICTED", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "PANCAKE_FACTORY", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "PANCAKE_ROUTER", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "SHARE_HOLDER_MANAGER", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "TOKEN_HELPER_5", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "TOKEN_MANAGER_2", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "WETH", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "_mode", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [{ "internalType": "address", "name": "owner", "type": "address" }, { "internalType": "address", "name": "spender", "type": "address" }], "name": "allowance", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [{ "internalType": "address", "name": "spender", "type": "address" }, { "internalType": "uint256", "name": "amount", "type": "uint256" }], "name": "approve", "outputs": [{ "internalType": "bool", "name": "", "type": "bool" }], "stateMutability": "nonpayable", "type": "function" },
+    { "inputs": [{ "internalType": "address", "name": "account", "type": "address" }], "name": "balanceOf", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "claimFee", "outputs": [], "stateMutability": "nonpayable", "type": "function" },
+    { "inputs": [{ "internalType": "address", "name": "account", "type": "address" }], "name": "claimableFee", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [{ "internalType": "address", "name": "account", "type": "address" }], "name": "claimedFee", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "decimals", "outputs": [{ "internalType": "uint8", "name": "", "type": "uint8" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [{ "internalType": "address", "name": "spender", "type": "address" }, { "internalType": "uint256", "name": "subtractedValue", "type": "uint256" }], "name": "decreaseAllowance", "outputs": [{ "internalType": "bool", "name": "", "type": "bool" }], "stateMutability": "nonpayable", "type": "function" },
+    { "inputs": [], "name": "feeAccumulated", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "feeBurn", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "feeDispatched", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "feeFounder", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "feeHolder", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "feeLiquidity", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "feePerShare", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "feeRate", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "founder", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [{ "internalType": "address", "name": "spender", "type": "address" }, { "internalType": "uint256", "name": "addedValue", "type": "uint256" }], "name": "increaseAllowance", "outputs": [{ "internalType": "bool", "name": "", "type": "bool" }], "stateMutability": "nonpayable", "type": "function" },
+    { "inputs": [{ "components": [{ "internalType": "address", "name": "quote", "type": "address" }, { "internalType": "string", "name": "name", "type": "string" }, { "internalType": "string", "name": "symbol", "type": "string" }, { "internalType": "uint256", "name": "totalSupply", "type": "uint256" }, { "internalType": "address", "name": "founder", "type": "address" }, { "internalType": "uint256", "name": "feeRate", "type": "uint256" }, { "internalType": "uint256", "name": "rateFounder", "type": "uint256" }, { "internalType": "uint256", "name": "rateHolder", "type": "uint256" }, { "internalType": "uint256", "name": "rateBurn", "type": "uint256" }, { "internalType": "uint256", "name": "rateLiquidity", "type": "uint256" }, { "internalType": "uint256", "name": "minDispatch", "type": "uint256" }, { "internalType": "uint256", "name": "minShare", "type": "uint256" }], "internalType": "struct ITokenCreator5.InitParams", "name": "a", "type": "tuple" }], "name": "init", "outputs": [], "stateMutability": "nonpayable", "type": "function" },
+    { "inputs": [], "name": "minDispatch", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "minShare", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "name", "outputs": [{ "internalType": "string", "name": "", "type": "string" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "owner", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "pair", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "quote", "outputs": [{ "internalType": "address", "name": "", "type": "address" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "quoteClaimed", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "quoteFounder", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "quoteHolder", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "rateBurn", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "rateFounder", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "rateHolder", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "rateLiquidity", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "renounceOwnership", "outputs": [], "stateMutability": "nonpayable", "type": "function" },
+    { "inputs": [{ "internalType": "uint256", "name": "v", "type": "uint256" }], "name": "setMode", "outputs": [], "stateMutability": "nonpayable", "type": "function" },
+    { "inputs": [], "name": "symbol", "outputs": [{ "internalType": "string", "name": "", "type": "string" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "totalShares", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [], "name": "totalSupply", "outputs": [{ "internalType": "uint256", "name": "", "type": "uint256" }], "stateMutability": "view", "type": "function" },
+    { "inputs": [{ "internalType": "address", "name": "to", "type": "address" }, { "internalType": "uint256", "name": "amount", "type": "uint256" }], "name": "transfer", "outputs": [{ "internalType": "bool", "name": "", "type": "bool" }], "stateMutability": "nonpayable", "type": "function" },
+    { "inputs": [{ "internalType": "address", "name": "from", "type": "address" }, { "internalType": "address", "name": "to", "type": "address" }, { "internalType": "uint256", "name": "amount", "type": "uint256" }], "name": "transferFrom", "outputs": [{ "internalType": "bool", "name": "", "type": "bool" }], "stateMutability": "nonpayable", "type": "function" },
+    { "inputs": [{ "internalType": "address", "name": "newOwner", "type": "address" }], "name": "transferOwnership", "outputs": [], "stateMutability": "nonpayable", "type": "function" },
+    { "inputs": [{ "internalType": "address", "name": "", "type": "address" }], "name": "userInfo", "outputs": [{ "internalType": "uint256", "name": "share", "type": "uint256" }, { "internalType": "uint256", "name": "rewardDebt", "type": "uint256" }, { "internalType": "uint256", "name": "claimable", "type": "uint256" }, { "internalType": "uint256", "name": "claimed", "type": "uint256" }], "stateMutability": "view", "type": "function" }
+]

package/dist/shared/abis/index.d.ts

@@ -1,5 +1,6 @@
 import TokenManager from './TokenManager.json';
 import TokenManager2 from './TokenManager2.json';
 import TokenManagerHelper3 from './TokenManagerHelper3.json';
-export { TokenManager, TokenManager2, TokenManagerHelper3 };
+import TaxToken from './TaxToken.json';
+export { TokenManager, TokenManager2, TokenManagerHelper3, TaxToken };
 export * from './common.js';

package/dist/shared/abis/index.js

@@ -1,6 +1,7 @@
 import TokenManager from './TokenManager.json' with { type: 'json' };
 import TokenManager2 from './TokenManager2.json' with { type: 'json' };
 import TokenManagerHelper3 from './TokenManagerHelper3.json' with { type: 'json' };
-export { TokenManager, TokenManager2, TokenManagerHelper3 };
+import TaxToken from './TaxToken.json' with { type: 'json' };
+export { TokenManager, TokenManager2, TokenManagerHelper3, TaxToken };
 // ✅ 公共 ABI 导出
 export * from './common.js';

package/dist/shared/clients/four.d.ts

@@ -26,6 +26,27 @@ export type LoginReq = {
     };
     walletName: 'MetaMask' | string;
 };
+/**
+ * Four.meme 税币配置参数
+ * - feeRate: 交易费率（固定选项：1, 3, 5, 10，代表 1%, 3%, 5%, 10%）
+ * - burnRate: 销毁比例（百分比，如 20 = 20%）
+ * - divideRate: 分红比例（百分比，如 30 = 30%）
+ * - liquidityRate: 流动性池比例（百分比，如 40 = 40%）
+ * - recipientRate: 创始人/接收者比例（百分比，如 10 = 10%）
+ * - recipientAddress: 接收者地址（不使用时传空字符串 ""）
+ * - minSharing: 最低持仓分红门槛（ether 单位，须满足 d × 10^n, n≥5, 1≤d≤9）
+ *
+ * 约束：burnRate + divideRate + liquidityRate + recipientRate = 100
+ */
+export type FourTokenTaxInfo = {
+    feeRate: 1 | 3 | 5 | 10;
+    burnRate: number;
+    divideRate: number;
+    liquidityRate: number;
+    recipientRate: number;
+    recipientAddress: string;
+    minSharing: number;
+};
 export type CreateTokenReq = {
     name: string;
     shortName: string;
@@ -38,6 +59,18 @@ export type CreateTokenReq = {
     telegramUrl?: string;
     preSale: string;
     onlyMPC?: boolean;
+    /**
+     * AntiSniperFeeMode（开盘高税模式）
+     * - true: 启用动态手续费系统（开盘时高税，逐区块自动降低）
+     * - false: 不启用（默认）
+     */
+    feePlan?: boolean;
+    /**
+     * 税币配置（Tax Token）
+     * - 提供此字段时创建税币（creatorType = 5）
+     * - 不提供或为 undefined 时创建普通代币
+     */
+    tokenTaxInfo?: FourTokenTaxInfo;
     lpTradingFee: 0.0025;
     symbol: 'BNB';
     totalSupply: 1000000000;

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

@@ -0,0 +1,7 @@
+/**
+ * Four.meme 工具模块
+ *
+ * 提供 Four.meme 平台相关的工具函数：
+ * - TaxToken：税币识别、状态查询、奖励领取
+ */
+export { isTaxToken, isAntiSniperFeeMode, getCreatorType, getTaxTokenInfo, getClaimableFee, getClaimedFee, getUserRewardInfo, buildClaimFeeTx, buildBatchClaimFeeTxs, validateFourTokenTaxInfo, TAX_TOKEN_ABI, TransferMode, type TaxTokenConfig, type TaxTokenRewardStats, type TaxTokenUserInfo, type TaxTokenInfo, } from './tax-token.js';

package/dist/shared/four/index.js

@@ -0,0 +1,22 @@
+/**
+ * Four.meme 工具模块
+ *
+ * 提供 Four.meme 平台相关的工具函数：
+ * - TaxToken：税币识别、状态查询、奖励领取
+ */
+// TaxToken 工具
+export { 
+// 识别方法
+isTaxToken, isAntiSniperFeeMode, getCreatorType, 
+// 状态查询
+getTaxTokenInfo, 
+// 用户奖励
+getClaimableFee, getClaimedFee, getUserRewardInfo, 
+// 奖励领取
+buildClaimFeeTx, buildBatchClaimFeeTxs, 
+// 校验工具
+validateFourTokenTaxInfo, 
+// ABI
+TAX_TOKEN_ABI, 
+// 类型
+TransferMode, } from './tax-token.js';

package/dist/shared/four/tax-token.d.ts

@@ -0,0 +1,176 @@
+import TaxTokenAbi from '../abis/TaxToken.json';
+/** TaxToken 转账模式 */
+export declare enum TransferMode {
+    /** 正常转账模式 - 允许所有转账 */
+    NORMAL = 0,
+    /** 限制转账模式 - 禁止所有转账 */
+    RESTRICTED = 1,
+    /** 受控转账模式 - 只允许与 owner 相关的转账 */
+    CONTROLLED = 2
+}
+/** TaxToken 税收配置状态 */
+export type TaxTokenConfig = {
+    /** 交易费率（基点，10000 = 100%） */
+    feeRate: bigint;
+    /** 创始人分配比例（百分比，100 = 100%） */
+    rateFounder: bigint;
+    /** 持有者分配比例 */
+    rateHolder: bigint;
+    /** 销毁比例 */
+    rateBurn: bigint;
+    /** 流动性比例 */
+    rateLiquidity: bigint;
+    /** 创始人地址 */
+    founder: string;
+    /** 报价代币地址 */
+    quote: string;
+    /** PancakeSwap 配对地址 */
+    pair: string;
+    /** 当前转账模式 */
+    mode: TransferMode;
+    /** 最低分发阈值 */
+    minDispatch: bigint;
+    /** 最低持仓参与分红门槛 */
+    minShare: bigint;
+};
+/** TaxToken 奖励统计数据 */
+export type TaxTokenRewardStats = {
+    /** 总持仓份额 */
+    totalShares: bigint;
+    /** 每份额累计奖励 */
+    feePerShare: bigint;
+    /** 累积待分发手续费 */
+    feeAccumulated: bigint;
+    /** 已分发手续费总额 */
+    feeDispatched: bigint;
+    /** 分配给创始人的代币总额 */
+    feeFounder: bigint;
+    /** 分配给持有者的代币总额 */
+    feeHolder: bigint;
+    /** 销毁的代币总额 */
+    feeBurn: bigint;
+    /** 注入流动性的代币总额 */
+    feeLiquidity: bigint;
+    /** 创始人获得的报价代币总额 */
+    quoteFounder: bigint;
+    /** 持有者获得的报价代币总额 */
+    quoteHolder: bigint;
+    /** 已领取的报价代币总额 */
+    quoteClaimed: bigint;
+};
+/** 用户在 TaxToken 中的奖励信息 */
+export type TaxTokenUserInfo = {
+    /** 用户持仓份额 */
+    share: bigint;
+    /** 已计入的奖励债务 */
+    rewardDebt: bigint;
+    /** 可领取的奖励金额（报价代币） */
+    claimable: bigint;
+    /** 已领取的奖励金额（报价代币） */
+    claimed: bigint;
+};
+/** TaxToken 完整信息 */
+export type TaxTokenInfo = {
+    config: TaxTokenConfig;
+    rewardStats: TaxTokenRewardStats;
+};
+/**
+ * 链上判断代币是否是 TaxToken
+ *
+ * 原理：读取 TokenManager2._tokenInfos[token].template，
+ * 提取 creatorType = (template >> 10) & 0x3F，判断是否等于 5
+ *
+ * @param tokenAddress - 代币合约地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns 是否为 TaxToken
+ */
+export declare function isTaxToken(tokenAddress: string, rpcUrl: string): Promise<boolean>;
+/**
+ * 链上判断代币是否启用了 AntiSniperFeeMode
+ *
+ * 原理：读取 TokenManager2._tokenInfoEx1s[token].feeSetting > 0
+ *
+ * @param tokenAddress - 代币合约地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns 是否启用 AntiSniperFeeMode
+ */
+export declare function isAntiSniperFeeMode(tokenAddress: string, rpcUrl: string): Promise<boolean>;
+/**
+ * 获取代币的 creatorType
+ *
+ * @param tokenAddress - 代币合约地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns creatorType 数值
+ */
+export declare function getCreatorType(tokenAddress: string, rpcUrl: string): Promise<number>;
+/**
+ * 获取 TaxToken 的完整配置信息
+ *
+ * @param tokenAddress - TaxToken 合约地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns 税收配置 + 奖励统计
+ */
+export declare function getTaxTokenInfo(tokenAddress: string, rpcUrl: string): Promise<TaxTokenInfo>;
+/**
+ * 查询用户在 TaxToken 中的可领取奖励
+ *
+ * @param tokenAddress - TaxToken 合约地址
+ * @param account - 用户钱包地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns 可领取的报价代币数量（wei）
+ */
+export declare function getClaimableFee(tokenAddress: string, account: string, rpcUrl: string): Promise<bigint>;
+/**
+ * 查询用户在 TaxToken 中的已领取奖励
+ *
+ * @param tokenAddress - TaxToken 合约地址
+ * @param account - 用户钱包地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns 已领取的报价代币数量（wei）
+ */
+export declare function getClaimedFee(tokenAddress: string, account: string, rpcUrl: string): Promise<bigint>;
+/**
+ * 查询用户在 TaxToken 中的完整奖励信息
+ *
+ * @param tokenAddress - TaxToken 合约地址
+ * @param account - 用户钱包地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns 用户奖励信息（份额、债务、可领取、已领取）
+ */
+export declare function getUserRewardInfo(tokenAddress: string, account: string, rpcUrl: string): Promise<TaxTokenUserInfo>;
+/**
+ * 构建 TaxToken 奖励领取的签名交易（不发送）
+ *
+ * @param tokenAddress - TaxToken 合约地址
+ * @param privateKey - 用户私钥
+ * @param rpcUrl - BSC RPC URL
+ * @returns 签名后的交易 hex
+ */
+export declare function buildClaimFeeTx(tokenAddress: string, privateKey: string, rpcUrl: string): Promise<string>;
+/**
+ * 批量构建 TaxToken 奖励领取交易（多个钱包）
+ *
+ * @param tokenAddress - TaxToken 合约地址
+ * @param privateKeys - 用户私钥数组
+ * @param rpcUrl - BSC RPC URL
+ * @returns 签名后的交易 hex 数组
+ */
+export declare function buildBatchClaimFeeTxs(tokenAddress: string, privateKeys: string[], rpcUrl: string): Promise<string[]>;
+/**
+ * 验证 FourTokenTaxInfo 参数合法性
+ *
+ * @param info - 税币配置
+ * @returns 验证结果，valid=true 表示合法
+ */
+export declare function validateFourTokenTaxInfo(info: {
+    feeRate: number;
+    burnRate: number;
+    divideRate: number;
+    liquidityRate: number;
+    recipientRate: number;
+    minSharing: number;
+}): {
+    valid: boolean;
+    error?: string;
+};
+export { TaxTokenAbi as TAX_TOKEN_ABI };

package/dist/shared/four/tax-token.js

@@ -0,0 +1,302 @@
+/**
+ * Four.meme TaxToken 工具模块
+ *
+ * 提供 TaxToken 的识别、状态查询、奖励领取等功能。
+ * 基于 Four.meme 官方文档: API-Contract-TaxToken.md
+ */
+import { ethers, Contract, Wallet, JsonRpcProvider } from 'ethers';
+import TaxTokenAbi from '../abis/TaxToken.json' with { type: 'json' };
+// ============================================================================
+// 常量
+// ============================================================================
+/** Four.meme TokenManager2 合约地址（BSC） */
+const TOKEN_MANAGER_2_ADDRESS = '0x5c952063c7fc8610FFDB798152D69F0B9550762b';
+/** TaxToken 的 creatorType 值 */
+const TOKEN_TYPE_TAX = 5;
+/** TokenManager2 最小 ABI（用于查询 _tokenInfos 和 _tokenInfoEx1s） */
+const TOKEN_MANAGER_QUERY_ABI = [
+    'function _tokenInfos(address) view returns (uint256 template)',
+    'function _tokenInfoEx1s(address) view returns (uint256 launchFee, uint256 pcFee, uint256 feeSetting, uint256 blockNumber, uint256 extraFee)',
+];
+/** TaxToken 读取 ABI（ethers human-readable 格式，比 JSON 更轻） */
+const TAX_TOKEN_READ_ABI = [
+    'function feeRate() view returns (uint256)',
+    'function rateFounder() view returns (uint256)',
+    'function rateHolder() view returns (uint256)',
+    'function rateBurn() view returns (uint256)',
+    'function rateLiquidity() view returns (uint256)',
+    'function founder() view returns (address)',
+    'function quote() view returns (address)',
+    'function pair() view returns (address)',
+    'function _mode() view returns (uint256)',
+    'function minDispatch() view returns (uint256)',
+    'function minShare() view returns (uint256)',
+    'function totalShares() view returns (uint256)',
+    'function feePerShare() view returns (uint256)',
+    'function feeAccumulated() view returns (uint256)',
+    'function feeDispatched() view returns (uint256)',
+    'function feeFounder() view returns (uint256)',
+    'function feeHolder() view returns (uint256)',
+    'function feeBurn() view returns (uint256)',
+    'function feeLiquidity() view returns (uint256)',
+    'function quoteFounder() view returns (uint256)',
+    'function quoteHolder() view returns (uint256)',
+    'function quoteClaimed() view returns (uint256)',
+    'function claimableFee(address) view returns (uint256)',
+    'function claimedFee(address) view returns (uint256)',
+    'function userInfo(address) view returns (uint256 share, uint256 rewardDebt, uint256 claimable, uint256 claimed)',
+    'function claimFee()',
+];
+// ============================================================================
+// 类型
+// ============================================================================
+/** TaxToken 转账模式 */
+export var TransferMode;
+(function (TransferMode) {
+    /** 正常转账模式 - 允许所有转账 */
+    TransferMode[TransferMode["NORMAL"] = 0] = "NORMAL";
+    /** 限制转账模式 - 禁止所有转账 */
+    TransferMode[TransferMode["RESTRICTED"] = 1] = "RESTRICTED";
+    /** 受控转账模式 - 只允许与 owner 相关的转账 */
+    TransferMode[TransferMode["CONTROLLED"] = 2] = "CONTROLLED";
+})(TransferMode || (TransferMode = {}));
+// ============================================================================
+// 识别方法
+// ============================================================================
+/**
+ * 链上判断代币是否是 TaxToken
+ *
+ * 原理：读取 TokenManager2._tokenInfos[token].template，
+ * 提取 creatorType = (template >> 10) & 0x3F，判断是否等于 5
+ *
+ * @param tokenAddress - 代币合约地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns 是否为 TaxToken
+ */
+export async function isTaxToken(tokenAddress, rpcUrl) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    const tm2 = new Contract(TOKEN_MANAGER_2_ADDRESS, TOKEN_MANAGER_QUERY_ABI, provider);
+    const template = await tm2._tokenInfos(tokenAddress);
+    const creatorType = Number((template >> 10n) & 0x3fn);
+    return creatorType === TOKEN_TYPE_TAX;
+}
+/**
+ * 链上判断代币是否启用了 AntiSniperFeeMode
+ *
+ * 原理：读取 TokenManager2._tokenInfoEx1s[token].feeSetting > 0
+ *
+ * @param tokenAddress - 代币合约地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns 是否启用 AntiSniperFeeMode
+ */
+export async function isAntiSniperFeeMode(tokenAddress, rpcUrl) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    const tm2 = new Contract(TOKEN_MANAGER_2_ADDRESS, TOKEN_MANAGER_QUERY_ABI, provider);
+    const info = await tm2._tokenInfoEx1s(tokenAddress);
+    return BigInt(info.feeSetting) > 0n;
+}
+/**
+ * 获取代币的 creatorType
+ *
+ * @param tokenAddress - 代币合约地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns creatorType 数值
+ */
+export async function getCreatorType(tokenAddress, rpcUrl) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    const tm2 = new Contract(TOKEN_MANAGER_2_ADDRESS, TOKEN_MANAGER_QUERY_ABI, provider);
+    const template = await tm2._tokenInfos(tokenAddress);
+    return Number((template >> 10n) & 0x3fn);
+}
+// ============================================================================
+// TaxToken 状态查询
+// ============================================================================
+/**
+ * 获取 TaxToken 的完整配置信息
+ *
+ * @param tokenAddress - TaxToken 合约地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns 税收配置 + 奖励统计
+ */
+export async function getTaxTokenInfo(tokenAddress, rpcUrl) {
+    const provider = new JsonRpcProvider(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(),
+    ]);
+    return {
+        config: {
+            feeRate: BigInt(feeRate),
+            rateFounder: BigInt(rateFounder),
+            rateHolder: BigInt(rateHolder),
+            rateBurn: BigInt(rateBurn),
+            rateLiquidity: BigInt(rateLiquidity),
+            founder: String(founder),
+            quote: String(quote),
+            pair: String(pair),
+            mode: Number(mode),
+            minDispatch: BigInt(minDispatch),
+            minShare: BigInt(minShare),
+        },
+        rewardStats: {
+            totalShares: BigInt(totalShares),
+            feePerShare: BigInt(feePerShare),
+            feeAccumulated: BigInt(feeAccumulated),
+            feeDispatched: BigInt(feeDispatched),
+            feeFounder: BigInt(feeFounderVal),
+            feeHolder: BigInt(feeHolderVal),
+            feeBurn: BigInt(feeBurnVal),
+            feeLiquidity: BigInt(feeLiquidityVal),
+            quoteFounder: BigInt(quoteFounderVal),
+            quoteHolder: BigInt(quoteHolderVal),
+            quoteClaimed: BigInt(quoteClaimed),
+        },
+    };
+}
+// ============================================================================
+// 用户奖励查询
+// ============================================================================
+/**
+ * 查询用户在 TaxToken 中的可领取奖励
+ *
+ * @param tokenAddress - TaxToken 合约地址
+ * @param account - 用户钱包地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns 可领取的报价代币数量（wei）
+ */
+export async function getClaimableFee(tokenAddress, account, rpcUrl) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    const token = new Contract(tokenAddress, TAX_TOKEN_READ_ABI, provider);
+    return BigInt(await token.claimableFee(account));
+}
+/**
+ * 查询用户在 TaxToken 中的已领取奖励
+ *
+ * @param tokenAddress - TaxToken 合约地址
+ * @param account - 用户钱包地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns 已领取的报价代币数量（wei）
+ */
+export async function getClaimedFee(tokenAddress, account, rpcUrl) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    const token = new Contract(tokenAddress, TAX_TOKEN_READ_ABI, provider);
+    return BigInt(await token.claimedFee(account));
+}
+/**
+ * 查询用户在 TaxToken 中的完整奖励信息
+ *
+ * @param tokenAddress - TaxToken 合约地址
+ * @param account - 用户钱包地址
+ * @param rpcUrl - BSC RPC URL
+ * @returns 用户奖励信息（份额、债务、可领取、已领取）
+ */
+export async function getUserRewardInfo(tokenAddress, account, rpcUrl) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    const token = new Contract(tokenAddress, TAX_TOKEN_READ_ABI, provider);
+    const info = await token.userInfo(account);
+    return {
+        share: BigInt(info.share),
+        rewardDebt: BigInt(info.rewardDebt),
+        claimable: BigInt(info.claimable),
+        claimed: BigInt(info.claimed),
+    };
+}
+// ============================================================================
+// 奖励领取
+// ============================================================================
+/**
+ * 构建 TaxToken 奖励领取的签名交易（不发送）
+ *
+ * @param tokenAddress - TaxToken 合约地址
+ * @param privateKey - 用户私钥
+ * @param rpcUrl - BSC RPC URL
+ * @returns 签名后的交易 hex
+ */
+export async function buildClaimFeeTx(tokenAddress, privateKey, rpcUrl) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    const wallet = new Wallet(privateKey, provider);
+    const token = new Contract(tokenAddress, TAX_TOKEN_READ_ABI, wallet);
+    const tx = await token.claimFee.populateTransaction();
+    const nonce = await provider.getTransactionCount(wallet.address, 'latest');
+    const feeData = await provider.getFeeData();
+    const signedTx = await wallet.signTransaction({
+        to: tokenAddress,
+        data: tx.data,
+        nonce,
+        gasLimit: 200000n,
+        gasPrice: feeData.gasPrice ?? ethers.parseUnits('3', 'gwei'),
+        chainId: 56,
+        type: 0,
+    });
+    return signedTx;
+}
+/**
+ * 批量构建 TaxToken 奖励领取交易（多个钱包）
+ *
+ * @param tokenAddress - TaxToken 合约地址
+ * @param privateKeys - 用户私钥数组
+ * @param rpcUrl - BSC RPC URL
+ * @returns 签名后的交易 hex 数组
+ */
+export async function buildBatchClaimFeeTxs(tokenAddress, privateKeys, rpcUrl) {
+    const provider = new JsonRpcProvider(rpcUrl);
+    const iface = new ethers.Interface(TAX_TOKEN_READ_ABI);
+    const claimData = iface.encodeFunctionData('claimFee', []);
+    const feeData = await provider.getFeeData();
+    const gasPrice = feeData.gasPrice ?? ethers.parseUnits('3', 'gwei');
+    const signedTxs = await Promise.all(privateKeys.map(async (pk) => {
+        const wallet = new Wallet(pk, provider);
+        const nonce = await provider.getTransactionCount(wallet.address, 'latest');
+        return wallet.signTransaction({
+            to: tokenAddress,
+            data: claimData,
+            nonce,
+            gasLimit: 200000n,
+            gasPrice,
+            chainId: 56,
+            type: 0,
+        });
+    }));
+    return signedTxs;
+}
+// ============================================================================
+// 校验工具
+// ============================================================================
+/**
+ * 验证 FourTokenTaxInfo 参数合法性
+ *
+ * @param info - 税币配置
+ * @returns 验证结果，valid=true 表示合法
+ */
+export function validateFourTokenTaxInfo(info) {
+    // feeRate 必须是 1, 3, 5, 10 之一
+    if (![1, 3, 5, 10].includes(info.feeRate)) {
+        return { valid: false, error: `feeRate 必须为 1, 3, 5 或 10，当前: ${info.feeRate}` };
+    }
+    // 四项比例之和必须为 100
+    const rateSum = info.burnRate + info.divideRate + info.liquidityRate + info.recipientRate;
+    if (rateSum !== 100) {
+        return { valid: false, error: `burnRate + divideRate + liquidityRate + recipientRate 必须等于 100，当前: ${rateSum}` };
+    }
+    // 每项比例 >= 0
+    if (info.burnRate < 0 || info.divideRate < 0 || info.liquidityRate < 0 || info.recipientRate < 0) {
+        return { valid: false, error: '所有比例值不能为负数' };
+    }
+    // minSharing 验证: d × 10^n, n >= 5, 1 <= d <= 9
+    if (info.minSharing > 0) {
+        const str = String(info.minSharing);
+        // 必须形如 d000...0（d 为 1-9 的数字，后面至少 5 个 0）
+        const match = str.match(/^([1-9])(0+)$/);
+        if (!match || match[2].length < 5) {
+            return { valid: false, error: `minSharing 必须满足 d × 10^n (n≥5, 1≤d≤9)，当前: ${info.minSharing}` };
+        }
+    }
+    return { valid: true };
+}
+// 导出 ABI 供外部使用
+export { TaxTokenAbi as TAX_TOKEN_ABI };

package/dist/shared/index.d.ts

@@ -3,8 +3,8 @@
  *
  * 包含所有跨链共享的功能：
  * - constants: 常量定义
- * - (未来) clients: API 客户端
- * - (未来) utils: 工具函数
- * - (未来) types: 通用类型
+ * - clients: API 客户端
+ * - four: Four.meme 工具（TaxToken 等）
  */
 export * from './constants/index.js';
+export * as FourUtils from './four/index.js';

package/dist/shared/index.js

@@ -3,8 +3,8 @@
  *
  * 包含所有跨链共享的功能：
  * - constants: 常量定义
- * - (未来) clients: API 客户端
- * - (未来) utils: 工具函数
- * - (未来) types: 通用类型
+ * - clients: API 客户端
+ * - four: Four.meme 工具（TaxToken 等）
  */
 export * from './constants/index.js';
+export * as FourUtils from './four/index.js';

package/package.json

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