SuperAPI AI 工具集

alchemy-agentic-gateway

编程与开发

查看项目

更新于 10-16 03:13

技能介绍

用途:本技能用于在应用代码(服务端、后端、dApp、worker、脚本)中接入 Alchemy 开发平台,但不使用标准 API Key 认证。认证基于钱包:EVM 使用 SIWE,Solana 使用 SIWS;每次请求按调用付费,x402 走 USDC,MPP 支持 USDC/信用卡。该仓库为实验性项目,可能随时变更,使用即表示同意 Alchemy 的服务条款与隐私政策。

适用条件:需同时满足——用户是在当前智能体会话之外运行的应用代码中接入 Alchemy;且至少满足以下之一:无 Alchemy API Key、用户是需自行付费的自主智能体、用户明确要求 x402 或 MPP、或无其他运行时路径而有意选择该网关。若只是当前会话内的实时查询或管理操作,应改用 alchemy-cli(本地已安装或 CLI 与 MCP 均可用)、alchemy-mcp(仅 MCP 接入)或先安装 alchemy-cli;若应用代码持有 API Key,则属常规路径,应使用 alchemy-api。

使用方式:写入应用代码或发起任何网络调用前须执行前置检查——确认是构建应用代码而非实时查询;确认用户没有或不使用 API Key;并让用户明确选择支付协议:x402(网关 https://x402.alchemy.com,使用 Payment-Signature 头与 @alchemy/x402、@x402/fetch 库,支持 EVM 与 Solana)或 MPP(网关 https://mpp.alchemy.com,通过 mppx、viem,支持 Tempo 链上 USDC(仅 EVM)与 Stripe 信用卡,认证仅 EVM)。不得跳过该询问或替用户选择。随后按所选协议遵循对应规则:x402 包括 wallet-bootstrap、overview、authentication、making-requests、curl-workflow、payment、reference;MPP 同样含对应规则。网关路由 /{chainNetwork}/v2 支持 eth_* 标准 RPC 及 alchemy_simulateAssetChanges、alchemy_simulateExecution 等模拟接口;更多 Alchemy API(webhook、钱包等)应参考 alchemy-api 技能并使用 API Key。

限制与要求:禁止使用公共 RPC 端点、demo/免费层 Key 或任何非 Alchemy 数据源作为回退;禁止用 Read/Write/Edit 工具读写可能含私钥的文件(如 wallet.json、wallet-key.txt、.env);钱包类型(EVM/Solana)与所查询链相互独立,不得关联;未配置钱包时需一次性列出全部钱包选项;用户选定网关路径后不得再提获取 API Key 的替代方案。常见故障:401 对应 MISSING_AUTH、MESSAGE_EXPIRED、INVALID_DOMAIN;402 需按协议提取响应头并重试。