mcpField
G
goldrush-x402

goldrush-x402

github.com/covalenthq数据与数据库496 次安装34 周前更新
代码仓库

关于 goldrush-x402

goldrush-x402 是通过 x402 按请求付费访问 GoldRush 区块链数据的技能。它指导 AI Agent 发现端点、评估价格并发起付费请求，无需 API 密钥。

主要功能

  1. 01发现可用端点
  2. 02查看价格和支持的链
  3. 03通过 x402 按请求付费
  4. 04使用固定或分档定价
  5. 05收费前验证请求

适用场景

  1. 01查询代币余额或 NFT 持仓
  2. 02获取交易和事件日志数据
  3. 03构建按需付费获取链上数据的 Agent

安装

复制下面的命令，在终端中运行。

$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/...

定价摘要

模式描述示例
固定每次调用一个价格代币余额、NFT 持仓、区块详情
分级按数据量定价交易、事件日志
分级（适用于长度可变的数据）
级别项目数用例
小1-50快速查询、近期活动
中51-200标准查询
大201-500详细分析
XL501+完整历史记录

通过查询参数选择级别：?tier=small

响应缓存

缓存的响应费用更低。缓存 TTL：

  • 余额： 30 秒
  • 定价数据： 5 分钟

AI Agent 工作流

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.md需要了解 x402 协议详情、定价模式细分或快速入门代码
ai-agents.md构建自主 Agent 时——四步工作流、x402 与 API 密钥对比、速率限制
endpoints.md需要了解发现 API 详情（免费），或可用数据端点目录

评论

支持 Markdown