Web3 Docs

Current patterns and references for EVM development. Covers the full stack: contracts → testing → deployment → frontend integration.

Stack Coverage

Quick Lookup

Starting a new Foundry project: See references/foundry.md → Project Setup

Starting a Hardhat project: See references/hardhat.md → Installation

Writing an ERC-20: See references/openzeppelin.md → ERC-20

Building a yield vault (ERC-4626): See references/erc4626.md → OpenZeppelin Implementation

First depositor attack on vaults: See references/erc4626.md → First Depositor Attack

Connecting a wallet in React: See references/wagmi.md → Quick Start

Reading contract state with Viem: See references/viem.md → Read Contracts

Common Solidity errors: See references/solidity.md → Error Reference

Deploying to Optimism/Base with Hardhat: See references/hardhat.md → hardhat.config.ts

Fetch Latest Docs

INLINECODE17 pulls live docs from official sources when the reference files may be stale.

CODEBLOCK0

Gas Optimization Quick Rules

1. 1. Use calldata instead of memory for read-only function params
2. Pack storage variables: multiple uint128 in one slot beats two separate INLINECODE21
3. INLINECODE22 blocks for arithmetic that can't overflow (saves ~30 gas/op)
4. INLINECODE23 > constant > storage for values set once
5. Events are cheaper than storage for historical data
6. Batch operations: one tx touching N items beats N txs