.env.example

# --- data-ingestion-go ---
REDIS_URL=redis://localhost:6379/0
# Real live boards. Run ONE ingestor process per provider; the pollers need no
# credentials (they read the books' public live JSON):
PROVIDER_MODE=helabet
#   helabet     = real Helabet live 1X2 board + in-play stats (no credentials)
#   betpawa     = real BetPawa live 1X2 odds/scores via pawablox gateway
#   apifootball = paid API (requires APIFOOTBALL_KEY)
#   mock        = local simulator; requires PROVIDER_WS_URL below
# PROVIDER_WS_URL=ws://localhost:19999/vendor
# HELABET_BASE_URL=https://helabet.co.tz
# HELABET_POLL_SECONDS=5
# BETPAWA_BASE_URL=https://www.betpawa.co.tz
# BETPAWA_BRAND=betpawa-tanzania
# BETPAWA_POLL_SECONDS=5
MARKETS_SCOPE=1H_1X2,2H_1X2,CS_1H,CS_2H

# --- analytics-engine-py ---
ANALYTICS_IN_CHANNEL=matches:live
EXECUTION_OUT_CHANNEL=execution:commands
DIAGNOSTICS_CHANNEL=diagnostics:events
# Requests the execution engine, which listens on 8081 locally:
EXECUTION_SERVICE_URL=http://localhost:8081
INTERNAL_AUTH_SECRET=local-dev-secret
MIN_TRIGGER_ODDS=5.0
TRUE_PROB_MARGIN_SLACK=0.02
STAKE_AMOUNT=25.0

# --- mock-vendor ---
# Local simulator: vendor feed + bookmaker, no external credentials.
# NOT part of the real-data chain (start-local.ps1 no longer launches it);
# used only by the test suite and offline demos.
MOCK_VENDOR_PORT=19999
MOCK_TRADE_PORT=19998
REDIS_URL=redis://localhost:6379/0      # settlement bus (bookmaker:settlements)
SETTLE_CHANNEL=bookmaker:settlements

# --- execution-engine-go ---
# PAPER_TRADE=true grades paper fills against the REAL full-time scores the
# feed pollers publish on matches:live (no bookmaker WebSocket needed).
# Live real-money mode (requires a real bookmaker gateway):
#   PAPER_TRADE unset, BOOKMAKER_WS_URL + BOOKMAKER_API_KEY set.
PAPER_TRADE=true
BOOKMAKER_API_KEY=local-test-key
# Local mock bookmaker (unused in paper mode; test/demo only):
# BOOKMAKER_WS_URL=ws://localhost:19998/trade
# Production:
# BOOKMAKER_WS_URL=wss://bookmaker.example.com/trade
LISTEN_ADDR=:8081
# PnL feedback: reads graded results, publishes snapshots + accumulates pnl:session
SETTLE_IN_CHANNEL=bookmaker:settlements
PNL_OUT_CHANNEL=execution:pnl
PNL_HASH=pnl:session

# --- web-interface-js/frontend ---
# The relay serves WebSocket upgrades on /ws.
NEXT_PUBLIC_WS_BACKEND_URL=ws://localhost:8080/ws

# --- web-interface-js/backend (relay) ---
# Pre-shared secret for the admin tier. Public WebSocket clients only see the
# live match feed; /api/stats and admin channels (pnl, diagnostics,
# execution:commands) require a session token issued from /api/auth/token
# using this secret. Set once into the relay process env.
ADMIN_SECRET=local-admin-secret