Skip to main content
Network Mirror Mode keeps a Virtual Environment continuously aligned with its parent network. New mainnet blocks are absorbed into the Virtual Environment as they’re produced, and a UI-visible mempool collects any transactions you submit. Your transactions are prepended to the next synced block in the order they arrive.
Network Mirror Mode is available on the paid plan. To enable it for your account, contact our sales team.
Network Sync page showing sync status counters, block-lag chart, time controls, and a sync-operations table with tenderly_startSync and tenderly_stopSync entries

Network Sync page for a Mirror-Mode Virtual Environment: block-lag chart, sync status counters, and the Rewind / Sync block / Start auto-sync controls.

When to use it

Use Network Mirror Mode when you need to evaluate behavior against live network conditions rather than a frozen fork:
  • Test how your contracts behave against today’s oracle prices, pool reserves, or governance state.
  • Stage a transaction and control when it executes relative to the next synced block.
  • Pause the live network at a specific block to inspect state, then continue replaying.
  • Compare your Virtual Environment’s storage and balances against mainnet baselines over time.
  • Fork at a past block and replay real history forward, for example to backtest a token position’s realized yield.
If you need a frozen point-in-time fork, use a standard Virtual Environment. If you need real-time state without mempool semantics or block-for-block ticking, use State Sync.

How sync works

A mainnet tick produces a Virtual Environment tick within roughly 12 seconds. Each tick brings in the next block’s transactions and applies them on top of your Virtual Environment’s current state. Transactions you submit sit in the Virtual Environment’s mempool until the next sync tick, at which point they’re prepended to the synced block in FIFO order. Your transactions execute first; the synced mainnet transactions execute after them, against the resulting state. A “live” indicator shows whether the Virtual Environment is keeping up:
Network sync status counters showing Mainnet head 25,644,372, Virtual Environment head 25,634,318, and 10,054 blocks behind mainnet in orange

Sync status header: Mainnet head, Virtual Environment head, and how many blocks behind mainnet the Virtual Environment currently is.

Time controls

The time-control strip lets you move the Virtual Environment’s clock relative to mainnet. Each control maps directly to an RPC call you can also invoke from your own code: The speed picker (0.5×, , , ) sets the tick delay between sync calls (24s, 12s, 6s, 3s per block respectively); matches mainnet pace.
Rewind, Sync block, and Start auto-sync buttons with the speed menu open showing 0.5x, 1x mainnet pace, 2x, and 4x options

Time-control strip: Rewind, Sync block, and Start auto-sync with speed multiplier (0.5×, 1×, 2×, 4×).

To check sync progress programmatically, use tenderly_getSyncStatus.

State drift lens

The State Drift lens shows where your Virtual Environment has diverged from mainnet. Useful for finding the contract or wallet your test actually moved. Two sub-views share one surface: The lens is scoped to the contracts and wallets you’re watching plus any contracts the current session has touched.
State drift view inside Network Sync, showing the State and Balance tabs and the Track variable / Track balance buttons

State Drift tab: State and Balance sub-views with Track variable and Track balance controls.

Block-context fidelity

Network Mirror Mode commits to one-to-one parity with the parent network on the dimensions that most often affect contract behavior:
  • Block-context alignment: block.timestamp, baseFee, coinbase, and prevrandao reflect mainnet values.
  • Gas-market parity: current mainnet gas pricing applies to transactions you submit.
  • Sub-tick latency: a mainnet tick produces a Virtual Environment tick within roughly 12 seconds.

Cheatcode behavior

Because Network Mirror Mode is continuously importing real blocks, some Admin RPC cheatcodes behave differently than on a standard Virtual Environment. See the Admin RPC reference for the full cheatcode list.

Mode comparison

Known limitations

  • Single-network only. Network Mirror Mode applies per Virtual Environment; combining it with multichain Virtual Environments isn’t currently supported.

See also