Custom RPC Methods

You can fully control your Virtual Environment by using special RPC methods. These methods are made available through the Admin RPC, which you can copy from the Dashboard. They allow you to manipulate the network state such as account balances, block numbers, and storage to accommodate your development needs. Calls to these RPC methods are represented by a call to virtual TenderlyCheatcodes contract.

The list of special RPC methods listed here will only work if they are called through the Admin RPC. Network customization

evm_increaseTime
evm_setNextBlockTimestamp
tenderly_setNextBlockTimestamp
evm_increaseBlocks
evm_mine

Send transaction

eth_sendTransaction
eth_createAccessList
evm_getLatest

Unlimited faucet

tenderly_setBalance
tenderly_addBalance
tenderly_setErc20Balance
tenderly_addErc20Balance
tenderly_setMaxErc20Balance

Storage manipulation

tenderly_setStorageAt
tenderly_setCode

State revert

evm_snapshot
evm_revert

Network Mirror Mode sync control

tenderly_startSync
tenderly_stopSync
tenderly_syncNext
tenderly_revertSync
tenderly_getSyncStatus

`evm_increaseTime`

Advances the blockchain time by a specified amount and creates an empty block with the new timestamp. Subsequent calls to eth_call and eth_sendRawTransaction will get different block.timestamp values based on the blockNumber they target:

For pending block: Returns current_time + time_increase This represents the expected timestamp of the next block to be mined.
For latest block: Returns time_of_evm_increaseTimestamp_call + time_increase. This is the timestamp of the empty block created when evm_increaseTimestamp was called.

Parameters

QUANTITY - hex-encoded time_increase of seconds to jump forward by

Returns

DATA - 32-byte block hash of the newly generated block

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "evm_increaseTime",
  "params": ["0x15180"],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": "0x51e0a03f19e0c154b16363086aa6bbf22ad4582b0515b0a3a00519015f06246f",
  "id": "1234"
}

`evm_setNextBlockTimestamp`

Offsets current time to the specified timestamp, and creates an empty block with given timestamp. Subsequent calls to eth_call and eth_sendRawTransaction will return different block.timestamp values based on the blockNumber they target:

For pending block: Returns specified_timestamp + time_since_evmSetNextBlockTimestamp_call. This represents the set timestamp plus any time elapsed since the method was called.
For latest block: Returns specified_timestamp. This is the timestamp of the empty block created when evm_setNextBlockTimestamp was called.

Parameters

QUANTITY - hex-encoded specified_timestamp that represents epoch timestamp (in seconds)

Returns

QUANTITY - integer (epoch timestamp) that is set for the next block

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "evm_setNextBlockTimestamp",
  "params": ["1750074671"],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": 1750074671,
  "id": "1234"
}

`tenderly_setNextBlockTimestamp`

Offsets current time to given timestamp without creating an empty block. Subsequent calls to eth_call and eth_sendRawTransaction will return different block.timestamp values based on the blockNumber they target:

For pending block: Returns specified_timestamp + time_since_tenderly_setNextBlockTimestamp. This represents the set timestamp plus any time elapsed since the method was called.
For latest block: Returns the timestamp of the latest created block.

Parameters

QUANTITY - hex-encoded specified_timestamp that represents epoch timestamp (in seconds)

Returns

QUANTITY - integer (epoch timestamp) that is set for the next block

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "evm_setNextBlockTimestamp",
  "params": ["1750074671"],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": 1750074671,
  "id": "1234"
}

`evm_increaseBlocks`

Skips a number of blocks and generates a new block with the new block number. Parameters

QUANTITY - hex-encoded number of blocks to skip

Returns

DATA - 32-byte block hash of the newly generated block

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "evm_increaseBlocks",
  "params": ["0x20"],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": "0x51e0a03f19e0c154b16363086aa6bbf22ad4582b0515b0a3a00519015f06246f",
  "id": "1234"
}

`eth_sendTransaction`

Submits an unsigned transaction. Parameters

Transaction - The transaction object

from: DATA, 20 Bytes - The address the transaction is sent from.
to: DATA, 20 Bytes - (optional, omitted when creating new contract) The address the transaction is directed to.
gas: QUANTITY - (optional) Integer of the gas provided for the transaction execution. It will return unused gas.
gasPrice: QUANTITY - (optional) Integer of the gasPrice used for each paid gas.
value: QUANTITY - (optional) Integer of the value sent with this transaction.
data: DATA - (optional) The compiled code of a contract OR the hash of the invoked method signature and encoded parameters.

example.json

