{"skill":{"slug":"aavegotchi-3d-renderer","displayName":"Aavegotchi 3D Renderer","summary":"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 use...","description":"---\nname: aavegotchi-3d-renderer\ndescription: 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.\n---\n\n# Aavegotchi 3D Renderer\n\nRender gotchi assets from token data and renderer batch APIs.\n\n## Inputs\n\n- Accept either `tokenId` or inventory URL with `id=`.\n- Target Base by default (`chainId=8453`).\n\n## Outputs\n\n- Return derived renderer hash.\n- Return `/api/renderer/batch` HTTP status.\n- Save raw batch JSON to disk.\n- Save `PNG_Full` and `PNG_Headshot` to disk when available.\n- Return `GLB_3DModel` availability and URL when present.\n\n## Execute\n\n1. Extract `tokenId` from direct input or inventory URL.\n2. Query Goldsky Base core subgraph:\n`https://api.goldsky.com/api/public/project_cmh3flagm0001r4p25foufjtt/subgraphs/aavegotchi-core-base/prod/gn`\n3. Derive hash in renderer format:\n`---------`\n4. Kick off render with `POST https://www.aavegotchi.com/api/renderer/batch` using:\n- `force: true`\n- `verify: false`\n- `renderTypes: [\"PNG_Full\", \"PNG_Headshot\", \"GLB_3DModel\"]`\n5. Poll `POST /api/renderer/batch` with `verify: true` until `availability.exists=true` for all requested render types or timeout.\n6. Download `proxyUrls.PNG_Full` and `proxyUrls.PNG_Headshot` only when corresponding `availability.exists=true`.\n7. Return the hash, kickoff + verify responses, poll summary, and saved artifact paths.\n\n## Command\n\nRun the bundled script:\n\n```bash\nnode scripts/render-gotchi-bypass.mjs --token-id 6741\n```\n\nOr pass an inventory URL:\n\n```bash\nnode scripts/render-gotchi-bypass.mjs \\\n --inventory-url \"https://www.aavegotchi.com/u/0x.../inventory?itemType=aavegotchis&chainId=8453&id=6741\"\n```\n\nUse `--out-dir /tmp` to control artifact location (default: `/tmp`).\n\nOptional polling controls:\n\n```bash\n--poll-attempts 18 --poll-interval-ms 10000\n```\n\n## Return format\n\nAlways return:\n\n1. `tokenId`\n2. `hash`\n3. Kickoff status, verify status, and raw JSON paths\n4. Poll summary (`pollAttempts`, `pollIntervalMs`, `renderReady`)\n5. `PNG_Full` and `PNG_Headshot` output paths (or missing reason)\n6. `GLB_3DModel` availability and URL when present\n\n## Troubleshooting\n\n- If Goldsky returns no gotchi, verify `tokenId` and Base context.\n- If batch returns hash-format `400`, verify eye mappings and right/left wearable order (`index4` then `index5`).\n- If `availability.exists` is `false`, ensure kickoff used `force:true`, then keep polling `verify:true` until timeout.\n- If endpoint returns `404`, verify production deployment state.\n","tags":{"latest":"0.1.2"},"stats":{"comments":0,"downloads":960,"installsAllTime":3,"installsCurrent":3,"stars":0,"versions":3},"createdAt":1771917665442,"updatedAt":1778992808490},"latestVersion":{"version":"0.1.2","createdAt":1772091881998,"changelog":"Release 0.1.2: force renderer kickoff (force:true, verify:false), add verify polling, and return clear availability/missing reasons for artifacts.","license":null},"metadata":null,"owner":{"handle":"cinnabarhorse","userId":"s17ck8672hv34df1xsnx35r121885f29","displayName":"cinnabarhorse","image":"https://avatars.githubusercontent.com/u/6047087?v=4"},"moderation":null}