Skip to main content

Environment

The runtime auto-loads .env and .env.local. Start from:
cp .env.example .env

Drift

VariableDescription
DRIFT_RPC_URLRPC used by the Drift adapter
DRIFT_OWNER_ADDRESSExpected Drift owner address
DRIFT_ENVDrift environment, usually mainnet-beta
DRIFT_MARKET_INDEXSpot market index
DRIFT_MARKET_SYMBOLSpot market symbol
DRIFT_SUB_ACCOUNT_IDDrift subaccount ID
DRIFT_USER_NAMEDrift user name used during init
DRIFT_INCLUDE_ATA_IXSWhether to include ATA creation instructions
DRIFT_INIT_USER_IF_NEEDEDWhether to auto-init a missing user
DRIFT_COMMITMENTSolana commitment level
DRIFT_SMOKE_MODEdeposit or withdraw for drift-smoke.ts
DRIFT_LIVE_ACTIONdeposit or withdraw for drift-live-send.ts
DRIFT_LIVE_AMOUNT_USDUSD-sized notional used by drift-live-send.ts

Kamino

VariableDescription
KAMINO_RPC_URLRPC used by the Kamino adapter
KAMINO_OWNER_ADDRESSExpected Kamino owner address
KAMINO_MARKET_ADDRESSKamino market address
KAMINO_RESERVE_SYMBOLReserve symbol, usually USDC

Ranger and vault

VariableDescription
VAULT_RPC_URLRPC used by vault operator CLIs
RANGER_RPC_URLRPC used by Ranger runtime
VAULT_ADDRESSVault PDA if already known
VAULT_PROGRAM_IDDeployed program ID
VAULT_DEPOSIT_MINTBase asset mint, usually mainnet USDC
VAULT_NAMEHuman-readable vault name
RANGER_ALLOW_SIMULATED_STEPSAllows hybrid runs with non-live strategy paths
SOLANA_SKIP_PREFLIGHTToggle Solana preflight checks
COBO_MPC_PUBKEYOptional manager pubkey override
RANGER_EXECUTOR_PUBKEYOptional executor pubkey override

Vault lifecycle

VariableDescription
VAULT_SHARE_MINT_KEYPAIR_PATHKeypair file for the share mint
VAULT_TREASURY_KEYPAIR_PATHKeypair file for the vault treasury token account
VAULT_USER_KEYPAIR_PATHOptional keypair for vault user actions
VAULT_ADMIN_ACTIONAdmin action for vault-admin.ts
VAULT_USER_ACTIONUser action for vault-user.ts
VAULT_DEPOSIT_AMOUNT_USDCDeposit amount in raw mint units
VAULT_WITHDRAW_SHARE_AMOUNTShare burn amount in raw units
VAULT_WITHDRAWAL_REQUEST_IDWithdrawal request id used for finalize
VAULT_STRATEGY_IDStrategy id used by strategy admin actions
VAULT_STATUS_STRATEGY_IDOptional strategy filter for vault-status.ts
VAULT_STATUS_OWNER_ADDRESSOptional owner for withdrawal inspection
VAULT_STATUS_WITHDRAWAL_REQUEST_IDOptional withdrawal request filter

Strategy manifests

VariableDescription
STRATEGY_MARGINFI_CANARY_MANIFEST_PATHMarginFi manifest file path
STRATEGY_PERENA_EXOTIC_MANIFEST_PATHPerena manifest file path

Signers

VariableDescription
COBO_MPC_KEYPAIR_PATHCOBO manager signer file
RANGER_EXECUTOR_KEYPAIR_PATHRanger executor signer file
VAULT_AUTHORITY_KEYPAIR_PATHVault authority signer file

Important unit note

Amounts like VAULT_DEPOSIT_AMOUNT_USDC=1000000 are raw token units. For a 6 decimal USDC mint:
  • 1000000 = 1 USDC
  • 10000000 = 10 USDC