Skip to content

Latest commit

 

History

History
138 lines (101 loc) · 3.78 KB

README.md

File metadata and controls

138 lines (101 loc) · 3.78 KB
Raw

Astria

Astria replaces centralized sequencers, allowing many rollups to share a single decentralized network of sequencers that’s simple and permissionless to join. This shared sequencer network provides out-of-the-box censorship resistance, fast block confirmations, and atomic cross-rollup composability – all while retaining each rollup’s sovereignty.

This repository contains the custom Astria components that make up the Astria network. Other components of the Astria network can be found in the astriaorg organization.

To run locally, we utilize a dev-cluster which can be found at astriaorg/astria/charts.

To learn more about Astria, please visit astria.org.

Components

  • conductor: conducts blocks from the data availability layer to the execution layer.
  • proto: the protobuf spec to interact with Astria services.
  • sequencer: ABCI application that defines the sequencer state transition logic.
  • sequencer-relayer: relays blocks from the sequencer chain to the data availability layer.

Build

To build the relevant Astria binaries, you only need Rust installed.

Then:

git clone https://github.com/astriaorg/astria.git
cd astria
git submodule update --init
cargo build --release

Docker build

To build a docker image locally you will first need docker installed. With docker installed you can use the following just command:

# Full command:
just docker-build <CRATE> <TAG=local>
#
# Replace CRATE with what the target binary is ie `astria-sequencer`
# TAG defaults to `local` but can be changed.

# this command will build a local image tagged as 'astria-sequencer:local' 
just docker-build astria-sequencer

# this command will build a local image tagged as 'astria-sequencer:debug' 
just docker-build astria-sequencer debug

Running locally

The entire stack consists of many different binaries. It's recommended to use the setup located in astriaorg/dev-cluster.

Testing

To run unit tests:

cargo test

Formatting

This project uses rustfmt to format rust sources, taplo to format toml files, and markdownlint-cli2 for markdown.

Rust

# Install rustfmt
rustup +nightly-2024-02-07 component add rustfmt
# Run rustfmt
just fmt rust

Toml

# Install for macOS
brew install taplo
# Install for Arch Linux
sudo pacman -S taplo

# Run
just fmt toml

Markdown

# Install for macOS w/ homebrew
brew install markdownlint-cli2
# Install for Arch Linux
sudo pacman -S markdownlint-cli2
# Install with NPM
npm install markdownlint-cli2 --global

# Run
just lint md

# Run with docker
docker run -v $PWD:/workdir davidanson/markdownlint-cli2:v0.8.1

Contributing

Pull requests should be created against the main branch. In general, we follow the "fork-and-pull" Git workflow.

  1. Fork the repo on GitHub
  2. Clone the project to your own machine
  3. Commit changes to your own branch
  4. Push your work back up to your fork
  5. Submit a Pull request so that we can review your changes

NOTE: Be sure to merge the latest from upstream before making a pull request!

Issues

If you encounter any issues while using this project or have any questions, please open an issue in this repository here.