Mainnet Simulation

As the stagenet replays historical mainnet blocks, it can selectively re-execute transactions from each block. This lets you recreate production blockchain behaviour directly on your stagenet, enabling realistic testing.

• Test smart contracts with realistic third-party protocols (e.g. a yield vault interacting with Uniswap).
• Run bots (e.g. arbitrage, liquidation) against real historical activity and analyse their performance.
• Validate clients (e.g. dapp UIs, wallets) by observing how they respond to real transaction flows.

How Simulation Works

Mainnet simulation works by designating simulated accounts. When you mark an account as simulated, your stagenet will automatically re-execute every mainnet transaction involving that account as it replays each block. For example, if you simulated Aave’s lending pool, the stagenet would re-run all its supply, borrow, repay, and withdraw transactions, exactly as they happened on mainnet.

Setting Simulation Up

By selecting a set of simulated accounts, you can recreate specific on-chain conditions in a realistic, private testnet environment. There are two ways to start mainnet simulation on your stagenet:

• Use a template — quickly simulate pre-configured on-chain entities, like a DeFi protocol.
• Manual selection — specify any mainnet address you want to simulate.