Mainnet Replay

Mainnet Replay is the state-sync system behind Stagenets.

When you create a Stagenet, it starts from the target chain’s current block. From there, it replays new blocks from the target chain one after another. For each replayed block, the Stagenet:

1. Executes any pending transactions submitted to the Stagenet.
2. Updates untouched state to match the target chain at the end of the replayed block.

This gives you a private environment that keeps following production state — oracle prices, DeFi protocol state, token balances — while your own transactions persist.

In this section

• State Behaviour — how untouched and modified state behave during replay.
• Block Context — the block values your transactions execute against.
• Mainnet Follow — keep selected state synced to the live chain, even after it is touched.
• State Reset — periodically clear accumulated drift while keeping your wallets intact.