Alchemy Prod Checklist

Alchemy Production Checklist

Overview

Use this checklist to make a deliberate go/no-go decision for an Alchemy-powered application. It covers provider isolation, key custody, application security, contract controls, performance, monitoring, and a reversible launch path.

Prerequisites

• Named engineering, security, product, and operations owners who can block a release, plus an approved deployment window and rollback target.
• Separate production application and managed-secret bindings that have been tested in staging without reusing local or testnet credentials.
• A documented user-impact fallback for provider outages, contract incidents, and unsafe chain-data results.

Instructions

1. Assign an owner and evidence link to each pre-launch item, treating an unchecked security, provider, or contract control as a release blocker.
2. Run the readiness script using the production deployment identity and inspect only its redacted results.
3. Exercise the rollback or disable flag in staging, verify operator alerts, and record the owner who will make the launch decision.
4. Enable traffic progressively and stop expansion when any listed threshold or safety invariant fails.

Pre-Launch Checklist

API & Infrastructure

• API key restricted to production domains in Alchemy Dashboard
• Separate Alchemy apps for dev/staging/prod environments
• Rate limit headroom verified (< 70% of CU/sec budget)
• Retry logic with exponential backoff implemented
• Error monitoring configured (Sentry, Datadog, etc.)
• Webhook endpoints HTTPS-only with signature verification

Security

• API key NOT in frontend code — proxied through backend
• Private keys in secret manager (not env files)
• All user-supplied addresses validated and checksummed
• No console.log of sensitive data in production builds
• npm audit clean — no critical vulnerabilities

Smart Contracts (if applicable)

• Contracts audited by reputable firm
• Deployed and verified on Etherscan/Polygonscan
• Admin keys secured in multi-sig wallet
• Emergency pause function tested

Performance

• Response caching for frequently-queried data (balances, metadata)
• Connection pooling for provider instances
• Batch requests where possible (NFT metadata, balances)
• WebSocket reconnection logic for real-time subscriptions

Validation Script

// src/prod/readiness.ts
import { Alchemy, Network } from 'alchemy-sdk';

async function checkReadiness(): Promise<void> {
  const checks: Array<{ name: string; pass: boolean; detail: string }> = [];

  // 1. API connectivity
  const alchemy = new Alchemy({ apiKey: process.env.ALCHEMY_API_KEY, network: Network.ETH_MAINNET });
  try {
    const block = await alchemy.core.getBlockNumber();
    checks.push({ name: 'API Connectivity', pass: true, detail: `Block ${block}` });
  } catch (err: any) {
    checks.push({ name: 'API Connectivity', pass: false, detail: err.message });
  }

  // 2. Enhanced API
  try {
    await alchemy.core.getTokenBalances('0x0000000000000000000000000000000000000000');
    checks.push({ name: 'Enhanced API', pass: true, detail: 'getTokenBalances works' });
  } catch { checks.push({ name: 'Enhanced API', pass: false, detail: 'Enhanced API unavailable' }); }

  // 3. NFT API
  try {
    await alchemy.nft.getContractMetadata('0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D');
    checks.push({ name: 'NFT API', pass: true, detail: 'getContractMetadata works' });
  } catch { checks.push({ name: 'NFT API', pass: false, detail: 'NFT API unavailable' }); }

  // 4. API key not in build output
  const fs = await import('fs');
  const buildDir = './dist';
  if (fs.existsSync(buildDir)) {
    const content = fs.readdirSync(buildDir, { recursive: true })
      .filter((f: any) => f.toString().endsWith('.js'))
      .map((f: any) => fs.readFileSync(`${buildDir}/${f}`, 'utf8'))
      .join('');
    const apiKeyExposed = content.includes(process.env.ALCHEMY_API_KEY || '');
    checks.push({ name: 'API Key Safety', pass: !apiKeyExposed, detail: apiKeyExposed ? 'CRITICAL: API key found in build!' : 'API key not in build' });
  }

  // Print results
  console.log('\n=== Alchemy Production Readiness ===\n');
  for (const c of checks) {
    console.log(`[${c.pass ? 'PASS' : 'FAIL'}] ${c.name}: ${c.detail}`);
  }
  const failures = checks.filter(c => !c.pass);
  console.log(`\n${failures.length === 0 ? 'READY FOR PRODUCTION' : `${failures.length} BLOCKING ISSUES`}`);
}

checkReadiness().catch(console.error);

Output

• All checklist items validated
• Readiness script with pass/fail reporting
• API key exposure scan in build output
• Multi-network connectivity verified

Examples

For a mainnet release rehearsal, complete the checklist in staging with the production-shaped secret bindings, run the readiness script, and record the revision, redacted pass/fail output, rate-limit headroom, and rollback owner. Launch only when every required check passes and the service can be disabled without exposing an API key or abandoning a user operation. If the build scan finds a key, a contract safety control is incomplete, or provider connectivity fails, declare a no-go, revoke or correct the affected configuration, and rerun the full readiness check rather than accepting a partial result.

Error Handling

Resources

• Alchemy Docs
• Alchemy Dashboard

Next Steps

For version upgrades, see alchemy-upgrade-migration.