.env.example

# Sub Rosa — environment template. Copy to .env and fill with real values.
# NEVER commit a populated .env. No mock values are used anywhere in this project.

# --- Stellar network ---
STELLAR_NETWORK=testnet
STELLAR_RPC_URL=https://soroban-testnet.stellar.org
STELLAR_NETWORK_PASSPHRASE="Test SDF Network ; September 2015"

# --- Deployed contract ---
ROUND_CONTRACT_ID=

# --- Signer for @sub-rosa/sdk (state-changing calls) ---
# Secret key (S…) of the account that signs & pays. Read-only calls don't need it.
STELLAR_SECRET_KEY=

# --- USDC (Stellar Asset Contract) ---
# testnet issuer: GBBD47IF6LWK7P7MDEVSCWR7DPUWV3NY3DTQEVFL4NAT4AQH3ZLLFLA5
USDC_SAC=

# --- Drand (quicknet) ---
# Validated against a live round before deploy (see services/drand-tools).
DRAND_CHAIN_HASH=52db9ba70e0cc0f6eaf7803dd07447a1f5477735fd3f661792ba94600c84e971
DRAND_API_URL=https://api.drand.sh

# --- OpenZeppelin Relayer Channels (optional submitter adapter) ---
# Direct Soroban RPC is the default. If both URL + key are set, SDK callers can
# pass createOzChannelsSubmitterFromEnv() into SubRosaClient({ submitter }).
OZ_CHANNELS_BASE_URL=https://channels.openzeppelin.com/testnet
OZ_CHANNELS_API_KEY=
# Self-hosted Relayer only:
OZ_CHANNELS_PLUGIN_ID=
OZ_CHANNELS_FUND_RELAYER_ID=
OZ_CHANNELS_TIMEOUT_MS=30000

# --- x402 appraisal API ---
X402_APPRAISAL_URL=
# Server runtime (minimal testnet config):
# FACILITATOR_SECRET=S…
# PAY_TO=G…
# X402_NETWORK=stellar:testnet
# NETWORK_PASSPHRASE="Test SDF Network ; September 2015"
# RPC_URL=https://soroban-testnet.stellar.org
# PAYMENT_ASSET=          # defaults to USDC for X402_NETWORK
# PRICE=0.10
# PORT=4021

# --- Keeper (services/keeper) ---
# KEEPER_SECRET=S…
# ROUND_CONTRACT_ID=C…
# KEEPER_DRY_RUN=true
# ROUND_ID=1
# WATCH_POLL_MS=15000
# WATCH_ROUND_IDS=1,2,5
# WATCH_FROM=1
# WATCH_MAX_ROUNDS=64

# --- Mainnet launch (value-moving commands) ---
# MAINNET_CONFIRM=SUB_ROSA_MAINNET
# OPERATOR_SECRET=S…        # signs deploy + settle
# BIDDER_SECRET=S…          # signs micro commit; defaults to OPERATOR_SECRET if unset
# MAINNET_DRY_RUN=1
# MICRO_BID_STROOPS=
# MICRO_ESCROW_STROOPS=