# Racerverse — full reference for assistants and agents

Last updated: 2026-07-16

This document expands `/llms.txt`. It is a product and integration summary, not a legal contract. Use live checkout, API responses, the FAQ, and the legal pages for facts that can change.

## Product summary

Racerverse is a browser-native digital toy world made by Lucky Machines LLC. An Original Racer is a unique digital character/vehicle assembled from authored parts and colors. A person can reveal one, view its detail page, inspect the model, drive it in the viewer, keep it in a collection, or gift it.

Normal customers do not need an app, crypto wallet, or prior technical setup. The customer-facing experience uses product language rather than protocol jargon.

An Original Racer is not:

- a shipped physical toy;
- a subscription or recurring membership;
- a wager, prize-racing product, or investment;
- guaranteed to be ready instantly.

## Current pricing and fulfillment

Standard checkout is a one-time purchase:

- 1 Original Racer: $5 total;
- 3 Original Racers: $12 total ($4 each);
- 5 Original Racers: $18 total ($3.60 each);
- group/custom orders of 6 or more: $3.50 per racer.

The racer is generated, checked, and added to the buyer's Racerverse account. Most racers are ready within a few minutes. Current checkout pricing is authoritative if it differs from this dated summary.

## Identity contract

Racerverse separates art identity from ownership metadata.

- Canonical public key: `dna-<artUuid>`
- Canonical art base: `https://cdn.racerverse.com/art/dna/<artUuid>`
- Human identifier: a DNA-derived license plate and plate slug
- Ownership/catalog metadata: `tokenId`, numeric IDs, and `dnaIndex`

Never build canonical asset URLs from `tokenId`, a numeric racer ID, or `dnaIndex`. When resolving a racer, prefer these public API fields in order:

1. `canonicalAssetBase`
2. nested `art.asset_base_url` when present
3. `https://cdn.racerverse.com/art/dna/<artUuid>` when `artUuid` is present
4. explicit legacy URLs only as a final graceful fallback

The nested `art` object can be null. Top-level canonical fields are the stable public integration contract.

## Canonical asset contract

Each ready canonical base publishes:

- `model_1k.glb`
- `model_showcase.glb`
- `model_embed.glb`
- `model_sim.glb`
- `model_imposter.glb`
- `model.usdz`
- `model_embed.usdz`
- `hero_alpha.png`
- `hero_alpha_2048.webp`
- `animation-manifest.json`

Do not request unpublished `hero_alpha_512.webp` or `hero_alpha_1024.webp` files.

Recommended variants:

- cards, thumbnails, and normal product imagery: `hero_alpha_2048.webp`, then `hero_alpha.png`;
- anatomy and normal inline 3D: `model_embed.glb`;
- Drive: `model_sim.glb`, then `model_embed.glb`, then `model_1k.glb`;
- near city traffic: `model_sim.glb`;
- distant traffic: `model_imposter.glb`;
- high-quality inspector: `model_1k.glb`;
- deliberate showcase presentation: `model_showcase.glb`;
- standard iOS AR: `model.usdz`;
- compact AR: `model_embed.usdz`.

Use the hero image as the visible loading poster and as the fallback when WebGL or AR is unavailable.

## Animation contract

Load `animation-manifest.json` from the same canonical base as the model. Semantic defaults are:

- `idle` → `All`
- `hover` → `ArmWave`
- `rev` → `WheelSpin`
- `accelerate` → `WheelSpin`

`All` is a merged animation. Never play it at the same time as its individual component clips. Racers can expose additional authored clips, so clients must read the manifest rather than assume every racer has the same animation list.

## Public catalog API

Compact canonical-art request:

`GET https://racerverse.com/api/collection/public?page=1&limit=200&filter=all&view=viewer&assetsOnly=1`

Paginate until `page >= totalPages`; do not assume a permanent catalog total. A viewer row can include:

- `publicKey` and `racerKey`
- `displayId` and `plateSlug`
- `status`
- `artUuid`
- `canonicalAssetBase`
- `canonicalGlb`
- `canonicalHero`
- `glbUrl`
- `imageUrl`
- `assetReady`
- `traits`

Full API description: <https://racerverse.com/openapi.json>

Human-readable docs: <https://racerverse.com/docs/api>

## Agent-only x402 purchases

