Environment Variables
mindwallet can be configured entirely through environment variables. Env vars override config file values; no config file is required.
Variable Reference
| Variable | Description | Example |
|---|---|---|
MINDWALLET_PRIVATE_KEY | Raw EVM private key (hex, 0x-prefixed) | 0xac09... |
MINDWALLET_CHAIN_IDS | Comma-separated CAIP-2 chain IDs | eip155:8453,eip155:4217 |
MINDWALLET_WALLET_ID | OWS wallet name/ID | default |
MINDWALLET_VAULT_PATH | OWS vault directory | ~/.minds/wallet/vault |
MINDWALLET_TEMPO_GAS | Fixed gas limit for Tempo charges | 200000 |
MINDWALLET_RPC_BASE | Base chain RPC URL | https://mainnet.base.org |
MINDWALLET_RPC_TEMPO | Tempo chain RPC URL | https://rpc.mainnet.tempo.xyz |
Legacy Variables
| Variable | Description |
|---|---|
CONFIG_PATH | Override config file path (default: ~/.config/mindwallet/config.json) |
OWS_PASSPHRASE | OWS vault passphrase (read by OWS internally) |
Resolution Order
Configuration is resolved by merging three sources:
env vars > config file > hardcoded defaults
- Hardcoded defaults —
walletId: "default",vaultPath: ~/.minds/wallet/vault - Config file —
~/.config/mindwallet/config.json(returns{}if missing) - Env vars —
MINDWALLET_*variables override everything
Examples
CI pipeline with private key
export MINDWALLET_PRIVATE_KEY=$SECRET_KEY
export MINDWALLET_CHAIN_IDS=eip155:8453
mindwallet fetch https://api.example.com/data
Custom RPC URLs
export MINDWALLET_RPC_BASE=https://base-mainnet.g.alchemy.com/v2/...
export MINDWALLET_RPC_TEMPO=https://rpc.testnet.tempo.xyz
mindwallet fetch https://api.example.com/data
Override config file wallet
# Config file says walletId: "production"
# Env var overrides to "staging"
export MINDWALLET_WALLET_ID=staging
mindwallet fetch https://api.example.com/data