quicknode-skill

# Quicknode Blockchain Infrastructure

## Intake Questions
- Which chain and network should Quicknode target?
- Is this read-only or should I create infrastructure (streams, webhooks, IPFS writes)?
- Does this require real-time streaming (Solana gRPC/Blazar WSS/HyperCore gRPC) or standard RPC?
- What endpoint or API key should I use (default: `QUICKNODE_RPC_URL`, optional `QUICKNODE_WSS_URL` / `QUICKNODE_API_KEY`)?
- If no API key exists, does the agent want pay-per-request access (x402, MPP) or a wallet-paid Quicknode account via [Agent Subscriptions](#agent-subscriptions)?
- Any constraints (latency, regions, throughput, destinations)?

## Safety Defaults
- Default to testnet/devnet when a network is not specified.
- Prefer read-only operations and dry runs before creating resources.
- Never ask for or accept private keys or secret keys.

## Confirm Before Write
- Require explicit confirmation before creating or modifying Streams, Webhooks, or IPFS uploads.
- Require explicit confirmation before creating an Agent Subscription, topping up credits, or any action that spends real funds via x402 or MPP.
- If confirmation is missing, return the exact API payload for review.

## Quick Reference

### Infrastructure

| Product | Description | Use Case |
|---------|-------------|----------|
| **Core RPC API** | High-performance blockchain access for 80+ chains | dApp backend, wallet interactions |
| **Dedicated Clusters** | Dedicated private node clusters | High-throughput production, compliance isolation |
| **IPFS** | Decentralized file storage | NFT metadata, asset hosting |

### Real-Time Data

| Product | Description | Use Case |
|---------|-------------|----------|
| **Streams** | Real-time & historical blockchain data pipelines | Event monitoring, analytics, indexing |
| **Streams Backfills** | On-demand historical data backfill into Streams | Gap recovery, historical re-indexing |
| **Webhooks** | Event-driven notifications | Alerts, transaction monitoring |
| **Solana gRPC** | Solana Geyser streaming — included on Scale/Business, add-on on Build/Accelerate | Real-time account, transaction, slot data |
| **Blazar WSS** | Quicknode-built Solana WebSocket engine — all plans, free | Fast block, account, transaction, and slot subscriptions |
| **HyperCore gRPC** | gRPC streaming for Hyperliquid L1 — included on all paid plans | Trades, order book diffs, events, blocks in real time |

### Indexed Data

| Product | Description | Use Case |
|---------|-------------|----------|
| **SQL Explorer** | Direct SQL access to indexed blockchain data | Trading analytics, historical queries, market analysis |
| **Agent Identity (ERC-8004)** | On-chain agent discovery and reputation records | Agent identity, capability advertising |
| **Blockbook** | Wallet-centric blockchain data via JSON-RPC | Address balances, UTXOs, transaction history |
| **Metaplex DAS API** | Solana Digital Asset Standard — NFTs, cNFTs, fungible tokens, MPL Core | NFT/token queries, compressed NFTs, asset search |
| **Ordinals & Runes API** | Bitcoin inscriptions and Runes protocol data | Inscription lookup, UTXO tracking, Runes balances |

### Trading & DeFi

| Product | Description | Use Case |
|---------|-------------|----------|
| **Swap API** | Multi-DEX aggregated token swaps | Solana (Jupiter/Metis), EVM (0x, OpenOcean, Aerodrome, Velodrome, Titan) |

### Marketplace Add-ons

| Product | Description | Use Case |
|---------|-------------|----------|
| **Solana Priority Fee API** | Recommended priority fees for Solana transactions | Fee estimation, transaction landing |
| **Jito Bundles** | Solana bundle submission and status APIs | MEV-aware transaction delivery |
| **Single Flight RPC** | Request de-duplication for identical in-flight RPC calls | High-concurrency read workloads |
| **Multi-region Transaction Broadcast** | Transaction propagation across multiple regions | Latency-sensitive submission |
| **Scorechain Risk Assessment API** | Wallet and transaction risk data | Compliance, fraud monitoring |
| **Block Timestamp Lookup** | Timestamp-to-block lookup utilities | Time-window to block-range conversion |
| **Multi-chain Stablecoin Balance API** | Stablecoin balances across supported chains | Treasury, payments, portfolio state |
| **Covalent GoldRush APIs** | Multi-chain wallet and portfolio data | Wallet summaries, token/NFT holdings |

### Agent Surface

| Product | Description | Use Case |
|---------|-------------|----------|
| **x402** | Testnet monthly cap plus mainnet pay-per-request via stablecoins | Keyless RPC access, AI agents, pay-as-you-go |
| **MPP** | Testnet monthly cap plus mainnet pay-per-request via IETF Payment Authentication | AI agents, multi-service payments, high-volume sessions |
| **Agent Subscriptions** | Wallet-paid Quicknode account creation, returns a `QN_*` full platform API key | Autonomous agents needing full platform access |
| **Quicknode CLI** | `qn` CLI for endpoints, Streams, Webhooks, KV, and SQL from the terminal | Scripting, CI/CD, infrastructure automation |
| **Quicknode MCP** | Native Claude/OpenAI connector plus generic MCP server — Admin API via MCP | Manage Quicknode from Claude, ChatGPT, Codex, Cursor, or any MCP-capable AI tool |

### Platform

| Product | Description | Use Case |
|---------|-------------|----------|
| **Admin API** | REST API for account management | Endpoint CRUD, usage monitoring, billing |
| **Key-Value Store** | Serverless key-value and list storage (beta) | Persistent state for Streams, dynamic address lists |
| **Quicknode SDK** | Official SDK for Quicknode product APIs | Admin API, Streams, Webhooks, KV, SQL Explorer |

---

## Core RPC API

Quicknode provides low-latency RPC endpoints for 80+ blockchain networks.

`qn rpc call` (CLI) and `qn.rpc.call` (SDK) reach any supported network via **Tooling Access** — a single multichain, read-only endpoint Quicknode provisions automatically with short-lived JWTs. No endpoint setup required. See [refer