{"id":20433883,"url":"https://github.com/flashbots/suave-specs","last_synced_at":"2025-03-05T06:24:21.714Z","repository":{"id":208982821,"uuid":"698194244","full_name":"flashbots/suave-specs","owner":"flashbots","description":"☀️ SUAVE Alpha Protocol Specifications","archived":false,"fork":false,"pushed_at":"2024-10-09T19:57:45.000Z","size":1375,"stargazers_count":38,"open_issues_count":8,"forks_count":8,"subscribers_count":22,"default_branch":"main","last_synced_at":"2025-02-25T15:16:46.555Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"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":null,"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-09-29T11:20:43.000Z","updated_at":"2024-12-20T02:43:07.000Z","dependencies_parsed_at":"2023-12-21T18:27:21.530Z","dependency_job_id":"710b9fd8-0769-4333-b0ee-5d4b707c1605","html_url":"https://github.com/flashbots/suave-specs","commit_stats":null,"previous_names":["flashbots/suave-specs"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fsuave-specs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fsuave-specs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fsuave-specs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/flashbots%2Fsuave-specs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/flashbots","download_url":"https://codeload.github.com/flashbots/suave-specs/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241976534,"owners_count":20051658,"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:22:10.070Z","updated_at":"2025-03-05T06:24:21.692Z","avatar_url":"https://github.com/flashbots.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!-- no toc --\u003e\n# ☀️ SUAVE Protocol Specifications\n\n\u003cdiv className=\"hide-in-docs\"\u003e\n\n[![Rigil specs ./specs/rigil/](https://img.shields.io/badge/jump%20into-Rigil%20Specs-purple.svg)](./specs/rigil/)\n[![Docs at https://suave.flashbots.net/](https://img.shields.io/badge/read-SUAVE%20docs-blue.svg)](https://suave.flashbots.net/)\n[![Join the discourse at https://collective.flashbots.net/](https://img.shields.io/badge/chat-on%20Flashbots%20forum-blue.svg)](https://collective.flashbots.net/)\n\nThis repository hosts the current SUAVE protocol specifications. For SUAPP developers please check out our [developer docs](https://suave.flashbots.net/).\n\nDiscussions about design rationale and proposed changes can be brought up and discussed on the [Flashbots forum](https://collective.flashbots.net/). Solidified, agreed-upon changes to the spec can be made through pull requests.\n\n\u003cdiv class=\"warning\"\u003e\n\n⚠️ The SUAVE protocol is still in alpha state, and [the code](https://github.com/flashbots/suave-geth) is the most up-to-date protocol spec. The goal of these notes is to gradually evolve into an implementation-agnostic specification. ⚠️\n\n\u003c/div\u003e\n\n\u003c/div\u003e\n\n---\n\n# About Suave\n\nSUAVE - *Single Unifying Auction for Value Expression* - is a platform for building MEV applications such as OFAs and block builders in a decentralized and private way.\n\nRead more about SUAVE:\n- https://writings.flashbots.net/the-future-of-mev-is-suave\n- https://writings.flashbots.net/mevm-suave-centauri-and-beyond\n\nSee also: [suave-geth](https://github.com/flashbots/suave-geth), [suapp-examples](https://github.com/flashbots/suapp-examples)\n\n---\n\n# Specs - In-development\n\nSpecifications for the SUAVE protocol are split into two main tracks, Centauri and Andromeda.\n\n| Testnet                       | Phase                                               | ChainID    | Specs                                                                                                                                                                                                                                                                                                   |\n| ----------------------------- | --------------------------------------------------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |\n| [**Rigil**](./specs/rigil/)   | [Big Bang](/assets/future_roadmap_draft.png)        | `16813125` | • [SUAVE chain](./specs/rigil/suave-chain.md) \u003cbr/\u003e • [MEVM](./specs/rigil/mevm.md) \u003cbr/\u003e • [Precompiles](./specs/rigil/precompiles.md) \u003cbr/\u003e • [Confidential Data Store](./specs/rigil/confidential-data-store.md) \u003cbr/\u003e • [Bridge](./specs/rigil/bridge.md) \u003cbr/\u003e • [Kettle](./specs/rigil/kettle.md) |\n| [**Toliman**](./specs/toliman/) | [Big Bang](/assets/future_roadmap_draft.png) |  `33626250`          | • [SUAVE chain](./specs/toliman/suave-chain.md) \u003cbr/\u003e • [MEVM](./specs/toliman/mevm.md) \u003cbr/\u003e • [Precompiles](./specs/toliman/precompiles.md) \u003cbr/\u003e • [Confidential Data Store](./specs/toliman/confidential-data-store.md) \u003cbr/\u003e • [Bridge](./specs/toliman/bridge.md) \u003cbr/\u003e • [Kettle](./specs/toliman/kettle.md) |\n| [**Sirrah**](./specs/sirrah/) | [Proto-Collision](/assets/future_roadmap_draft.png) |            |                                                                                                                                                                                                                                                                                                         |\n\n## Roadmap\n\n**Centauri* is focused on exploration and developer experience, serving as a spec for the secure instantiation. The plan is a progression of three testnets in the direction of increasing functionality and scalability.*\n\n**Andromeda* is the secure instantiation using SGX and cryptography, focusing on privacy with trust minimization. The plan is a progression of three milestones in the direction of better hardening and trust minimization.*\n\n**Proto-Collisions* are plans to sync up between these two development tracks. They represents points where parts of Centauri testnets can be run in secure and trust minimized fashion. Permissioned components from Proto-Collisions, if self-contained, could be used with Ethereum mainnet.*\n\n**Collision* is where the entirety of the SUAVE protocol can be safely deployed for use with Ethereum mainnet in a trust minimized and permissionless fashion.*\n\n![SUAVE Roadmap](/assets/future_roadmap_draft.png)\n\n---\n\n# Contributing\n\nYou are welcome to open PRs and issues. We invite you to discuss your ideas in the [Flashbots Forum](https://collective.flashbots.net/) for greater visibility and to avoid doing work that is unlikely to be widely accepted and merged into the core specs.\n\n\u003cdiv className=\"hide-in-docs\"\u003e\n\nFor creating tables of contents, we use the [\"Markdown All in One\" VS code extension](https://marketplace.visualstudio.com/items?itemName=yzhang.markdown-all-in-one). This extension comes with a lot of keyboard shortcuts, which may override the ones you are already using. You can disable keyboard shortcuts for this extension by going to \"Settings -\u003e Keyboard Shortcuts\" (cmd+K cmd+S) and searching for `markdown.ext` (see [#22](https://github.com/flashbots/suave-specs/pull/22) for more details).\n\nHowever, we don't need the ToCs and some other content (like this paragraph) rendered in the documentation frontend. Therefore, please add the `\u003cdiv className=\"hide-in-docs\"\u003e\u003c/div\u003e` to any content that should not appear in the FE.\n\n\u003c/div\u003e\n\n---\n\nMade with ☀️ by the ⚡🤖 collective.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflashbots%2Fsuave-specs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fflashbots%2Fsuave-specs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fflashbots%2Fsuave-specs/lists"}