block-sdk/README.md
2023-12-06 11:56:08 -05:00

58 lines
2.4 KiB
Markdown
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<h1 align="center">Block SDK 🧱</h1>
<!-- markdownlint-disable MD013 -->
<!-- markdownlint-disable MD041 -->
<div align="center">
<a>
<img alt="Logo" src="img/block-sdk.png" width="600">
</a>
</div>
<div align="center">
<a>
<img alt="Repo Status" src="https://www.repostatus.org/badges/latest/active.svg" />
</a>
<a>
<img alt="License" src="https://img.shields.io/github/license/skip-mev/block-sdk.svg?style=flat-square" />
</a>
<a>
<img alt="License" src="https://img.shields.io/badge/godoc-reference-blue?style=flat-square&logo=go" />
</a>
</div>
### 🤔 What is the Block SDK?
> **Note**: The Block SDK is midway through an audit. Please use at your own risk. Timeline for audit completion is early November.
**🌐 The Block SDK is a toolkit for building customized blocks**. The Block SDK is a set of Cosmos SDK and ABCI++ primitives that allow chains to fully customize blocks to specific use cases. It turns your chain's blocks into a **`highway`** consisting of individual **`lanes`** with their own special functionality.
Skip has built out a number of plug-and-play `lanes` on the SDK that your protocol can use, including in-protocol MEV recapture and Oracles! Additionally, the Block SDK can be extended to add **your own custom `lanes`** to configure your blocks to exactly fit your application needs.
### Release Compatibility Matrix
| Block SDK Version | Cosmos SDK |
| :---------: | :--------: |
| `v1.x.x` | `v0.47.x` |
| `v2.x.x` | `v0.50.x` |
### 📚 Block SDK Documentation
To read more about how the Block SDK works, check out the [How it Works](https://docs.skip.money/chains/overview).
#### 🏪 Lane App Store
To read more about Skip's pre-built `lanes` and how to use them, check out the [Lane App Store](https://docs.skip.money/chains/lanes/existing-lanes/mev).
#### 🎨 Lane Development
To read more about how to build your own custom `lanes`, check out the [Build Your Own Lane](https://docs.skip.money/chains/lanes/build-your-own-lane).
### Audits
The Block SDK has undergone audits by the following firms:
* [OtterSec (Sept 9th, 2023)](audits/ottersec_sept_9_2023.pdf): Post audit code released as [v1.2.0](https://github.com/skip-mev/block-sdk/releases/tag/v1.2.0) and [v2.0.0](https://github.com/skip-mev/block-sdk/releases/tag/v2.0.0) for the `v1.x.x` and `v2.x.x` release families, respectively.