用途
该技能用于在正式集成 Alchemy 之前,构建一个最小化、可审查的 Alchemy EVM 只读连接验证(Read-Only Connectivity Proof)。其目标是在任何实时副作用发生之前,产出一份可审查的工件与负向路径证据,证明网络、认证与失败行为符合预期。
主要能力
- 选择一个受支持的 EVM 链,并在第一方文档中核对其当前端点与功能支持。
- 安装仓库批准的、固定版本的 viem 发布版,并保留 lockfile 审查;不添加 alchemy-sdk。
- 使用声明的 viem 链与来自服务端密钥边界的 Alchemy HTTP transport 创建公共客户端。
- 读取链 ID 与最新区块号,断言链 ID 等于配置的链,并仅记录脱敏后的计时与区块证据。
- 演练无效凭据与故意不匹配的链预期,以证明失败关闭(fail-closed)行为。
- 返回源码、lockfile、测试输出与回滚变更,且不发起交易、不请求签名密钥。
使用方式
- 选择一个受支持的 EVM 链,并在第一方文档中验证其当前端点与功能支持。
- 安装仓库批准的、固定版本的 viem 发布版并保留 lockfile 审查;不要添加 alchemy-sdk。
- 使用声明的 viem 链与来自服务端密钥边界的 Alchemy HTTP transport 创建公共客户端。
- 读取链 ID 与最新区块号,断言链 ID 等于配置的链,并仅记录脱敏后的计时与区块证据。
- 演练无效凭据与故意不匹配的链预期,以证明失败关闭行为。
- 返回源码、lockfile、测试输出与回滚变更,且不发起交易、不请求签名密钥。
工具纪律方面,使用 Read、Glob 与 Grep 检查当前文档、配置、代码、fixtures 与证据;仅对已批准的仓库工件使用 Write 与 Edit。技能调用本身不授权网络访问、凭据、钱包地址、客户数据、计划变更、支出、密钥创建或轮换、webhook 变更、部署、重放、交易构造、签名、广播或删除。
适用场景
- 开始 Alchemy 集成前的连通性验证。
- 需要在不产生链上副作用的前提下,证明端点连通性、凭据有效性与失败关闭行为。
- 需要记录正向与负向测试证据(如有效开发密钥、无效密钥、错误链、限流响应、提供方超时、凭据金丝雀未出现在日志中)。
限制
- 成功的 eth_blockNumber 仅证明端点连通性,不证明 Enhanced API、NFT API、Portfolio、Wallet API 或 Admin 权限。
- 链身份必须从响应上下文检查,而不能从端点字符串假定。
- 只读开发验证需要应用所有者提供限定范围的密钥;安装依赖需遵循仓库审查。
- 任何交易、钱包连接、浏览器凭据或生产调用均超出该技能范围,需要单独批准。
- 401 或 403 应视为凭据或策略失败,而非扩大访问的理由;链 ID 不匹配应视为硬配置失败,即使区块号调用成功。
- 429 与提供方 5xx 应遵守有界重试预算,绝不循环直到成功。
- 观察到的账户、应用、网络、索引器、链或提供方行为属于环境特定证据,绝非通用保证。
前置条件
- 所选产品、链、功能、客户端、认证方法、限制与生命周期的当前第一方 Alchemy 文档。
- 与请求范围相称的产品、应用、安全、数据/隐私、预算、发布与运营负责人。
- 合成或已批准的非生产 fixtures、凭据金丝雀、明确的成功标准与经过测试的回滚边界。
输出
返回所选链、当前源码链接、依赖决策、最小 viem 客户端、链 ID 断言、脱敏的正向与负向测试回执,以及回滚命令。明确标记假设、观察、源码日期、环境特定行为、负责人与未解决的缺口。