{
  "id": 0,
  "jsonrpc": "2.0",
  "method": "eth_sendTransaction",
  "params": [
    {
      "from": "0xDC6bDc37B2714eE601734cf55A05625C9e512461",
      "to": "0xff39a3e734fe363e631441f6d24c7539240c2628",
      "value": "0x0",
      "data": "0x2e7700f0"
    }
  ]
}

RESULT: Transaction hash STRING 32 byte hex value

`eth_createAccessList`

Returns the access tuples that would be touched by the transaction. Parameters

SendTransactionObject - transaction object (same as the one provided to eth_sendTransaction)
BlockNumber - block number parameter

Returns

AccessList - an array of access tuples touched by the transaction

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "eth_getAccessList",
  "params": [
    {
      "from": "0x7ed8dff35e6fef1a6c1f95423cd8a64e22687aac",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "gas": "0x76c00",
      "gasPrice": "0x0",
      "value": "0x0",
      "data": "0xa9059cbb0000000000000000000000005eddecc908575e1adcf857d8be380b9b7e5f658300000000000000000000000000000000000000000000000228813d891ab86000"
    },
    "latest"
  ],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": [
    {
      "address": "0x7ed8dff35e6fef1a6c1f95423cd8a64e22687aac"
    },
    {
      "address": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "storage_keys": [
        "0x5051a693fd89be4fee1466db5a0684c1868dc09405da86e3d13004a803e302ec"
      ]
    },
    {
      "address": "0xc8f595e2084db484f8a80109101d58625223b7c9"
    }
  ],
  "id": 1234
}

`evm_getLatest`

Fetches the latest transaction ID on a network Virtual Environment. Parameters Returns

DATA - UUID of the latest Virtual Environment transaction

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "evm_getLatest",
  "params": [],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": "4a05d7ed-f66c-471a-899d-d6d843b8e790",
  "id": "1234"
}

`tenderly_setBalance`

Modifies the balance of an account or accounts. Parameters

ADDRESS/ADDRESSES - a string or an array of account addresses
AMOUNT - hex-encoded number of an amount in wei

Returns

DATA - 32-byte block hash of the newly created transaction

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "tenderly_setBalance",
  "params": [["0x0d2026b3EE6eC71FC6746ADb6311F6d3Ba1C000B", "0xf39Fd6e51aad88F6F4ce6aB8827279cffFb92266"], "0xDE0B6B3A7640000"],
  "id": "1234"
}

example.json

{
  "jsonrpc": "2.0",
  "method": "tenderly_setBalance",
  "params": ["0x0d2026b3EE6eC71FC6746ADb6311F6d3Ba1C000B", "0xDE0B6B3A7640000"],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": "0xc5b2c658f5fa236c598a6e7fbf7f21413dc42e2a41dd982eb772b30707cba2eb",
  "id": "1234"
}

`tenderly_addBalance`

Adds the balance to the provided account or accounts. Parameters

ADDRESS/ADDRESSES - a string or an array of account addresses
AMOUNT - hex-encoded number of an amount in wei

Returns

DATA - 32-byte block hash of the newly created transaction

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "tenderly_addBalance",
  "params": [["0x0d2026b3EE6eC71FC6746ADb6311F6d3Ba1C000B"], "0xDE0B6B3A7640000"],
  "id": "1234"
}

example.json

{
  "jsonrpc": "2.0",
  "method": "tenderly_addBalance",
  "params": ["0x0d2026b3EE6eC71FC6746ADb6311F6d3Ba1C000B", "0xDE0B6B3A7640000"],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": "0xc5b2c658f5fa236c598a6e7fbf7f21413dc42e2a41dd982eb772b30707cba2eb",
  "id": "1234"
}

`tenderly_setErc20Balance`

Sets the token balance for the wallet on the provided erc20 contract.

tenderly_setErc20Balance writes the new balance directly to the token contract’s storage and does not emit an ERC-20 Transfer event. If your downstream tooling (indexers, subgraphs, accounting) relies on Transfer events to track balances, use tenderly_addErc20Balance instead, it emits a synthetic Transfer log for each funded account.

Parameters

TOKEN_ADDRESS - address of the ERC20 contract
WALLET - address of the wallet that will get topped up
VALUE - 32-byte hash representing the wei value of the tokens

Returns DATA - 32-byte hash of the newly created transaction (storage override is committed via transaction) Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "tenderly_setErc20Balance",
  "params": [
    "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    "0x40BdB4497614bAe1A67061EE20AAdE3c2067AC9e",
    "0xDE0B6B3A7640000"
  ],
  "id": 3640
}

Example response

example.json

{
  "id": 3640,
  "jsonrpc": "2.0",
  "result": "0x8a84686634729c57532b9ffa4e632e241b2de5c880c771c5c214d5e7ec465b1c"
}

