log · book I

THE LOG

What the hook does, in the order it does it. Read top to bottom; nothing here is hidden in a docs site that doesn't exist yet.

token
$LODE — ERC-20
hook
BurnPool — uniswap v4
round
30 blocks
fee
5% of swap, in ETH
split
90 winner · 10 burn
RNG
Chainlink VRF v2.5

contracts verified on etherscan →  ·  open the pool on uniswap →

the fee path

A trader signs a swap on the LODE/ETH pool. The pool calls our hook before the swap settles. Inside that callback the hook reads the swap amount and takes 5% of it as ETH, regardless of direction.

  1. 1
    swap arrives. The pool manager hands the hook a delta and asks what it wants to do.
  2. 2
    hook takes 5% in ETH. Settled against the pool manager, not held on a router. The fee is parked on the hook's internal pot for the current round.
  3. 3
    ticket logged. The wallet that signed the swap is added to the round's ticket list, weighted by the ETH it paid.
  4. 4
    swap settles normally. From the trader's side: one swap, one signature, one fill. The fee is part of the price; the round is the bonus side.

note — there is no off-chain step here. The fee accrual, the ticket log, and the round are all on chain. Anyone reading the hook's storage can reconstruct the current round at any block.

the roll

Once block 30 of the round closes, anyone can call roll(roundId) on the hook. Calling it costs gas; the caller is reimbursed a small bounty from the pot so the round always closes on time.

roll requests a random word from Chainlink VRF v2.5. VRF answers on a later block via fulfillRandomWords. That callback is where the work happens.

What fulfillRandomWords does, in order
#actioneffect
1walk weighted ticketsland on winner address
2call poolManager.unlockopen a v4 callback
3swap pot ETH → LODEatomically, in-pool
4transfer 90% LODE to winnercredited to winning wallet
5send 10% LODE to 0x…dEaDburned
6open round N+1fees resume accruing

note — the buyback is just a swap on the same pool the trader used. Anyone watching the pool sees the round's ETH come back through as a single large buy, and the price moves like it would for any other large buy. The hook does not have a secret path; it is a market participant on its own pool.

the kiln

Of the LODE that comes back through the buyback, ten percent is sent to the zero address. There is no toggle. There is no "burn off" switch. The hook cannot be reconfigured; the proportions are written into the bytecode.

Across a thousand rounds, that ten percent slice compounds. Float shrinks. Holders keep the same number of LODE; the supply they sit inside of gets smaller. The vein gets richer.

round 1 round N · float ↓

specs

ticker$LODE
chainEthereum mainnet
poolLODE / ETH on Uniswap v4
hookBurnPool (custom; v4)
round length30 blocks (~6 min)
per-swap fee5%, taken in ETH
winner share90% of the round's pot, paid in $LODE via in-pool buyback
burn share10% of the round's pot, sent to 0x…dEaD
randomnessChainlink VRF v2.5
weightingETH paid in fees, summed per wallet, per round
directionbuys and sells both pay; both buy tickets
caller bountysmall slice of the pot to whoever calls roll
mint after launchnone
upgradeableno

verifying — all of this is on chain. The hook's source is verified on etherscan; read the roll, fulfillRandomWords, and the unlockCallback directly.

LODE WORKS log · book I · field-stamped
@lode_eth verified contracts back to surface