.env.example

# Privy App ID for wallet onboarding (https://dashboard.privy.io)
NEXT_PUBLIC_PRIVY_APP_ID=your_privy_app_id
# Solana RPC URL — use a paid provider (e.g. Helius) for production
# Mainnet: https://mainnet.helius-rpc.com/?api-key=YOUR_HELIUS_API_KEY
# Devnet:  https://api.devnet.solana.com
NEXT_PUBLIC_SOLANA_RPC_URL=https://api.devnet.solana.com
# Public app URL used for metadata/OpenGraph absolute URLs
NEXT_PUBLIC_SITE_URL=http://localhost:3000
# Optional private RPC override for server-side fetches (can share same Helius key)
SOLANA_RPC_URL=https://api.devnet.solana.com
# Optional comma-separated client fallback RPC URLs (used when the primary endpoint is unavailable)
NEXT_PUBLIC_SOLANA_RPC_FALLBACK_URLS=

# Hetzner Object Storage (S3 Compatible)
HETZNER_ACCESS_KEY_ID=your_access_key
HETZNER_SECRET_ACCESS_KEY=your_secret_key
HETZNER_BUCKET_NAME=blocs-storage
HETZNER_REGION=fsn1
HETZNER_ENDPOINT=https://fsn1.your-objectstorage.com
# Optional public URL base for uploaded assets (defaults to <HETZNER_ENDPOINT>/<HETZNER_BUCKET_NAME>)
HETZNER_PUBLIC_BASE_URL=https://fsn1.your-objectstorage.com/blocs-storage

# Optional shared upload guards (recommended for multi-instance deployments)
UPSTASH_REDIS_REST_URL=
UPSTASH_REDIS_REST_TOKEN=
# In production, upload API requires shared guards unless this is explicitly set to true.
ALLOW_IN_MEMORY_UPLOAD_GUARDS=false

# Optional webhook target for forwarded client crash reports from /api/client-errors
ERROR_REPORT_WEBHOOK_URL=

# Optional public image URL checked by /api/health to verify object-storage public readability.
# Example: https://<public-bucket-host>/<bucket>/health-probe.webp
HEALTH_PUBLIC_READ_PROBE_URL=