.env.example

# Polygon mainnet RPC endpoint (required for chain_id=137 keys).
# A reliable, low-latency endpoint is required — public RPCs may rate-limit.
POLYGON_RPC_URL=https://polygon-rpc.com

# Polygon Amoy testnet RPC endpoint (required for chain_id=80002 keys).
AMOY_RPC_URL=https://rpc-amoy.polygon.technology

# Facilitator wallet private key (required, 0x-prefixed 32-byte hex).
# Holds MATIC for gas. Never commit a real key.
FACILITATOR_PRIVATE_KEY=0x0000000000000000000000000000000000000000000000000000000000000000

# Supabase service-role credentials (required) for API key lookup.
SUPABASE_URL=https://<project>.supabase.co
SUPABASE_SERVICE_ROLE_KEY=<service-role-key>

# Upstash Redis (required in production for replay protection).
UPSTASH_REDIS_REST_URL=https://<region>-<id>.upstash.io
UPSTASH_REDIS_REST_TOKEN=<token>

# Replay-protection failure mode. Default (unset / false) = fail-closed:
# if Redis is unreachable, /settle returns 503 instead of broadcasting.
# Set true only if you intentionally accept the risk of a duplicate
# broadcast during a Redis outage.
REPLAY_FAIL_OPEN=false

# Tagamie webhook (optional). Both must be set to enable.
# When enabled, mainnet /settle successes POST event data to Tagamie for
# monthly aggregation + invoice PDF + freee. Failures are logged, never
# block the settle response. Mainnet only (polygon).
TAGAMIE_WEBHOOK_URL=
TAGAMIE_WEBHOOK_SECRET=