Skip to content

Latest commit

 

History

History
109 lines (72 loc) · 2.32 KB

README.md

File metadata and controls

109 lines (72 loc) · 2.32 KB
Raw

SUAVE Suapp Examples

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

See also:

Writings:

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:

  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 🛠️