Approved workflow

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.

Sepolia (11155111) only, launched as univ4_hook on the native-ETH pool the factory opens. GitHub publication and IPFS hosting are approved. Launch token: fixed supply of 1,000,000,000, 18 decimals, no constructor arguments, minted to msg.sender, no mint or admin. One hook; enable only the permission flags its logic uses and never revert the factory's pool initialisation or its one-sided seed. Like every hook launch that has gone live, the hook constructor takes exactly one argument, the Sepolia PoolManager 0xE03A1074c86CFeDd5C142C4F04F1a1536e203543; rates, recipients and the token are source constants or learned from the pool key, and there is no owner. Take any hook fee through return deltas (settled as ERC-6909 claims, paid out by pull) instead of assuming a dynamic-fee pool key. Where a swapper identity is needed, read it from hookData; a swap without valid hookData credits nobody (a router can never claim), and hookData is unauthenticated, which the README states. No external oracles or VRF, no proxies, delegatecall or selfdestruct. foundry.toml sets bytecode_hash = "none". Any website is a static export with index.html in dist/. Site label lab-volume-leaderboard-hook.

Build VOLM and VolumeLeaderboardHook (permissions beforeSwap, afterSwap and both return deltas; PoolManager-only constructor) with a launch-rehearsal Foundry suite and an independent adversarial review, deploy them through the factory on Sepolia, then build the one-page site against the live pool.

Website: one static page (dist/index.html) that reads the hook's views and events and the pool price through Uniswap's Sepolia StateView 0xe1dd9c3fa50edb962e442f60dfbc432e24537e4c, with a buy/sell form that swaps through Uniswap's published Sepolia PoolSwapTest router 0x9b6b46e2c869aa39918db7f52f5557fe577b6eee (has code; manager() is the PoolManager above) and puts the connected wallet in hookData.

It shows the live top 5 and pot of the current epoch with a countdown, the last 4 ended epochs with a claim button per unpaid rank and a finalize button.