Build OrderBook (src/OrderBook.sol)

An on-chain limit-order book for one ERC-20 base token against one ERC-20 quote token with price-time priority, partial fills and cancels, then independent invariant tests and a review.

Build a minimal ERC-8004-style ('Trustless Agents') registry trio in one Foundry project (Solidity 0.8.26, OpenZeppelin ERC721), with independent tests and a review.

Release Oddsmaker (ERC-20 symbol ODMK) on Sepolia as an evm_project: the fixed-supply launch token plus one application contract. Token: Oddsmaker (ODMK), total supply 1,000,000,000 ODMK with 18 decimals, minted once to the deployer. Application contract: ParimutuelMarket. Currency: ODMK is the app's working currency. ParimutuelMarket takes the ODMK address as its only constructor argument (constructorArgs ["$token"]), stores it immutable, exposes it as token(), and holds no ODMK at deploy; bettors get ODMK by swapping Sepolia ETH in the launch pool the factory seeds. Every payment in is approve + SafeERC20.safeTransferFrom (permit not required). ParimutuelMarket has no payable function and no receive/fallback, so it never holds ETH. Payouts are pull-based (the recipient calls to collect; nothing is pushed to third parties), follow checks-effects-interactions and are nonReentrant. No owner, admin, pause or upgrade path. Yes/no parimutuel markets in ODMK with a named human resolver (no oracle). createMarket(question bytes32, closeTime, resolver): closeTime between block.timestamp + 1 hour and + 90 days, resolver != address(0). bet(id, yes, amount): amount > 0, only while block.timestamp < closeTime, and not from the resolver. resolve(id, outcome): resolver only, once, in [closeTime, closeTime + 7 days), outcome YES, NO or INVALID. If the winning side has no stake, the market is treated as INVALID. claim(id): after YES/NO, each winner receives floor(stake * totalPool / winningPool) once; after INVALID, or if nobody resolved by closeTime + 7 days (anyone may then call voidMarket(id)), every bettor gets their stakes back once. Rounding leaves at most 1 base unit per winner in the contract (README says so). No fee. The resolver is trusted: the README and site state that the resolver decides the outcome and could bet through another address. Views: market(id), marketCount(), stakeOf(id, account, yes), impliedOdds(id), token(). Events: Created, Bet(id, bettor, yes, amount), Resolved(id, outcome), Voided, Claimed. The site calls markets Sepolia test markets with no real value. Tests (Foundry) must cover: bets at the close boundary, resolve before close and after the 7-day window refused, a one-sided market, INVALID and void refunds, double claim, claims from a losing bettor, and the invariant that sum of payouts never exceeds the pool and ODMK held >= unclaimed entitlements. The independent adversarial review must attack: payout rounding exceeding the pool, a resolver resolving twice or late, void racing resolve at the 7-day boundary, cross-market accounting, and reentrancy on claim. Deploy through the project factory, then publish a one-page website to list markets with implied odds and status, create one, bet yes or no, resolve (resolver only) and claim. The page reads the ODMK address from ParimutuelMarket.token(), shows the connected wallet's ODMK balance and allowance, has an Approve step before every paying action, and says that ODMK comes from swapping Sepolia ETH in the launch pool (no in-page swap). Lists come from contract views and events only (no backend, no indexer). Keep it to one small page; the static export has index.html in dist/.

