Contributing

Contributions are welcome — issues and PRs alike.

Workflow

Work lands on main through a PR (see the branch rules in RELEASING.md ); main is protected. Keep changes focused and update the CHANGELOG ## [Unreleased] section with anything user-facing.

Before you push

CI runs formatting, Clippy, tests, and a dependency audit (see .github/workflows/). Run them locally first:


cargo fmt --all
cargo clippy --all-targets -- -D warnings
cargo test

Some tests boot real containers and need a running Docker daemon.

Adding a chain kind or capability

Chains implement the Engine trait in src/runtime/engine.rs; the per-chain code lives under src/<kind>/. The per-chain guides (EVM, Starknet, Solana) describe how each stack wires up tokens, faucet, forking, and its explorer — a good map before you extend one.

Editing these docs

This site is a Nextra app under landing/. To run it locally:


cd landing
pnpm install
pnpm dev

Pages are MDX files under landing/content/; the sidebar order is set in landing/content/_meta.js. Push to main and a GitHub Actions workflow builds and deploys the site to GitHub Pages.