Skip to main content
This page provides installation instructions for supersim.
1

Prerequisites: `foundry`

supersim requires anvil, which is installed alongside the Foundry toolchain.Follow the Foundry toolchain guide for detailed instructions.
2

Install `supersim`

Either download precompiled binaries or install using Homebrew:
  • Precompiled binaries: Download the executable for your platform from the GitHub releases page.
  • Homebrew: Install Homebrew (OS X, Linux), and then run:
brew tap ethereum-optimism/tap
brew install supersim
3

Start `supersim` in vanilla mode

Start supersim in vanilla mode by running:
supersim
Vanilla mode will start 3 chains, with the OP Stack contracts already deployed.
  • (1) L1 Chain
    • Chain 900
  • (2) L2 Chains
    • Chain 901
    • Chain 902

Next steps

  • Continue to the First Steps tutorial to try L1 to L2 message passing.
  • Explore Supersim features, particularly in vanilla mode, which starts 3 chains (L1 and L2).