{"id":20433854,"url":"https://github.com/flashbots/suapp-examples","last_synced_at":"2026-01-31T23:15:00.387Z","repository":{"id":207732443,"uuid":"713867109","full_name":"flashbots/suapp-examples","owner":"flashbots","description":"SUAVE Application Examples","archived":false,"fork":false,"pushed_at":"2024-12-04T09:29:50.000Z","size":465,"stargazers_count":57,"open_issues_count":8,"forks_count":20,"subscribers_count":18,"default_branch":"main","last_synced_at":"2025-04-02T06:07:06.438Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/flashbots/suave-geth/","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/flashbots.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-11-03T12:03:09.000Z","updated_at":"2025-03-27T05:52:59.000Z","dependencies_parsed_at":null,"dependency_job_id":"c75b274d-ec6c-48ad-8aa3-af85eebdfb7b","html_url":"https://github.com/flashbots/suapp-examples","commit_stats":null,"previous_names":["flashbots/suapp-examples"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fsuapp-examples","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fsuapp-examples/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fsuapp-examples/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fsuapp-examples/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flashbots","download_url":"https://codeload.github.com/flashbots/suapp-examples/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247999861,"owners_count":21031046,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-15T08:21:50.358Z","updated_at":"2026-01-31T23:15:00.357Z","avatar_url":"https://github.com/flashbots.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# SUAVE Suapp Examples\n\nThis repository contains several [examples and useful references](/examples/) for building Suapps!\n\n---\n\nSee also:\n\n- [suave-geth source](https://github.com/flashbots/suave-geth)\n- [Flashbots Collective: SUAVE Forum](https://collective.flashbots.net/c/suave/27)\n\nWritings:\n\n- [The Future of MEV is SUAVE](https://writings.flashbots.net/the-future-of-mev-is-suave)\n- [The MEVM, SUAVE Centauri, and Beyond](https://writings.flashbots.net/mevm-suave-centauri-and-beyond)\n\n---\n\n## Getting Started\n\n```bash\n# Clone this repository\ngit clone https://github.com/flashbots/suapp-examples.git\n```\n\n---\n\n## Compile the examples\n\nInstall [Foundry](https://getfoundry.sh/):\n\n```bash\ncurl -L https://foundry.paradigm.xyz | bash\nfoundryup\n```\n\nInstall dependencies:\n\n```bash\nforge install\n```\n\nCompile:\n\n```bash\nforge build\n```\n\n---\n\n## Start the local devnet\n\n### TL;DR\n\n1. Install prerequisites:\n\n   - [Docker](https://docs.docker.com/engine/install/)\n   - [Kurtosis](https://docs.kurtosis.com/install/)\n\n2. Run\n\n    ```bash\n    # Launch kurtosis devnet + sidecar docker-compose with SUAVE\n    make devnet-up\n\n    # Point SUAVE examples to the devnet\n    export BUILDER_URL=http://el-4-geth-builder-lighthouse:8545\n    export L1_PRIVKEY=bcdf20249abf0ed6d944c0288fad489e33f66b3960d9e6229c1cd214ed3bbe31\n\n    # Run\n    go run examples/app-ofa-private/main.go\n\n    # Tear-down\n    make devnet-down\n    ```\n\n\u003e\n\u003e **Notes:**\n\u003e\n\u003e 1. If you are Mac OS user, you might want to consider using\n\u003e    [OrbStack](https://orbstack.dev/) instead of Docker Desktop.\n\u003e\n\u003e 2. Some of the tests (`app-ofa-private`, for example) will need Eth\n\u003e    devnet to progress beyond dencun fork.  Wait out ~5m after the\n\u003e    start before running them (roughly slot 128).\n\u003e\n\n### Details\n\nAbove setup will (among other things) deploy:\n\n- SUAVE devnet RPC on `http://127.0.0.1:8545`\n- Eth devnet RPC on `http://127.0.0.1:8555`\n- SUAVE explorer on `http://127.0.0.1:8080`\n- Eth explorer on `http://127.0.0.1:18080`\n- MEV Boost Relay Overview on `http://127.0.0.1:9060`\n\nAll Eth components are provisioned by `ethereum-package` from kurtosis.\nPlease check `https://github.com/kurtosis-tech/ethereum-package` for more info.\n\n---\n\n## Run the examples\n\nCheck out the [`/examples/`](/examples/) folder for several example Suapps and `main.go` files to deploy and run them!\n\n---\n\nHappy hacking 🛠️\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflashbots%2Fsuapp-examples","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflashbots%2Fsuapp-examples","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflashbots%2Fsuapp-examples/lists"}