CLI Overview
The thru command is the main command-line interface for interacting with the Thru network.
Use this page to decide which command family fits your task before you load a more detailed reference page.
Use this page to decide which command family fits your task before you load a more detailed reference page.
Prerequisites
Section titled “Prerequisites”Start Here
Section titled “Start Here”Read Global Flags and configuration first if you need to understand:
--json,--quiet,--url, and--network- where config lives on disk
- how named networks override the default RPC target
- when a command accepts key names versus raw
ta...addresses
Command Families
Section titled “Command Families” RPC Query node state, account data, balances, slot metrics, and use the top-level native transfer command.
Program Create, upgrade, pause, finalize, destroy, and derive managed program accounts.
Uploader Upload raw program binaries and inspect or clean up uploader accounts.
ABI Publish or inspect on-chain ABI accounts, or use ABI tooling such as codegen, reflection, flattening, and bundling.
Keys List, add, generate, inspect, and remove keys stored in CLI config.
Account Create accounts, inspect them, list transactions, and work with compression flows.
Transaction Sign, execute, inspect, and sort transaction inputs, or generate state proofs.
Utility Convert public keys and signatures between hex and Thru address formats.
Token Create mints, manage token accounts, and transfer, mint, burn, freeze, or thaw tokens.
Faucet Deposit to or withdraw from the faucet program.
Registrar Initialize the `.thru` registry and manage lease lifecycle commands.
Name Service Initialize root registrars, manage records, register subdomains, and derive addresses.
Wrapped Thru Initialize wrapped Thru infrastructure, then deposit and withdraw wrapped balances.
Dev Install toolchains and SDKs, inspect install paths, and scaffold projects.
Network Configure named RPC endpoints and choose the default network for future commands.
Debug Re-execute transactions and resolve DWARF-backed debug traces.
Choose The Right Family
Section titled “Choose The Right Family”| If your task is… | Open this page |
|---|---|
| Query a node or inspect account state | RPC |
| Deploy or manage a program | Program |
| Work with raw upload buffers | Uploader |
| Publish or inspect ABIs, or work with ABI YAML tooling | ABI |
| Manage local signing keys | Keys |
| Create or compress accounts | Account |
| Build or submit a transaction directly | Transaction |
| Manage token mints and token accounts | Token |
| Work with name registration or DNS-style records | Registrar or Name Service |
Install the dev toolchain or scaffold a project | dev |
| Re-execute or symbolicate a failing transaction | Debug |
Typical Workflow For Agents
Section titled “Typical Workflow For Agents”- Configure an RPC endpoint with network commands.
- Check Global Flags and configuration if you need to know how config, key lookup, or
--jsonoutput works. - Jump to the relevant command family page instead of scanning the whole CLI surface.
- Only load the detailed command section you need for the task at hand.