Release Farm (token symbol FARMX) on Sepolia as a univ4_hook launch. Token: Farm (FARMX), total supply 1,000,000,000 FARMX with 18 decimals, minted once to the deployer (a separate zero-argument ERC-20, no mint, owner or admin). Hook: LiquidityMiningHook, a Uniswap v4 hook on the token's native-ETH pool that streams a reward pool of the pool's currency1 (the launch token, for the launch pool) to staked liquidity pro rata to liquidity-seconds, Synthetix-style per pool: rewardPerLiquidity (scaled by 1e18) is updated before every stake change and claim. Staking: a position (the PoolManager's key: sender, tickLower, tickUpper, salt) is staked only when liquidity is added with a beneficiary in hookData (exactly 32 bytes, non-zero address). The first such add fixes the beneficiary for that key; later adds to the key count toward it with or without hookData; liquidity added before any beneficiary, including the factory's seed position, is never staked and never dilutes rewards. afterAddLiquidity (liquidityDelta > 0) adds liquidityDelta to staked[key] and totalStaked; afterRemoveLiquidity sets staked[key] = min(staked[key], the position's liquidity after the removal, read with StateLibrary), so fee collection (delta 0) changes nothing. Out-of-range liquidity earns like in-range liquidity: a disclosed simplification. Funding: anyone calls fund(poolKey, amount), which pulls currency1 with transferFrom (counting the balance change) and sets rate = (amount + unstreamed remainder + idle) / 30 days and periodEnd = now + 30 days. Stream time that passes while totalStaked is 0 accrues to idle, which the next fund() re-streams, so no tokens are stranded. claim(poolKey, positionKey), callable only by that key's beneficiary, pays its accrued tokens (CEI). The beneficiary never changes, even if a PositionManager NFT is transferred. ETH is never accepted. Events: Staked, Unstaked, Funded, Claimed. Views: earned(poolId, positionKey), rewardRate, periodEnd, staked, totalStaked, positionsOf(beneficiary). The symbol is FARMX, not FARM, which is an existing token's ticker. Deploy shape, matching the live Sepolia hook launches 170 and 186 (168 passed the mainnet PoolManager and is not a model): LiquidityMiningHook's only constructor argument is the Sepolia PoolManager 0xE03A1074c86CFeDd5C142C4F04F1a1536e203543; every rate, window and threshold here is a source constant; there is no owner, admin, setter, pause, upgrade or sweep, and no $owner or $token argument. Permissions are exactly afterAddLiquidity, afterRemoveLiquidity (low address bits 0x0500), all others false; the constructor calls Hooks.validateHookPermissions and the CREATE2 salt is mined for those bits. The factory initializes the pool (currency0 native ETH, currency1 FARMX, fee 3000, tickSpacing 60) and seeds one-sided FARMX liquidity, so nothing in the hook may revert that initialize or that liquidity add (launch 138 was parked when a beforeInitialize gate reverted the factory), and the first buy lands in a pool that holds no ETH. All state is keyed by PoolId; a pool on this hook 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 FARMX liquidity like the factory and makes the first buy into the ETH-less pool; exact-in and exact-out in both directions; dust amounts; a pool whose currency0 is not ETH; direct callback calls from a non-PoolManager address revert; fuzzed sizes; and specifically: two stakers entering at different times split rewards by liquidity-seconds; a fund while nothing is staked is fully re-streamed by the next fund; the factory-style seed position earns nothing; fee collection does not unstake; partial removal reduces the stake; claims sum to at most funded tokens and the hook's token balance always covers earned plus unstreamed plus idle. An independent adversarial review (read-only) must attack: accumulator ordering (update before every stake change), removal paths through PositionManager (decrease, burn, delta 0), idle and rounding leakage, beneficiary hijack on shared keys, fee-on-transfer funding, and precision or overflow in rewardPerLiquidity. It reports each finding with the exact call sequence that triggers it. Website: one static page (dist/index.html) that reads the hook's views and events and pool and position state through Uniswap's Sepolia StateView, and sends every liquidity action through Uniswap's published Sepolia PositionManager (check it has code; never the unguarded PoolModifyLiquidityTest, whose positions anyone can remove). It shows the stream (rate, period end, total staked), a fund form (approve plus fund), the connected wallet's positions with earned rewards and claim buttons, and a PositionManager mint form for full-range positions only (ticks -887220 to 887220; token approval through Permit2, as the v4 SDK does) that puts the wallet in hookData; nothing else. Farm is a Sepolia test toy: its token and any pot have no value, and nothing here promises a return.

X402Settler

A contract that settles x402-style 'exact' payments in any standard ERC-20 through a Permit2 witness transfer, with Foundry tests, an independent review and a fix pass.

Release Tiers (token symbol TIER) on Sepolia as a univ4_hook launch. Token: Tiers (TIER), total supply 1,000,000,000 TIER with 18 decimals, minted once to the deployer. Hook: LoyaltyTierHook, a Uniswap v4 hook on the token's native-ETH pool that discounts its fee by lifetime volume. Volume: lifetime ETH leg per pool and identity (rule below), uint128, added after the swap's fee is priced. Every swap in both directions pays, priced from the volume before this swap: 100 bps below 0.01 ETH, 75 bps from 0.01 ETH, 50 bps from 0.1 ETH, 25 bps from 1 ETH (thresholds inclusive), charged with the ETH-leg mechanics below. Fees accrue as ETH claims whose only destination is permissionless burnFees(), which takes them all to 0x000000000000000000000000000000000000dEaD. Events: VolumeAdded(poolId, user, ethLeg, total, tier). Views: volumeOf, tierOf, feeBpsOf, nextTierAt(poolId, user). Economics for the README: reaching a tier costs the fees paid on the way, so tiers cannot be farmed for free, and volume in one pool never discounts another. 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: abi.decode(hookData, (address)) only when hookData is exactly 32 bytes, non-zero and equal to tx.origin, so nobody can borrow another address's standing to lower a fee; any other swap has no identity, pays the full 1% and adds no volume. tx.origin only confirms that claim for pricing and never authorises moving funds; the README says smart-contract wallets (signed by a bundler or relayer) never earn a discount. 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 TIER, fee 3000, tickSpacing 60) and seeds one-sided TIER 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 (each threshold at and 1 wei below, a threshold-crossing swap paying the old rate, pool isolation, mismatched or missing hookData, burnFees). The independent adversarial review (read-only) attacks the hookData == tx.origin check, threshold arithmetic, volume overflow, farming tiers through a private pool, fee sign and rounding on all four swap modes, and burnFees accounting; 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 connected wallet's tier, volume to the next tier, the tier table and the fee its next swap would pay. Tiers is a Sepolia test toy: its token and any pot have no value, and nothing here promises a return.

Release Match (ERC-20 symbol MTCH) on Sepolia as an evm_project: the fixed-supply launch token plus one application contract. Token: Match (MTCH), total supply 1,000,000,000 MTCH with 18 decimals, minted once to the deployer. Application contract: QuadraticFunding. Currency: MTCH is the app's working currency. QuadraticFunding takes the MTCH address as its only constructor argument (constructorArgs ["$token"]), stores it immutable, exposes it as token(), and holds no MTCH at deploy; contributors get MTCH by swapping Sepolia ETH in the launch pool the factory seeds. Every payment in is approve + SafeERC20.safeTransferFrom (permit not required). QuadraticFunding has no payable function and no receive/fallback, so it never holds ETH. Payouts are pull-based (the recipient calls to collect; nothing is pushed to third parties), follow checks-effects-interactions and are nonReentrant. No owner, admin, pause or upgrade path. Quadratic funding rounds in MTCH. createRound(start, end): anyone; start >= block.timestamp, end - start between 1 day and 30 days. fund(roundId, amount): anyone adds to the matching pool until end; funders are recorded. register(roundId, payout): the round's creator only (rounds are curated, so strangers cannot fill the cap), before end, at most 50 projects per round, payout != address(0). contribute(roundId, projectId, amount): only in [start, end), amount >= 1 MTCH; each contributor's total per project accumulates, and the contract keeps sumSqrt[p] = sum over contributors of sqrt(total), updated incrementally (sumSqrt += sqrt(new) - sqrt(old)) with OpenZeppelin Math.sqrt (floor) on base units. After end, finalize(roundId) (anyone, once) computes q_p = sumSqrt[p]^2 and Q = sum q_p over the round's projects; match_p = Math.mulDiv(pool, q_p, Q) (floor); the rounding remainder goes to the project with the largest q_p (lowest id on ties), so the whole pool is always distributed. If Q == 0 (no contributions), each funder can reclaim their own funding. claim(roundId, projectId): only the project's payout address, once, after finalize; transfers contributions + match to it. The README says the round creator curates the project list and that QF is sybil-able (splitting contributions across addresses raises the match) and that no identity check exists on Sepolia. Views: round(id), project(roundId, pid), contributionOf(roundId, pid, account), estimateMatch(roundId, pid) (live estimate), token(). Events: RoundCreated, Funded, Registered, Contributed, Finalized, Claimed, Reclaimed. Tests (Foundry) must cover: integer square root edge cases, incremental sumSqrt matching a from-scratch recomputation, the whole pool distributed exactly (sum of matches == pool) under fuzzed contributions, Q == 0 reclaims, the 50-project cap, register by a non-creator reverting, double claim, and time-window boundaries. The independent adversarial review must attack: match arithmetic overflow (sumSqrt^2 times pool), registration by anyone but the round creator, rounding that leaves or over-spends pool dust, claiming before finalize or twice, contributions outside the window, and the sybil and creator-curation trade-offs being stated. Deploy through the project factory, then publish a one-page website to create a round, register a project (round creator), contribute, fund the pool, finalize, claim and reclaim, and show each project's contributions and live match estimate. The page reads the MTCH address from QuadraticFunding.token(), shows the connected wallet's MTCH balance and allowance, has an Approve step before every paying action, and says that MTCH comes from swapping Sepolia ETH in the launch pool (no in-page swap). Lists come from contract views and events only (no backend, no indexer). Keep it to one small page; the static export has index.html in dist/.

Release Threeway (token symbol THRW) on Sepolia as a univ4_hook launch. Token: Threeway (THRW), total supply 1,000,000,000 THRW with 18 decimals, minted once to the deployer. Hook: FeeSplitHook, a Uniswap v4 hook on the token's native-ETH pool that splits one fee three ways. Every swap pays 100 bps (1%) of its ETH leg with the ETH-leg mechanics below, split by source constants: interfaceShare = floor(fee x 2,000 / 10,000) to an interface address named in hookData (identity rule below; without one this share goes to the burn), lpShare = floor(fee x 3,000 / 10,000) to in-range LPs, and burnShare = fee - interfaceShare - lpShare, so every fee closes exactly. Buckets are ETH claims tracked per pool: interface balances are claimable by their owner with claim() (pull, zeroed first); the LP bucket is paid by permissionless donateAccrued(poolKey), which in the hook's unlockCallback burns those claims and calls PoolManager.donate(key, amount, 0), and reverts leaving the bucket intact when the pool has no in-range liquidity; the burn bucket goes to 0x000000000000000000000000000000000000dEaD through permissionless burnAccrued(). Nothing is donated inside a swap. Events: FeeSplit(poolId, interface, fee, interfaceShare, lpShare, burnShare), Donated, Burned, Claimed. Views: the split constants, lifetime totals per bucket per pool, pending buckets. 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 THRW, fee 3000, tickSpacing 60) and seeds one-sided THRW 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 write-foundry-tests step lists (shares sum to the fee, a missing interface, donateAccrued with and without in-range liquidity, burn and claim emptying their buckets, the claims invariant across pools). The independent adversarial review (read-only) attacks rounding and closure of the split, JIT liquidity capturing the LP bucket (document it), the unlock/donate settlement order, claim reentrancy and buckets leaking between pools; 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 optional interface address in hookData; it shows the split, lifetime totals per bucket, the last 20 swaps from FeeSplit events, donateAccrued and burnAccrued buttons, an interface claim button and an optional interface-address field. Threeway is a Sepolia test toy: its token and any pot have no value, and nothing here promises a return.

Release Taskboard (ERC-20 symbol TASK) on Sepolia as an evm_project: the fixed-supply launch token plus one application contract. Token: Taskboard (TASK), total supply 1,000,000,000 TASK with 18 decimals, minted once to the deployer. Application contract: SwarmJobBoard. Currency: rewards are Sepolia test ETH; TASK is only the launch token. A Sepolia test toy: it is not a hiring or payment service, a reward carries no off-chain obligation, and the README and the page say so. SwarmJobBoard has no constructor arguments (constructorArgs []) and no owner, admin, fee or upgrade path; plain ETH sent to it reverts. Payouts are credited and paid by withdraw() (pull, checks-effects-interactions, nonReentrant). post(specHash, deadline) payable: reward = msg.value >= 0.0001 ETH, deadline between block.timestamp + 1 hour and + 30 days. Phases: commit while block.timestamp < deadline; reveal in [deadline, deadline + 1 day); poster decision in [deadline + 1 day, deadline + 7 days), after every reveal is in. commit(taskId, c): one per address, not the poster, no cap on submissions (nothing ever loops over them, so spam cannot lock workers out), with c = keccak256(abi.encode(resultHash, salt, msg.sender, taskId)), so copying another worker's commitment is useless. resultHash is the hash of work the worker shares off-chain; the contract never sees the work itself. reveal(taskId, resultHash, salt) checks it and increments the task's revealedCount. The poster settles the task once, inside the decision window: accept(taskId, worker) for a worker who revealed credits the whole reward to that worker, or rejectAll(taskId) refunds the reward to the poster (work is judged off-chain, so junk submissions never force a payout). cancel(taskId): poster only, before any commit; refunds the reward. finalize(taskId): anyone, at or after deadline + 7 days if the poster did neither: with revealedCount > 0 it fixes share = reward / revealedCount and credits the remainder wei to the poster, and each revealed worker then calls claimSplit(taskId) once to credit its share; with no revealed workers the reward is refunded to the poster. Every task therefore ends in exactly one of accepted, rejected, cancelled or finalized, and finalize is always reachable. The README says the poster is trusted to judge fairly (rejectAll is always open to them), and that the split only applies when the poster does not decide and can be diluted by sybil submitters. Views: task(id), taskCount(), submission(taskId, worker), revealedCount(taskId), withdrawable(address). Events: Posted, Committed, Revealed(taskId, worker, resultHash), Accepted, Rejected, Cancelled, Finalized(taskId, share, revealedCount), SplitClaimed, Withdrawn. Tests (Foundry) must cover: each phase boundary (commit at the deadline reverts, reveal at deadline + 1 day reverts, accept before deadline + 1 day reverts), a wrong salt or copied commitment failing to reveal, accept, rejectAll and finalize excluding each other, accept or rejectAll after the decision window refused, claimSplit twice or by a non-revealer refused, remainder wei, cancel after a commit refused, and, fuzzing with warped time, the invariant that the contract's ETH >= open rewards + unclaimed split shares + withdrawable balances. The independent adversarial review must attack: paying a reward twice (accept, rejectAll and finalize in any order, or claimSplit replay), stealing a result by copying a commitment, a poster accepting an unrevealed worker, split rounding, and reentrancy on withdraw. Deploy through the project factory, then publish a one-page website to post a task, commit and reveal a result hash, accept or reject all, finalize, claim a split share and withdraw; revealed workers are listed from Revealed events. The page generates the salt with crypto.getRandomValues, keeps it in localStorage and shows it for backup. Lists come from contract views and events only (no backend, no indexer). Keep it to one small page; the static export has index.html in dist/.

Implement SignatureTransfer in src/SignatureTransfer.sol

A self-contained re-implementation of the signature-transfer half of Uniswap Permit2, with tests and an independent review.

Release Kudos (ERC-20 symbol KUDO) on Sepolia as an evm_project: the fixed-supply launch token plus one application contract. Token: Kudos (KUDO), total supply 1,000,000,000 KUDO with 18 decimals, minted once to the deployer. Application contract: KudosEpochs. Currency: KUDO is the app's working currency. KudosEpochs takes the KUDO address as its only constructor argument (constructorArgs ["$token"]), stores it immutable, exposes it as token(), and holds no KUDO at deploy; users get KUDO by swapping Sepolia ETH in the launch pool the factory seeds. Every payment in is approve + SafeERC20.safeTransferFrom (permit not required). KudosEpochs has no payable function and no receive/fallback, so it never holds ETH. Payouts are pull-based (the recipient calls to collect; nothing is pushed to third parties), follow checks-effects-interactions and are nonReentrant. No owner, admin, pause or upgrade path. Weekly kudos with optional KUDO tips. Epoch = (block.timestamp - deployTimestamp) / 7 days. Every address may give 5 kudos per epoch. give(to, count, tipPerKudo): to != caller and != address(0), 1 <= count <= the caller's remaining kudos this epoch; if tipPerKudo > 0 the contract pulls count * tipPerKudo KUDO from the giver and credits it to the recipient's withdrawable balance. Kudos received are counted per epoch and lifetime; they are counters, not tokens, and cannot be transferred. Unused kudos do not roll over. withdraw() pays credited KUDO. Kudos counts are free and therefore sybil-able; tips only ever move the giver's own KUDO, so sybils cannot extract value (the README says so). Views: currentEpoch(), remaining(account), receivedIn(epoch, account), lifetimeReceived(account), tipsReceived(account), withdrawable(account), token(). Events: Kudos(epoch, from, to, count, tip), Withdrawn. Tests (Foundry) must cover: the 5-per-epoch limit across several gives, the epoch rollover at the exact boundary, self-kudos and zero address refused, tips with count > 1, withdraw twice, and the invariant that KUDO held equals the sum of withdrawable balances. The independent adversarial review must attack: giving more than 5 kudos in an epoch (including in the rollover block), tip arithmetic overflow or mis-crediting, and reentrancy on withdraw. Deploy through the project factory, then publish a one-page website to give kudos with an optional tip, show your remaining kudos and this epoch's leaderboard (built from Kudos events), and withdraw tips. The page reads the KUDO address from KudosEpochs.token(), shows the connected wallet's KUDO balance, allowance and withdrawable balance, has an Approve step before every paying action and a Withdraw button, and says that KUDO comes from swapping Sepolia ETH in the launch pool (no in-page swap). Lists come from contract views and events only (no backend, no indexer). Keep it to one small page; the static export has index.html in dist/.

BatchNFT

A gas-optimised ERC-721 with ERC721A-style batch minting, and compare it with an OpenZeppelin ERC721 baseline.

Release Oneway Launch (token symbol OWLN) on Sepolia as a univ4_hook launch. Token: Oneway Launch (OWLN), total supply 1,000,000,000 OWLN with 18 decimals, minted once to the deployer (a separate zero-argument ERC-20, no mint, owner or admin). Hook: BuyOnlyWindowHook, a Uniswap v4 hook on the token's native-ETH pool that allows only buys for the first 300 blocks. afterInitialize records opensAt[poolId] = block.number + 300 for pools whose currency0 is native ETH and never reverts. beforeSwap reverts with SellsLocked(opensAt) for every sell (oneForZero, token to ETH; exact-in and exact-out alike) while block.number < opensAt, and otherwise returns a zero delta; buys are always allowed and nothing is ever charged in either direction. No liquidity or donate callbacks, so LPs can add and remove at any time. The window cannot be extended, shortened or re-armed: there is no admin and a pool initializes once. Event: WindowSet(poolId, opensAt). Views: opensAt(poolId), sellsOpen(poolId). Public-safety note for the README and site: blocking sells is the mechanism honeypots use; here it is a disclosed, fixed 300-block (about an hour on Sepolia) test of launch-time gating, visible on-chain before anyone buys. Deploy shape, matching the live Sepolia hook launches 170, 183 and 186 (launch 168 passed the mainnet PoolManager and is not a model): BuyOnlyWindowHook's only constructor argument is the Sepolia PoolManager 0xE03A1074c86CFeDd5C142C4F04F1a1536e203543; every rate, window and threshold here is a source constant; there is no owner, admin, setter, pause, upgrade or sweep, and no $owner or $token argument. Permissions are exactly afterInitialize, beforeSwap (low address bits 0x1080), all others false; the constructor calls Hooks.validateHookPermissions and the CREATE2 salt is mined for those bits. The factory initializes the pool (currency0 native ETH, currency1 OWLN, fee 3000, tickSpacing 60) and seeds one-sided OWLN liquidity, so nothing in the hook may revert that initialize or that liquidity add (launch 138 was parked when a beforeInitialize gate reverted the factory), and the first buy lands in a pool that holds no ETH. All state is keyed by PoolId; a pool on this hook 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 OWLN liquidity like the factory and makes the first buy into the ETH-less pool; exact-in and exact-out in both directions; dust amounts; a pool whose currency0 is not ETH; direct callback calls from a non-PoolManager address revert; fuzzed sizes; and specifically: buys and reverted sells (exact-in and exact-out) in block opensAt - 1; sells succeed at exactly opensAt; liquidity removal works during the window; a non-ETH pool is never gated; the hook holds no funds. An independent adversarial review (read-only) must attack: every way to sell during the window (exact-output swaps that buy ETH, other routers, a second ETH pool on the same hook, which has its own window), whether afterInitialize can revert the factory, the off-by-one at opensAt, and whether anything can make the lock permanent. It reports each finding with the exact call sequence that triggers it. 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). It shows the countdown in blocks and minutes to opensAt, whether sells are open, and a sell button disabled until then.

