Protocol overview

Hanok is a small set of contracts with one job each. The factory is the entry point for launching and graduating; everything else is either created per launch or shared by every launch.

Design goals

• Nothing to rug. Supply is fixed at launch, every token is minted to the curve, and graduated liquidity lives in a contract that cannot release it.
• Deterministic graduation. Every launch on the same config graduates into a pool of the same size at the same price, whether it was bought out by one wallet or a thousand.
• No custody, no backend. Every step is a transaction your wallet signs. Hanok never holds user funds, and every number in the app is read straight from the chain.
• Creator revenue in ETH. Fees are always charged on the ETH side of a trade, before and after graduation, so creators are never paid in a token they would have to sell.

Components

Contract	Scope	Role
HanokFactory	Shared	Launches tokens, keeps the launch registry, drives graduation, holds admin settings with hard-coded ceilings.
HanokToken	Per launch	Fixed-supply ERC-20 with EIP-2612 permit. No owner, no mint, no pause, no transfer tax.
HanokCurve	Per launch	Constant-product bonding curve with a virtual reserve. Prices and settles every pre-graduation trade and exposes on-chain quotes.
HanokLiquidityLocker	Shared	Creates each graduated Uniswap V4 pool and owns its full-range position forever.
HanokHook	Shared	Uniswap V4 hook that charges Hanok's fees on graduated pools and distributes them.
HanokRouter	Shared	One trading entry point that routes to the curve or the pool depending on the launch phase.
HanokFeeEscrow	Shared	Pull-payment ledger for every payout: creator earnings, protocol fees, referrals.
HanokVestingVault	Shared	Holds bought-back tokens and releases them linearly over five years.
HanokDeployer	Shared	Deploys each token and curve at deterministic CREATE2 addresses.

A launch in one picture

 create ──▶ bonding curve ──▶ sold out ──▶ Uniswap V4 pool (locked)
  │            │  buy/sell        │  same tx        │  buy/sell via any router
  │            │  fees in ETH     │  seed at closing │  fees in ETH via hook
  │            │                  │  price           │
  └ optional first buy            └ unpaired tokens burned

Read the launch lifecycle for the full walk-through.