.env.example

# Stellar Network Configuration
# One of: mainnet | testnet | futurenet
NEXT_PUBLIC_STELLAR_NETWORK=mainnet_or_testnet

# Horizon API URL
# Mainnet: https://horizon.stellar.org
# Testnet: https://horizon-testnet.stellar.org
NEXT_PUBLIC_HORIZON_URL=https://horizon.stellar.org_or_testnet_url

# USDC Issuer Account Address on Stellar Network
# This is the trusted issuer for USDC tokens
NEXT_PUBLIC_USDC_ISSUER=stellar_public_key_here

# Application Name (required — boot fails if unset)
NEXT_PUBLIC_APP_NAME="App_Name_Here"

# Stellar Expert API base for transaction links (optional)
# Default: https://api.stellar.expert/explorer/public
NEXT_PUBLIC_STELLAR_EXPERT_URL=https://api.stellar.expert/explorer/public

# Feature flag — signed-intent off-ramp path is OFF unless set to "true"
NEXT_PUBLIC_INTENT_FLOW=false

# Admin secret key — required to access /admin/disputes and related API routes
ADMIN_SECRET_KEY=your_secret_admin_key_here

# ─── Server-side (optional) ───────────────────────────────────────────────────

# Max acceptable fee as a fraction of the amount, e.g. 0.05 for 5% (router budget)
FEE_BUDGET_PCT=0.05

# Shared secret required by cron-triggered routes (publisher tick / reconcile / refresh)
CRON_SECRET=your_cron_secret_here

# Reputation store backend: "sqlite" (default) or "postgres"
# Setting DATABASE_URL implies the postgres backend.
REPUTATION_BACKEND=sqlite
DATABASE_URL=postgres://user:pass@host:5432/dbname

# Pino log level: trace | debug | info | warn | error (default: info)
LOG_LEVEL=info

# Metrics rolling-window length in milliseconds (default: 3600000 = 1h)
METRICS_RESET_WINDOW_MS=3600000

# ─── Soroban oracle ops scripts ───────────────────────────────────────────────

# Soroban reputation oracle contract address — required by scripts/init-oracle-registry.ts
ORACLE_CONTRACT_ID=your_contract_id_here

# Server-side rate fetch timeouts (milliseconds) and retries per tier.
# Leave unset to use the built-in defaults (8s timeout, 1 retry on network errors only).
# RATES_TOML_TIMEOUT_MS=8000
# RATES_SEP38_TIMEOUT_MS=8000
# RATES_SEP24_INFO_TIMEOUT_MS=8000
# RATES_TOML_RETRY_ATTEMPTS=1
# RATES_SEP38_RETRY_ATTEMPTS=1
# RATES_SEP24_INFO_RETRY_ATTEMPTS=1