basectl
basectl is the operator TUI for configuring and inspecting Base nodes across multiple network targets. The interface is built with ratatui.
Package
Section titled “Package”- Crate name:
basectl - Source:
bin/basectl - Library:
crates/infra/basectl(basectl-cli)
Architecture
Section titled “Architecture”basectl is split into two crates:
basectl(binary) — The CLI entry point that parses arguments and launches the TUIbasectl-cli(library) — The core logic for configuration management, subcommands, and the TUI renderer
The TUI is built with ratatui, providing an interactive terminal interface for node management.
Subcommands
Section titled “Subcommands”| Subcommand | Purpose |
|---|---|
config | Generate or inspect node configuration for a target network |
flashblocks | Inspect and manage flashblocks streaming state |
da | Data availability layer inspection and diagnostics |
command-center | Interactive TUI dashboard for monitoring and managing the node |
Configuration Targets
Section titled “Configuration Targets”| Config | Network |
|---|---|
mainnet | Base Mainnet |
sepolia | Base Sepolia Testnet |
devnet | Local Development Network |
<path> | Custom configuration file path |
Key Dependencies
Section titled “Key Dependencies”basectl-cli— Configuration logic libraryratatui— TUI frameworkclap— CLI argument parsinganyhow— Error handlingtokio— Async runtime
# Via cargocargo run -p basectl --release -- -c <config>
# Via Just (preferred)just basectl mainnetjust basectl sepoliajust basectl devnet