核心用法
Maestro API Skill 提供了一条完整的去中心化 API 调用链路，专为区块链数据查询设计。其核心流程遵循 "先尝试后付费" 原则：
1. 文档解析：从 docs.gomaestro.org 读取 OpenAPI 规范，精确定位目标端点
2. 无认证试探：首次请求不带任何认证头，若返回 200 直接获取数据
3. SIWX 签名：若遇 402 响应，按 EIP-4361 标准签名 "Sign-In with X" 挑战
4. JWT 复用：签名成功后获得 JWT，后续请求可复用直至过期
5. 按需付费：仅当 JWT 不足时，通过 ERC-3009 EIP-712 标准购买 x402 积分
关键特性：
- 零 API Key 架构，完全依赖链上身份（地址签名）
- 智能路由：Blockchain Indexer（确认数据）、Mempool Monitoring（待确认）、Esplora（mempool.space 风格）、Wallet API（余额活动）
- 主网操作前需用户确认，防意外扣费
显著优点
- 隐私友好：无需注册账户或暴露邮箱，私钥即身份
- 成本透明：402 响应明确告知
supported_chains、accepts[]、asset、pay_to及价格上限，无隐藏费用 - 渐进式付费：免费层 → SIWX 认证 → 按需购买，按实际需求阶梯付费
- 标准兼容：SIWX 基于 EIP-4361，x402 支付基于 ERC-3009，均为以太坊生态成熟标准
- JWT 缓存：认证令牌可复用，减少重复签名操作
潜在局限与风险
| 风险点 | 说明 |
|--------|------|
| 私钥管理 | 需 `PRIVATE_KEY` 或 CDP 运行时钱包，泄露即资产风险 |
| USDC 前置 | 必须预存 USDC + 原生 Gas，新手门槛 |
| 主网不可逆 | 支付一旦上链无法撤回，需人工确认 |
| 文档依赖 | 端点依赖实时文档解析，若 docs.gomaestro.org 变更可能断联 |
| 网络锁定 | `supported_chains` 动态返回，可能限制可用网络 |
适合人群
- 已持有 Web3 钱包、熟悉 EIP-712 签名的开发者
- 需要高频区块链数据但不愿管理多平台 API Key 的 DeFi 团队
- 追求隐私优先、抗审查数据查询的独立研究者
常规风险总结
本 Skill 将链上身份与链下 API 访问深度绑定，虽实现了无许可访问，但也把传统 API Key 的安全风险转移到了私钥安全与 Gas 管理上。建议仅在受控环境（如 CDP 沙箱）使用运行时钱包，避免硬编码私钥。