Environments - Veil

The CLI uses the same two-mode model as the rest of Veil: sandbox and live. All reads and writes are scoped to the active mode. See Sandbox vs. production for context.

Active mode

After pairing, your active mode defaults to sandbox. Check or switch it with veil mode:

# Show the current mode
veil mode

# Switch to live
veil mode live

# Switch back to sandbox
veil mode sandbox

Switching modes requires that the corresponding credentials exist. If you try veil mode live before completing production KYC, the CLI prints an error. A switch is also refused if the target mode’s key has been revoked or expired server-side — the CLI will tell you to run veil login to restore it.

One-shot override

Every command accepts --live to use live mode for that invocation only, without changing the persisted active mode:

veil wallets list --live
veil transactions list --live --status pending