Anvil Patterns

# Start default local node (8545)
anvil

# Custom port and chain ID
anvil --port 8546 --chain-id 31337

# With specific number of accounts and balance
anvil --accounts 20 --balance 10000

# Specific mnemonic (reproducible addresses)
anvil --mnemonic "test test test test test test test test test test test junk"

# Specific block base fee
anvil --block-base-fee-per-gas 0

# Fork mainnet (latest block)
anvil --fork-url $ETH_RPC_URL

# Fork at specific block (reproducible state)
anvil --fork-url $ETH_RPC_URL --fork-block-number 18000000

# Fork Base
anvil --fork-url $BASE_RPC_URL --chain-id 8453

# Fork with retry and rate limiting
anvil --fork-url $ETH_RPC_URL --fork-retry-backoff 3 --compute-units-per-second 100

# No storage caching (fresh state each time)
anvil --fork-url $ETH_RPC_URL --no-storage-caching

# Impersonate an address via RPC
cast rpc anvil_impersonateAccount 0xWhaleAddress

# Send tx as the impersonated address
cast send 0xToken "transfer(address,uint256)" 0xRecipient 1000000000000000000 \
  --from 0xWhaleAddress --unlocked --rpc-url http://127.0.0.1:8545

# Stop impersonating
cast rpc anvil_stopImpersonatingAccount 0xWhaleAddress

vm.prank(0xWhaleAddress);
token.transfer(recipient, amount);

# Auto-mine (default): mine a block for each transaction
anvil

# Interval mining: mine every N seconds
anvil --block-time 12

# Manual mining: no auto-mining
anvil --no-mining

# Mine a single block manually
cast rpc evm_mine --rpc-url http://127.0.0.1:8545

# Mine N blocks
cast rpc anvil_mine 10 --rpc-url http://127.0.0.1:8545

# Mine with specific timestamp
cast rpc evm_mine "0x$(printf '%x' 1700000000)" --rpc-url http://127.0.0.1:8545

# Set ETH balance
cast rpc anvil_setBalance 0xAddress "0xDE0B6B3A7640000" # 1 ETH in hex

# Set ERC-20 balance (write to storage slot directly)
# First find the balance slot: for most tokens, balanceOf mapping is slot 0 or slot 2
SLOT=$(cast index address 0xAddress 0)
cast rpc anvil_setStorageAt 0xTokenAddress $SLOT \
  "0x0000000000000000000000000000000000000000000000000DE0B6B3A7640000"

# Set nonce
cast rpc anvil_setNonce 0xAddress "0x10"

# Set contract code
cast rpc anvil_setCode 0xAddress "0x608060405234..."

# Set block timestamp
cast rpc evm_setNextBlockTimestamp "0x$(printf '%x' $(date +%s))"

# Increase time by N seconds
cast rpc evm_increaseTime 3600  # +1 hour

# Take snapshot (returns snapshot ID)
SNAP_ID=$(cast rpc evm_snapshot --rpc-url http://127.0.0.1:8545)

# ... make changes ...

# Revert to snapshot
cast rpc evm_revert $SNAP_ID --rpc-url http://127.0.0.1:8545

# Dump state to file
cast rpc anvil_dumpState --rpc-url http://127.0.0.1:8545 > state.json

# Later, start anvil and load state
anvil &
cast rpc anvil_loadState "$(cat state.json)" --rpc-url http://127.0.0.1:8545

# Terminal 1: Start fork
anvil --fork-url $ETH_RPC_URL --fork-block-number 18000000

# Terminal 2: Run tests against fork
forge test --fork-url http://127.0.0.1:8545

# Or script against fork
forge script script/Simulate.s.sol --fork-url http://127.0.0.1:8545

// Fork in test setup
function setUp() public {
    // fork mainnet at specific block
    vm.createSelectFork("mainnet", 18_000_000);
}

function test_swapOnUniswap() public {
    address whale = 0xWhaleAddress;
    vm.startPrank(whale);
    // ... interact with real mainnet contracts
    vm.stopPrank();
}