.env.example

# ── Required ──────────────────────────────────────────────────────────────────

# Starknet JSON-RPC endpoint (http or https)
APP_RPC_URL=https://api.zan.top/public/starknet-mainnet/rpc/v0_10

# ── Optional: WebSocket ───────────────────────────────────────────────────────

# WebSocket endpoint for live new-block subscriptions (falls back to polling)
# APP_WS_URL=ws://localhost:9545/ws

# ── Optional: Pathfinder query service ───────────────────────────────────────

# URL of a running pf-query instance for fast nonce history (see crates/pf-query)
# APP_PATHFINDER_SERVICE_URL=http://localhost:8234

# ── Optional: API keys ────────────────────────────────────────────────────────

# Voyager API key — enriches address labels (paid API, optional luxury feature)
# When set: fetches contract names/types on address lookup, cached locally 24h
# Status bar shows green when connected, labels appear with ⬡ marker
# VOYAGER_API_KEY=

# Dune Analytics API key — enables reverted-tx detection and contract call history
# DUNE_API_KEY=

# Mark dynamic Dune queries as private (default: true). Set to false to dodge
# the per-account private-query quota when it's exhausted; archive-on-finish
# cleanup still runs either way, so the queries stay temporary.
# DUNE_PRIVATE_QUERIES=true

# ── Labels & registry ─────────────────────────────────────────────────────────

# Path to user-defined labels file (default: labels.toml in the working directory)
# APP_USER_LABELS=labels.toml

# Path to privacy-pool viewing keys file. Held separately from labels.toml
# because the keys are SECRETS — do not commit. Default: viewing_keys.toml in
# the working directory (or ~/.config/snbeat/viewing_keys.toml for global installs).
# APP_VIEWING_KEYS=viewing_keys.toml

# ── Logging ───────────────────────────────────────────────────────────────────

# Log level: trace | debug | info | warn | error  (default: info)
# APP_LOG_LEVEL=info

# Directory for log files (default: ~/.config/snbeat/logs)
# APP_LOG_DIR=

# ── pf-query service (crates/pf-query) ───────────────────────────────────────
# These variables are used when running the pf-query binary, not snbeat itself.

# Path to the Pathfinder SQLite database
# PF_DB_PATH=/var/lib/pathfinder/pathfinder.db

# Port the pf-query HTTP service listens on (default: 8234)
# PF_PORT=8234