Aavegotchi Renderer Bypass
Render gotchi assets from token data and renderer batch APIs.
Inputs
- Accept either
tokenIdor inventory URL withid=<tokenId>. - Target Base by default (
chainId=8453).
Outputs
- Return derived renderer hash.
- Return
/api/renderer/batchHTTP status. - Save raw batch JSON to disk.
- Save
PNG_FullandPNG_Headshotto disk when available. - Return
GLB_3DModelavailability and URL when present.
Execute
- Extract
tokenIdfrom 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>-<LeftHand>-<RightHand>-<Pet> - Call
POST https://www.aavegotchi.com/api/renderer/batchwith:
verify: truerenderTypes: ["PNG_Full", "PNG_Headshot", "GLB_3DModel"]
- Download
proxyUrls.PNG_FullandproxyUrls.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/batchstatus and raw JSONPNG_FullandPNG_Headshotoutput paths (or missing reason)GLB_3DModelURL oravailability.exists=false
Troubleshooting
- If Goldsky returns no gotchi, verify
tokenIdand Base context. - If batch returns hash-format
400, verify eye mappings and left/right wearable order. - If
availability.existsisfalse, rerun batch to trigger render and poll again. - If endpoint returns
404, verify production deployment state.