# tevm action simulate-calls `tevm action simulate-calls` runs this operation: Simulate a bundle of calls without committing state. 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. ```bash npm install --global @tevm/cli@1.0.0-rc.151 tevm session docs --local --json tevm set-account --address 0x5a0b54d5dc17e482fe8b0bdca5320161b95fb929 --balance 2000000000000000000 --session docs --run --json tevm action simulate-calls --session docs --run --json ``` Output captured from the final command: ```json { "ok": true, "command": "simulate-calls", "result": { "assetChanges": [], "block": { "number": "1", "hash": "0x0a9c2eca14d1a331a1dbbeb3cf9489977d0d697bca293322001af9ceaacbf4fb", "timestamp": "12", "gasLimit": "30000000", "gasUsed": "0", "baseFeePerGas": "7", "logsBloom": null, "nonce": null, "transactions": [], "totalDifficulty": null }, "results": [ { "data": "0x", "gasUsed": "0", "logs": [], "status": "success", "result": null }, { "data": "0x", "gasUsed": "0", "logs": [], "status": "success", "result": null } ] }, "session": "docs" } ``` ## Arguments and flags The command schema in [`cli/src/commands/action/simulateCalls.tsx`](https://github.com/evmts/tevm/blob/main/cli/src/commands/action/simulateCalls.tsx) exposes: | Kind | Syntax | Description | | --- | --- | --- | | Flag | `--account [account]` | Account to simulate calls from (env: TEVM_ACCOUNT) | | Flag | `--block-number [block-number]` | Block number to simulate at (env: TEVM_BLOCK_NUMBER) | | Flag | `--block-tag [block-tag]` | Block tag (latest, pending, etc.) to simulate at (env: TEVM_BLOCK_TAG) | | Flag | `--calls [calls]` | Calls as inline JSON or a JSON file path (env: TEVM_CALLS) | | Flag | `--trace-asset-changes` | Whether to trace asset changes (env: TEVM_TRACE_ASSET_CHANGES) (default: false) | | Flag | `--trace-transfers` | Whether to trace transfers (env: TEVM_TRACE_TRANSFERS) (default: false) | | Flag | `--validation` | Whether to enable validation mode (env: TEVM_VALIDATION) (default: false) | | Flag | `-r, --run` | Run directly without interactive parameter editing (env: TEVM_RUN) (default: false) | | Flag | `--rpc [rpc]` | RPC endpoint (env: TEVM_RPC) | | Flag | `--json` | Emit the stable machine-readable JSON envelope (env: TEVM_JSON) (default: false) | | Flag | `-h, --help` | Show help | `--json` and `--session ` are global options accepted before routing. See the [CLI overview](/reference/cli#global-options) for their environment-variable forms and execution model. ## Neighbours [CLI overview](/reference/cli) ยท [`tevm set-storage-at`](/reference/cli/set-storage-at)