Release Pyre (ERC-20 symbol PYRE) on Sepolia as an evm_project: the fixed-supply launch token plus one application contract. Token: Pyre (PYRE), total supply 1,000,000,000 PYRE with 18 decimals, minted once to the deployer. Application contract: BurnLeaderboard. Currency: PYRE is the app's working currency. BurnLeaderboard takes the PYRE address as its only constructor argument (constructorArgs ["$token"]), stores it immutable, exposes it as token(), and holds no PYRE at deploy; players get PYRE by swapping Sepolia ETH in the launch pool the factory seeds. Every payment in is approve + SafeERC20.safeTransferFrom (permit not required). BurnLeaderboard has no payable function and no receive/fallback, so it never holds ETH. Payouts are pull-based (the recipient calls to collect; nothing is pushed to third parties), follow checks-effects-interactions and are nonReentrant. Burns are transfers to 0x000000000000000000000000000000000000dEaD. No owner, admin, pause or upgrade path. A burn leaderboard for PYRE with an all-time board and 7-day seasons. burn(amount): amount > 0; the contract moves PYRE straight from the caller to 0x000000000000000000000000000000000000dEaD with safeTransferFrom (it never holds PYRE), adds amount to the caller's lifetime total and current-season total, and updates two sorted top-10 lists (all-time and current season) in place: an address already listed moves up without duplicating, a new total must strictly exceed the 10th entry to enter, and on equal totals the address that reached it first ranks higher. Season = (block.timestamp - deployTimestamp) / 7 days; season boards are kept per season and never change after the season ends. sweep(): anyone may forward any PYRE that was sent to the contract directly to the dead address (credited to nobody), so nothing is stranded. Views: lifetimeOf(account), seasonTotalOf(season, account), topAllTime() and topSeason(season) returning (address, total)[10], currentSeason(), totalBurned(), token(). Events: Burned(account, amount, season, lifetimeTotal), Swept(amount). This redoes the earlier parked burn tracker (launch 122 stranded its supply): here the app needs no PYRE at deploy. Tests (Foundry) must cover: insertion and re-ordering in both top-10 lists, ties, an 11th address that does not exceed the 10th, a season rollover at the exact 7-day boundary, sweep, zero-amount burns, and the invariants that the contract's PYRE balance is 0 after every burn and that totalBurned equals the sum of lifetime totals. The independent adversarial review must attack: top-10 corruption (duplicates, wrong order, lost entries) under fuzzed burn sequences, gas growth of the sorted insert, season boundary off-by-one, and burns credited to the wrong address. Deploy through the project factory, then publish a one-page website to show the all-time and current-season top 10, your totals and rank (computed in the page from Burned events), and a burn form. The page reads the PYRE address from BurnLeaderboard.token(), shows the connected wallet's PYRE balance and allowance, has an Approve step before every paying action, and says that PYRE comes from swapping Sepolia ETH in the launch pool (no in-page swap). Lists come from contract views and events only (no backend, no indexer). Keep it to one small page; the static export has index.html in dist/.