`tenderly_addErc20Balance`

Adds the specified amount of tokens to one or more wallets on the provided ERC-20 contract. Unlike tenderly_setErc20Balance, this method emits a synthetic Transfer event for every funded account, so indexers, subgraphs, and any tooling that reconciles balances from logs stay in sync with the resulting state. The emitted log has the standard ERC-20 Transfer(address,address,uint256) topic, uses the transaction sender as the from address and the funded wallet as the to address, and carries the added amount in the data field. Parameters

TOKEN_ADDRESS - address of the ERC-20 contract
WALLETS - array of wallet addresses that will receive the tokens
VALUE - 32-byte hash representing the wei amount of tokens to add to each wallet

Returns DATA - 32-byte hash of the newly created transaction (storage override is committed via transaction) Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "tenderly_addErc20Balance",
  "params": [
    "0xA0b86991c6218b36c1d19D4a2e9Eb0cE3606eB48",
    [
      "0x40BdB4497614bAe1A67061EE20AAdE3c2067AC9e",
      "0xBd8DaA414Fda8a8A129F7035e7496759C5aF8570"
    ],
    "0xDE0B6B3A7640000"
  ],
  "id": 3641
}

Example response

example.json

{
  "id": 3641,
  "jsonrpc": "2.0",
  "result": "0x8a84686634729c57532b9ffa4e632e241b2de5c880c771c5c214d5e7ec465b1d"
}

`tenderly_setMaxErc20Balance`

Tops up the wallet address with maximum possible token balance (primarily intended for tokens that don’t have a simple balance mapping) on the provided erc20 contract.

Like tenderly_setErc20Balance, this method writes directly to storage and does not emit an ERC-20 Transfer event. Use tenderly_addErc20Balance when you need indexers or log-based tooling to pick up the balance change.

Parameters

YIELD_TOKEN_ADDRESS - address of the ERC20 contract
WALLET - address of the wallet that would get topped up

Returns DATA - 32-byte hash of the newly created transaction (storage override is committed via transaction) Example request

example.json

{
  "id": 0,
  "jsonrpc": "2.0",
  "method": "tenderly_setMaxErc20Balance",
  "params": [
    "0xae7ab96520DE3A18E5e111B5EaAb095312D7fE84",
    "0xb5f45E52649123117C175B2016Ed3fCd26f9bE06"
  ]
}

Example response

example.json

{
  "id": 0,
  "jsonrpc": "2.0",
  "result": "0x8fb202d4612be9f6e96b955b4e5bd002cde4d79bec8a6d1b7d35976f124636a4"
}

`tenderly_setStorageAt`

Sets the storage of the provided address at the provided slot. Parameters

ADDRESS - the address where the storage will be overridden
SLOT - 32-byte hash representing the storage slot key
VALUE - 32-byte hash representing the value at the key slot

Returns

DATA - 32-byte hash of the newly created transaction (storage override is committed via transaction)

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "tenderly_setStorageAt",
  "params": [
    "0x3Df2f692132f55b97cc9DA04A1fFFEA82F5d710b",
    "0x8111de210bcfef10861a4ab6df0f4838296bd61d5a8f02dca283ed3b72a47bba",
    "0x0000000000000000000000000000000000000000000000000000000000000000"
  ],
  "id": "1"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": "0xc5b2c658f5fa236c598a6e7fbf7f21413dc42e2a41dd982eb772b30707cba2eb",
  "id": "1234"
}

`evm_snapshot`

Returns a snapshot ID that allows you to revert a Virtual Environment to a previous point (same as block hash from evm_getLatest). Parameters Returns

DATA - hash of the latest block produced by the Virtual Environment (Snapshot ID)

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "evm_snapshot",
  "params": [],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": "0xfdb5a15fe652e0f47e4312df749f8cc1769d5e70f0bf3f26a4e231bb6a550f8d",
  "id": "1234"
}

`evm_revert`

Reverts the state of the Virtual Environment to a previous snapshot. Parameters

DATA - ID of the snapshot

Returns

BOOLEAN - operation success flag

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "evm_revert",
  "params": ["0xfdb5a15fe652e0f47e4312df749f8cc1769d5e70f0bf3f26a4e231bb6a550f8d"],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": true,
  "id": "1234"
}

`tenderly_setCode`

Sets the code at a particular location. Example Parameters

ADDRESS - Contract address
DATA - Bytecode

Returns

NUMBER - transaction hash

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "tenderly_setCode",
  "params": [
    "0x1",
    "0x1"
  ],
  "id": "1234"
}

