Skip to content

Commit

Permalink
Some comments from Chris
Browse files Browse the repository at this point in the history
  • Loading branch information
andytudhope committed Oct 25, 2023
1 parent 9cd7b14 commit 54f50e8
Show file tree
Hide file tree
Showing 6 changed files with 48 additions and 49 deletions.
2 changes: 0 additions & 2 deletions docs/how-to/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -19,8 +19,6 @@ SUAVE is focused on delivering credible, confidential computation that enables y

> **SUAVE enables anyone to build and deploy MEV applications, on a decentralized network, which were not possible until today.**
## What's in the sausage?

The how to guides in this section are like all of our recipes. Like any good recipe, our guides do not provide history and background explanation: they show you how to do interesting and delicious things.

1. [How to run SUAVE](/how-to/run-suave), test your node, and participate in the network.
44 changes: 3 additions & 41 deletions docs/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,9 +18,7 @@ import GridBlock from "@site/src/components/GridBlock/GridBlock.tsx";

If MEV only benefits the few, we cannot realize the permissionless, censorship-resistant systems that crypto promises.

SUAVE unifies how we coordinate without forcing any one mechanism onto everyone. SUAVE does not replace other blockchains: it is intended to aggregate and coordinate all the things that ultimately change the state of other chains.

SUAVE is a permissionless and open marketplace for mechanisms. SUAVE enables anyone to innovate, design, and deploy different applications that mitigate issues caused by MEV on any other blockchain. Such "MEV applications" can provide rich incentives that help us steer clear of the centralizing economic forces both within and beyond crypto.
SUAVE is a permissionless and open marketplace for mechanisms. SUAVE enables anyone to innovate, design, and deploy different applications that mitigate issues caused by MEV on any other blockchain. Such "SUAPPs" can provide rich incentives that help us steer clear of the centralizing economic forces both within and beyond crypto.

Reducing the economic centralization pressure on other blockchains enables:

Expand All @@ -41,47 +39,11 @@ Reducing the economic centralization pressure on other blockchains enables:

SUAVE is _unifying infrastructure_ in which the incentives for all actors in the transaction supply network are aligned around shared ownership, rather than private economies of scale.

We must make sure block building - and the power it implies - ends up meaningfully decentralized, because decentralization is a means towards the end where crypto helps us realize permissionless, censorship-resistant, and verifiable public systems which are genuinely good for the communities who use them.

## About this site

This site encourages you to move through a specific flow in order to start building the _future of coordination_.

1. Begin with **[tutorials](/)**. These are _learning-oriented_. They focus on practical skills, not theoretical knowledge. Our goal here is that you enjoy the experience and gain confidence, not that you become an expert.
2. Grow with the **[how to guides](/how-to/)**. These are _task-oriented_. You can think of them like recipes. Following a recipe requires basic competence. Recipes do not give you context or history: they will help you do stuff. All the recipes taken together help frame a general picture of how SUAVE enables you.
2. Grow with the **[how to guides](/how-to/)**. These are _task-oriented_. You can think of them like recipes. Recipes do not give you context or history: they will help you do stuff.
3. Consult the **[technical specs](/technical/)**. These are _information-oriented_ and provide you with up-to-date certainty about the software we provide. They are our treasure maps.
4. Refine your **[understanding of MEV](/understand/)**. This section is _discussion-oriented_. It does not present "the right way", but rather encourages you to reflect on "the deep why", ideally in dialogue with friends. Why does it matter that we work on MEV?

<AlignItems horizontal="center" vertical="center" sideMargin={0}>
<div>
<img alt="Website structure" src={require('/static/img/diatraxis.png').default} usemap="#imagemap" />
<map name="imagemap">
<area shape="rect" coords="50,50,250,250" href="/" alt="Tutorials" />
<area shape="rect" coords="330,0,550,250" href="/how-to" alt="How To Guides" />
<area shape="rect" coords="20,300,250,600" href="/understand" alt="Understanding MEV" />
<area shape="rect" coords="330,300,600,600" href="/technical" alt="Technical Specs" />
</map>
</div>
</AlignItems>

