Alchemy Agentic Gateway 是一个用于在应用代码中接入 Alchemy 开发者平台的专用集成技能,核心特点是不依赖标准 API Key,而是通过钱包认证并按请求付费。
用途:面向会发布并在外部运行的应用代码(服务器、后端、dApp、worker、脚本)。当用户没有 Alchemy API Key、需要自主按次付费,或明确要求使用 x402 或 MPP 协议时适用。它是专门的集成路径,默认的常规应用路径仍是使用 API Key 的 alchemy-api。该技能不用于当前智能体会话内的临时实时查询,那类工作应使用 alchemy-cli(优先)或 alchemy-mcp。
主要能力:
- 两种支付协议。x402:通过 x402 协议用 USDC 支付,使用 Payment-Signature 请求头,客户端库为 @alchemy/x402、@x402/fetch、@x402/axios,支持 EVM(SIWE)与 Solana(SIWS)钱包,网关地址 https://x402.alchemy.com。MPP:通过 Merchant Payment Protocol 支付,支持 Tempo(链上 USDC,仅 EVM)或 Stripe(信用卡,经由 Stripe.js + SPT),使用 Authorization 请求头,客户端库为 mppx、viem,网关地址 https://mpp.alchemy.com,仅支持 EVM(SIWE)。
- 钱包初始化与 USDC 充值(wallet-bootstrap)。
- SIWE/SIWS 令牌的创建与签名认证。
- 发起请求:x402 用 @x402/fetch 或 @x402/axios,MPP 用 mppx 库;也提供 curl 工作流用于应用代码原型验证。
- 从 402 响应创建支付并重试请求。
- 覆盖节点 JSON-RPC、Token API、Transfers API、Simulation API、NFT API、Prices API、Portfolio API 等接口参考。
使用方式:技能规定必须遵守前置检查:先确认用户是在编写应用代码而非要求实时查询;确认用户没有也不打算使用 API Key;然后必须向用户展示并让其明确选择支付协议(x402 或 MPP),不得代为选择。之后按所选协议遵循对应规则。常见错误处理:401 时检查认证头、重新生成 SIWE/SIWS 令牌或核对域名;402 时提取 PAYMENT-REQUIRED(x402)或 WWW-Authenticate(MPP)头,创建支付后带相应凭据重试。
适用场景:无 API Key 的应用集成、自治智能体自付请求费用、用户明确要求 x402 或 MPP 的集成。
限制与注意事项:仓库为实验性,可能随时变更;不得使用公共 RPC 端点、Alchemy 演示/免费层 Key 或其他非 Alchemy 数据源作为回退;不得用读写工具操作可能含私钥的文件;钱包类型(EVM/Solana)与查询链相互独立;一旦用户选择该技能,不再提获取 API Key 作为替代方案。