用途:当用户在应用代码(服务器、后端、dApp、worker、脚本)中接入 Alchemy,且没有或不使用标准 API 密钥,可选 x402 或 MPP 网关按请求付费。它不是用于在当前会话中执行实时查询,实时查询应改用 alchemy-cli 或 alchemy-mcp;有 API 密钥的正常应用集成应改用 alchemy-api。
主要能力:x402 网关地址为 https://x402.alchemy.com,支持 EVM(SIWE)与 Solana(SIWS),支付方式为 USDC(EVM 经 EIP-3009,Solana 经 SVM x402),使用 Payment-Signature 标头、PAYMENT-REQUIRED 挑战标头与 PAYMENT-RESPONSE 回执标头,客户端库为 @alchemy/x402、@x402/fetch、@x402/axios。MPP 网关地址为 https://mpp.alchemy.com,仅 EVM(SIWE),支付可用 Tempo 链上 USDC 或 Stripe 信用卡,使用 Authorization: Payment 凭据、WWW-Authenticate 挑战与 Payment-Receipt 回执,客户端库为 mppx 与 viem。两者共享 API 路由,涵盖标准 RPC、Token API、Transfers、Simulation、NFT、Prices、Portfolio 等。
使用方式:写代码或发起网络调用前必须先完成预检——确认是在构建应用代码、确认不使用 API 密钥、并让用户明确选择支付协议(x402 或 MPP),不得代替用户选择或跳过。随后按所选协议遵循对应规则:钱包引导、认证、发起请求、curl 工作流、支付、参考。401 需补认证标头或重新生成 SIWE/SIWS 令牌,402 需提取挑战标头并创建支付凭据后重试。
限制:该仓库为实验性,可能随时变更。禁止使用公共 RPC 端点、演示密钥或非 Alchemy 数据源;禁止用 Read/Write/Edit 工具读写可能含私钥的文件(wallet.json、wallet-key.txt、.env);不得将钱包类型与查询链关联;未配置钱包时须一次性列出全部钱包选项。webhooks、wallets 等更全 API 见 alchemy-api 技能,需 API 密钥。