Racerverse has an agent-facing x402 rail that is separate from normal human checkout. Do not present it as a button or setup requirement for ordinary buyers.

1. Fetch <https://racerverse.com/.well-known/x402-discovery>.
2. Fetch the live status and pricing URLs in that document.
3. POST to the advertised quantity endpoint without payment proof to receive the HTTP 402 requirement.
4. Have an x402-compatible client satisfy the requirement on the advertised network.
5. Retry with the required payment header and poll the returned order endpoint.

Discovery and live pricing override any dated price hint in prose.

## Website and viewer routes

Website:

- Homepage: <https://racerverse.com/>
- Collection: <https://racerverse.com/collection>
- Racer detail: `https://racerverse.com/racer/<plate-slug-or-dna-public-key>`
- Purchase: <https://racerverse.com/purchase>
- Compare one-time packs: <https://racerverse.com/compare>
- Try Drive: <https://racerverse.com/try>
- Gift: <https://racerverse.com/gift-a-racer>
- Group orders: <https://racerverse.com/group-orders>
- FAQ: <https://racerverse.com/faq>
- Story: <https://racerverse.com/story>
- World: <https://racerverse.com/world>
- Trait catalog: <https://racerverse.com/traits>
- Devlog: <https://racerverse.com/devlog>

Viewer routes accept a catalog-supplied plate slug, DNA public key, or `artUuid`:

- `https://viewer.racerverse.com/drive/<racer-key>`
- `https://viewer.racerverse.com/anatomy/<racer-key>`
- `https://viewer.racerverse.com/ar-view/<racer-key>`
- `https://viewer.racerverse.com/model-inspector/<racer-key>`

Do not replace a missing key with an unrelated numeric racer ID.

## Language and international search

English is the default locale. The site currently publishes these 25 locale codes:

`en`, `es`, `pt`, `fr`, `de`, `zh`, `ja`, `ko`, `it`, `nl`, `pl`, `ro`, `sv`, `cs`, `el`, `hu`, `bg`, `da`, `fi`, `sk`, `hr`, `lt`, `sl`, `lv`, `et`.

Canonical links, `hreflang`, Open Graph locale metadata, sitemap alternates, and HTML `lang`/`dir` values are generated from one locale registry. A newly scaffolded locale remains disabled and absent from search alternates until its translations are reviewed and the registry marks it published.

## Recommended language

Prefer:

- Original Racer
- digital toy
- unique racer
- open a racer
- inspect in 3D
- drive in the browser
- collect, keep, or gift

Avoid:

- claiming a subscription or recurring charge;
- promising instant fulfillment;
- using token IDs as art identity;
- describing Racerverse as an investment;
- comparisons with unrelated toy or entertainment brands;
- leading with protocol jargon when answering a normal product question.

## Common questions

### Is Racerverse a subscription?

No. Current public checkout offers one-time single and pack purchases. Existing private subscription-management code may remain for historical accounts, but it is not a current acquisition offer.

### Is a wallet required?

No. Normal buyers can use the website and account flow. Optional custody/export mechanics are governed by the current terms and relevant account tools.

### Is it a physical toy?

No. It is a digital toy with browser-based imagery and 3D experiences.

### How quickly is a racer ready?

Most racers are ready within a few minutes after generation and checks complete. Do not promise an instantaneous result.

### How should an integration choose a racer model?

Resolve the racer through the public catalog, use its canonical DNA/artUuid base, and select the smallest context-appropriate variant. Do not fall back to a different numeric racer's model.

## Source priority

When facts conflict, use this order:

1. legal pages for legal rights and policies;
2. live checkout and live x402 pricing for prices and availability;
3. live public catalog and OpenAPI for integration fields;
4. current FAQ and product pages for customer-facing explanations;
5. this dated reference for orientation.

Key machine-readable files:

- <https://racerverse.com/robots.txt>
- <https://racerverse.com/llms.txt>
- <https://racerverse.com/llms-full.txt>
- <https://racerverse.com/openapi.json>
- <https://racerverse.com/.well-known/ai-plugin.json>
- <https://racerverse.com/.well-known/x402-discovery>
- <https://racerverse.com/sitemap.xml>
- <https://racerverse.com/api/sitemap-racers.xml>

Support: hello@racerverse.com