.env.example

# Stellar RPC endpoint (JSON-RPC 2.0). Default is the public testnet node.
# For mainnet, use a provider URL (public mainnet nodes are rate-limited or absent).
RPC_URL=https://soroban-testnet.stellar.org

# Postgres connection string.
DATABASE_URL=postgres://sorotrail:sorotrail@localhost:5432/sorotrail?sslmode=disable

# How often to poll for new events once caught up.
POLL_INTERVAL=5s

# HTTP API listen address.
HTTP_ADDR=:8080

# Optional: comma-separated contract IDs (C...) to watch. Empty = ingest all
# contract events.
WATCHED_CONTRACTS=

# Optional: force ingestion to start from this ledger on cold start.
# If unset, ingestion starts from (latest ledger - RETENTION_LEDGERS).
START_LEDGER=

# How far back to reach on cold start, in ledgers (~5s each; 17280 ≈ 24h).
RETENTION_LEDGERS=17280

# Partition width for the events table, in ledgers (~7 days by default).
PARTITION_LEDGER_SPAN=120960

# debug | info | warn | error
LOG_LEVEL=info

# HTTP rate limiting (per client IP). Both must be set together to enable;
# when unset the middleware is a no-op (preserving existing behavior).
# RATE_LIMIT_RPS=10
# RATE_LIMIT_BURST=20

# Honour X-Forwarded-For for client IP detection. Only enable behind a
# trusted proxy that strips/rewrites the header — clients control XFF
# themselves, so enabling it on an Internet-facing surface lets any
# caller pick their own rate-limit key.
# RATE_LIMIT_TRUSTED_PROXY=false