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. 1. Extract tokenId from direct input or inventory URL.
2. Query Goldsky Base core subgraph:

1. 3. Derive hash in renderer format:

1. 4. Kick off render with POST https://www.aavegotchi.com/api/renderer/batch using:

• - INLINECODE11
• INLINECODE12
• INLINECODE13

1. 5. 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:

CODEBLOCK0

Or pass an inventory URL:

CODEBLOCK1

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

Optional polling controls:

CODEBLOCK2

Return format

Always return:

1. 1. INLINECODE22
2. INLINECODE23
3. Kickoff status, verify status, and raw JSON paths
4. Poll summary (pollAttempts, pollIntervalMs, renderReady)
5. INLINECODE27 and PNG_Headshot output paths (or missing reason)
6. INLINECODE29 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.