.env.example

# =====================================
# Server Configuration
# =====================================

# Port the API server listens on locally.
PORT=3000

# Runtime mode: use "development" for local testing.
NODE_ENV=development


# =====================================
# Stellar Network Configuration
# =====================================

# Stellar network to target.
# Allowed: testnet, mainnet, futurenet.
# For local testing, use testnet.
STELLAR_NETWORK=testnet

# Optional explicit Horizon endpoint.
# Leave commented to use the default URL for STELLAR_NETWORK.
# HORIZON_URL=https://horizon-testnet.stellar.org

# Optional: use mock Stellar responses without outbound network calls.
# true  = mock mode (good for offline/local tests)
# false = real Stellar network requests
MOCK_STELLAR=false


# =====================================
# Database Configuration
# =====================================

# Storage engine used by the app.
# Current local default uses sqlite.
DB_TYPE=sqlite

# SQLite file path (relative to project root).
DB_PATH=./donations.db


# =====================================
# API Configuration
# =====================================

# Prefix for all API routes.
API_PREFIX=/api/v1

# Max requests per IP per time window (see rate limiter config in code).
RATE_LIMIT=100


# =====================================
# API Key Protection
# =====================================

# Legacy API key list (comma-separated).
# Required by current environment validation for local/runtime startup.
# Safe local examples only; replace with your own dev keys.
API_KEYS=dev_key_1234567890,dev_key_abcdef123456

# Recommended: Database-backed API key management.
# Example commands:
#   npm run keys:create -- --name "Local Dev Key" --role admin --expires 365
#   npm run keys:list
# See docs/API_KEY_ROTATION.md for details.


# =====================================
# Service Account (Optional)
# =====================================

# Stellar secret for service-side operations.
# Keep this commented unless you explicitly need service signing.
# Never commit a real secret key.
# SERVICE_SECRET_KEY=SXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
# Alias supported by code (same purpose as SERVICE_SECRET_KEY):
# STELLAR_SECRET=SXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX


# =====================================
# Data Storage (Optional Overrides)
# =====================================

# Optional JSON storage path override for donation records.
# If omitted, code defaults to ./data/donations.json.
# DB_JSON_PATH=./data/donations.json


# =====================================
# Donation Limits (XLM)
# =====================================

# Minimum donation amount accepted by validation.
MIN_DONATION_AMOUNT=0.01

# Maximum donation amount accepted by validation.
MAX_DONATION_AMOUNT=10000

# Daily cap per donor.
# Set to 0 to disable the daily limit.
MAX_DAILY_DONATION_PER_DONOR=0


# =====================================
# Logging Configuration
# =====================================

# Write logs to files in LOG_DIR in addition to console.
LOG_TO_FILE=false

# Directory for log files when LOG_TO_FILE=true.
LOG_DIR=./logs

# Include extra debug details in logs.
LOG_VERBOSE=false


# =====================================
# Encryption (Optional for Local, Required in Production)
# =====================================

# App uses a development fallback when this is unset outside production.
# In production, ENCRYPTION_KEY must be provided.
# ENCRYPTION_KEY=local_dev_encryption_key_change_me
# Debug Mode (local development only)
# Enables detailed debug logging for troubleshooting
# WARNING: Never enable in production - may expose sensitive information
# Set to 'true' to enable, 'false' or omit to disable (default: false)
DEBUG_MODE=false