核心用法
本 skill 用于渲染 Aavegotchi 数字宠物的 3D/2D 资产。用户只需提供 tokenId 或 inventory URL,系统即可自动完成从链上数据查询到最终图像下载的全流程。
执行流程:
1. 解析 tokenId(支持直接输入或从 URL 提取)
2. 查询 Goldsky Base 核心子图获取 gotchi 元数据
3. 根据佩戴装备特征生成标准渲染器哈希:Collateral-EyeShape-EyeColor-Body-Face-Eyes-Head-RightHand-LeftHand-Pet
4. 调用 Aavegotchi 官方渲染批处理 API,请求 PNG_Full、PNG_Headshot、GLB_3DModel 三种输出
5. 轮询验证渲染完成状态,下载可用资产到本地磁盘
显著优点
- 官方链路:直接对接 Aavegotchi 官方渲染服务与 Goldsky 索引数据,输出质量有保障
- 多格式输出:同时支持 2D 全图、头像及 3D GLB 模型,满足展示/元宇宙/游戏等多场景需求
- 确定性渲染:基于链上数据生成唯一哈希,确保渲染结果可复现、可验证
- 自动化轮询:内置智能轮询机制,自动等待渲染完成,无需手动跟进
潜在局限
- 依赖官方服务:渲染完全依赖
www.aavegotchi.com/api/renderer/batch,存在服务不可用或限流风险 - 异步延迟:复杂资产渲染需多次轮询(默认 18 次 × 10 秒),实时性受限
- Base 链限制:当前仅支持 Base 网络(chainId=8453),未覆盖 Polygon 等其他部署
- 无持久存储:资产仅保存到本地
/tmp,需自行管理长期归档
适合人群
- Aavegotchi 持有者:快速导出个人宠物高清素材
- 元宇宙开发者:批量获取标准化 3D 模型用于游戏集成
- NFT 分析师:通过程序化方式获取可视化资产进行数据研究
常规风险
- API 稳定性:第三方 Goldsky 子图及官方渲染端点存在变更或降级可能
- 数据一致性:若链上数据与渲染器预期格式不匹配(如装备索引顺序错误),将导致 400 错误
- 资产临时性:官方
proxyUrls可能有过期时间,建议下载后及时转存 - 轮询资源消耗:高频调用可能触发服务端限流,建议合理控制并发