CLI › Devnet Burner

Devnet Burner

The fastest way to test ATF on devnet. Switches your active profile to devnet so you can simulate and verify transactions safely before using real keys.

Quickstart

First time

Run directly with npx. No install needed.

1. Create a devnet burner profile

npx @trucore/atf@1.5.1 profile create devnet-burner --network devnet

2. Select the profile

npx @trucore/atf@1.5.1 profile select devnet-burner

3. Enable burner mode

npx @trucore/atf@1.5.1 burner enable

4. Verify setup

npx @trucore/atf@1.5.1 doctor --pretty

Use again later

1. Select the profile

npx @trucore/atf@1.5.1 profile select devnet-burner

2. Enable burner mode

npx @trucore/atf@1.5.1 burner enable

Already created this profile?

If you see Profile "devnet-burner" already exists., skip profile creation and jump to Use again later above.

Once burner mode is active, you can test safely on devnet. Run simulate next to try a transaction.

Example Output

{
  "ok": true,
  "burner_enabled": true,
  "profile": "default",
  "solana_cluster": "devnet",
  "message": "Burner mode enabled on profile \"default\" (cluster: devnet)."
}

Burner, Then Simulate

A common testing workflow: create a burner, then immediately simulate a transaction.

Burner + simulate

npx @trucore/atf@1.5.1 burner --network devnet && npx @trucore/atf@1.5.1 simulate --preset swap_small --verify

Important Notes

Devnet only

Burner mode is devnet-only. It cannot be used on mainnet.
Burner mode sets the profile cluster to devnet. Ephemeral keypair generation and airdrop are planned follow-up features.
Do not send real funds to devnet addresses.

Flags

Flag	Description
--network devnet	Target network (only devnet is supported for burner).
--json	Output burner details as JSON.