whale.store / docs
developer manual · v1.0.0

the whale manual.

everything you need to launch a token, trade a pool, or build on top of whale.store. opinionated by design, on base by default.

what is whale.store?

whale.store is a deep liquidity token launchpad on base. every token launched through the factory gets a uniswap v3 concentrated liquidity position paired with WETH. the LP NFT stays in the factory — not in anyone's wallet.

tokens launch with real liquidity from day one. no graduation curve, no thin pool.

who is this for?

  • project founders who want a launch with real depth that traders take seriously.
  • traders who are tired of buying into thin pools and getting wrecked by slippage.
  • builders who need a predictable launchpad — every pool uses the same uniswap v3 interface.

how it works

the factory deploys the token, creates a uniswap v3 pool with concentrated liquidity, and optionally executes an initial buy — all in one transaction.

  • 1B token supply per launch.
  • 2% max wallet during the first 5 blocks (anti-snipe).
  • no buys allowed in the launch block itself.
  • LP NFT held by the factory contract.

deep liquidity

a pool is deep when its reserves are large relative to typical trade size. the deeper the pool, the less a single buyer can move the price.

whale.store uses uniswap v3 concentrated liquidity — the full token supply is placed in a single price range, giving maximum depth from launch.

  1. thin pool (3 Ξ) · 1 Ξ buy = brutal slippage. one whale ruins the chart.
  2. whale pool · concentrated liquidity across a wide range. organic-feeling trades.

lp positions

when you launch on whale.store, the uniswap v3 position NFT stays in the WhaleFactory contract. the creator and platform controller can collect accrued swap fees, but the underlying liquidity position remains in the factory.

fee collection

call collectFees(tokenId) on the factory. fees are split:

  • 50% to the platform.
  • remaining 50% split between creator and receiver based on the split parameter set at launch.

token fees (non-WETH side) are sent to the receiver. WETH fees are unwrapped to ETH and distributed.

penalty system

if ETH is sent with the deployCoin() call, the factory executes an initial buy through the pool. a penalty (tax) is applied based on the ETH amount:

ETH amountpenalty
< 0.5 ETH0%
0.5 – 5 ETH2.5% – 25% (linear scale)
≥ 5 ETH25% cap

this penalty is multiplied by the liquidity config's penaltyMultiplier (default 100% = no extra scaling).

core contracts

deployed on base mainnet.

contractaddressresponsibility
WhaleFactory0x16bb…8e54deploys token + creates pool + holds LP
Position Manager0x03a5…34f1uniswap v3 NFT position manager
Swap Router0x2626…e481uniswap v3 swap router 02
WETH0x4200…0006wrapped ETH on base

liquidity configs

the factory ships with 3 pre-set liquidity configurations, each defining different price ranges and virtual depths. the platform controller can add more.

configvirtual depthtick range
config 0 · standard84 ETH · ~$177K mcap137750 → 874600
config 1 · deep167 ETH · ~$353K mcap130800 → 874600
config 2 · whale335 ETH · ~$707K mcap123900 → 874600

token specs

every token launched through whale.store has:

paramvalue
total supply1,000,000,000 (1B)
decimals18
max wallet (launch)2% for first 5 blocks
launch block protectionno buys in deploy block
LP pooluniswap v3 · 0.25% fee tier
creator fieldchangeable by platform
burnanyone can burn their own tokens

reading on-chain data

all data is on-chain. read directly from the factory contract:

all token data is queryable on-chain from the factory — paginated token lists, tokens by creator, market cap in ETH, fee info, and LP position IDs. read the verified contract on basescan for the full interface.

platform controls

the platform controller can:

  • toggleDeployCoin() — enable/disable new launches.
  • collectFees(tokenId) — collect accrued uniswap v3 fees for any pool.
  • createLiquidityConfig(…) — add new liquidity range presets.
  • updateLiquidityConfig(…) — modify existing presets.
  • withdrawFeesWETH() — withdraw WETH from the factory.
  • withdrawFeesETH() — withdraw ETH from the factory.
  • transferPlatformController(…) — transfer control to a new address.

trading

tokens launched through whale.store are standard ERC-20s paired on uniswap v3. trade them anywhere:

  • uniswap — direct swap through the 0.25% fee tier pool.
  • any aggregator — 1inch, paraswap, cowswap all route through uni v3.
  • whale.store ui — swap directly from the pools page.

the swap router address on base: 0x2626664c2603336E57B271c5C0b26F421741e481

security

the factory contract is deployed on base mainnet and verified on basescan. the LP NFT is held by the factory — no external vault or multisig.