SUAVE Suapp Examples

This repository contains several examples and useful references for building Suapps!

See also:

• suave-geth source
• Flashbots Collective: SUAVE Forum

Writings:

• The Future of MEV is SUAVE
• The MEVM, SUAVE Centauri, and Beyond

Getting Started

# Clone this repository
git clone https://github.com/flashbots/suapp-examples.git

Compile the examples

Install Foundry:

curl -L https://foundry.paradigm.xyz | bash
foundryup

Install dependencies:

forge install

Compile:

forge build

Start the local devnet

TL;DR

1. Install prerequisites:

   • Docker
   • Kurtosis

2. Run

   # Launch kurtosis devnet + sidecar docker-compose with SUAVE
   make devnet-up
   
   # Point SUAVE examples to the devnet
   export BUILDER_URL=http://el-4-geth-builder-lighthouse:8545
   export L1_PRIVKEY=bcdf20249abf0ed6d944c0288fad489e33f66b3960d9e6229c1cd214ed3bbe31
   
   # Run
   go run examples/app-ofa-private/main.go
   
   # Tear-down
   make devnet-down
   

Notes:

1. If you are Mac OS user, you might want to consider using OrbStack instead of Docker Desktop.

2. Some of the tests (app-ofa-private, for example) will need Eth devnet to progress beyond dencun fork. Wait out ~5m after the start before running them (roughly slot 128).

Details

Above setup will (among other things) deploy:

• SUAVE devnet RPC on http://127.0.0.1:8545
• Eth devnet RPC on http://127.0.0.1:8555
• SUAVE explorer on http://127.0.0.1:8080
• Eth explorer on http://127.0.0.1:18080
• MEV Boost Relay Overview on http://127.0.0.1:9060

All Eth components are provisioned by ethereum-package from kurtosis. Please check https://github.com/kurtosis-tech/ethereum-package for more info.

Run the examples

Check out the /examples/ folder for several example Suapps and main.go files to deploy and run them!

Happy hacking 🛠️