mcpField
G
goldrush-x402

goldrush-x402

github.com/covalenthqデータ・データベース496 回インストール34 週間前に更新
リポジトリ

goldrush-x402 について

goldrush-x402は、x402のリクエスト単位課金でGoldRushのブロックチェーンデータにアクセスするスキルです。AIエージェントによるエンドポイントの検索、料金の確認、支払い付きリクエストを支援し、APIキーは不要です。

主な機能

  1. 01利用可能なエンドポイントの検索
  2. 02料金と対応チェーンの確認
  3. 03x402によるリクエスト単位の支払い
  4. 04固定・段階制料金の利用
  5. 05課金前のリクエスト検証

活用シーン

  1. 01トークン残高やNFT保有状況の照会
  2. 02トランザクションやイベントログの取得
  3. 03オンチェーンデータを従量課金で取得するエージェントの構築

インストール

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

$npx skills add https://github.com/covalenthq/goldrush-agent-skills --skill goldrush-x402

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

同梱ファイル

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

references/
ai-agents.md
endpoints.md
overview.md

詳細

GoldRush x402

x402 プロトコルを使用して、GoldRush のブロックチェーンデータにリクエストごとにアクセスできます。API キーも登録も請求も不要で、必要なのは資金を入金したウォレットだけです。透過的なリバースプロキシを通じて、Foundational API のエンドポイントを利用できます。

クイックスタート

import { HTTPClient } from "@x402/core";
import { ExactEvmScheme } from "@x402/evm";

const client = new HTTPClient({
  scheme: new ExactEvmScheme({
    network: "eip155:84532", // Base Sepolia
    privateKey: process.env.WALLET_PRIVATE_KEY,
  }),
});

// Get token balances — payment handled automatically
const balances = await client.get(
  "https://x402.goldrush.dev/v1/eth-mainnet/address/demo.eth/balances_v2/"
);
console.log(balances);

インストール: npm install @x402/core @x402/evm

x402 の仕組み

1. REQUEST  → Agent calls endpoint without payment
2. 402      → Server responds with payment instructions (amount, token, recipient)
3. PAY      → Agent signs payment with stablecoins on Base, retries with proof
4. DATA     → Server validates request *before* charging, returns data

x402 クライアントライブラリが、ステップ 2～3 を自動的に処理します。コードからは、GET リクエストを送るだけです。

重要な安全機能： プロキシは、課金前にリクエストを検証します。アドレスの形式が正しくない場合、未対応のチェーンが指定された場合、またはパラメーターが不正な場合は、わかりやすいエラーが返され、料金はかかりません。

支払い： Base Sepolia（テストネット）上の USDC。Base メインネットのサポートは近日開始予定です。

相互参照

x402 は、Foundational API と同じエンドポイントを、同じパラメーターとレスポンス形式で提供します。エンドポイントの詳細なドキュメント（パラメーター、レスポンススキーマ、ユースケース）については、goldrush-foundational-api スキルを参照してください。

ベース URL の対応関係：

  • Foundational API：https://api.covalenthq.com/v1/...
  • x402 プロキシ：https://x402.goldrush.dev/v1/...

料金の概要

モデル説明例
固定呼び出し 1 回あたりの固定料金トークン残高、NFT 保有状況、ブロックの詳細
段階制データ量に応じた料金トランザクション、イベントログ
段階（可変長データの場合）
段階項目数用途
小1-50手早い検索、最近のアクティビティ
中51-200一般的なクエリ
大201-500詳細な分析
XL501+全履歴

クエリパラメーターで段階を選択します：?tier=small

レスポンスキャッシュ

キャッシュされたレスポンスは、料金が安くなります。キャッシュ TTL：

  • 残高： 30 秒
  • 価格データ： 5 分

AI エージェントのワークフロー

1. 検出（無料）
curl https://x402.goldrush.dev/v1/x402/endpoints | jq
curl https://x402.goldrush.dev/v1/x402/search?q=balance | jq
2. 評価
curl https://x402.goldrush.dev/v1/x402/endpoints/get-token-balances-for-address | jq

クレジットレート、料金モデル、対応チェーンなど、呼び出す内容を判断するために必要な情報がすべて返されます。

3. 支払いと利用
const balances = await client.get(
  `https://x402.goldrush.dev/v1/eth-mainnet/address/${wallet}/balances_v2/`
);
// Same JSON format as standard GoldRush API

リファレンスファイル

このインデックスに記載されている内容を超える詳細が必要な場合は、該当するリファレンスファイルを参照してください。

ファイル参照するタイミング
overview.mdx402 プロトコルの詳細、料金モデルの内訳、またはクイックスタートコードが必要な場合
ai-agents.md自律型エージェントを構築する場合 — 4 ステップのワークフロー、x402 と API キーの比較、レート制限
endpoints.md検出 API の詳細（無料）や、利用可能なデータエンドポイントの一覧が必要な場合

コメント

Markdown 対応