.env.example

# ═══════════════════════════════════════════════════════════════════════════════
# CLAWDMINT ENVIRONMENT CONFIGURATION
# ═══════════════════════════════════════════════════════════════════════════════
# Copy this file to .env.local and fill in your values
# NEVER commit .env.local or any file containing real secrets
# ═══════════════════════════════════════════════════════════════════════════════

# ─────────────────────────────────────────────────────────────────────────────────
# DATABASE
# ─────────────────────────────────────────────────────────────────────────────────
# Development: SQLite
DATABASE_URL="file:./dev.db"

# Production: PostgreSQL (uncomment for production)
# DATABASE_URL="postgresql://user:password@host:5432/clawdmint?schema=public"

# ─────────────────────────────────────────────────────────────────────────────────
# BLOCKCHAIN - BASE NETWORK
# ─────────────────────────────────────────────────────────────────────────────────
# Chain ID: 8453 = Base Mainnet, 84532 = Base Sepolia Testnet
NEXT_PUBLIC_CHAIN_ID=84532

# Factory contract address (deployed via Foundry)
NEXT_PUBLIC_FACTORY_ADDRESS=

# Alchemy API Key - Get from https://dashboard.alchemy.com
NEXT_PUBLIC_ALCHEMY_ID=

# WalletConnect Project ID - Get from https://cloud.walletconnect.com
NEXT_PUBLIC_WALLET_CONNECT_ID=

# ─────────────────────────────────────────────────────────────────────────────────
# DEPLOYER & TREASURY (SERVER-SIDE ONLY - NEVER EXPOSE)
# ─────────────────────────────────────────────────────────────────────────────────
# Private key for deploying contracts and managing factory (without 0x prefix)
# Generate: cast wallet new
DEPLOYER_PRIVATE_KEY=

# Treasury address for platform fees
TREASURY_ADDRESS=

# Solana wallet that receives collector mint fees.
# Falls back to SOLANA_DEPLOYER_ADDRESS if omitted.
SOLANA_PLATFORM_FEE_RECIPIENT=

# MoonPay on-ramp for agent wallet funding
# Publishable + secret keys are used to generate signed SOL funding links for agent wallets.
MOONPAY_PUBLISHABLE_KEY=
MOONPAY_SECRET_KEY=
# Use "sandbox" while testing MoonPay, then switch to "production"
MOONPAY_ENVIRONMENT=production
MOONPAY_BASE_CURRENCY_CODE=usd
MOONPAY_BASE_CURRENCY_AMOUNT=50
MOONPAY_COLOR_CODE=#1cc8ff

# ─────────────────────────────────────────────────────────────────────────────────
# IPFS - PINATA
# ─────────────────────────────────────────────────────────────────────────────────
# Get from https://app.pinata.cloud/developers/api-keys
PINATA_API_KEY=
PINATA_SECRET_KEY=
PINATA_JWT=

# ─────────────────────────────────────────────────────────────────────────────────
# AGENT AUTHENTICATION
# ─────────────────────────────────────────────────────────────────────────────────
# HMAC secret for agent API authentication (min 32 characters)
# Generate: openssl rand -hex 32
AGENT_HMAC_SECRET=

# JWT secret for agent sessions (min 32 characters)
# Generate: openssl rand -hex 32
AGENT_JWT_SECRET=

# Encryption key for agent operational Solana wallets (min 32 characters)
# Generate: openssl rand -hex 32
AGENT_WALLET_ENCRYPTION_KEY=

# ─────────────────────────────────────────────────────────────────────────────────
# APPLICATION
# ─────────────────────────────────────────────────────────────────────────────────
NEXT_PUBLIC_APP_URL=http://localhost:3000
NEXT_PUBLIC_APP_NAME=Clawdmint
# When not "false", all /studio routes show Coming soon. Set to false in .env.local to work on the full studio UI.
NEXT_PUBLIC_STUDIO_COMING_SOON=true

# Environment: development | staging | production
NODE_ENV=development

# ─────────────────────────────────────────────────────────────────────────────────
# EXTERNAL APIS (OPTIONAL)
# ─────────────────────────────────────────────────────────────────────────────────
# Twitter/X API for tweet verification
# Get from https://developer.twitter.com
TWITTER_BEARER_TOKEN=

# Etherscan API for contract verification
# Get from https://basescan.org/myapikey
BASESCAN_API_KEY=

