Release Volume (token symbol VOLM) on Sepolia as a univ4_hook launch.

Token: Volume (VOLM), total supply 1,000,000,000 VOLM with 18 decimals, minted once to the deployer.

Hook: VolumeLeaderboardHook, a Uniswap v4 hook on the token's native-ETH pool that runs a weekly volume race.

Fee: 30 bps (0.3%) of every swap's ETH leg (mechanics below) into the pot of that pool's current epoch.

Epochs: epoch = (block.timestamp - DEPLOY_TIME) / 7 days, DEPLOY_TIME being block.timestamp in the constructor; a swap at exactly a boundary belongs to the new epoch.

Volume: the ETH leg is added to the identity's volume for that pool and epoch; a swap with no identity pays the fee but credits nobody.

Leaderboard: each pool and epoch keeps an on-chain top 5 (address, volume), updated in O(5) on every credited swap; an address already on it is updated in place and re-sorted, and entering or passing needs a strictly greater volume, so ties keep the earlier address ahead.

Payout: once an epoch has ended, anyone may call claim(poolKey, epoch, rank) to pay that rank's recorded address 40/25/15/10/10% of the pot for ranks 1-5, each floor-rounded and paid once. finalize(poolKey, epoch), callable once by anyone after the epoch ends, moves the shares of empty ranks (fewer than 5 credited addresses, or none) plus the rounding remainder into the pot of the epoch current at that call, so every pot is paid or carried in full.

An ended epoch's pot is frozen; claim and finalize work in either order. A recipient that rejects ETH only leaves its own share claimable.

Events: Credited, Claimed, EpochFinalized.

Views: epochNow(), epochEnd(epoch), leaderboard(poolId, epoch) with addresses, volumes, pot and claimed flags, volumeOf(poolId, epoch, user). Economics for the README: wash volume costs the 0.3% LP fee plus the 0.3% hook fee on every leg, so it pays only when the pot other traders funded exceeds that cost.

ETH-leg fee mechanics (as live launch 170's MedallionHook): a buy is zeroForOne (ETH in), a sell oneForZero (ETH out), and the swapper's specified amount is always honoured exactly.

With ETH specified (exact-in buys, exact-out sells) the fee is a positive specified BeforeSwapDelta in beforeSwap of floor(|amountSpecified| x bps / 10,000); with ETH unspecified (exact-out buys, exact-in sells) it is a positive unspecified delta in afterSwap of floor(ETH the pool moved x bps / 10,000). That fee base is the swap's ETH leg. A partial fill (price limit hit) reverts with PartialFill.

The hook settles each fee by minting itself ERC-6909 ETH claims (poolManager.mint) inside the swap, never take() or an ETH transfer in a callback, so the first buy into the ETH-less pool works; every payout burns claims and takes ETH in the hook's own unlockCallback, balance zeroed first (CEI). A fee that rounds to 0 is 0, so dust never reverts.

Invariant: the hook's ETH claims at the PoolManager equal everything it still owes.

Identity: the address abi.decode(hookData, (address)) when hookData is exactly 32 bytes and non-zero; any other swap credits nobody. Deploy shape (as live Sepolia hook launches 170, 183 and 186, constructor per the context): every rate, window and threshold is a source constant; no admin, setter, pause, upgrade or sweep.

Permissions are exactly beforeSwap, afterSwap, beforeSwapReturnDelta and afterSwapReturnDelta (address bits 0x00CC), all others false, checked by Hooks.validateHookPermissions in the constructor with a CREATE2 salt mined for those bits. The factory initializes the pool (currency0 native ETH, currency1 VOLM, fee 3000, tickSpacing 60) and seeds one-sided VOLM liquidity; the hook must revert neither, and the first buy lands in a pool with no ETH.

State is keyed by PoolId; a pool whose currency0 is not native ETH gets zero deltas and no other effect. Every callback requires msg.sender == PoolManager.

Tests (Foundry, a real v4-core PoolManager deployed in the test, hook at a mined address): a launch rehearsal that initializes at the manifest price, seeds one-sided liquidity like the factory and makes the first buy into the ETH-less pool; all four swap modes; dust; a non-ETH pool; non-PoolManager callers revert; fuzzed sizes; and the cases the build step lists (epoch boundary, ties, 0/1/5+ participants, claims plus carry equal the pot).

The independent adversarial review (read-only) attacks top-5 maintenance, the epoch boundary, pot and carry accounting, fee sign and rounding, and wash trading or hookData spoofing; its step lists each target.

Website: one static page (dist/index.html) reading the hook's views and events, with a buy/sell form that swaps through the Sepolia PoolSwapTest router named in the site step and puts the connected wallet in hookData; it shows the live top 5, pot and countdown of the current epoch, and the last 4 ended epochs with a claim button per unpaid rank and a finalize button. Volume is a Sepolia test toy: its token and any pot have no value, and nothing here promises a return.