Network Mirror Mode sync control

The following methods control Network Mirror Mode, they start, stop, step, rewind, and inspect the continuous sync between a Virtual Environment and its parent network.

While Network Mirror Mode sync is active, other Admin RPC cheatcodes (for example tenderly_setBalance, tenderly_setStorageAt, tenderly_sendBlock) are disabled. Pause sync with tenderly_stopSync first if you need them to take effect immediately.

`tenderly_startSync`

Starts continuous sync between the Virtual Environment and its parent network. New parent-network blocks are absorbed as they’re produced, and any transactions in the Virtual Environment’s mempool are prepended (in FIFO order) to the next synced block. Parameters None. Returns

BOOLEAN - true if sync was started

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "tenderly_startSync",
  "params": [],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": true,
  "id": "1234"
}

`tenderly_stopSync`

Stops any in-progress sync. The Virtual Environment stays at its current block; you can resume with tenderly_startSync or advance manually with tenderly_syncNext. Use this before calling other Admin RPC cheatcodes when Mirror Mode is active. Parameters None. Returns

BOOLEAN - true if sync was stopped (or already stopped)

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "tenderly_stopSync",
  "params": [],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": true,
  "id": "1234"
}

`tenderly_syncNext`

Syncs the next single parent-network block onto the Virtual Environment. Any pending Virtual Environment transactions are prepended to that block in FIFO order. Useful for stepping through sync one block at a time. Parameters None. Returns

DATA - 32-byte block hash of the newly synced block

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "tenderly_syncNext",
  "params": [],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": "0x51e0a03f19e0c154b16363086aa6bbf22ad4582b0515b0a3a00519015f06246f",
  "id": "1234"
}

`tenderly_revertSync`

Rewinds the Virtual Environment by N synced blocks, undoing their effect on Virtual Environment state. The default is 10 blocks. Use this to step the Mirror-Mode Virtual Environment back to an earlier point in the parent network’s history. Parameters

QUANTITY (optional) - hex-encoded number of blocks to rewind. Defaults to 0xa (10).

Returns

DATA - 32-byte block hash of the block the Virtual Environment is now positioned at

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "tenderly_revertSync",
  "params": ["0xa"],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": "0xfdb5a15fe652e0f47e4312df749f8cc1769d5e70f0bf3f26a4e231bb6a550f8d",
  "id": "1234"
}

`tenderly_getSyncStatus`

Returns the current sync state of the Virtual Environment, including whether sync is active, how far behind the parent network it is, and the latest synced block. Parameters None. Returns

OBJECT - sync status with the following fields:
- active - BOOLEAN, true if sync is currently running
- lag - QUANTITY, number of blocks the Virtual Environment is behind the parent network
- latestSyncedBlock - QUANTITY, block number of the latest block synced onto the Virtual Environment
- parentLatestBlock - QUANTITY, block number of the latest block on the parent network

Example request

example.json

{
  "jsonrpc": "2.0",
  "method": "tenderly_getSyncStatus",
  "params": [],
  "id": "1234"
}

Example response

example.json

{
  "jsonrpc": "2.0",
  "result": {
    "active": true,
    "lag": 0,
    "latestSyncedBlock": 22845130,
    "parentLatestBlock": 22845130
  },
  "id": "1234"
}

​evm_increaseTime

​evm_setNextBlockTimestamp

​tenderly_setNextBlockTimestamp

​evm_increaseBlocks

​eth_sendTransaction

​eth_createAccessList

​evm_getLatest

​tenderly_setBalance

​tenderly_addBalance

​tenderly_setErc20Balance

​tenderly_addErc20Balance

​tenderly_setMaxErc20Balance

​tenderly_setStorageAt

​evm_snapshot

​evm_revert

​tenderly_setCode

​Network Mirror Mode sync control

​tenderly_startSync

​tenderly_stopSync

​tenderly_syncNext

​tenderly_revertSync

​tenderly_getSyncStatus

`evm_increaseTime`

`evm_setNextBlockTimestamp`

`tenderly_setNextBlockTimestamp`

`evm_increaseBlocks`

`eth_sendTransaction`

`eth_createAccessList`

`evm_getLatest`

`tenderly_setBalance`

`tenderly_addBalance`

`tenderly_setErc20Balance`

`tenderly_addErc20Balance`

`tenderly_setMaxErc20Balance`

`tenderly_setStorageAt`

`evm_snapshot`

`evm_revert`

`tenderly_setCode`

Network Mirror Mode sync control

`tenderly_startSync`

`tenderly_stopSync`

`tenderly_syncNext`

`tenderly_revertSync`

`tenderly_getSyncStatus`