SoroTrail/.env.example at main · emmyafolly123-coder/SoroTrail · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
# 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

# API-originated store reads get a statement timeout and slow-query logging.
# API_QUERY_TIMEOUT=25s
# API_SLOW_QUERY_THRESHOLD=2s

# HTTP server timeouts. Zero disables the timeout for that field.
# HTTP_READ_TIMEOUT=30s
# HTTP_WRITE_TIMEOUT=30s
# HTTP_IDLE_TIMEOUT=60s
# HTTP_READ_HEADER_TIMEOUT=10s

# 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

# How long to wait for an in-flight request to finish during graceful
# shutdown. Zero means wait indefinitely. Default is 15s.
# SHUTDOWN_TIMEOUT=15s

# 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

# Horizon REST endpoint used by `sorotrail backfill` only — live
# ingestion does not touch Horizon.
HORIZON_URL=https://horizon-testnet.stellar.org

# Pace the backfill against Horizon. 10 req/s matches the public
# Horizon cap; private deployments may safely go higher.
# BACKFILL_RATE_RPS=10