Skip to content

astria-sequencer

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

astria-sequencer

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
benches
benches
 
 
scripts
scripts
 
 
src
src
 
 
CHANGELOG.md
CHANGELOG.md
 
 
Cargo.toml
Cargo.toml
 
 
README.md
README.md
 
 
TESTNET.md
TESTNET.md
 
 
build.rs
build.rs
 
 
justfile
justfile
 
 
local.env.example
local.env.example
 
 

README.md

Astria-Sequencer

Dependencies

We use just for convenient project specific commands.

  • rust 1.68
  • gcc-12, gcc-12-libs
  • go 1.18+

Building

Because penumbra-storage:0.54.1 depends on rocksdb:0.19.0 compilation on gcc 13 will not work.

On arch linux:

sudo pacman -S gcc12 gcc12-libs
CC=/usr/bin/gcc-12 CXX=/usr/bin/c++-12 cargo build

rust-rocksdb/rust-rocksdb#713 facebook/rocksdb#11118

Running the Sequencer

Configuration

Composer is configured via environment variables. An example configuration can be seen in local.env.example.

To copy a configuration to your .env file run:

# Can specify an environment
just copy-env <ENVIRONMENT>

# By default will copy `local.env.example`
just copy-env

Install cometbft

Ensure ~/go is in your PATH, or GOPATH is set to some other place in your PATH.

git clone https://github.com/cometbft/cometbft
cd cometbft
git checkout origin/v0.38.6
export GOPATH=~/go
make install

Optional: install abci-cli for a bit of CLI testing

In the cometbft/ dir:

make install_abci

Start the application

In astria-sequencer/:

just run

Query the app for info

$ abci-cli info
I[2023-05-16|16:53:56.786] service start    module=abci-client
    msg="Starting socketClient service"
    impl=socketClient
-> code: OK
-> data: astria_sequencer
-> data.hex: 0x626173655F617070

To query an address's balance:

abci-cli query --path=accounts/balance/<ADDRESS> 0x00

To query an address's nonce:

abci-cli query --path=accounts/nonce/<ADDRESS> 0x00

Start the cometbft node

# initialize the node
cometbft init

# generate a sequencer genesis file
cargo run -p astria-sequencer-utils -- generate-genesis-state -o genesis-state.json

# Edit the generated `genesis-state.json` as desired

# update the cometbft genesis file to include the sequencer genesis application state
cargo run -p astria-sequencer-utils -- copy-genesis-state \
    --genesis-app-state-file=genesis-state.json \
    --destination-genesis-file=$HOME/.cometbft/config/genesis.json \
    --chain-id <desired_test_chain_id>

# set the block time to 15s
sed -i'.bak' 's/timeout_commit = "1s"/timeout_commit = "15s"/g' ~/.cometbft/config/config.toml

# start the node
cometbft start

You should see blocks being produced.

You can also use just to run the above commands:

just run-cometbft

Testnet

Check out the TESTNET.md file for details on how to run a multi-node sequencer testnet.