alchemy-common-errors

name	alchemy-common-errors
description	Diagnose and fix common Alchemy SDK and Web3 API errors. Use when encountering rate limits, RPC failures, invalid parameters, or blockchain query errors with the Alchemy SDK. Trigger: "alchemy error", "alchemy not working", "alchemy 429", "alchemy debug", "fix alchemy issue".
allowed-tools	Read, Write, Edit, Bash(curl:*), Grep
version	1.5.0
license	MIT
author	Jeremy Longshore <[e-mail]>
tags	["saas","blockchain","web3","alchemy","troubleshooting"]
compatibility	Designed for Claude Code

Alchemy Common Errors

Overview

Troubleshooting guide for Alchemy SDK errors covering rate limits, RPC failures, invalid parameters, and network-specific issues.

Error Reference

Authentication & Rate Limits

HTTP Code	Error	Root Cause	Fix
401	Unauthorized	Invalid or missing API key	Verify key in Alchemy Dashboard
403	Forbidden	API key disabled or app deleted	Create new app in Dashboard
429	Too Many Requests	Rate limit exceeded	Implement backoff; upgrade plan
429	Compute Units exceeded	CU quota depleted	Check CU usage in Dashboard

Alchemy Rate Limits by Plan

Plan	Compute Units/sec	Throughput
Free	330 CU/s	~25 requests/s
Growth	660 CU/s	~50 requests/s
Scale	Custom	Custom

RPC & Query Errors

// Common RPC error handler
import { Alchemy, Network } from 'alchemy-sdk';

async function safeAlchemyCall<T>(
  operation: () => Promise<T>,
  context: string
): Promise<T | null> {
  try {
    return await operation();
  } catch (error: ) {
     code = error. || error.?.;

     (code) {
       -: 
        .();
        .();
        ;

       -: 
        .();
        ;

       -: 
        .();
        .();
        ;

       -: 
        .();
        ;

       :
         retryAfter = error.?.?.[] || ;
        .();
        ;

      :
        .();
    }
     ;
  }
}