Imported from jeremylongshore/tons-of-skills-marketplace (skills/.curated/alchemy-install-auth/SKILL.md). Install upstream with npx skills add jeremylongshore/tons-of-skills-marketplace --skill alchemy-install-auth. Copyright stays with the author (MIT).

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

1. Go to dashboard.alchemy.com
2. Click "Create new app"
3. Select chain: Ethereum, Polygon, Arbitrum, Optimism, Base, or Solana
4. Select network: Mainnet, Sepolia (testnet), or Mumbai
5. 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

Output

• alchemy-sdk installed in node_modules
• API key configured in environment
• Verified connection with latest block number
• Multi-chain client configuration ready

Examples

Create a development-only Alchemy application for Sepolia or another supported test network, store its key in a local ignored environment file or platform secret store, and run verifyConnection. A successful setup prints a current block number from the selected test network without printing the key. Add a second client only when the application genuinely needs another chain, and keep the network selection explicit per client. If verification returns 401, the network is unsupported, or the variable is absent, correct the dashboard or environment configuration before proceeding; do not reuse a production key in local examples or commit it to the repository.

Error Handling

Resources

• Alchemy Docs
• Alchemy SDK GitHub
• Alchemy Dashboard

Next Steps

Proceed to alchemy-hello-world for your first blockchain query.