用途
该技能用于在开展 Alchemy 集成工作之前，先选定并证明当前应使用的 Alchemy 客户端、密钥类型、网络与认证边界。其目标是在产生任何实际副作用之前，产出一份可审查的工件以及负向路径证据。
主要能力
- 将请求的能力归类为 Node RPC、Data API、Portfolio、Wallet APIs、Notify 管理、webhook 接收、Admin 使用或 Solana。
- 在实时支持链与功能支持矩阵中确认所需链与功能，不因 RPC 支持而推断功能对等。
- 依据能力选择 viem、直接 HTTP、@alchemy/wallet-apis 或 Solana Web3.js，而非依据已归档的 SDK 示例。
- 创建或识别非生产应用与最小权限密钥，并单独识别实际需要的 Admin 访问密钥或 Notify 令牌。
- 通过仓库既有的密钥机制配置凭据，并记录请求使用服务器请求头、服务器 URL 还是经批准的限制性浏览器边界。
- 运行一次只读的链特定验证，记录脱敏后的请求形态与响应，并记录轮换、吊销、所有权转移与环境隔离。
当前契约
旧的 alchemy-sdk JavaScript 仓库已归档并弃用。新的 EVM 读取使用 viem 或直接使用有文档的 HTTP API；交易类应用与 Portfolio 支持使用 @alchemy/wallet-apis；Solana 工作使用 Solana Web3.js。应用 API 密钥、Admin 访问密钥、Notify 认证令牌与 webhook 签名密钥是不同的凭据，不可互换。
认证
机密工作负载优先使用服务器端请求头认证。仅当当前 Alchemy 指南、明确的域名允许列表、最小权限与产品威胁模型允许时，浏览器密钥才可接受；短时 JWT 是更强的前端选项。Admin、Notify、webhook 与签名凭据只能存放在经批准的密钥存储中。
使用方式
- 归类请求的能力。
- 在实时支持矩阵中确认链与功能。
- 依据能力选择客户端。
- 创建或识别非生产应用与最小权限密钥。
- 通过既有密钥机制配置凭据并记录认证边界。
- 运行一次只读验证并记录脱敏结果与密钥生命周期。
工具纪律
使用 Read、Glob 与 Grep 检查当前文档、配置、代码、夹具与证据。仅对经批准的仓库工件使用 Write 与 Edit。仅调用技能本身并不授权网络访问、凭据、钱包地址、客户数据、计划变更、支出、密钥创建或轮换、webhook 变更、部署、重放、交易构造、签名、广播或删除。
审批边界
应用所有者选择产品与链。安全团队批准任何浏览器凭据边界与生产密钥存储。创建、轮换、吊销或删除实时密钥需要其所有者的明确批准。
错误处理
- 在不受支持的功能或链上使用有效密钥不构成成功设置。
- 不得用应用 API 密钥替代 Admin 访问密钥、Notify 令牌或 webhook 签名密钥。
- 若密钥出现在源码、日志或工件中，应停止、吊销或轮换该密钥、移除暴露并保留脱敏的事件回执。
输出
返回能力到客户端的决策、链/功能证明、凭据类别矩阵、脱敏连通性结果、密钥生命周期、所有者、证据日期与未解决缺口。明确标记假设、观察、来源日期、环境特定行为、所有者与未解决缺口。
示例
- 对于服务器渲染的以太坊余额视图，选择 viem，用开发应用密钥证明一次读取，并将生产密钥保留在服务器密钥边界内。
- 对于交易类智能钱包应用，选择 Wallet APIs v5，并拒绝已归档的 alchemy-sdk 引导，即使旧仓库仍导入它。
验证
针对以下情形演练并记录预期与实际结果：错误的链；受支持链上不受支持的功能；缺失或无效密钥；将应用密钥提供给 Admin 端点；已吊销密钥；密钥金丝雀扫描。
资源
当前第一方证据地图——执行前重新核对带日期的 Alchemy 来源。将观察到的账户、应用、网络、索引器、链或提供商行为视为环境特定证据，而非普遍保证。
限制
该技能不授权任何网络访问、凭据使用、钱包地址、客户数据、计划变更、支出、密钥创建或轮换、webhook 变更、部署、重放、交易构造、签名、广播或删除。具体支持链、功能、客户端版本与认证方式需以执行时的第一方文档为准；资料未提供具体价格、收费或平台细节。