.env.example

# =============================================================================
# Solarix — Universal Solana Indexer Configuration
# =============================================================================
# Copy to .env and customize. All values shown are defaults unless noted.

# === Solana RPC ===
SOLANA_RPC_URL=https://api.mainnet-beta.solana.com
# SOLANA_WS_URL=                          # Optional: WebSocket URL (derived from RPC URL if unset)

# === Database ===
DATABASE_URL=postgres://solarix:solarix@localhost:5432/solarix  # Required, no default

# === Database Pool ===
SOLARIX_DB_POOL_MIN=2
SOLARIX_DB_POOL_MAX=10

# === Rate Limiting ===
SOLARIX_RPC_RPS=10                        # Requests per second to Solana RPC (public limit ~10)

# === Backfill ===
SOLARIX_BACKFILL_CHUNK_SIZE=50000         # Slots per backfill chunk
# SOLARIX_START_SLOT=                     # Optional: backfill start slot
# SOLARIX_END_SLOT=                       # Optional: backfill end slot

# === Indexing ===
SOLARIX_INDEX_FAILED_TXS=false            # Index failed transactions

# === API ===
SOLARIX_API_HOST=0.0.0.0
SOLARIX_API_PORT=3000
SOLARIX_API_PAGE_SIZE=50                  # Default page size for queries
SOLARIX_API_MAX_PAGE_SIZE=1000            # Maximum allowed page size

# === Pipeline ===
SOLARIX_CHANNEL_CAPACITY=256              # Bounded channel capacity (must be >= 1)
SOLARIX_CHECKPOINT_INTERVAL_SECS=10       # How often to save pipeline checkpoints

# === Retry ===
SOLARIX_RETRY_INITIAL_MS=500              # Initial retry delay (exponential backoff)
SOLARIX_RETRY_MAX_MS=30000                # Maximum retry delay
SOLARIX_RETRY_TIMEOUT_SECS=300            # Total retry timeout before giving up

# === Streaming ===
SOLARIX_MAX_CONSECUTIVE_FETCH_FAILURES=100  # Max consecutive fetch failures before halt (>= 1)

# === WebSocket ===
SOLARIX_WS_PING_INTERVAL_SECS=30         # Ping interval for keep-alive (>= 1)
SOLARIX_WS_PONG_TIMEOUT_SECS=10          # Pong timeout before disconnect (>= 1)
SOLARIX_DEDUP_CACHE_SIZE=10000            # Signature dedup FIFO cache size (>= 1)

# === Shutdown ===
SOLARIX_SHUTDOWN_DRAIN_SECS=15            # Seconds to drain pipeline on shutdown
SOLARIX_SHUTDOWN_DB_FLUSH_SECS=10         # Seconds to flush DB on shutdown

# === Logging ===
SOLARIX_LOG_LEVEL=info                    # trace, debug, info, warn, error
SOLARIX_LOG_FORMAT=json                   # json or pretty