four-meme-sdk

A practical SDK for Four.Meme on BSC that supports the full lifecycle:

• 发币: deploy token (via four-meme-token-launcher)
• 买币: bonding-curve (Four.Meme) or PancakeSwap V2
• 卖币: bonding-curve (Four.Meme) or PancakeSwap V2

Install

npm i four-meme-sdk

Quick Start

1) Deploy token

const { deployToken } = require('four-meme-sdk');

const tokenConfig = {
  name: 'My Meme Token',
  symbol: 'MEME',
  description: 'The next big thing on BSC',
  imagePath: './assets/logo.png',
  twitter: 'https://x.com/...',
  telegram: 'https://t.me/...',
};

const result = await deployToken(
  tokenConfig,
  {
    privateKey: 'YOUR_PRIVATE_KEY',
    dryRun: true,
  },
  {
    taxRateBps: 500,
    fundsBps: 9700,
    burnBps: 100,
    holdersBps: 100,
    liquidityBps: 100,
    beneficiaryAddress: '0x...'
  }
);

console.log(result);

2) Buy token

const { buyToken } = require('four-meme-sdk');

const buy = await buyToken(
  {
    tokenAddress: '0xTokenAddress',
    bnbAmount: '0.05',
  },
  {
    privateKey: 'YOUR_PRIVATE_KEY',
    slippageBps: 300,
    deadlineSeconds: 600,
    route: 'auto', // auto | fourmeme | pancake
  }
);

console.log(buy);

3) Sell token

const { sellToken, utils } = require('four-meme-sdk');

const amountToSell = utils.parseUnits('100000', 18); // 100,000 tokens (18 decimals)

const sell = await sellToken(
  {
    tokenAddress: '0xTokenAddress',
    tokenAmount: amountToSell,
  },
  {
    privateKey: 'YOUR_PRIVATE_KEY',
    slippageBps: 300,
    deadlineSeconds: 600,
    route: 'auto', // auto | fourmeme | pancake
  }
);

console.log(sell);

API

deployToken(tokenConfig, deployConfig, taxConfig?)

Re-exported from four-meme-token-launcher.

buyToken(params, tradeConfig)

• params.bnbAmount supports string (in BNB, e.g. '0.1') or bigint (wei)
• for non-BNB quote tokens, pass params.quoteAmount and tradeConfig.quoteDecimals
• default router: PancakeSwap V2 0x10ED...

sellToken(params, tradeConfig)

• params.tokenAmount must be in token smallest units (use utils.parseUnits)

TradeConfig

• privateKey (no 0x prefix)
• rpcUrl (default: BSC public RPC)
• routerAddress (default: PancakeSwap V2)
• slippageBps (default: 300)
• deadlineSeconds (default: 600)
• useSupportingFeeOnTransfer (default: true)
• dryRun (default: false)
• route (default: auto)
• helperAddress (default: Four.Meme Helper3)
• quoteDecimals (required when quoteAmount is string)

Notes

• SDK auto-detects bonding-curve vs DEX by reading liquidityAdded from Helper3.
• If Four.Meme changes routers, set routerAddress.
• For tokens with transfer fees, keep useSupportingFeeOnTransfer: true (default).
• This SDK does not manage gas settings; viem defaults are used.

Safety

• Never commit private keys.
• Use dryRun: true before live transactions.