alchemy-reference-architecture

Implement reference architecture for Alchemy-powered Web3 applications. Use when designing dApp infrastructure, planning multi-chain deployments, or structuring a production blockchain application. Trigger: "alchemy architecture", "dApp architecture", "alchemy project structure", "web3 system design", "alchemy multi-chain design".

Jump to install

Repository: jeremylongshore/claude-code-plugins-plus-skills
Last source activity: July 17, 2026 at 22:18
Detected SKILL.md language: English
Stars: 2,604
Forks: 378

Install options

The review-first prompt is selected by default. You can switch to a direct command or download a local copy.

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

A direct command skips the review prompt. Inspect the source before running it.

npx skills add https://github.com/jeremylongshore/claude-code-plugins-plus-skills --skill alchemy-reference-architecture

The command stays on one line. Scroll horizontally to inspect it before copying.

Prefer a local copy? Download the files currently available to SkillsMP.

Review the source files

Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.

SKILL.md

Source instructions · Read-only preview

Back to search Back to installation

clerk-core-workflow-a

Implement user sign-up and sign-in flows with Clerk. Use when building authentication UI, customizing sign-in experience, or implementing OAuth social login. Trigger with phrases like "clerk sign-in", "clerk sign-up", "clerk login flow", "clerk OAuth", "clerk social login".

2026-07-23

clerk-core-workflow-b

Implement session management and middleware with Clerk. Use when managing user sessions, configuring route protection, or implementing token refresh and custom JWT templates. Trigger with phrases like "clerk session", "clerk middleware", "clerk route protection", "clerk token", "clerk JWT".

2026-07-23

clerk-enterprise-rbac

Configure enterprise SSO, role-based access control, and organization management. Use when implementing SSO integration, configuring role-based permissions, or setting up organization-level controls. Trigger with phrases like "clerk SSO", "clerk RBAC", "clerk enterprise", "clerk roles", "clerk permissions", "clerk organizations".

2026-07-23

View all from this repository

Alchemy Reference Architecture

System Architecture

┌─────────────────────────────────────────────────────────┐ │ Frontend (React/Next.js) │ │ - Wallet connection (MetaMask, WalletConnect) │ │ - Portfolio dashboard │ │ - NFT gallery │ │ - Transaction history │ └────────────────────────┬────────────────────────────────┘ │ HTTPS (no API key exposed) ┌────────────────────────▼────────────────────────────────┐ │ API Layer (Next.js/Express) │ │ - /api/balance/:address │ │ - /api/nfts/:owner │ │ - /api/tokens/:address │ │ - /api/transactions/:address │ │ - /webhooks/alchemy (webhook receiver) │ └───────┬──────────┬──────────┬───────────────────────────┘ │ │ │ ┌────▼───┐ ┌───▼────┐ ┌──▼──────┐ │Alchemy │ │Alchemy │ │Alchemy │ │Core API│ │NFT API │ │Notify │ │(RPC) │ │ │ │(Webhooks│ └────────┘ └────────┘ └─────────┘ ETH/Polygon/ARB/OP/Base

Project Structure

web3-dapp/ ├── src/ │ ├── alchemy/ │ │ ├── client-factory.ts # Multi-chain Alchemy client factory │ │ ├── cache.ts # Response caching with TTL │ │ ├── throttler.ts # CU-aware rate limiter │ │ └── errors.ts # Error classification │ ├── portfolio/ │ │ ├── fetcher.ts # Wallet portfolio aggregator │ │ ├── transactions.ts # Transaction history analyzer │ │ └── multi-chain.ts # Cross-chain balance aggregator │ ├── nft/ │ │ ├── collection.ts # NFT collection explorer │ │ ├── batch-metadata.ts # Batch metadata fetcher │ │ └── verify-ownership.ts # NFT ownership verification │ ├── contracts/ │ │ ├── read-contract.ts # Smart contract read operations │ │ └── abis/ # Contract ABI files │ ├── webhooks/ │ │ ├── handler.ts # Webhook endpoint │ │ ├── verify.ts # HMAC signature verification │ │ └── event-router.ts # Event type routing │ ├── security/ │ │ ├── validators.ts # Input validation (addresses, blocks) │ │ └── proxy.ts # API key proxy for frontend │ └── api/ # API route handlers ├── tests/ │ ├── unit/ # Unit tests (mocked Alchemy) │ ├── fork/ # Mainnet fork tests (Hardhat) │ └── integration/ # Sepolia integration tests ├── contracts/ # Solidity contracts (if applicable) ├── hardhat.config.ts # Hardhat + Alchemy fork config └── package.json

Key Design Decisions

Decision

Choice

Rationale

SDK

alchemy-sdk

Official, typed, Enhanced + NFT APIs included

Multi-chain

Client factory pattern

Lazy initialization, shared API key

Caching

In-memory with TTL tiers

Block data = 12s, metadata = 24h

Rate limiting

Bottleneck with CU weights

Matches Alchemy CU budget model

Frontend access

API proxy

Never expose API key to browser

Real-time

WebSocket subscriptions

Lower cost than polling

Testing

Hardhat mainnet fork

Reproducible tests with real data

Output

Complete project structure for Alchemy-powered dApp

Multi-chain architecture with client factory

API proxy pattern keeping API key server-side

Webhook integration for real-time event processing

Resources

Next Steps

Start with alchemy-install-auth, then follow skills through production deployment.

name	alchemy-reference-architecture
description	Implement reference architecture for Alchemy-powered Web3 applications. Use when designing dApp infrastructure, planning multi-chain deployments, or structuring a production blockchain application. Trigger: "alchemy architecture", "dApp architecture", "alchemy project structure", "web3 system design", "alchemy multi-chain design".
allowed-tools	Read, Write, Edit
version	1.5.0
license	MIT
author	Jeremy Longshore <jeremy@intentsolutions.io>
tags	["saas","blockchain","web3","alchemy","architecture"]
compatibility	Designed for Claude Code

name	alchemy-reference-architecture
description	Implement reference architecture for Alchemy-powered Web3 applications. Use when designing dApp infrastructure, planning multi-chain deployments, or structuring a production blockchain application. Trigger: "alchemy architecture", "dApp architecture", "alchemy project structure", "web3 system design", "alchemy multi-chain design".
allowed-tools	Read, Write, Edit
version	1.5.0
license	MIT
author	Jeremy Longshore <jeremy@intentsolutions.io>
tags	["saas","blockchain","web3","alchemy","architecture"]
compatibility	Designed for Claude Code

alchemy-reference-architecture

Source facts

Install options

Review the source files

More from this repository

More from this repository