Skip to content

Environment Variables ​

The exhaustive reference. Audited 2026-11-17 by grepping every environment access across src/, lib/, bin/ and scripts/, then cross-checked against .env.example — if a variable is listed here, the source reads it; the config-file equivalent (config.toml network profiles) is covered in Configuration & Diagnostics.

Secrets live in environment variables or stdin — never as CLI arguments (argv is visible in process listings and shell history). Variables without the NEXT_PUBLIC_ style prefix never reach any client bundle; they are read only by the local process.

Setup & precedence ​

Bash / macOS / Linux:

bash
export HYPERLIQUID_PRIVATE_KEY="0x..."   # or an env file you source

Windows PowerShell (current session):

powershell
$env:HYPERLIQUID_PRIVATE_KEY = "0x..."

Persisted per-user: setx NAME value (new shells only) or a $PROFILE script. Never place secrets in cloud-synced directories.

Precedence: real environment > .env file (loaded by dotenv from the working directory) > built-in default. A value set in the shell wins over .env.

Rotation: API keys are read at process start — rotating a key takes effect on the next invocation. The keystore master key rotates by re-importing (wallet import). Redaction is property-tested: private keys never appear in errors, toString, JSON, or signature envelopes (test/key-redaction.test.js).

Signing keys ​

VariableUsed byNotes
HYPERLIQUID_PRIVATE_KEYPerp execution, HLP vaultPreferred. Fails closed if absent on signed surfaces. Use a delegated API Agent key, not your master
ETH_PRIVATE_KEYPerp execution, HLP vaultFallback signer (same code path)
FURLPAY_HL_TESTNETHyperliquid1 = testnet, 0 = mainnet — explicit, never silently swapped
HYPERLIQUID_WALLET_ADDRESSRead-only account viewsDefault address for account balance/positions/orders; a signer is still required for anything that signs
FURLPAY_USDC_PEG_FEED_URLPre-trade peg guardrailUSDC/USD feed for the depeg monitor; defaults to CoinGecko's simple price. Any https endpoint answering { "usd-coin": { "usd": <number> } }. Refreshed at most once per 30s; a failed feed is surfaced as an explicit PEG_FEED_UNAVAILABLE warning on every order — never a synthetic price, and a depeg halt in force stays until real data proves recovery

Exchange credentials ​

VariableUsed byNotes
BINANCE_API_KEYBinance spotCreate with spot trading enabled, withdrawals disabled, IP-bound
BINANCE_API_SECRETBinance spotHMAC-SHA256 signing, recvWindow enforced
FURLPAY_BINANCE_ENVBinancetestnet or mainnet — distinct constants, never silently swapped

RPC endpoints (public defaults; bring your own provider) ​

VariableUsed byDefault
STELLAR_HORIZON_URLtx verify, Stellar toolingnetwork-dependent Horizon
SOLANA_RPC_URLsolana status/balancehttps://api.mainnet-beta.solana.com
ETHEREUM_RPC_URLJS app surfacehttps://cloudflare-eth.com
BASE_RPC_URLJS app surfacehttps://mainnet.base.org
ARBITRUM_RPC_URLJS app surfacehttps://arb1.arbitrum.io/rpc

Oracle & Jupiter ​

VariablePurpose
FURLPAY_PYTH_HERMES_URLOptional authorized Pyth Hermes gateway base URL — the Pyth provider is inactive without it (public Hermes is auth-gated)
FURLPAY_PYTH_FEED_IDSJSON map {"SOL":"0x…"} of verified Pyth feed ids (required with the gateway); no feed ids ship baked in
FURLPAY_JUPITER_API_URLJupiter API base for solana price/quote (default: public Lite API)

Platform, auth & finance ​

VariableUsed bySecretNotes
FURLPAY_ENVJS app surface (pay TUI)NoExact string live opts into live-environment semantics; unset is never live
ANTHROPIC_API_KEYAI support chat engineYesOnly the assistant chat; trading never needs it
FURLPAY_FINANCE_WEBHOOK_URLfinance eventsNoSigned webhook receiver for ledger events (optional)
FURLPAY_FINANCE_APPROVER_TOKENfinance approval approveYesShared-secret bearer token the human approver must present when set; server-side only, never argv

Behavior & master gates ​

VariableEffectDefault
FURLPAY_LIVELive-execution master gate (src/capabilities/registry.ts): signing paths call assertLiveAllowed(); without FURLPAY_LIVE=1 the surface stays inert with a clear refusal. On top of per-surface credentialsunset = inert
FURLPAY_NO_BROWSERDevice auth prints the URL instead of opening a browserunset
FURLPAY_QUIET_TRUST_WARNINGSuppresses the repeated agent-trust warning bannerunset
NO_COLORPresence (any value, including 0 or empty) disables all colorunset
COLORTERM, TERM, WT_SESSIONColor-level detection (truecolor / 256 / 16)—
NODE_ENV, FURLPAY_ENVEnvironment hints; production/live gates sandbox fixtures—

What is deliberately absent ​

  • No FURLPAY_PRIVATE_KEY-style master override for Stellar: Stellar keys live in the encrypted keystore or hardware — never env, never argv.
  • No screening-vendor API keys: OFAC/travel-rule integrations are not implemented in this build and the CLI does not pretend otherwise.
  • No NEXT_PUBLIC_ anything: this is a CLI; secrets never ship to a browser.

Hygiene rules the CLI enforces ​

  • Argv secrets are refused — mnemonics/keys on stdin only (wallet import, login --key).
  • Terminal echo is suppressed for interactive seed-phrase/key input.
  • The session cookie attaches only to furlpay.com over TLS or loopback — pointing --api-base elsewhere sends the request credential-less and says so.
  • Cleartext http:// is refused for remote targets, and refused even on loopback when the environment is live.
  • URLs with embedded credentials (https://user:pass@host) are refused outright.

FurlPay CLI is non-custodial software. Every execution surface is labeled live or simulated at runtime.