核心用法
Aavegotchi 3D Renderer 是一个自动化资产渲染工具，专为 Aavegotchi NFT 生态设计。用户只需提供 tokenId 或库存页面 URL，工具即可：
1. 数据溯源：通过 Goldsky Base 核心子图查询链上原始数据
2. 哈希派生：将抵押品类型、眼部形状/颜色、身体、面部、装备等属性组合为渲染器专用哈希格式
3. 批量渲染：调用 Aavegotchi 官方渲染 API 生成三种输出格式：
PNG_Full：完整角色立绘PNG_Headshot：头像特写GLB_3DModel：可交互 3D 模型
4. 本地存储：自动下载并保存图像与模型文件到指定目录（默认 /tmp）
典型工作流
# 直接通过 tokenId 渲染 node scripts/render-gotchi-bypass.mjs --token-id 6741 # 通过库存 URL 渲染 node scripts/render-gotchi-bypass.mjs --inventory-url "https://www.aavegotchi.com/u/0x.../inventory?id=6741"
显著优点
- 确定性输出：基于链上数据生成唯一哈希，确保渲染结果可复现
- 多格式支持：同时获取 2D 图像与 3D 模型，满足多样化应用场景
- 官方 API 集成：直接调用
aavegotchi.com官方渲染服务，资产质量有保障 - Base 链优先：默认支持 Base L2 网络，Gas 成本较以太坊主网显著降低
潜在局限
- 依赖中心化服务：渲染 API 由 Aavegotchi 官方运营，存在服务中断或速率限制风险
- 异步渲染延迟：
GLB_3DModel可能需要多次轮询才能就绪 - 哈希格式敏感：眼部映射和左右手装备顺序错误会导致 400 错误
- Goldsky 子图依赖：若子图同步延迟或故障，无法获取原始数据
适合人群
- NFT 收藏者需要批量导出高清资产
- 游戏开发者集成 Aavegotchi 角色到元宇宙场景
- 内容创作者制作社交媒体素材或 3D 打印文件
- 数据分析师研究 wearables 稀有度与视觉特征关联
常规风险
| 风险类型 | 说明 | 缓解措施 |
|---------|------|---------|
| API 变更 | 官方渲染端点或参数格式更新 | 关注 Aavegotchi 官方公告，保留版本回退能力 |
| 子图延迟 | Goldsky 数据可能滞后链上状态 | 添加重试逻辑与缓存机制 |
| 渲染失败 | 复杂装备组合可能无法即时生成 | 实现指数退避轮询策略 |
| 文件存储 | 默认 `/tmp` 可能被系统清理 | 显式指定持久化输出目录 |
技术依赖
- Goldsky Subgraph:
aavegotchi-core-base生产环境端点 - 渲染 API:
https://www.aavegotchi.com/api/renderer/batch - 网络: Base (chainId 8453)
- 运行时: Node.js 环境