Deploying to Production

Checklist and guides for deploying your paid API to production.

Last updated: December 23, 2025

1. Environment Variables

Your production environment must have these variables set.

bash
# .env.production
METER_PROJECT_ID=proj_abc123xyz
METER_HMAC_SECRET=your-production-secret

2. Platform Specifics

Vercel / Netlify / Railway

Add the variables above in your platform's dashboard under Settings → Environment Variables.

Cloudflare Workers

Use the CLI to add secrets securely:

bash
wrangler secret put METER_PROJECT_ID
wrangler secret put METER_HMAC_SECRET

3. Mainnet Migration (Base/CDP)

When you are ready to move from testnet to mainnet, you need to update your Action Registry configuration. Atomic Rail is optimized for Base Mainnet via the Coinbase Developer Platform (CDP).

Migration Steps

  1. Registry Update: In your dashboard, change the Expected Network for all live actions from base-sepolia to base (CAIP-2 eip155:8453).
  2. Wallet Check: Ensure your sellerWallet is a mainnet address that you control.
  3. Client Update: Update your frontend to connect to Base Mainnet. If you are using Viem, switch baseSepolia to base.

Why Base?

Base offers the lowest fees and highest throughput for micro-payments, making it the ideal network for metered API actions. Using CDP infrastructure ensures enterprise-grade reliability for your payment verification.

4. Production Checklist

Before Deploying

  • Registry Configured: Ensure your production apiPath values are correctly set in the Action Registry.
  • Update Base URL: In Settings → General, change your Application Base URL from localhost to your production domain (e.g., https://api.acme.com).
  • Facilitator Verified: Ensure your Facilitator URL is set to the production facilitator if you are moving off testnet.
  • Wallet Correct: Verify your sellerWallet in your AtomicGate initialization is your real production wallet.
  • Debug Mode OFF: Ensure debug: false is set for production.

After Deploying

  • Test 402: Run curl -i https://your-api.com/api/premium. You should see a 402 Payment Required status.
  • Run Simulation: Use the Interactive Playground on your live production URL to verify the end-to-end pipeline.
  • Check Logs: Ensure the simulated event appears in your dashboard.

5. Scaling

Atomic Rail is built on a high-concurrency event ingestion engine. As your traffic grows, you don't need to change anything.

Note: If you hit the 10,000 request/month limit on the Free plan, you will need to upgrade to a Pro plan in the dashboard to avoid event dropping.