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.
Prerequisites
Section titled “Prerequisites”Request test funds
Section titled “Request test funds”thru auth loginthru --network betanet faucet withdraw thrusd ta... 100Use an existing THRUSD token-account address on the selected network. See Faucet for limits and THRU, or authentication configuration for API keys.
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”RPCQuery node state, account data, balances, slot metrics, and use the top-level native transfer command.
ProgramCreate, upgrade, pause, finalize, destroy, and derive managed program accounts.
UploaderUpload raw program binaries and inspect or clean up uploader accounts.
ABIPublish or inspect on-chain ABI accounts, or use ABI tooling such as codegen, reflection, flattening, and bundling.
KeysList, add, generate, inspect, and remove keys stored in CLI config.
AccountCreate accounts, inspect them, list transactions, and work with compression flows.
TransactionSign, execute, inspect, and sort transaction inputs, or generate state proofs.
UtilityConvert public keys and signatures between hex and Thru address formats, or derive a public key from a private key.
TokenCreate mints, manage token accounts, and transfer, mint, burn, freeze, or thaw tokens.
FaucetRequest test THRUSD or THRU, or deposit THRU into the faucet.
RegistrarInitialize the `.thru` registry and manage lease lifecycle commands.
Name ServiceInitialize root registrars, manage records, register subdomains, and derive addresses.
Wrapped ThruInitialize wrapped Thru infrastructure, then deposit and withdraw wrapped balances.
DevInstall toolchains and SDKs, inspect install paths, and scaffold projects.
NetworkConfigure named RPC endpoints and choose the default network for future commands.
DebugRe-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.