A Uniswap v4 hook: Build UNLOCK (UNLK), "The $5M Unlock Experiment", as a compilable, tested Foundry source project and publish it to GitHub. THIS REQUEST IS CODE AND TESTS ONLY: Deploy onchain is OFF. Do not deploy to any public network, create a live token/pool, require signing keys, or require future live addresses or reward allocations. Website and public-network release are separate later tasks. Deliver repository URL and exact commit, source, ABIs, pinned dependencies, reproducible build/test commands and results. Do not replace implementation with a plan or a blocked-input note.

Future integration target, not a deployment request: IMD univ4_hook, 87% pool share, initially tested on Sepolia and later separately released on Ethereum mainnet. Inspect available official factory/router/distributor interfaces. Parameterize chain-specific dependencies through constructors or authenticated one-time setup, with no later admin changes. Hook must be attached when the official pool is initialized. Never use a plain pool or unattached hook as an equivalent. If an IMD interface is unavailable, implement and test independent core logic, isolate the integration boundary, and document the exact missing interface. Clearly label mocks and unverified adapters; do not claim production compatibility. Missing release credentials/addresses alone must not stop code development. The following rules specify the intended contract behavior and future launch economics.

Token: standard ERC-20, 1 billion UNLK, 18 decimals, minted once. 10% IMD swarm, 87% official pool, 3% paying wallet. Ordinary transfers remain free of token-level taxes/quotas/blacklists/pausing. No later minting, upgrades, admin rule/oracle changes, counter resets or trader exemptions. Preserve IMD opening economics. Hook takes no additional fee; retain the mandatory 1.25% pool trading fee, split 1% to the paying wallet and 0.25% to IMD through official fee distribution.

Callbacks: beforeInitialize authenticates the authorized launch factory and binds the pool once. beforeSwap authenticates the supported route and actual trader; afterSwap checks quotas and records actual executed token deltas atomically, reverting excess sales. Only canonical PoolManager invokes callbacks. Use matching hook address permission flags. Keep security-critical initialization available while allowing no later admin changes. Public users may trade, read, claim eligible rewards, synchronize proven credits and request contract-verified milestone updates.

Per wallet E=cumulative eligible acquisitions, S=cumulative official-pool sales. E credits only actual official-pool buys delivered to the authenticated beneficiary, the verified 3% payer allocation, and rewards actually claimed. Verify allocations/claims on-chain from immutable launch/distributor data or authenticated callbacks; deduplicate credits. Anyone may synchronize proofs to their rightful recipient, never select amounts/recipients. User-supplied logs are not proof. Preserve IMD eligibility/proof/release rules; claiming has no added price/quota restriction. Credit-sync failure cannot block native claims. Expose pending credits; unclaimed rewards are not E.

Initially p=2500. Before full unlock Q=max(0,floor(Ep/10000)-S). Sale q requires S+q<=floor(Ep/10000), then increments S by executed tokens. Use overflow-safe math and documented fee accounting; reverted swaps change nothing. Other wallets cannot consume Q. Ordinary transfers, donations and liquidity operations do not credit/move/reset E or S; the three authenticated acquisition types above do credit E. A transfer-only recipient with E=0 cannot sell here until acquiring rights or final unlock. Disclose this and prevent transfer-chain credit creation.

Verified USD FDV thresholds permanently raise p: $100K:3500; $250K:4500; $500K:5500; $1M:7000; $2.5M:8500. At $5M permanently bypass quota checks for everyone, including transfer-only recipients; p=10000 alone is insufficient. Retain standard fees/settlement/authentication. Falling prices never relock.

Authenticate actual token-paying sellers and receiving buyers and enforce sourcing/delivery. Never trust tx.origin, callback sender alone or arbitrary hookData. Signed intents need domain/transaction binding, replay protection and supported smart-wallet validation. Reject direct/router paths bypassing or misattributing rights; enforce this on-chain.

FDV=fixed supply times verified UNLK/USD. Use a chain-specific verified Chainlink ETH/USD feed plus an implemented on-chain UNLK/ETH time-weighted oracle; assume neither a UNLK feed nor built-in v4 TWAP. Pin/review window, warm-up, freshness, liquidity floor and sustained-threshold confirmation. Test flash-loan/same-block/sustained manipulation. Invalid data blocks new tiers only. Permanently protect initial liquidity principal using verified IMD protection or a compatible lock; preserve fee collection and reward claims. Inspect withdrawal rights, not just labels.

Deliver contracts, Foundry configuration with bytecode_hash = "none", pinned dependencies, ABIs, local deployment scripts and integration documentation. Test launch/router/distributor interactions, callbacks, exact-input/output, currency ordering, multihop/multiple swaps, fee deltas, quota boundaries, spoofing/replay/bypass, transfers, duplicate credits, claim/sync/sale, liquidity, oracle attacks/failure and permanent unlock with unit/fuzz/invariant tests and available fork tests. Use explicitly labeled local fixtures for tokens, rewards and oracle scenarios; never substitute them for production evidence. Report executed commands/results, skipped tests and missing inputs. Provide a review checklist; only claim independent review if a separate reviewer actually performed it. Record unresolved findings and prohibit release with critical/high findings. Document future hook-address mining, deployment order, chain-specific configuration, required IMD manifest fields where verified, and post-deployment PoolKey/credit/liquidity checks. This job completes with implemented source, tests and a GitHub handoff, not mainnet addresses or transaction hashes; explicitly list unfinished integration work.

Token name: UNLK