Implement MultiToken6909 in src/MultiToken6909.sol

An ERC-6909 multi-token with the EIP's exact interface and events: balanceOf(owner, id), allowance(owner, spender, id), isOperator(owner, spender), transfer, transferFrom, approve, setOperator, and supportsInterface for 0x0f632fb3 and ERC-165.

Release Ticket (token symbol TIKT) on Sepolia as a univ4_hook launch. Token: Ticket (TIKT), total supply 1,000,000,000 TIKT with 18 decimals, minted once to the deployer. Hook: SwapLotteryHook, a Uniswap v4 hook on the token's native-ETH pool that runs an hourly swap lottery. Rounds: per pool, round = block.timestamp / 3,600 (UTC hours). Pot: 50 bps (0.5%) of every swap's ETH leg, charged with the ETH-leg mechanics below, goes to the current round's pot. Tickets: each swap whose ETH leg is at least 0.001 ETH pushes one ticket for its identity (rule below) onto the current round's list; swaps without one pay the fee but get no ticket. A swap after round r ends always lands in a later round, so a closed round never gains tickets. Draw: after round r ends, anyone calls seal(poolKey, r), which records targetBlock = block.number + 1 once. Then, while targetBlock < block.number <= targetBlock + 256, anyone calls draw(poolKey, r): winner = tickets[uint256(keccak256(abi.encode(blockhash(targetBlock), poolId, r))) % ticketCount], credited the whole pot as a claimable balance. If the round has no tickets, or draw is first called after targetBlock + 256, the pot rolls into the round current at that call. Each round draws or rolls exactly once. claim() pays msg.sender its winnings, zeroed first, through the hook's unlockCallback. Randomness: a future blockhash can be biased by the Sepolia proposer withholding a block; that is acceptable only because pots are test-toy sized, and the README says so. No VRF, oracle or keeper. Events: Ticket(poolId, round, holder, index), Sealed, Drawn(poolId, round, winner, pot), RolledOver, Claimed. Views: pot, ticketCount, ticketsOf(poolId, round, user), roundState. 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 TIKT, fee 3000, tickSpacing 60) and seeds one-sided TIKT 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 write-foundry-tests step lists (the ticket threshold, seal timing, the targetBlock + 1 / + 256 / + 257 window, empty rounds, double seal or draw, pots == claims). The independent adversarial review (read-only) attacks blockhash-window off-by-ones, timing games around seal, ticket index bias, round-boundary assignment, rollover double counting, claim reentrancy and ticket-array gas in swaps; 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 current hour's pot and ticket count, the connected wallet's tickets, a countdown, seal and draw buttons when due, past winners from Drawn events and a claim button. Ticket is a Sepolia test toy: its token and any pot have no value, and nothing here promises a return.

