CLI › Guides › Helius Setup

Helius RPC Setup with Profiles

Configure a Helius RPC endpoint within an ATF CLI profile. This guide walks through profile creation, endpoint configuration, and connectivity verification.

Prerequisites

doctor passes with no errors.
A Helius account with an API key. Sign up at helius.dev if you have not already.
The ATF CLI installed (pinned version, not @latest).

Step-by-Step

1. Create a profile (or select an existing one)

Profiles isolate configuration, wallet, and RPC settings. Create a dedicated profile for your Helius-connected environment.

Create profile

npx @trucore/atf@1.5.1 profile create --name helius-dev

If the profile already exists, switch to it instead:

Switch profile

npx @trucore/atf@1.5.1 profile switch --name helius-dev

2. Set the Helius RPC endpoint

Configure the Helius endpoint using the rpc set command. Your API key is stored locally in the profile config and is never sent to ATF.

Set Helius RPC

npx @trucore/atf@1.5.1 rpc set --provider helius --api-key YOUR_KEY

Secrets are never echoed. The CLI stores your API key in the profile config file on disk. It is never logged, printed to stdout, or included in any ATF API request or receipt.

3. Ping the endpoint

Confirm that the RPC endpoint is reachable and measure latency.

Ping RPC

npx @trucore/atf@1.5.1 rpc ping

Endpoint: https://devnet.helius-rpc.com/?api-key=****
Latency: 42ms
Status: reachable
Network: devnet

4. Confirm the network

Use whoami to verify that the profile, wallet, and network are all set correctly.

Confirm identity

npx @trucore/atf@1.5.1 whoami

Profile: helius-dev
Network: devnet
RPC: https://devnet.helius-rpc.com/?api-key=****
Wallet: 5UBb...xYz3

5. Run doctor to confirm everything

Doctor validates the full environment. If all checks pass, you are ready to simulate.

Final check

npx @trucore/atf@1.5.1 doctor

Troubleshooting

Symptom	Likely cause	Fix
RPC ping fails with timeout	Invalid API key, wrong URL, or network issue.	Double-check your Helius API key and endpoint URL.
Wrong network in whoami	Profile is set to the wrong network.	Run `config set network devnet` (or mainnet-beta).
Wallet not found	No keypair configured in the profile.	Generate or import a wallet. See the Profiles reference.