Configuration

Configure these environment variables in Vercel after deployment.

Blockchain configuration

• PRIVATE_KEY (required): Private key of the facilitator account (no 0x prefix). Must have funds for gas.
• RPC_URL_ETHEREUM (optional): Ethereum mainnet RPC.
• RPC_URL_BASE (optional): Base mainnet RPC.
• RPC_URL_SEPOLIA (optional): Ethereum Sepolia RPC.
• RPC_URL_BASE_SEPOLIA (optional): Base Sepolia RPC.

At least one RPC URL must be set. /supported only lists networks that are configured.

API authentication (optional)

Choose one of the following:

Option 1: Static API key

• STATIC_API_KEY: Single key for all requests. Required in X-API-Key.

Option 2: Database-backed keys

• DATABASE_URL: Postgres connection string.
• DATABASE_QUERY (optional): Custom query to validate keys. Must accept $1 and return a row if valid.

Do not set both STATIC_API_KEY and DATABASE_URL. If neither is set, endpoints are public.

Vercel steps

1. Open your Vercel project settings.
2. Add environment variables.
3. Redeploy for changes to take effect.