Release Doomsday (ERC-20 symbol DOOM) on Sepolia as an evm_project: the fixed-supply launch token plus one application contract. Token: Doomsday (DOOM), total supply 1,000,000,000 DOOM with 18 decimals, minted once to the deployer. Application contract: DoomsdayClock. Currency: DOOM is the app's working currency. DoomsdayClock takes the DOOM address as its only constructor argument (constructorArgs ["$token"]), stores it immutable, exposes it as token(), and holds no DOOM at deploy; players get DOOM by swapping Sepolia ETH in the launch pool the factory seeds. Every payment in is approve + SafeERC20.safeTransferFrom (permit not required). DoomsdayClock has no payable function and no receive/fallback, so it never holds ETH. Payouts are pull-based (the recipient calls to collect; nothing is pushed to third parties), follow checks-effects-interactions and are nonReentrant. No owner, admin, pause or upgrade path. A last-buyer timer game in DOOM, played in rounds. A round opens with its first key purchase, which sets end = block.timestamp + 1 hour. buyKeys(n, maxCost): 1 <= n <= 100; if the current round has ended, the call first settles it and the purchase opens the next round. Key k of a round (k from 0) costs price_k base units, where price_0 = 10^18 (1 DOOM) and price_k = ceil(price_(k-1) * 1001 / 1000); the total must be <= maxCost (slippage guard). Each key adds 30 seconds: end = min(end + 30 * n, block.timestamp + 24 hours). The buyer becomes lastBuyer and their key count grows. The pot is all DOOM paid for keys plus the carry from the previous round. When block.timestamp >= end, anyone may call settle() (or the next buyKeys does it): 50% of the pot (rounded down) is credited to lastBuyer; each key holder may later claimShare(round) for floor(pot * 30% / totalKeys) per key; the rest (20% plus all rounding dust) becomes the next round's carry. The last buyer also earns the per-key share for their keys. A round with no keys never starts. withdraw() pays credited DOOM. Views: round(), end(), pot(), carry(), priceOfNext(n), keysOf(round, account), lastBuyer(), withdrawable(address), token(). Events: KeysBought(round, buyer, n, cost, end), Settled(round, lastBuyer, prize, perKey, carry), ShareClaimed, Withdrawn. The README and site call it a Sepolia test game with no real value, and say that the last buyer can be decided by transaction ordering and block timestamps (block stuffing near the end is a known strategy). Tests (Foundry) must cover: the price sequence and ceil rounding, the 100-key and 24-hour caps, maxCost reverting, buy after end settling first, settle twice, claimShare twice, a round where one address holds every key, and the invariant that DOOM held == current pot + carry + unclaimed shares + withdrawable balances. The independent adversarial review must attack: share rounding letting claims exceed 30% of the pot, the 24-hour cap arithmetic, buying in the same block as the end, carry accounting across rounds, and reentrancy on claim or withdraw. Deploy through the project factory, then publish a one-page website to show a big countdown, the pot, the last buyer, the next key price, buy keys with a max cost, and claim shares from past rounds. The page reads the DOOM address from DoomsdayClock.token(), shows the connected wallet's DOOM balance, allowance and withdrawable balance, has an Approve step before every paying action and a Withdraw button, and says that DOOM comes from swapping Sepolia ETH in the launch pool (no in-page swap). Lists come from contract views and events only (no backend, no indexer). Keep it to one small page; the static export has index.html in dist/.

