.env.example

# Server Configuration
PORT=3000

# API Authentication
# Set this to enable API key authentication
# The frontend's BACKEND_API_KEY must match this value
SERVER_API_KEY=your-secure-api-key-here

# Database Configuration
# PostgreSQL connection string
# Format: postgresql://USER:PASSWORD@HOST:PORT/DATABASE
DATABASE_URL=postgresql://user:password@localhost:5432/cgov_db

# Blockfrost API (for reading blockchain data)
# Get your API key from: https://blockfrost.io/
MAINNET_BLOCKFROST_API_KEY=mainnetxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# Koios API (for governance data ingestion)
# API Documentation: https://api.koios.rest/
# Get your API key from: https://koios.rest/ (if required)
KOIOS_BASE_URL=https://api.koios.rest/api/v1
KOIOS_API_KEY=your_koios_api_key_here

# Cron Job Configuration
# Enable or disable automatic proposal sync cron job
ENABLE_CRON_JOBS=true

# Cron schedule for proposal sync (cron syntax)
# Default: */5 * * * * (every 5 minutes)
# Examples:
#   */5 * * * *   - Every 5 minutes
#   */15 * * * *  - Every 15 minutes
#   0 * * * *     - Every hour at minute 0
#   0 */6 * * *   - Every 6 hours
PROPOSAL_SYNC_SCHEDULE=*/5 * * * *

# Cron schedule for DRep and SPO voting power sync (cron syntax)
# Default: 30 */6 * * * (every 6 hours at minute 30)
# Examples:
#   30 */6 * * *  - Every 6 hours at minute 30
#   0 */12 * * *  - Every 12 hours
#   0 0 * * *     - Once daily at midnight
#   0 */1 * * *   - Every hour
VOTER_POWER_SYNC_SCHEDULE=30 */6 * * *

# Cron schedule for epoch analytics sync (cron syntax)
# Default: 10 * * * * (every hour at minute 10)
# Examples:
#   10 * * * *    - Every hour at minute 10
#   0 */2 * * *   - Every 2 hours
#   0 */6 * * *   - Every 6 hours
EPOCH_ANALYTICS_SYNC_SCHEDULE=10 * * * *

# Cron schedule for DRep delegation change sync (cron syntax)
# Default: 40 * * * * (every hour at minute 40)
# Examples:
#   40 * * * *    - Every hour at minute 40
#   0 */2 * * *   - Every 2 hours
#   0 */6 * * *   - Every 6 hours
DREP_DELEGATOR_SYNC_SCHEDULE=40 * * * *

# Parallel processing concurrency for voter power sync
# Controls how many Koios API calls are made concurrently
# Default: 5, Maximum: 20
# Higher values = faster sync but more API load
VOTER_SYNC_CONCURRENCY=5