Alchemy Install & Auth
Overview
Install the alchemy-sdk npm package and configure API authentication. Alchemy provides blockchain infrastructure (RPC nodes, Enhanced APIs, NFT APIs, webhooks) across Ethereum, Polygon, Arbitrum, Optimism, Base, and Solana.
Prerequisites
- Node.js 18+ (or Python 3.10+ for alchemy-sdk Python)
- Free Alchemy account at alchemy.com
- API key from Alchemy Dashboard
Instructions
Step 1: Install the Alchemy SDK
# JavaScript/TypeScript (official SDK)
npm install alchemy-sdk
# Python (community SDK)
pip install alchemy-sdk
Step 2: Create an Alchemy App
- Go to dashboard.alchemy.com
- Click "Create new app"
- Select chain: Ethereum, Polygon, Arbitrum, Optimism, Base, or Solana
- Select network: Mainnet, Sepolia (testnet), or Mumbai
- Copy the API key
Step 3: Configure Environment
# Set environment variable
export ALCHEMY_API_KEY="your-api-key-here"
# Or create .env file
cat > .env << 'EOF'
ALCHEMY_API_KEY=your-api-key-here
ALCHEMY_NETWORK=ETH_MAINNET
EOF
echo ".env" >> .gitignore
Step 4: Initialize and Verify
// src/alchemy-client.ts
import { Alchemy, Network } from 'alchemy-sdk';
const alchemy = new Alchemy({
apiKey: process.env.ALCHEMY_API_KEY,
network: Network.ETH_MAINNET,
});
// Verify connection
async function verifyConnection() {
const blockNumber = await alchemy.core.getBlockNumber();
console.log(`Connected! Latest block: ${blockNumber}`);
return blockNumber;
}
verifyConnection().catch(console.error);
Step 5: Multi-Chain Configuration
// src/config/chains.ts
import { Alchemy, Network } from 'alchemy-sdk';
// Create clients for multiple chains
const chains = {
ethereum: new Alchemy({ apiKey: process.env.ALCHEMY_API_KEY, network: Network.ETH_MAINNET }),
polygon: new Alchemy({ apiKey: process.env.ALCHEMY_API_KEY, network: Network.MATIC_MAINNET }),
arbitrum: new Alchemy({ apiKey: process.env.ALCHEMY_API_KEY, network: Network.ARB_MAINNET }),
optimism: new Alchemy({ apiKey: process.env.ALCHEMY_API_KEY, network: Network.OPT_MAINNET }),
base: new Alchemy({ apiKey: process.env.ALCHEMY_API_KEY, network: Network.BASE_MAINNET }),
};
export default chains;
Supported Networks
| Chain |
Network Enum |
Mainnet |
Testnet |
| Ethereum |
ETH_MAINNET |
Yes |
Sepolia |
| Polygon |
MATIC_MAINNET |
Yes |
Amoy |
| Arbitrum |
ARB_MAINNET |
Yes |
Sepolia |
| Optimism |
OPT_MAINNET |
Yes |
Sepolia |
| Base |
BASE_MAINNET |
Yes |
Sepolia |
| Solana |
SOL_MAINNET |
Yes |
Devnet |
Output
alchemy-sdk installed in node_modules
- API key configured in environment
- Verified connection with latest block number
- Multi-chain client configuration ready
Error Handling
| Error |
Cause |
Solution |
Must provide apiKey |
Missing env var |
Set ALCHEMY_API_KEY in environment |
401 Unauthorized |
Invalid API key |
Verify key in Alchemy Dashboard |
429 Rate Limit |
Free tier exceeded |
Upgrade plan or reduce request rate |
ECONNREFUSED |
Network blocked |
Ensure HTTPS to *.g.alchemy.com allowed |
Resources
Next Steps
Proceed to alchemy-hello-world for your first blockchain query.
1---2name: alchemy-install-auth3description: |4 Install the Alchemy SDK and configure API key authentication for Web3 development.5 Use when setting up blockchain API access, creating an Alchemy app,6 or configuring multi-chain RPC endpoints.7 Trigger: "install alchemy", "setup alchemy", "alchemy auth", "alchemy API key".8allowed-tools: Read, Write, Edit, Bash(npm:*), Bash(pip:*), Grep9version: 1.0.010license: MIT11author: Jeremy Longshore <jeremy@intentsolutions.io>12tags: [saas, blockchain, web3, alchemy]13compatible-with: claude-code14---1516# Alchemy Install & Auth1718## Overview1920Install the `alchemy-sdk` npm package and configure API authentication. Alchemy provides blockchain infrastructure (RPC nodes, Enhanced APIs, NFT APIs, webhooks) across Ethereum, Polygon, Arbitrum, Optimism, Base, and Solana.2122## Prerequisites2324- Node.js 18+ (or Python 3.10+ for alchemy-sdk Python)25- Free Alchemy account at [alchemy.com](https://www.alchemy.com)26- API key from Alchemy Dashboard2728## Instructions2930### Step 1: Install the Alchemy SDK3132```bash33# JavaScript/TypeScript (official SDK)34npm install alchemy-sdk3536# Python (community SDK)37pip install alchemy-sdk38```3940### Step 2: Create an Alchemy App41421. Go to [dashboard.alchemy.com](https://dashboard.alchemy.com)432. Click "Create new app"443. Select chain: Ethereum, Polygon, Arbitrum, Optimism, Base, or Solana454. Select network: Mainnet, Sepolia (testnet), or Mumbai465. Copy the API key4748### Step 3: Configure Environment4950```bash51# Set environment variable52export ALCHEMY_API_KEY="your-api-key-here"5354# Or create .env file55cat > .env << 'EOF'56ALCHEMY_API_KEY=your-api-key-here57ALCHEMY_NETWORK=ETH_MAINNET58EOF5960echo ".env" >> .gitignore61```6263### Step 4: Initialize and Verify6465```typescript66// src/alchemy-client.ts67import { Alchemy, Network } from 'alchemy-sdk';6869const alchemy = new Alchemy({70 apiKey: process.env.ALCHEMY_API_KEY,71 network: Network.ETH_MAINNET,72});7374// Verify connection75async function verifyConnection() {76 const blockNumber = await alchemy.core.getBlockNumber();77 console.log(`Connected! Latest block: ${blockNumber}`);78 return blockNumber;79}8081verifyConnection().catch(console.error);82```8384### Step 5: Multi-Chain Configuration8586```typescript87// src/config/chains.ts88import { Alchemy, Network } from 'alchemy-sdk';8990// Create clients for multiple chains91const chains = {92 ethereum: new Alchemy({ apiKey: process.env.ALCHEMY_API_KEY, network: Network.ETH_MAINNET }),93 polygon: new Alchemy({ apiKey: process.env.ALCHEMY_API_KEY, network: Network.MATIC_MAINNET }),94 arbitrum: new Alchemy({ apiKey: process.env.ALCHEMY_API_KEY, network: Network.ARB_MAINNET }),95 optimism: new Alchemy({ apiKey: process.env.ALCHEMY_API_KEY, network: Network.OPT_MAINNET }),96 base: new Alchemy({ apiKey: process.env.ALCHEMY_API_KEY, network: Network.BASE_MAINNET }),97};9899export default chains;100```101102## Supported Networks103104| Chain | Network Enum | Mainnet | Testnet |105|-------|-------------|---------|---------|106| Ethereum | `ETH_MAINNET` | Yes | Sepolia |107| Polygon | `MATIC_MAINNET` | Yes | Amoy |108| Arbitrum | `ARB_MAINNET` | Yes | Sepolia |109| Optimism | `OPT_MAINNET` | Yes | Sepolia |110| Base | `BASE_MAINNET` | Yes | Sepolia |111| Solana | `SOL_MAINNET` | Yes | Devnet |112113## Output114115- `alchemy-sdk` installed in node_modules116- API key configured in environment117- Verified connection with latest block number118- Multi-chain client configuration ready119120## Error Handling121122| Error | Cause | Solution |123|-------|-------|----------|124| `Must provide apiKey` | Missing env var | Set `ALCHEMY_API_KEY` in environment |125| `401 Unauthorized` | Invalid API key | Verify key in Alchemy Dashboard |126| `429 Rate Limit` | Free tier exceeded | Upgrade plan or reduce request rate |127| `ECONNREFUSED` | Network blocked | Ensure HTTPS to *.g.alchemy.com allowed |128129## Resources130131- [Alchemy Docs](https://www.alchemy.com/docs)132- [Alchemy SDK GitHub](https://github.com/alchemyplatform/alchemy-sdk-js)133- [Alchemy Dashboard](https://dashboard.alchemy.com)134135## Next Steps136137Proceed to `alchemy-hello-world` for your first blockchain query.138