Create a NEW Foundry codebase from this specification. This is a BUILD-ONLY job: deliver source to a NEW GitHub repository created by the swarm. No existing repository is an input. Do not request an input GitHub URL. Do NOT deploy contracts, mint a production token, create a pool, upload artwork, open claims or lock contracts. Use local mock tokens only in tests. Final production token launch is a separate future job, not this request.

Project: Ink & Inference.

Token name: INK.

Token symbol: INK.

Token supply: 1,000,000,000 with 18 decimals. These describe the external token for integration and test mocks; do not mint or deploy a production token.

Solidity 0.8.26, Cancun, optimizer 200, bytecode_hash none, pinned OpenZeppelin/Uniswap v4 dependencies. Implement five contracts, complete local tests and setup documentation.

InkPortraits: ERC721 Ink & Inference (INKINF), maximum 2000 portraits combined. Agent IDs 0-1999 equal identity.md seat IDs; swarm IDs start at 10000. Only configured vault mints. Store fixed agent inputs accepted uint32, rateBps uint16, turns uint32, hoursTenths uint32, outdated bool; swarm seed bytes32. Track agent-holder balances across transfers. ERC2981 5% to explicit owner. Configurable renderer with irreversible selection lock. No Develop or paid variations.

InkVault: accept externally supplied 18-decimal INK. 400000 INK per portrait. One-time funded setup with stats root, claim start and liquidity contract. Current seat owners, including inactive seats, claim once free during 24 hours. Authenticate current ERC721 ownership and StandardMerkleTree proofs. Leaf is keccak256(bytes.concat(keccak256(abi.encode(seat,accepted,rateBps,turns,hoursTenths,outdated)))). Synthetic fixtures only; private production snapshot supplied later. Permissionless release after window moves 400000 INK per unclaimed seat to permanent liquidity atomically, then enables swarm pulls. Failed liquidity addition must roll back release. Pulls lock 400000 INK each, reserve capacity and reveal from next-block hash; handle 256-block expiry without stranded funds/double reservations. Disclose manipulation risks. Draw returned inventory or mint within unused capacity. Swarm NFT return pays backing minus 1%, or 0.5% for agent holders. Agent NFT return pays backing plus up to 5% from bonus pot. Deposit fees fund pot; never spend backing on bonuses. Returned NFTs remain inventory, not burned. Owner fee bounds: base <=5%, agent <=base, bonus <=10%; defaults 1%,0.5%,5%. No backing withdrawal.

InkLiquidity: official v4 managers, guarded pool setup, correct currency ordering/ticks, add released INK single-sided beyond current price. Retain positions permanently, no withdrawal escape hatch. Document collection permissions.

InkHook: immutable, ownerless, one INK/IMD pool. Extra fee 25bps, waived for agent-portrait holders. IMD fees to immutable treasury; INK fees to dead address, not IMD burning. Lock swaps until vault release or 7 days after pool initialization. First permitted swap starts 1-hour cumulative buy cap 1200000 INK per wallet, including fee-exempt wallets. Authenticate actual traders with documented production-router compatibility; do not trust arbitrary hookData or tx.origin. Test exact input/output, both currency orderings, deltas, settlement and callback authentication. Flag unsupported requirements rather than silently bypass them.

InkRenderer: chunk storage for owner-supplied ORIGINAL JavaScript, onchain JSON/animation_url HTML and separate irreversible script/preview lock. Original algorithm is NOT supplied yet: do not invent it, fabricate trait fidelity or replace it with AI art. Explicitly mark art/trait integration pending. Prepare verified, safely resumable upload tooling; never execute uploads.

All owned contracts take explicit owner constructor argument. Test-only seats/token mocks never target mainnet. Future economics context only: 1 billion plain-transfer INK; 10% swarm,10% initial pool,80% vault; Ethereum IMD pairing. Do not implement a token launch in this job. Pin dependencies; provide ABIs, constructor manifest, setup order, solvency/inventory invariants and router tests. Report security assumptions, unresolved findings and tests actually run. Request independent review if supported; never claim it ran if absent. If a requirement is unsafe, document a blocker instead of changing economics. BUILD ONLY; no source repository required as input.