360 Secure SkillHub
360 安全技能中心

Aavegotchi 3D Renderer

根据 tokenId 或库存链接从 Goldsky Base 子图读取 Aavegotchi 数据，派生渲染哈希，调用 Aavegotchi 批量渲染接口轮询状态，并保存 PNG_Full、PNG_Headshot 及记录 GLB_3DModel 可用性。

cinnabarhorse
cinnabarhorse
热度 76.38
最近更新 2026-05-17 12:40:08
分类：创作依赖：代码执行 / 读写文件 / 第三方 API应用场景：图像生成 / API 集成 / 自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add aavegotchi-3d-renderer
Metadata
name
aavegotchi-3d-renderer
description
Render Aavegotchi assets by deriving renderer hashes from Goldsky Base core data and calling POST /api/renderer/batch on www.aavegotchi.com. Use when the user gives a tokenId or inventory URL, or when deterministic hash plus image artifacts are required.

Aavegotchi 3D Renderer

Render gotchi assets from token data and renderer batch APIs.

Inputs

  • Accept either tokenId or inventory URL with id=<tokenId>.
  • Target Base by default (chainId=8453).

Outputs

  • Return derived renderer hash.
  • Return /api/renderer/batch HTTP status.
  • Save raw batch JSON to disk.
  • Save PNG_Full and PNG_Headshot to disk when available.
  • Return GLB_3DModel availability and URL when present.

Execute

  1. Extract tokenId from direct input or inventory URL.
  2. Query Goldsky Base core subgraph: https://api.goldsky.com/api/public/project_cmh3flagm0001r4p25foufjtt/subgraphs/aavegotchi-core-base/prod/gn
  3. Derive hash in renderer format: <Collateral>-<EyeShape>-<EyeColor>-<Body>-<Face>-<Eyes>-<Head>-<RightHand>-<LeftHand>-<Pet>
  4. Kick off render with POST https://www.aavegotchi.com/api/renderer/batch using:
  • force: true
  • verify: false
  • renderTypes: ["PNG_Full", "PNG_Headshot", "GLB_3DModel"]
  1. Poll POST /api/renderer/batch with verify: true until availability.exists=true for all requested render types or timeout.
  2. Download proxyUrls.PNG_Full and proxyUrls.PNG_Headshot only when corresponding availability.exists=true.
  3. Return the hash, kickoff + verify responses, poll summary, and saved artifact paths.

Command

Run the bundled script:

node scripts/render-gotchi-bypass.mjs --token-id 6741

Or pass an inventory URL:

node scripts/render-gotchi-bypass.mjs \
  --inventory-url "https://www.aavegotchi.com/u/0x.../inventory?itemType=aavegotchis&chainId=8453&id=6741"

Use --out-dir /tmp to control artifact location (default: /tmp).

Optional polling controls:

--poll-attempts 18 --poll-interval-ms 10000

Return format

Always return:

  1. tokenId
  2. hash
  3. Kickoff status, verify status, and raw JSON paths
  4. Poll summary (pollAttempts, pollIntervalMs, renderReady)
  5. PNG_Full and PNG_Headshot output paths (or missing reason)
  6. GLB_3DModel availability and URL when present

Troubleshooting

  • If Goldsky returns no gotchi, verify tokenId and Base context.
  • If batch returns hash-format 400, verify eye mappings and right/left wearable order (index4 then index5).
  • If availability.exists is false, ensure kickoff used force:true, then keep polling verify:true until timeout.
  • If endpoint returns 404, verify production deployment state.