## Unified, decentralized

After [formalizing the threat posed by MEV](https://arxiv.org/pdf/1904.05234.pdf), and creating [MEV-Geth](https://github.com/flashbots/mev-geth) to begin addressing it, [Flashbots](https://medium.com/flashbots/frontrunning-the-mev-crisis-40629a613752) has collaborated with many people and organizations to build neutral, open-source software like [MEV-Boost](https://github.com/flashbots/mev-boost) and protocols like [MEV-Share](https://github.com/flashbots/MEV-Share). Our work has prevented the worst effects of MEV, though many problems remain.

SUAVE is our means of _keeping block building decentralized_ by creating an _open marketplace for mechanisms_ for any kind of MEV application, which require one (or many) of the following:

1. **private data**, e.g., auctions, block building
2. **coordination within block times**, e.g., block building, trade routing and filling
3. **access to fresh off-chain data**, e.g., trading strategies conditional on centralized exchange prices or transactions that are conditional on other transactions
4. **commitments** of various kinds, e.g., shared sequencers for rollups, new kinds of DEXes and bridges
5. **too much gas to do on-chain** because of how much compute they use.

Any mechanism that strikes a meaningful balance between revenue optimality and efficiency will have broad application. SUAVE is a blockchain for many such applications and so exhibits second-order effects. For instance, keeping block building decentralized by creating an open marketplace for mechanisms could result in SUAVE being an effective, unified sequencing layer for other blockchains.

We expect that SUAVE will find increasingly wider application as more people build better mechanisms with it.

## About Flashbots

Our primary focus is to enable a permissionless, transparent, and fair ecosystem for MEV. We achieve this in three ways: _Illuminate the Dark Forest_, _Democratize Extraction_, and _Distribute Benefits_.

You can interact with Flashbots on our [Discourse forum](https://collective.flashbots.net/) or in [Discord](https://discord.gg/7hvTycdNcK). Our work is open source and you can follow our progress in each [Github repository](https://github.com/flashbots/).
4. Refine your **[understanding of MEV](/understand/)**. This section is _discussion-oriented_. It does not present "the right way", but rather encourages you to reflect on "the deep why", ideally in dialogue with friends. Why does it matter that we work on MEV?
10 changes: 5 additions & 5 deletions docs/novel-use-cases.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -22,9 +22,9 @@ Our research team suggests that [interoperability with web2 services may be one

They suggest thinking about [anti-mechanisms](https://www.youtube.com/watch?v=5v_wBkrIJhs) for web2 services as a fun, productive use of DarkDAOs. That is, instead of building collusion rings to buy votes, we can build collusion rings to allow permissionless interaction with web2.

While interesting, this page is split into **Cryptonative (short-term)**, **SGX (medium-term)** and **Interoperable (long-term)** so that you know which solutions may be possible to work on for the internal hackathon.
While interesting, this page is split into **Short-term**, **Medium-term** and **Long-term** so that you know which solutions may be possible to work on for the internal hackathon.

## Crpytonative (short-term)
## Short-term

### Ticketmasters

Expand All @@ -50,7 +50,7 @@ Frens from Pantera built an example [here](https://github.com/lstephanian/SUIFT)

### SAUVE router

_Details to come from dmarzzz._
Please [browse through this presentation](https://docs.google.com/presentation/d/19km1xqXrp6HClAOmyUwtq7lADM7BEUsPbTUE7zCwhCw/edit#slide=id.g2923336d3ff_0_569) to get an overview of the idea.

**Bonus: Add SUAVE-router to metamask page**

Expand All @@ -70,7 +70,7 @@ Deploy [this](https://blog.essential.builders/introducing-erc-7521-generalized-i

Basically this is to exercise the persistent storage. It can be an order that is partially filled, but raises the fee offered over time according to a fixed strategy. The entire curve doesn’t have to be revealed, only a short time window of the next offered price. (Confidentiality mechanism).

## SGX (medium-term)
## Medium-term

Inspired by [Andrew's shitposts](https://flashbots.notion.site/flashbots/SuApp-shitposts-f404c62d046545c2ae256a0ea8e6f2cd), some of which were included in short-term above.

Expand All @@ -86,7 +86,7 @@ SUAVE got that privacy, Telegramgram bots today just escrow user keys. This incr

Either to a centralized third party, or a completely separate SGX enclave. This could use [RAVE](https://github.com/PufferFinance/rave) from PufferFi.

## Interoperable (long-term)
## Long-term

### Friend.tech with Twitter

Expand Down
2 changes: 1 addition & 1 deletion docs/sidebars.js
Original file line number Diff line number Diff line change
Expand Up @@ -5,7 +5,7 @@ module.exports = {
label: '👋 Welcome',
link: {type: 'doc', id: 'index'},
items: [
'novel-use-cases', 'builder-solidity'
'what-is-suave', 'novel-use-cases', 'builder-solidity'
],
},
{
Expand Down
39 changes: 39 additions & 0 deletions docs/what-is-suave.mdx
Original file line number Diff line number Diff line change
@@ -0,0 +1,39 @@
---
title: What is SUAVE?
hide_title: true
description: An open marketplace for mechanisms, a way to decentralize block building, and a general-purpose coordination solution.
keywords:
- flashbots
- suave
- docs
- build
- mechanisms
---

# What is SUAVE?

SUAVE - the *Single Unifying Auction for Value Expression* - is a platform for building better mechanisms (such as OFAs and block builders) in a decentralized and private way.

SUAVE does not replace other blockchains: it is intended to aggregate and coordinate all the things that ultimately change the state of other chains.

## Unified, decentralized

After [formalizing the threat posed by MEV](https://arxiv.org/pdf/1904.05234.pdf), and creating [MEV-Geth](https://github.com/flashbots/mev-geth) to begin addressing it, [Flashbots](https://medium.com/flashbots/frontrunning-the-mev-crisis-40629a613752) has collaborated with many people and organizations to build neutral, open-source software like [MEV-Boost](https://github.com/flashbots/mev-boost) and protocols like [MEV-Share](https://github.com/flashbots/MEV-Share). Our work has prevented the worst effects of MEV, though many problems remain.

SUAVE is our means of _keeping block building decentralized_ by creating an _open marketplace for mechanisms_, which we call "SUAPPs". A SUAPP is an application deployed on SUAVE which requires one (or many) of the following:

1. **private data**, e.g., auctions, block building
2. **coordination within block times**, e.g., block building, trade routing and filling
3. **access to fresh off-chain data**, e.g., trading strategies conditional on centralized exchange prices or transactions that are conditional on other transactions
4. **commitments** of various kinds, e.g., shared sequencers for rollups, new kinds of DEXes and bridges
5. **too much gas to do on-chain** because of how much compute they use.

Any SUAPP that strikes a meaningful balance between revenue optimality and efficiency will have broad application. SUAVE is a blockchain for many such applications and so exhibits second-order effects. For instance, keeping block building decentralized by creating an open marketplace for mechanisms could result in SUAVE being an effective, unified sequencing layer for other blockchains.

We expect that SUAVE will find increasingly wider application as more people build better mechanisms with it.

## About Flashbots

Our primary focus is to enable a permissionless, transparent, and fair ecosystem for MEV. We achieve this in three ways: _Illuminate the Dark Forest_, _Democratize Extraction_, and _Distribute Benefits_.

You can interact with Flashbots on our [Discourse forum](https://collective.flashbots.net/) or in [Discord](https://discord.gg/7hvTycdNcK). Our work is open source and you can follow our progress in each [Github repository](https://github.com/flashbots/).
Binary file removed static/img/diatraxis.png
Binary file not shown.

0 comments on commit 54f50e8

Please sign in to comment.