CLI › Doctor

Doctor

Your first command. Doctor validates your environment, checks RPC connectivity, and confirms the CLI is ready to use.

Usage

Run doctor

npx @trucore/atf@1.5.1 doctor

Verbose output

npx @trucore/atf@1.5.1 doctor --verbose

What Doctor Checks

CLI version

Confirms you are running the expected pinned version.

Node.js version

Validates Node.js meets the minimum requirement (>=18).

RPC reachability

Pings the configured RPC endpoint and reports latency.

Network selection

Confirms whether you are targeting mainnet, devnet, or a custom endpoint.

Profile loaded

Shows the active profile name and config path.

Wallet detected

Confirms whether a signer is available for the active profile.

Example Output

✔ CLI version    : 1.5.1
✔ Node.js        : v20.11.0
✔ RPC endpoint   : https://rpc.helius.xyz (42ms)
✔ Network        : devnet
✔ Profile        : default (~/.atf/profiles/default.json)
✔ Wallet         : detected (pubkey: 7xKp...3mNv)

All checks passed. You are ready to go.

Common Issues

RPC unreachable? Check your network connection and verify the endpoint with rpc ping. If you are behind a VPN or firewall, confirm outbound HTTPS is allowed.

No wallet detected? Create a profile with profile create or use the devnet burner for quick testing.

Wrong network? Switch with config set network devnet or config set network mainnet.

Flags

Flag	Description
--verbose	Show detailed output for each check.
--json	Output results as JSON for scripting and CI.
--profile <name>	Run checks against a specific named profile.