Implement src/CloneFactory.sol containing the Counter implementation and CloneFactory.

Release Referral (token symbol REFR) on Sepolia as a univ4_hook launch. Token: Referral (REFR), total supply 1,000,000,000 REFR with 18 decimals, minted once to the deployer (a separate zero-argument ERC-20, no mint, owner or admin). Hook: ReferralHook, a Uniswap v4 hook on the token's native-ETH pool that pays referrers. Referrer: abi.decode(hookData, (address)) when hookData is exactly 32 bytes; it counts only if it is non-zero, not tx.origin (self-referral pays nothing), not the hook and not the PoolManager. A swap with a valid referrer pays 20 bps (0.2%) of its ETH leg with the ETH-leg mechanics below, credited to that referrer's claimable ETH balance; a swap without one pays no hook fee at all. There is no protocol cut and no owner (the earlier 0.1% to $owner is dropped: no live hook launch has taken $owner). claim() pays msg.sender its whole balance, zeroed first, through the hook's unlockCallback. Events: Referred(referrer, poolId, ethLeg, reward), Claimed(referrer, amount). Views: balanceOf(referrer), referredVolume(referrer), referralCount(referrer). Limits for the README: the self-referral check is tx.origin, so a second wallet defeats it, and the 0.2% then just returns to the swapper's own second wallet (no gain, no loss); hookData is unauthenticated, which only lets a swapper choose whom it pays. ETH-leg fee mechanics (the pattern live launch 170's MedallionHook uses): a buy is zeroForOne (ETH in), a sell is oneForZero (ETH out), and the swapper's specified amount is always honoured exactly. When ETH is the specified currency (exact-in buys, exact-out sells) the fee is taken in beforeSwap as a positive specified BeforeSwapDelta of floor(|amountSpecified| x bps / 10,000); when ETH is the unspecified currency (exact-out buys, exact-in sells) it is taken in afterSwap as a positive unspecified delta of floor(ETH the pool moved x bps / 10,000). A partial fill (price limit hit) reverts with PartialFill. The hook settles each fee by minting itself ERC-6909 claims on ETH (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 later burns claims and takes ETH inside the hook's own unlockCallback, with the balance zeroed before the take (CEI). A fee that rounds to 0 is 0: dust swaps never revert. Wherever this request says ETH leg, it means that fee base. Invariant: the hook's ETH claim balance at the PoolManager equals the sum of everything it still owes. Deploy shape, matching the live Sepolia hook launches 170, 183 and 186 (launch 168 passed the mainnet PoolManager and is not a model): ReferralHook's only constructor argument is the Sepolia PoolManager 0xE03A1074c86CFeDd5C142C4F04F1a1536e203543; every rate, window and threshold here is a source constant; there is no owner, admin, setter, pause, upgrade or sweep, and no $owner or $token argument. Permissions are exactly beforeSwap, afterSwap, beforeSwapReturnDelta, afterSwapReturnDelta (low address bits 0x00CC), all others false; the constructor calls Hooks.validateHookPermissions and the CREATE2 salt is mined for those bits. The factory initializes the pool (currency0 native ETH, currency1 REFR, fee 3000, tickSpacing 60) and seeds one-sided REFR liquidity, so nothing in the hook may revert that initialize or that liquidity add (launch 138 was parked when a beforeInitialize gate reverted the factory), and the first buy lands in a pool that holds no ETH. All state is keyed by PoolId; a pool on this hook 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 REFR liquidity like the factory and makes the first buy into the ETH-less pool; exact-in and exact-out in both directions; dust amounts; a pool whose currency0 is not ETH; direct callback calls from a non-PoolManager address revert; fuzzed sizes; and specifically: a 0.2% reward on all four swap modes; self, zero, hook and PoolManager referrers pay nothing; claim pays exactly once and a second claim pays zero; a referrer contract that rejects ETH blocks only its own claim; the sum of balances equals the hook's ETH claims under fuzzing. An independent adversarial review (read-only) must attack: the referrer validity checks, fee sign and rounding, claim CEI and reentrancy through a receiving contract, and any path where the hook's ETH claims fall below the sum of balances. It reports each finding with the exact call sequence that triggers it. 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). It shows a make-a-link box (?ref=address), a swap form that puts the ref from the URL in hookData, and the connected wallet's earnings, referral count and claim button.

Release Streak (token symbol STREAK) on Sepolia as a univ4_hook launch. Token: Streak (STREAK), total supply 1,000,000,000 STREAK with 18 decimals, minted once to the deployer. Hook: BuyStreakHook, a Uniswap v4 hook on the token's native-ETH pool that rewards daily buyers with a lower fee. Days: day = block.timestamp / 86,400 (UTC). Streaks are per pool and per identity (rule below). A qualifying buy is zeroForOne with an ETH leg of at least 0.0005 ETH; on one, if lastDay == today nothing changes, if lastDay == today - 1 then streak += 1, otherwise streak = 1; then lastDay = today and StreakUpdated(poolId, user, day, streak) is emitted. Effective streak = streak when lastDay >= today - 1, else 0 (a missed day resets). Every swap in both directions pays max(100 - 10 x effective streak, 30) bps of its ETH leg, priced from the streak before this swap updates it (1% at 0, 0.9% at 1, down to 0.3% from day 7), charged with the ETH-leg mechanics below. Sells never extend a streak. Fees accrue as ETH claims whose only destination is permissionless burnFees(), which takes them all to 0x000000000000000000000000000000000000dEaD. Views: streakOf(poolId, user) returning streak, lastDay, effective streak and fee bps now; feeFor(poolId, user). 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: abi.decode(hookData, (address)) only when hookData is exactly 32 bytes, non-zero and equal to tx.origin, so nobody can borrow another address's standing to lower a fee; any other swap has no identity, pays the full 1% and updates no streak. tx.origin only confirms that claim for pricing and never authorises moving funds; the README says smart-contract wallets (signed by a bundler or relayer) never earn a discount. 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 STREAK, fee 3000, tickSpacing 60) and seeds one-sided STREAK 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 write-foundry-tests step lists (UTC day boundary, two buys in a day, a missed day, the 0.3% floor, the 0.0005 ETH threshold, sells, burnFees, pool isolation, a mismatched hookData). The independent adversarial review (read-only) attacks the hookData == tx.origin check, day arithmetic, any way to extend or borrow a streak without a qualifying buy, fee sign and rounding on all four swap modes, and burnFees accounting; 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 connected wallet's streak, a 30-day calendar built from StreakUpdated events, and the fee it would pay right now. Streak is a Sepolia test toy: its token and any pot have no value, and nothing here promises a return.

Release Escalation (ERC-20 symbol ESCL) on Sepolia as an evm_project: the fixed-supply launch token plus one application contract. Token: Escalation (ESCL), total supply 1,000,000,000 ESCL with 18 decimals, minted once to the deployer. Application contract: DollarAuction. Currency: ESCL is the app's working currency. DollarAuction takes the ESCL address as its only constructor argument (constructorArgs ["$token"]), stores it immutable, exposes it as token(), and holds no ESCL at deploy; players get ESCL by swapping Sepolia ETH in the launch pool the factory seeds. Every payment in is approve + SafeERC20.safeTransferFrom (permit not required). DollarAuction has no payable function and no receive/fallback, so it never holds ETH. Payouts are pull-based (the recipient calls to collect; nothing is pushed to third parties), follow checks-effects-interactions and are nonReentrant. No owner, admin, pause or upgrade path. Shubik's dollar auction as a Sepolia game-theory demo, all in ESCL, many auctions by id. open(prize): prize >= 100 ESCL is pulled from the seller; the auction's lastActivity = block.timestamp. Each address has at most one standing bid per auction. bid(id, newTotal): not the seller, not the current highest bidder, newTotal >= highest + 1 ESCL (the first bid >= 1 ESCL), and only while block.timestamp < lastActivity + 1 hour; the contract pulls newTotal minus the caller's current standing bid (top-up), records newTotal as their bid, makes them highest (the previous highest becomes second-highest) and sets lastActivity = block.timestamp. Ties are impossible because every bid strictly exceeds the highest. settle(id): anyone, once, when block.timestamp >= lastActivity + 1 hour: the highest bidder is credited the prize; the seller is credited the highest bid plus the second-highest bid (just the highest if there was only one bidder). settle is constant-gas and never loops over bidders: every other bidder calls reclaim(id) after settlement, once, to move their standing bid in full to withdrawable (the winner and the second-highest cannot reclaim). With no bids, settle credits the prize back to the seller. withdraw() pays credited ESCL. Views: auction(id), auctionCount(), bidOf(id, bidder), topTwo(id), deadline(id), withdrawable(address), token(). Events: Opened, Bid(id, bidder, total, lastActivity), Settled(id, winner, prize, sellerTake), Withdrawn. The site and README say plainly that bidding past the prize loses ESCL by design and that this is a test toy with no real value. Tests (Foundry) must cover: the 1 ESCL increment, top-ups by a returning bidder, the highest bidder and the seller refused, bidding at exactly lastActivity + 1 hour reverting while settle works, one-bidder and no-bid settlements, double settle, reclaim by the winner, the second-highest or twice reverting, a settle with 200 bidders costing the same gas as with 2, and the invariant that ESCL held == prizes and standing bids of unsettled auctions + unreclaimed losing bids of settled auctions + withdrawable balances. The independent adversarial review must attack: miscounting the second-highest bid after top-ups, a loser's bid being both paid to the seller and refunded, settle racing a last-second bid, and reentrancy on withdraw. Deploy through the project factory, then publish a one-page website to explain the game in two sentences, show the prize, the top two bids and a countdown, and bid, settle, reclaim and withdraw. The page reads the ESCL address from DollarAuction.token(), shows the connected wallet's ESCL balance, allowance and withdrawable balance, has an Approve step before every paying action and a Withdraw button, and says that ESCL comes from swapping Sepolia ETH in the launch pool (no in-page swap). Lists come from contract views and events only (no backend, no indexer). Keep it to one small page; the static export has index.html in dist/.

Implement an ERC-2771 trusted forwarder and a recipient in the two listed files.

Release Oneway (token symbol ONEW) on Sepolia as a univ4_hook launch. Token: Oneway (ONEW), total supply 1,000,000,000 ONEW with 18 decimals, minted once to the deployer. Hook: AsymmetricTaxHook, a Uniswap v4 hook on the token's native-ETH pool that taxes sells and pays the tax out to buyers. Sells (oneForZero) pay 200 bps (2%) of their ETH leg with the ETH-leg mechanics below, into that pool's bonus pot (ETH claims). Buys pay no hook fee. An exact-input buy (zeroForOne, amountSpecified < 0) gets a bonus of min(floor(input x 100 / 10,000), pot): beforeSwap returns a negative specified BeforeSwapDelta of -bonus, so the pool swaps input + bonus while the buyer still pays exactly input, and the hook pays its side by burning bonus of its ETH claims (poolManager.burn) in the same callback, which cancels the hook's debt. Exact-output buys get no bonus; a bonus buy that fills partially reverts (PartialFill). The hook never swaps on its own account, so its fee logic cannot re-enter itself. Events: SellTaxed(poolId, ethLeg, tax), BuyBonus(poolId, input, bonus). Views: pot(poolId), bonusFor(poolId, input). Economics for the README: a round trip pays 2% on the sell and gets at most 1% back on the buy, plus LP fees, so washing never profits; the pot only moves sellers' tax to later buyers. 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. 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 ONEW, fee 3000, tickSpacing 60) and seeds one-sided ONEW 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 (sell tax on exact-in and exact-out sells, bonus = min(1%, pot) for empty, small and large pots, the buyer debited exactly its input, pot == claims, a round trip always loses). The independent adversarial review (read-only) attacks the negative specified delta's sign and its settlement by burning claims, HookDeltaExceedsSwapAmount limits, pot accounting across pools, exact-out and partial-fill paths, rounding, and any sequence that extracts more than the pot; 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; it shows buy fee 0, sell tax 2%, the current bonus pot, the bonus a typed buy would get, and recent SellTaxed and BuyBonus events. Oneway is a Sepolia test toy: its token and any pot have no value, and nothing here promises a return.

