Skip to content
LogoLogo

tevm multicall

tevm multicall runs this operation: Read several contracts in one request. Reach for it when you need the operation from a terminal, CI job, or shell script.

Working example

The commands below were run with @tevm/cli@1.0.0-rc.151. They create their own local prerequisites or use the named public endpoint, so no hidden process is required.

npm install --global @tevm/cli@1.0.0-rc.151
tevm session docs --local --json
tevm multicall --contracts [] --session docs --run --json

Output captured from the final command:

{
  "ok": true,
  "command": "multicall",
  "result": [],
  "session": "docs"
}

Arguments and flags

The command schema in packages/tevm-cli/src/commands/multicall.tsx exposes:

KindSyntaxDescription
Flag--contracts [contracts]Array of contract calls in JSON format (env: TEVM_CONTRACTS)
Flag--multicall-address [multicall-address]Address of the multicall contract (env: TEVM_MULTICALL_ADDRESS)
Flag--allow-failureWhether to allow calls to fail (env: TEVM_ALLOW_FAILURE) (default: false)
Flag--block-tag [block-tag]Block tag (latest, pending, etc.) (env: TEVM_BLOCK_TAG)
Flag--block-number [block-number]Block number to execute at (env: TEVM_BLOCK_NUMBER)
Flag-r, --runRun directly without interactive parameter editing (env: TEVM_RUN) (default: false)
Flag--rpc [rpc]RPC endpoint (env: TEVM_RPC)
Flag--jsonEmit the stable machine-readable JSON envelope (env: TEVM_JSON) (default: false)
Flag-h, --helpShow help

--json and --session <name> are global options accepted before routing. See the CLI overview for their environment-variable forms and execution model.

Neighbours

CLI overview · tevm mine · tevm read-contract