用途
本技能用于在 Alchemy Portfolio API 上设计多链持仓工作流，围绕分页、部分失败、隐私与对账建立显式契约。其目标是在任何实际副作用发生之前，先产出一份可审查的工件以及负路径证据。
主要能力
- 定义支持的网络集合、地址来源、新鲜度 SLO、显示货币、分页上限以及向用户展示的完整性状态。
- 通过响应校验适配器调用 Portfolio 代币或 NFT 端点，并将请求的网络集合与结果一并保留。
- 持久化成功的网络分页结果，并将顶层 error.partialErrors 作为具名不可用网络呈现，而不是直接丢弃。
- 仅对成功的结果集继续使用游标；对失败网络以全新请求在受限预算内重试，并在不重复持仓的前提下完成对账。
- 在 UI/API 中证明空、部分、分页、过期以及提供商完全失败等状态，并记录缓存失效与数据删除策略。
使用方式
- 确认当前第一方 Alchemy 文档中列出的每个 Portfolio 网络，并在访问提供商前校验每个地址。
- 通过响应校验适配器调用相应的 Portfolio 代币或 NFT 端点。
- 持久化成功网络的分页结果，并将 error.partialErrors 呈现为具名不可用网络。
- 对失败网络以全新请求在受限预算内重试，并对账以避免重复持仓。
- 在 UI/API 中验证空、部分、分页、过期和完全失败状态，并记录缓存失效与数据删除。
适用场景
- 需要跨多个网络聚合可替代代币与 NFT 持仓的应用。
- 需要处理多网络扇出返回 HTTP 200 但同时报告 error.partialErrors 的情况。
- 需要向用户明确展示哪些网络不可用、哪些结果完整、哪些结果不完整的场景。
限制与注意事项
- 多网络扇出可能返回 HTTP 200 同时报告 error.partialErrors；失败的网络可能从分页中缺失。因此 HTTP 成功不等于完整性，失败网络的重试应作为全新的受限请求开始，而不是继续成功网络的游标。
- 使用适合 Portfolio API 的应用 API 密钥，并将其保留在批准的服务器边界内。当产品上下文使钱包地址可识别时，钱包地址属于个人或客户关联数据，应适用声明的通知、同意、保留和日志策略。
- 在 partialErrors、请求网络和分页完成对账之前，绝不要将 HTTP 200 响应标记为完整。
- 不要为原始响应中失败的网络继续使用成功网络的页面键。
- 不要将缺失的价格或元数据转换为零值资产。
- 技能调用本身不授权网络访问、凭据、钱包地址、客户数据、计划变更、支出、密钥创建或轮换、webhook 变更、部署、重放、交易构造、签名、广播或删除。
- 产品与隐私负责人批准地址收集与保留；运营方批准新鲜度与降级模式语义；导出地址或持仓、增加保留或添加网络需要明确批准。
输出
返回网络/地址契约、经过校验的适配器模式、分页与部分错误状态机、缓存策略、隐私控制、降级 UX、对账证据以及回滚方案。明确标记假设、观察、来源日期、环境特定行为、负责人和未解决的缺口。
示例
- 渲染 Ethereum 和 Base 持仓，同时明确标记失败的 Arbitrum 查询为不可用，然后将 Arbitrum 作为全新的受限请求重试。
- 仅当每个请求网络都完成且分页已耗尽时，才将空投资组合显示为有效的完整结果。
验证
针对以下情况执行并记录预期与实际结果：空完整钱包、多页成功、HTTP 200 含 partialErrors、单个失败网络重试、重复对账、数据删除请求。
资源
当前第一方证据映射——执行前重新检查带日期的 Alchemy 来源。将观察到的账户、应用、网络、索引器、链或提供商行为视为环境特定证据，而非普遍保证。