用途
该技能用于构建 NFT 发现工作流，结合 Alchemy NFT API v3 与 viem 的类型化链上读取能力。适用于创建集合浏览器（collection explorer）或进行所有权核验等场景。其核心目标是在产生任何实际副作用之前，先产出一份可审查的工件（reviewable artifact）以及负路径证据（negative-path evidence）。
主要能力
- 支持四种查询方向：所有者发现（owner discovery）、集合枚举（collection enumeration）、元数据查询（metadata lookup）、合约状态验证（contract-state verification）。
- 通过窄接口的 NFT API v3 适配器进行分页抓取，逐页校验并保留缓存媒体与原始媒体的来源信息。
- 使用 viem 在声明的同一链上创建公共客户端，配合经过审查的最小 ABI 进行链上读取，并记录区块上下文。
- 在需要时对索引器输出与合约读取结果进行对账，显式表示不一致与重组风险。
- 定义响应模式、垃圾/过滤策略、元数据与媒体回退、page-key 处理、最大页数与新鲜度标签。
使用方式
- 选择所有者发现、集合枚举、元数据查询或合约状态验证，并确认端点当前支持的链。
- 定义响应模式、垃圾/过滤策略、元数据与媒体回退、page-key 处理、最大页数和新鲜度标签。
- 通过窄接口的 NFT API v3 适配器抓取，校验每一页，保留缓存与原始媒体的来源，且不执行远程媒体内容。
- 如需链上验证，在声明的同一链上创建 viem 公共客户端，使用经过审查的最小 ABI，并记录区块上下文。
- 仅在产品需要时对索引器输出与合约读取进行对账，显式表示不一致与重组风险。
- 在发布前测试空集合、分页、畸形元数据、垃圾过滤、不支持链以及索引器与链不一致等场景。
适用场景
- 分页遍历公开测试集合，保留下一页令牌直至耗尽，并标注缓存媒体的来源。
- 对所有权敏感的结果，在记录的区块上通过类型化的 ownerOf 读取进行验证，并暴露不一致而非静默选择某一来源。
限制与边界
- 该工作流为只读，交易、授权、铸造或市场写入均不在其范围内。
- 技能调用本身不授权网络访问、凭据使用、钱包地址、客户数据、计划变更、支出、密钥创建或轮换、webhook 变更、部署、重放、交易构造、签名、广播或删除。
- NFT API 的响应、元数据可用性、垃圾分类、分页和支持网络均因端点而异。NFT 索引不等于链最终性，缓存媒体不构成所有权证明。
- 不得从图片 URL 或过期的缓存元数据推断所有权；不得在未记录所配置垃圾/过滤策略的情况下静默排除资产；若 NFT 索引与合约读取不一致，应显示不确定状态并在经批准的区块/最终性点进行对账。
- 产品/隐私负责人需批准地址使用与分析；安全负责人需批准远程媒体处理与 ABI/来源溯源。
输出内容
返回查询目的、链/端点证明、模式与分页契约、过滤策略、媒体安全规则、可选的 viem 读取证据、不一致行为、测试与回滚方案，并显式标注假设、观察、来源日期、环境特定行为、负责人与未解决缺口。
前置条件
- 所选产品、链、功能、客户端、认证方式、限制与生命周期的当前第一方 Alchemy 文档。
- 与请求范围相称的产品、应用、安全、数据/隐私、预算、发布与运营负责人。
- 合成或经批准的非生产夹具、凭据金丝雀、明确的成功标准以及经过测试的回滚边界。
认证
在服务端边界使用限定范围的应用程序 API 密钥。查询前校验所有者与合约地址。根据产品的隐私与保留政策处理被查询的所有者地址、集合与行为分析数据。
验证
需针对以下场景记录预期与实际结果：空集合、多页所有者、缺失元数据、不安全媒体 URL、不支持网络、索引器/合约不一致。
资源
当前第一方证据地图——执行前重新核对带日期的 Alchemy 来源。将观察到的账户、应用、网络、索引器、链或提供商行为视为环境特定证据，而非普遍保证。