Release Desk (ERC-20 symbol DESK) on Sepolia as an evm_project: the fixed-supply launch token plus one application contract. Token: Desk (DESK), total supply 1,000,000,000 DESK with 18 decimals, minted once to the deployer. Application contract: OTCBoard, a fixed-price board where makers sell any ERC-20 for Sepolia ETH. Currency: DESK is the featured token. OTCBoard takes the DESK address as its only constructor argument (constructorArgs ["$token"]), exposes it as featuredToken() for the site's default, and holds no DESK at deploy. No owner, admin, fee or upgrade path; no receive/fallback. Tokens move with SafeERC20; post, fill, cancel and withdraw follow checks-effects-interactions and are nonReentrant. Orders have ids from 1; a call on an unknown id reverts. post(token, amount, pricePerToken, expiry): amount > 0, pricePerToken > 0 (wei per whole token, i.e. per 10^decimals base units), block.timestamp < expiry <= block.timestamp + 90 days; decimals() is read once and stored, and a token whose decimals() reverts or exceeds 30 is rejected. The tokens are pulled and the order records the amount actually received (balance delta; zero received reverts; fee-on-transfer tokens are recorded net; rebasing tokens are unsupported, README says so). fill(orderId, amount) payable: the order is not cancelled, block.timestamp < expiry, 0 < amount <= remaining, and the caller is not the maker; cost = Math.mulDiv(amount, pricePerToken, 10^decimals, Rounding.Ceil), so a 1-base-unit fill costs at least 1 wei, and msg.value must equal cost exactly. remaining drops by amount, amount is sent to the taker (a fee-on-transfer token delivers less than amount; the README says so), and cost is credited to the maker's withdrawable ETH (pull, so a maker that rejects ETH cannot block fills). cancel(orderId): maker only, while remaining > 0 and not already cancelled, before or after expiry; the remainder returns to the maker. withdraw() sends the caller's whole ETH credit with call and reverts on zero. Orders cannot be edited (cancel and repost). Views: order(id), orderCount(), quote(id, amount), withdrawable(address), featuredToken(). Events (token and maker indexed): Posted(id, maker, token, amount, pricePerToken, expiry), Filled(id, maker, taker, amount, cost), Cancelled(id, maker, remainder), Withdrawn(account, amount). Tests (Foundry) must cover: partial fills whose cost rounds up, exact msg.value (more or less reverts), expiry at the boundary, cancel after partial fills and after expiry, a 6-decimal token, a fee-on-transfer token, and the invariants: for each token, OTCBoard's balance >= the sum of remainders of orders not cancelled; OTCBoard's ETH == the sum of withdrawable credits. The independent adversarial review must attack: rounding that gives tokens for free or overcharges, reentrancy through a token with transfer callbacks on fill or cancel, filling a cancelled or expired order, and decimals mismatches between post and fill. Deploy through the project factory, then publish a one-page website where a connected wallet can view the order book (DESK by default, any token by address), post an order (approve the token first), fill with the exact quoted ETH, cancel its own orders and withdraw ETH proceeds. Lists come from contract views and events only (no backend, no indexer). Keep it to one small page; the static export has index.html in dist/.

