用途:为 Alchemy 相关开发提供能力路由与适配器边界设计,避免重新引入已归档的 alchemy-sdk,在产生任何实时副作用前产出可评审的工件与失败路径证据。
主要能力:按能力、链、运行时、副作用、数据归属和凭据类别清点现有调用;EVM Node 读走类型化 viem public client;NFT、Transfers、Prices、Simulation、Portfolio 走窄口径 HTTP 适配器并校验响应与分页契约;智能钱包创建与交易流走当前 Wallet APIs v5;Solana 走 Solana Web3.js。显式表达部分成功、分页、可重试与不支持链的结果,而非返回 null 或未类型化异常。为成功和各失败类建立契约夹具,并用仓库测试禁止新增 alchemy-sdk 导入。
必要用法:认证上每个适配器声明自身接受的凭据类型并拒绝其他类别,应用密钥、Admin 密钥、Notify token、webhook 签名密钥与钱包签名权限分类型、分密钥路径存放。审查用 Read、Glob、Grep;仅对已批准工件使用 Write、Edit。技能调用本身不授权网络访问、凭据、钱包地址、客户数据、套餐变更、花费、密钥创建轮换、webhook 变更、部署、回放、交易构造签名广播或删除。
适用场景:多链持仓查询走 Portfolio 适配器并暴露 partialErrors;eth_getBalance 走 viem public client;交易构造置于单独批准的签名边界之后。
限制:架构负责能力路由与适配器边界,安全负责凭据类型与签名策略;替换生产提供方或交易路径需 canary 与回滚批准。不要把每个产品包进通用客户端而抹掉分页、部分错误或凭据差异,不得把部分 Portfolio 响应当作完全成功,不得让读适配器获得签名权限。当前第一方文档、限量、生命周期等未在资料中给出具体值,需执行前复核带日期的 Alchemy 来源;账户、网络、索引器、链或提供方行为应视为环境特定证据。