.env.example

# Server
PORT=3000

# Logging
LOG_LEVEL=info
LOG_FORMAT=text

# Database Configuration
# RECOMMENDED: Use DATABASE_URL for cloud deployments (supports both methods)
# DATABASE_URL=postgresql://user:password@localhost:5432/scoopdope

# OR use individual environment variables (for non-cloud deployments)
DATABASE_HOST=localhost
DATABASE_PORT=5432
DATABASE_USER=your_db_user
DATABASE_PASSWORD=your_db_password
DATABASE_NAME=scoopdope

# Database Options
DB_LOGGING=false
DB_POOL_SIZE=10
DB_IDLE_TIMEOUT=10000
DB_SSL_REJECT_UNAUTHORIZED=true

# NOTE: TypeORM synchronize is ALWAYS disabled - use migrations in production

# Auth
JWT_SECRET=your_jwt_secret

# Google OAuth
GOOGLE_CLIENT_ID=your_google_client_id
GOOGLE_CLIENT_SECRET=your_google_client_secret
GOOGLE_CALLBACK_URL=http://localhost:3000/auth/google/callback

# Stellar
STELLAR_NETWORK=testnet
# STELLAR_SECRET_KEY is OPTIONAL. Without it, read-only operations (querying balances, transactions) work,
# but signing operations (issuing credentials, minting tokens, recording progress) will fail with 503 Service Unavailable.
# Required for: credential issuance, token minting, progress recording, metadata storage
STELLAR_SECRET_KEY=your_stellar_secret_key
STELLAR_HORIZON_URL=https://horizon-testnet.stellar.org

# Soroban
SOROBAN_RPC_URL=https://soroban-testnet.stellar.org
ANALYTICS_CONTRACT_ID=your_analytics_contract_id
TOKEN_CONTRACT_ID=your_token_contract_id
INDEXER_POLL_INTERVAL_MS=5000
STELLAR_WEB_AUTH_DOMAIN=localhost

# Redis
# Option 1: Use REDIS_URL (preferred for most cloud providers)
REDIS_URL=redis://localhost:6379

# Option 2: Use individual configuration variables (for advanced setups)
# Uncomment the following if not using REDIS_URL
# REDIS_HOST=localhost
# REDIS_PORT=6379
# REDIS_PASSWORD=your_redis_password
# REDIS_DB=0

# Example cloud provider configurations:
# AWS ElastiCache:     redis://:password@your-cluster.xxxxx.ng.0001.use1.cache.amazonaws.com:6379/0
# Redis Cloud:         redis://:password@redis-xxxxx.c251.us-east-1-2.ec2.cloud.redislabs.com:12345/0
# Heroku Redis:        redis://default:password@host:port
# Local Development:   redis://localhost:6379

# Throttler
THROTTLE_TTL=60000
THROTTLE_LIMIT=100

# Email
EMAIL_ENABLED=false
EMAIL_HOST=smtp.example.com
EMAIL_PORT=587
EMAIL_SECURE=false
EMAIL_USER=your_email_user
EMAIL_PASS=your_email_password
EMAIL_FROM="Scoopdope" <no-reply@Scoopdope.app>
FRONTEND_URL=http://localhost:3001

# CORS Configuration
CORS_ORIGINS=http://localhost:3001,http://localhost:3000
CORS_CREDENTIALS=true
CORS_MAX_AGE=86400

# Rate Limiting
THROTTLE_TTL=60000
THROTTLE_LIMIT=60

# Sentry
SENTRY_DSN=your_sentry_dsn_here
GIT_COMMIT_SHA=

# Frontend
NEXT_PUBLIC_API_URL=http://localhost:3000
NEXT_PUBLIC_STELLAR_NETWORK=testnet
NEXT_PUBLIC_SENTRY_DSN=your_sentry_dsn_here
NEXT_PUBLIC_GIT_COMMIT_SHA=

# KYC
KYC_PROVIDER_API_KEY=

# AWS (used for Comprehend content moderation)
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=your_aws_access_key_id
AWS_SECRET_ACCESS_KEY=your_aws_secret_access_key

# Content Moderation
MODERATION_TOXICITY_THRESHOLD=0.7

# Elasticsearch
ELASTICSEARCH_NODE=http://localhost:9200
ELASTICSEARCH_API_KEY=

# Stripe (fiat payments)
STRIPE_SECRET_KEY=sk_test_your_stripe_secret_key
STRIPE_WEBHOOK_SECRET=whsec_your_stripe_webhook_secret
STRIPE_PRO_PRICE_ID=price_your_pro_price_id
STRIPE_ENTERPRISE_PRICE_ID=price_your_enterprise_price_id

# Exchange Rate API (optional — omit to use free open.er-api.com)
# Get a key at https://www.exchangerate-api.com/
EXCHANGE_RATE_API_KEY=

# OpenTelemetry (Tracing)
# Sampling rate for traces (0.0-1.0). Use 1.0 for development to sample all traces.
# In production, consider using 0.1 or lower to reduce trace volume and storage costs.
OTEL_SAMPLING_RATE=1.0