Tevm CLI

The Tevm CLI exposes rc.151 node actions, contract tools, state controls, and Solidity compilation as shell commands. Reach for it when a one-off command or script is more direct than creating a JavaScript client.

Install and create a local session

npm install --global @tevm/cli@1.0.0-rc.151
tevm --version
tevm session docs --local --json

1.0.0-rc.151
{
  "ok": true,
  "command": "session",
  "result": {
    "version": 1,
    "name": "docs"
  },
  "session": "docs"
}

A named session reloads and persists local state between commands. Use --run to skip the interactive editor and --json for the stable { ok, command, result, session } envelope.

Global options

Flag	Environment	Effect
`--json`, `--no-json`	`TEVM_JSON`	Select stable JSON or human output.
`--session <name>`	`TEVM_SESSION`	Load and persist a named local or forked state file.
`--run`, `-r`	`TEVM_RUN`	Execute directly instead of opening the parameter editor.
`--rpc <url>`	`TEVM_RPC`	Fork or query the selected JSON-RPC endpoint.

Command reference

Command	Purpose
`tevm call`	call command
`tevm compile`	compile command
`tevm contract`	contract command
`tevm action create-access-list`	createAccessList command
`tevm create-block-filter`	createBlockFilter command
`tevm create-contract-event-filter`	createContractEventFilter command
`tevm create-event-filter`	createEventFilter command
`tevm deploy`	deploy command
`tevm dump-state`	dumpState command
`tevm estimate-fees-per-gas`	estimateFeesPerGas command
`tevm estimate-gas`	estimateGas command
`tevm get-account`	getAccount command
`tevm action get-balance`	getBalance command
`tevm get-block`	getBlock command
`tevm get-block-number`	getBlockNumber command
`tevm get-bytecode`	getBytecode command
`tevm get-chain-id`	getChainId command
`tevm get-ens-address`	getEnsAddress command
`tevm get-ens-name`	getEnsName command
`tevm get-ens-text`	getEnsText command
`tevm get-gas-price`	getGasPrice command
`tevm get-storage-at`	getStorageAt command
`tevm get-transaction`	getTransaction command
`tevm load-state`	loadState command
`tevm mine`	mine command
`tevm multicall`	multicall command
`tevm read-contract`	readContract command
`tevm action send-raw-transaction`	sendRawTransaction command
`tevm serve`	serve command
`tevm set-account`	setAccount command
`tevm set-code`	setCode command
`tevm set-nonce`	setNonce command
`tevm set-storage-at`	setStorageAt command
`tevm action simulate-calls`	simulateCalls command

The rc.151 create, generate, and tsc entry points are deliberately absent because their advertised non-interactive examples fail in this release. Their exact failures and disposition are recorded in the documentation ledger.

Neighbours

JSON-RPC · Actions · Contract tools · State management