.env.example

# Census3 BigQuery Service Configuration
# Copy this file to .env and configure your values

# Required: GCP Project ID for BigQuery
# Get this from: gcloud config get-value project
CENSUS3_PROJECT=your-gcp-project-id

# Service Configuration
CENSUS3_API_PORT=8080
CENSUS3_DATA_DIR=/app/.bigcensus3
# Log level: trace, debug, info, warn, error, fatal, panic (default: info)
CENSUS3_LOG_LEVEL=info
CENSUS3_BATCH_SIZE=10000
CENSUS3_MAX_CENSUS_SIZE=1000000

# Query Configuration File
# Path to the YAML file containing query configurations
# Copy queries.yaml.example to queries.yaml and customize
CENSUS3_QUERIES_FILE=/app/queries.yaml

# Google Cloud Authentication
# Base64 encoded service account key (required for BigQuery queries)
# Generate with: base64 -w 0 gcp-service-account-key.json
GOOGLE_APPLICATION_CREDENTIALS_JSON=your-base64-encoded-service-account-key-here

# Alternative: Default Credentials (Production on GCP only)
# If running on Google Cloud Platform, comment out GOOGLE_APPLICATION_CREDENTIALS_JSON
# and the service will use default credentials automatically

# Alchemy API Configuration
# Required for Alchemy queries (NFT holders, token balances, etc.)
# Get your API key from: https://www.alchemy.com/
ALCHEMY_API_KEY=your-alchemy-api-key-here

# Docker Configuration
RESTART=unless-stopped

# Localhost Only (true/false): if true, the API server will not use any external
# service (e.g., BigQuery, Alchemy). It only serves data stored locally.
CENSUS3_LOCAL_ONLY=false