B20factory — docs

The terminal-native launchpad for native B20 tokens on Base Beryl.

overview

B20factory launches B20 tokens — Base's native token standard from the Beryl upgrade. Each launch produces a clean, admin-less token paired with a locked single-sided liquidity pool, so it is tradeable the moment it deploys.

  • native B20 ASSET minted by the 0xB20f… precompile
  • no admin: not mintable, not pausable, not freezable
  • supply capped at 1,000,000,000 and fully minted at creation
  • single-sided V4 pool, liquidity locked forever
  • volatility-based dynamic swap fee, 1%–5%

the B20 standard

B20 token logic runs natively in the Base node as a Rust precompile rather than as EVM bytecode. It is a full superset of ERC-20 — every wallet, DEX, and tool works unchanged — while being cheaper and faster (Base targets ~50% cheaper transfers). B20factory deploys the ASSET variant.

Because the token has no transfer tax and no mint authority, buy/sell simulators see a clean token — so it can be boosted and promoted without being flagged.

launching a token

A launch is a free-mint collection that bonds and auto-deploys the token:

  • set name, symbol, and a starting market cap (e.g. $10k)
  • choose your fee band (base + max, each 1–5%)
  • the bonding completes and the B20 token mints automatically
  • 100% of the trading slice is seeded single-sided into a locked pool
launch \
  --name "Beryl Cat" --symbol BCAT \
  --base 3 --max 5 \
  --mc 10000

dynamic fees

The swap fee floats between a base and a max (both in 1%–5%). In calm markets it sits at the base; when a swap moves price hard (volatility / snipers) it ramps toward the max, then settles back. Setbase == max for a flat fee.

  • --base-fee 1% --max-fee 5% → dynamic 1→5%
  • --base-fee 2% --max-fee 2% → flat 2%
  • worst case ever observable is the max (≤5%) — honeypot-safe

supply & vesting

Total supply is 1,000,000,000, fully minted and capped at launch. The split:

  • 80% → single-sided pool (locked forever)
  • 20% → creator vesting, released 1% of supply per month (20 months)

Vesting is claimable monthly by the creator only — no early release, no rug path. Platform-run launches can instead distribute the reserved slice directly to a prepared list of addresses at launch.

fee splitter

Swap fees are paid in native ETH to a per-token splitter and split between the creator and the platform (default 55% / 45%). Anyone can calldistribute() to flush the accrued fees.

terminal commands

help                     list commands
balance                  wallet balance
launch [flags]           deploy a B20 token
fee --base --max         preview a fee band
clear                    clear screen

why it's not a honeypot

Detectors simulate a buy then a sell and flag high tax or failed sells. B20factory passes because:

  • the B20 token has no transfer tax (clean ERC-20)
  • no mint / pause / freeze authority exists
  • the swap fee is capped at 5% — never read as a punitive tax
  • liquidity is locked and the pool is single-sided but fully tradeable