03 Foundry workflow

The tools

• forge build, test, fuzz, coverage, scripts
• anvil local EVM node (test accounts with fake ETH)
• cast call / send / decode from the shell
• chisel Solidity REPL

Project layout

foundry.toml   # solc 0.8.24, evm_version = "cancun" for XDC mainnet
src/           # contracts
test/          # *.t.sol, contracts that inherit forge-std Test
script/        # *.s.sol deploy scripts

Tests in Solidity

function test_RevertWhen_Full() public {
    vm.prank(alice); seats.book();
    vm.prank(bob);   seats.book();
    vm.expectRevert(WorkshopSeats.Full.selector);
    seats.book();
}
function testFuzz_NeverOverbooked(uint8 n) public { ... }

Cheatcodes: vm.prank, vm.warp, vm.expectRevert, makeAddr, vm.createSelectFork

Local deploy loop

anvil --port 18513
forge script script/Deploy.s.sol --rpc-url http://127.0.0.1:18513 \
  --broadcast --private-key <anvil test account #0>
cast call <addr> "seatsLeft()(uint256)" --rpc-url http://127.0.0.1:18513

Same commands target XDC/Apothem by changing --rpc-url (not in this workshop).

Habits

• forge fmt, forge test --gas-report, forge coverage
• Keys: never in files or repos; use hardware/keystore (cast wallet import) for real deploys

→ Lab 1