DEVELOPER API

Authorized Avatars mint data is readable by third-party tools — galleries, marketplaces, and verifiers. Every record carries the work hash so anyone can independently confirm a mint was honestly mined.

Authentication

Reads are public. Use your app's Base44 API key in the Authorization header for any tool that hits the Avatar entity. Keep the key server-side — never expose it in a browser.

Authorization: Bearer <YOUR_API_KEY>

Endpoints

GET/avatars

List minted avatars, newest first. Supports a limit query param.

GET /avatars?limit=100

GET/avatars/:token_id

Fetch a single avatar by its sequential token id (1–4663).

GET /avatars/1

GET/avatars?owner=:address

Filter avatars belonging to a given wallet address.

GET /avatars?owner=0xabc…

GET/avatars?phase=:n

Filter avatars minted in a specific phase (0–5).

GET /avatars?phase=2

Avatar record shape

Each avatar record contains the fields a verifier needs:

{
  "token_id": 1,
  "owner_address": "0x…",
  "seed": "256-bit hex seed",
  "work_hash": "winning hash below target",
  "phase": 0,
  "phase_name": "Genesis",
  "mint_price_eth": 0.0005,
  "difficulty_bits": 22,
  "traits": { "background": "Sunset", "hat": "Leaf Boater", "eyes": "Pixel Shades", "shirt": "Rainbow Panel", "cloud": "Rainbow Cloud", "tone": "Mint" },
  "tx_hash": "on-chain payment tx to treasury"
}

Verifying a mint hash

To confirm an avatar was mined honestly, recompute the work hash from the recorded inputs and check it has at least difficulty_bits leading zero bits — the threshold for the avatar's phase. The seed is the work hash re-hashed with the 5-minute time bucket of the mint, so the same inputs always reproduce the same pixels.

Fetch the avatar record by token id.
Recompute hash(address | nonce | prevWork | anchor).
Count leading zero bits — it must be ≥ difficulty_bits.
Re-derive the seed from the work hash + time bucket and confirm the traits match.

On-chain payment

Each mint's tx_hash is a plain ETH transfer to the treasury, verifiable on the explorer:

Treasury0x328baca1c22d5cf7bdf4f67cfd56b4789c4a043b

ChainRobinhood Chain (ID 4663)

Explorerhttps://robinhoodchain.blockscout.com