# FairScale wallet reputation (server-side only)
FAIRSCALE_API_KEY=
# Optional override. Defaults to https://api.fairscale.xyz
FAIRSCALE_API_BASE_URL=
# Optional split configuration:
# Agent wallet score calls can use the Agent & Credit API. If that host returns an error, the server retries the main API (see FAIRSCALE_HUMAN_API_BASE_URL) using the human key or FAIRSCALE_API_KEY.
FAIRSCALE_AGENT_API_KEY=
FAIRSCALE_AGENT_API_BASE_URL=https://agent-api.fairscale.xyz
# Owner wallet / human score calls can stay on the Human Score API
FAIRSCALE_HUMAN_API_KEY=
FAIRSCALE_HUMAN_API_BASE_URL=https://api.fairscale.xyz

# Optional: custom Solana RPC (server-side) or Synapse RPC URL; keeps keys off the client when set.
# See: https://explorer.oobeprotocol.ai/docs/best-practices/rpc-and-network-configuration
SYNAPSE_SOLANA_RPC_URL=
SYNAPSE_API_KEY=
# Optional: full node for Metaplex `getProgramAccounts` / GPA scans (marketplace collection index).
# Used as the secondary fallback when `SYNAPSE_SOLANA_RPC_URL` either errors out
# or returns an empty page for an indexed Metaplex Core collection. Helius /
# Triton-class endpoints work well here. If unset, the public cluster URL for
# the current `NEXT_PUBLIC_SOLANA_CLUSTER` is used as the last resort.
SOLANA_GPA_RPC_URL=

# Marketplace asset sync uses paginated `getProgramAccountsV2` by default.
# The helper iterates GPA-capable RPC endpoints in priority order:
#   1. SYNAPSE_SOLANA_RPC_URL  (preferred — Synapse OOBE mainnet)
#   2. SOLANA_GPA_RPC_URL      (fallback — e.g. Helius)
#   3. Public mainnet/devnet cluster (last resort)
# An endpoint that errors out or returns 0 entries advances to the next one;
# the first non-empty result is returned. If every endpoint fails, the sync
# fails-soft with an empty snapshot.
#
# Optional opt-out: set to "true" to skip the on-chain GPA snapshot entirely
# and rely only on the database mint history (e.g. while debugging an RPC).
MARKETPLACE_GPA_V2_DISABLED=

# Synapse Agent Protocol (SAP) on-chain registration.
# Official path from https://explorer.oobeprotocol.ai/docs/examples/register-agent:
# the agent operational wallet signs SAP AgentAccount registration through @oobe-protocol-labs/synapse-sap-sdk.
# Enable only when agent wallets are funded for SAP program rent/fees on the selected Solana cluster.
SYNAPSE_SAP_ONCHAIN_ENABLED=false
# Optional override; defaults to NEXT_PUBLIC_APP_URL/api/x402/pricing.
SYNAPSE_SAP_X402_ENDPOINT=
SYNAPSE_SAP_PRICE_PER_CALL_LAMPORTS=1000
SYNAPSE_SAP_RATE_LIMIT=60
# Max time to wait for optional SAP registration during identity sync. 0 disables this guard.
SYNAPSE_SAP_TIMEOUT_MS=8000
SYNAPSE_SAP_INDEXING_ENABLED=true

# Optional legacy HTTP proxy only: routes JSON-RPC through this app to a merchant host.
# Not required for official SAP on-chain registration or x402 payment flow.
SYNAPSE_SAP_BASE_URL=https://merchant.synapse.network
SYNAPSE_SAP_TOKEN=
SYNAPSE_SAP_FALLBACK_TO_RPC=true
# Base URL of this app (used only if SYNAPSE_SAP_TOKEN is set) so the proxy can call /api/synapse-sap/rpc
CLAWDMINT_INTERNAL_BASE_URL=http://127.0.0.1:3000

# Solana collection deployment
# Use `devnet` while testing, then switch to `mainnet-beta`
NEXT_PUBLIC_SOLANA_CLUSTER=devnet
# Optional custom Solana RPC. Leave blank to use Solana public cluster URL.
# IMPORTANT: This must match NEXT_PUBLIC_SOLANA_CLUSTER.
# devnet example: https://api.devnet.solana.com
# mainnet example: https://api.mainnet-beta.solana.com
NEXT_PUBLIC_SOLANA_RPC_URL=
# Deployed Solana collection program ID (server-side canonical value)
SOLANA_COLLECTION_PROGRAM_ID=
# Optional client-side mirror for UI/debug surfaces. Usually same as SOLANA_COLLECTION_PROGRAM_ID.
NEXT_PUBLIC_SOLANA_COLLECTION_PROGRAM_ID=

# Solana program deploy wallet
# Public key of the wallet that will pay deployment fees
SOLANA_DEPLOYER_ADDRESS=
# Secret key for the deploy wallet.
# Preferred format: base58-encoded 64-byte secret key exported from Solana wallet tooling.
SOLANA_DEPLOYER_PRIVATE_KEY=