Prerequisites

Before running the sequencer, you must start a local Solana test validator and deploy the bridge program. The sequencer listens to bridge events over a WebSocket connection, which requires the validator to be running.

System dependencies

sudo apt update && sudo apt install \
  build-essential \
  pkg-config \
  libssl-dev \
  clang \
  libclang-dev

Rust toolchain

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
source $HOME/.cargo/env

Solana CLI

sh -c "$(curl -sSfL https://release.anza.xyz/stable/install)"
echo 'export PATH="$HOME/.local/share/solana/install/active_release/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc # If using Bash
solana --version
agave-install update

Surfpool

curl -sL https://run.surfpool.run/ | bash
source ~/.bashrc # If using Bash
surfpool --version

---

Start the test validator

surfpool start

Set Solana CLI to localnet

solana config set --url http://127.0.0.1:8899

Deploy the bridge program

solana program deploy ../../onchain-programs/bridge/target/deploy/bridge.so

After deployment:

1. Copy the deployed program ID
2. Update it in lib.rs
3. Re-deploy the program so the change is applied

---

Run the Sequencer

RUST_LOG=info cargo run -p core --release

---

Examples

Throughput benchmark

cargo run -p core --example bench_throughput --release

Bridge test

cargo run -p core --example bridge --release

Full lifecycle example

cargo run -p core --example full_lifecycle --release

L2 transaction example

cargo run -p core --example transaction --release

---

Debugging

Run a service

cargo run -p prover

Build a specific crate

cargo build -p core

License

Licensed under the Apache License, Version 2.0.