Scaffold a new foundry project and add [profile.default.zksync] config (forge init)

Install dependencies for a foundry project (forge install)

Remove build artifacts (out/ and zkout/) from a foundry project (forge clean)

Compile a foundry-zksync project (forge build --zksync). Check foundry.toml for [profile.X.zksync] sections — if zkSync sources live under a specific profile (e.g. 'zksync'), pass that as the profile argument.

Run tests in a foundry-zksync project (forge test --zksync). Check foundry.toml for [profile.X] sections — if the test directory differs per profile (e.g. profile 'zksync' has test = 'zksync/tests'), pass the correct profile argument.

Run a forge script targeting zkSync (forge script --zksync)

Deploy a contract to a zkSync network (forge create --zksync). Returns structured output with contract address, tx hash, and deployer.

Verify a deployed contract on a block explorer (forge verify-contract --zksync). Supports Etherscan (requires API key) and zkSync Explorer (no key needed).

Run tests and generate a gas usage report (forge test --zksync --gas-report). Note: zkSync gas values are aggregate-only (no computation/pubdata breakdown).

Create or compare gas snapshots (forge snapshot --zksync). Use diff=true to compare against existing .gas-snapshot, check=true to fail on changes.

Read and return the contents of foundry.toml from a project. Useful for inspecting profiles, zkSync config, library links, and other settings.

Explain raw output from foundry-zksync: error messages, logs, or transactions. Matches against a knowledge base of known zkSync gotchas and returns actionable advice. Use context='general' for background on what foundry-zksync is and how it works.

ABI-encode values for a given Solidity function/constructor signature (cast abi-encode)

Decode ABI-encoded hex data back into human-readable values (cast abi-decode)

Decode raw transaction calldata (with 4-byte selector) into function arguments (cast calldata-decode)

Read-only call to a deployed contract — no gas spent, no state change (cast call)

Send a state-changing transaction to a deployed contract (cast send)

Query the ETH balance of an address (cast balance)

Query the transaction nonce of an address (cast nonce). Note: on zkSync this returns the TX nonce only, not the deploy nonce.

Look up foundry-zksync documentation by topic. Returns URLs to the foundry-zksync book for installation, config, testing, deployment, cheatcodes, nonces, factory deps, paymasters, verification, and more. Use topic='list' to see all available topics.

Start or check a local anvil-zksync development node. Supports forking from mainnet/testnet. Default port: 8011.