Veyronn Documentation

Environment Variables

Place public configuration and private service credentials correctly.

Public web configuration

These values may be exposed to the browser:

NEXT_PUBLIC_VEYRONN_CHAIN_ID
NEXT_PUBLIC_VEYRONN_RPC_URL
NEXT_PUBLIC_VEYRONN_ORACLE_SOURCE
NEXT_PUBLIC_VEYRONN_PROTOCOL_ADDRESS
NEXT_PUBLIC_VEYRONN_VAULT_ADDRESS
NEXT_PUBLIC_VEYRONN_ORACLE_ROUTER_ADDRESS
NEXT_PUBLIC_VEYRONN_STRATEGY_NFT_ADDRESS
NEXT_PUBLIC_VEYRONN_COLLATERAL_TOKEN_ADDRESS
NEXT_PUBLIC_VEYRONN_START_BLOCK
NEXT_PUBLIC_VEYRONN_<SYMBOL>_MARKET_ID
NEXT_PUBLIC_KEEPER_EXECUTOR_ADDRESS
NEXT_PUBLIC_SITE_URL

BFF-only variables

VEYRONN_BACKEND_URL
VEYRONN_CANONICAL_FRONTEND_URL
DATABASE_URL
KEEPER_SERVICE_URL
KEEPER_API_TOKEN
PYTH_API_KEY
PYTH_BENCHMARKS_API_KEY
OPENAI_API_KEY

VEYRONN_BACKEND_URL belongs on Vercel for API proxying. Database and provider credentials belong only on Railway.

Indexer variables

VEYRONN_CHAIN_ID
VEYRONN_RPC_URL
VEYRONN_START_BLOCK
VEYRONN_CONFIRMATIONS
VEYRONN_PROTOCOL_ADDRESS
VEYRONN_VAULT_ADDRESS
VEYRONN_ORACLE_ROUTER_ADDRESS
VEYRONN_STRATEGY_NFT_ADDRESS
VEYRONN_COLLATERAL_TOKEN_ADDRESS
DATABASE_URL
INDEXER_BATCH_SIZE
INDEXER_POLL_INTERVAL_MS
PORT

Keeper variables

In addition to shared chain and contract configuration:

KEEPER_PRIVATE_KEY
KEEPER_API_TOKEN
KEEPER_INTERVAL_MS
KEEPER_REACTIVE_INTERVAL_MS
KEEPER_RECEIPT_CONFIRMATIONS
KEEPER_MAX_ACTIONS_PER_CYCLE
VEYRONN_SIGNED_ORACLE_PRIVATE_KEY
VEYRONN_ORACLE_SOURCE
VEYRONN_PYTH_HERMES_URL
PYTH_API_KEY
VEYRONN_ORACLE_MAX_SOURCE_AGE_SECONDS
VEYRONN_ORACLE_MAX_CONFIDENCE_BPS
VEYRONN_SIGNED_ORACLE_REPORT_TTL_SECONDS

Mainnet Data Streams

CHAINLINK_DATA_STREAMS_API_KEY
CHAINLINK_DATA_STREAMS_USER_SECRET
CHAINLINK_DATA_STREAMS_ENDPOINT
CHAINLINK_DATA_STREAMS_WS_ENDPOINT
VEYRONN_DATA_STREAMS_MAX_REPORT_AGE_SECONDS
VEYRONN_DATA_STREAMS_MARKETS_JSON

Rules

Never commit a populated .env file.
Never prefix secrets with NEXT_PUBLIC_.
Use separate keys and databases for testnet and mainnet.
Rotate any credential disclosed outside the intended secret manager.
Keep Mintlify MCP credentials outside this repository; they are unrelated to application runtime.