| 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
- Extract
tokenId from direct input or inventory URL.
- Query Goldsky Base core subgraph:
https://api.goldsky.com/api/public/project_cmh3flagm0001r4p25foufjtt/subgraphs/aavegotchi-core-base/prod/gn
- Derive hash in renderer format:
<Collateral>-<EyeShape>-<EyeColor>-<Body>-<Face>-<Eyes>-<Head>-<RightHand>-<LeftHand>-<Pet>
- Call
POST https://www.aavegotchi.com/api/renderer/batch with:
verify: truerenderTypes: ["PNG_Full", "PNG_Headshot", "GLB_3DModel"]
- Download
proxyUrls.PNG_Full and proxyUrls.PNG_Headshot.
- Return the hash, response, 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).
Return format
Always return:
tokenIdhash/api/renderer/batch status and raw JSONPNG_Full and PNG_Headshot output paths (or missing reason)GLB_3DModel URL or availability.exists=false
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, rerun batch to trigger render and poll again.
- If endpoint returns
404, verify production deployment state.
