mcpField
Q
quicknode

quicknode

github.com/bankrbotデータ・データベース1.2k58 回インストール1 日前に更新
リポジトリ

quicknode について

Quicknodeスキルは、APIキーまたはリクエストごとのx402決済で、複数のブロックチェーンネットワークのRPCデータをエージェントに提供します。Marketplaceアドオンや一般的なオンチェーン照会方法も説明します。

主な機能

  1. 01複数チェーンのJSON-RPCエンドポイント
  2. 02APIキーまたはx402で接続
  3. 03残高・取引状況・Gasの照会
  4. 04Marketplaceアドオンの利用

活用シーン

  1. 01EVMまたはSolanaウォレットの残高確認
  2. 02取引レシートとGas見積もりの確認
  3. 03x402によるRPCリクエストごとの支払い
  4. 04アドオンによるトークンやNFTデータの取得

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/bankrbot/skills --skill quicknode

インストール後、Claude Code で/quicknodeを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

catalog.json
references/
hypercore-hyperliquid-reference.md
marketplace-addons.md
rpc-reference.md
sdk-reference.md
solana-das-api-reference.md
x402-reference.md
yellowstone-grpc-reference.md

詳細

エージェント向けブロックチェーンデータアクセス：Quicknode

Quicknode は、Bankr がサポートするすべてのチェーン（Base、Ethereum、Polygon、Solana、Unichain）を含む、77 以上のブロックチェーンネットワークで高性能な RPC エンドポイントを提供します。

アクセス方法は 2 つあります。

  • API キー：Quicknode アカウントを作成し、認証情報が組み込まれたエンドポイント URL を取得します。すべての製品と設定にアクセスできます。
  • x402（アカウント不要）：USDC を保有するウォレットであれば、認証してリクエストごとに支払いができます。@quicknode/x402 をインストールすれば、すぐにクエリを開始できます。

x402 アクセス（エージェントにおすすめ）

x402 は自律型エージェントに最適です。登録も API キーも不要です。Base、Polygon、Solana 上の USDC で支払います。

import { createQuicknodeX402Client } from "@quicknode/x402";

const client = await createQuicknodeX402Client({
  baseUrl: 'https://x402.quicknode.com',
  network: "eip155:84532",   // pay on Base Sepolia (testnet)
  evmPrivateKey: process.env.PRIVATE_KEY,
  preAuth: true,             // pre-authenticates via SIWX for faster payment flow
});

// Pay on Base, query any chain
const res = await client.fetch("https://x402.quicknode.com/ethereum-mainnet", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ jsonrpc: "2.0", method: "eth_blockNumber", params: [], id: 1 }),
});

インストール：npm install @quicknode/x402

クレジット料金：

  • テストネット：0.01 USDC で 100 クレジット
  • メインネット：10 USDC で 1,000,000 クレジット
  • JSON-RPC の応答が正常に返るごとに 1 クレジット

x402 のドキュメント全文：https://x402.quicknode.com/llms.txt

API キーによるアクセス

Quicknode のエンドポイント URL には認証情報が含まれています。

https://{ENDPOINT_NAME}.{NETWORK}.quiknode.pro/{API_KEY}/

import { createPublicClient, http } from "viem";
import { base } from "viem/chains";

const client = createPublicClient({
  chain: base,
  transport: http(process.env.QUICKNODE_RPC_URL),
});

const block = await client.getBlockNumber();

エージェントでよく使う操作

ネイティブ残高の確認（EVM）
const balance = await client.getBalance({ address: "0x..." });

または、生の RPC を使用します。

{ "jsonrpc": "2.0", "method": "eth_getBalance", "params": ["0x...", "latest"], "id": 1 }
ERC-20 トークン残高の確認（EVM）

ERC-20 の balanceOf(address) セレクター（0x70a08231）を使って eth_call を実行します。

{
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [{
    "to": "0xTOKEN_CONTRACT",
    "data": "0x70a08231000000000000000000000000WALLET_ADDRESS_NO_0x"
  }, "latest"],
  "id": 1
}
ガス見積もりの取得（EVM）
{ "jsonrpc": "2.0", "method": "eth_gasPrice", "params": [], "id": 1 }
トランザクションステータスの確認（EVM）
{ "jsonrpc": "2.0", "method": "eth_getTransactionReceipt", "params": ["0xTX_HASH"], "id": 1 }
Solana の残高
{ "jsonrpc": "2.0", "method": "getBalance", "params": ["WALLET_PUBKEY"], "id": 1 }
Solana のトークンアカウント
{
  "jsonrpc": "2.0",
  "method": "getTokenAccountsByOwner",
  "params": [
    "WALLET_PUBKEY",
    { "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA" },
    { "encoding": "jsonParsed" }
  ],
  "id": 1
}

Quicknode Marketplace のアドオン

Quicknode のエンドポイントは、Marketplace のアドオンで拡張できます。トレーディングエージェントに役立つアドオンは次のとおりです。

  • Token API：qn_getWalletTokenBalance は、1 回の呼び出しでウォレットの ERC-20 残高をすべて返します。各トークンコントラクトを個別にクエリする必要はありません。
  • NFT API：qn_fetchNFTs は、アドレスが所有する NFT とそのメタデータを返します。
  • Solana Priority Fee API：qn_estimatePriorityFees は、最近のネットワークアクティビティに基づいて推奨優先手数料を返します。トランザクションを迅速に取り込ませるのに役立ちます。
  • Solana DAS API：getAssetsByOwner や searchAssets などのメソッドを使って、圧縮 NFT、代替可能トークン、デジタル資産をクエリできます。
  • Metis - Solana Trading API：Jupiter を利用した Solana 上のトークンスワップ機能です。quoteGet および swapPost エンドポイントから見積もりを取得し、スワップを実行できます。ドキュメント：https://www.quicknode.com/docs/solana/metis-overview

すべてのアドオンを見る：https://marketplace.quicknode.com/

これらのアドオンは API キーを使うエンドポイントで利用できます。Quicknode ダッシュボードで有効にしてください。

対応ネットワーク

Bankr がサポートするすべてのチェーンを Quicknode で利用できます。

チェーンx402 ネットワークスラッグAPI キーのドキュメント
Basebase-mainnethttps://www.quicknode.com/docs/base
Ethereumethereum-mainnethttps://www.quicknode.com/docs/ethereum
Polygonpolygon-mainnethttps://www.quicknode.com/docs/polygon
Solanasolana-mainnethttps://www.quicknode.com/docs/solana
Unichainunichain-mainnethttps://www.quicknode.com/docs/unichain

x402 ベース URL：https://x402.quicknode.com/{network-slug}

対応チェーンの一覧：https://www.quicknode.com/chains

エラー処理

  • 429 Too Many Requests：待機してから再試行します。指数バックオフを使用してください。
  • 402 Payment Required（x402）：クレジットが不足しています。@quicknode/x402 は新しい USDC の支払いを開始して、この状況を自動的に処理します。
  • JSON-RPC エラー（例：-32000）：メソッド固有のエラーです。パラメーターを確認して再試行してください。

リソース

コメント

Markdown 対応