Release Lockup (token symbol LKUP) on Sepolia as a univ4_hook launch. Token: Lockup (LKUP), total supply 1,000,000,000 LKUP with 18 decimals, minted once to the deployer (a separate zero-argument ERC-20, no mint, owner or admin). Hook: LiquidityLockupHook, a Uniswap v4 hook on the token's native-ETH pool that locks each liquidity position for 30 days after its last add. Position key: exactly the PoolManager's, keccak256(owner, tickLower, tickUpper, salt), where owner is the sender argument of the liquidity callbacks (the router or PositionManager that called modifyLiquidity; PositionManager uses the NFT tokenId as salt, so each NFT is its own position). afterAddLiquidity with liquidityDelta > 0 sets unlockAt[poolId][positionKey] = block.timestamp + 30 days (every top-up restarts the full 30 days) and emits Locked(poolId, positionKey, sender, tickLower, tickUpper, salt, liquidityDelta, unlockAt). beforeRemoveLiquidity reverts with StillLocked(unlockAt) when liquidityDelta < 0 and block.timestamp < unlockAt; liquidityDelta == 0 (fee collection, which v4 routes through beforeRemoveLiquidity) always passes, as does any removal at or after unlockAt. The factory's own seed position is locked like any other; the launch never needs to remove it. No deltas, no fee, no funds held, no admin; nothing can extend or shorten a lock except a new add to the same key. Known limit to document: on a shared router such as PoolModifyLiquidityTest, anyone adding to the same (router, range, salt) key restarts that key's lock, so the README and site send LPs to PositionManager. The symbol is LKUP because LOCK is already a live launch token on this factory (launch 113). Deploy shape, matching the live Sepolia hook launches 170, 183 and 186 (launch 168 passed the mainnet PoolManager and is not a model): LiquidityLockupHook's only constructor argument is the Sepolia PoolManager 0xE03A1074c86CFeDd5C142C4F04F1a1536e203543; every rate, window and threshold here is a source constant; there is no owner, admin, setter, pause, upgrade or sweep, and no $owner or $token argument. Permissions are exactly afterAddLiquidity, beforeRemoveLiquidity (low address bits 0x0600), all others false; the constructor calls Hooks.validateHookPermissions and the CREATE2 salt is mined for those bits. The factory initializes the pool (currency0 native ETH, currency1 LKUP, fee 3000, tickSpacing 60) and seeds one-sided LKUP liquidity, so nothing in the hook may revert that initialize or that liquidity add (launch 138 was parked when a beforeInitialize gate reverted the factory), and the first buy lands in a pool that holds no ETH. All state is keyed by PoolId; a pool on this hook 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 LKUP liquidity like the factory and makes the first buy into the ETH-less pool; exact-in and exact-out in both directions; dust amounts; a pool whose currency0 is not ETH; direct callback calls from a non-PoolManager address revert; fuzzed sizes; and specifically: removal at unlockAt minus 1 second reverts and at exactly unlockAt passes; a top-up restarts the lock; fee collection (delta 0) works while locked; two PositionManager NFTs on the same range lock independently; the factory-style seed add succeeds; swaps and donations are unaffected. An independent adversarial review (read-only) must attack: every path that removes liquidity (PositionManager decrease and burn, multicall, delta 0), whether any path can lock liquidity forever or lock someone else's position, the shared-router grief, position-key derivation, and that afterAddLiquidity can never revert the factory's seed add. It reports each finding with the exact call sequence that triggers it. Website: one static page (dist/index.html) that reads the hook's views and events and pool and position state through Uniswap's Sepolia StateView 0xe1dd9c3fa50edb962e442f60dfbc432e24537e4c, and sends every liquidity action through Uniswap's published Sepolia PositionManager 0x429ba70129df741b2ca2a85bc3a2a3328e5c09b4 (has code, poolManager() is the PoolManager above; never the unguarded PoolModifyLiquidityTest, whose positions anyone can remove). It shows each position's unlock date and time left (from Locked events, with current liquidity read through StateView), the pool's total liquidity still locked, a lookup by PositionManager tokenId, and for the connected wallet's own PositionManager positions (Locked events whose sender is the PositionManager and whose salt, read as a tokenId, has ownerOf equal to the wallet) a remove button that shows the unlock time and is disabled until then (adding liquidity is left to any v4 PositionManager client and explained in the README, keeping the site small).