Skip to content
OperationalWeb2 first · Web3 optional

SDK / Integration

Typed adapter contracts.

Origin Engine approved asset → Holofoil material configuration → rendered collectible → optional ARCANA-54 spatial placement. Holofoil does not mint, sign, deploy, or bill generation. AGENTROPOLIS-54T owns security.

    01

    Origin Engine approved asset

    Asset identity, QC, source hash and artwork URI. Holofoil never copies Origin Engine source.

    {
      "assetId": "origin.ember-fox.001",
      "title": "Ember Fox — Specimen 001",
      "approvedAt": "2026-09-01T00:00:00.000Z",
      "sourceHash": "7c3e91a04b2f88d1c6aa4412",
      "artwork": {
        "mime": "image/png",
        "uri": "holofoil://local/ember-fox",
        "width": 1024,
        "height": 1434
      },
      "metadata": {
        "foilType": "holographic",
        "district": "creator"
      },
      "qc": {
        "passed": true,
        "notes": [
          "geometry locked",
          "palette approved"
        ]
      }
    }

    02

    Holofoil material configuration

    Canonical JSON another Agentropolis application can consume.

    {
      "schema": "agentropolis.holofoil.material.v1",
      "version": 1,
      "foilType": "holographic",
      "intensity": 0.72,
      "refraction": 0.55,
      "glowColor": "#3ee0ff",
      "opacity": 0.86,
      "grain": 0.28,
      "fresnel": 0.62,
      "lightAzimuth": 38,
      "lightElevation": 42,
      "pointerResponse": true,
      "mobileTilt": true,
      "animationSpeed": 0.45,
      "seed": "7c3e91a04b2f88d1c6aa4412"
    }

    03

    Rendered collectible

    Foil hash plus locked dimensions. Presentation only.

    {
      "assetId": "holo:origin.ember-fox.001",
      "title": "Ember Fox — Specimen 001",
      "material": {
        "schema": "agentropolis.holofoil.material.v1",
        "version": 1,
        "foilType": "holographic",
        "intensity": 0.72,
        "refraction": 0.55,
        "glowColor": "#3ee0ff",
        "opacity": 0.86,
        "grain": 0.28,
        "fresnel": 0.62,
        "lightAzimuth": 38,
        "lightElevation": 42,
        "pointerResponse": true,
        "mobileTilt": true,
        "animationSpeed": 0.45,
        "seed": "7c3e91a04b2f88d1c6aa4412"
      },
      "render": {
        "foilHash": "076fcb14",
        "width": 1024,
        "height": 1434,
        "schema": "agentropolis.holofoil.render.v1"
      },
      "source": {
        "originAssetId": "origin.ember-fox.001",
        "sourceHash": "7c3e91a04b2f88d1c6aa4412"
      }
    }

    04

    Optional ARCANA-54 placement

    A transform into arcade, relic, museum or open rooms. ARCANA-54 consumes this; it is not implemented here.

    {
      "collectibleId": "holo:origin.ember-fox.001",
      "worldId": "arcana-54",
      "room": "museum",
      "transform": {
        "x": 8.75,
        "y": 1.2,
        "z": -6.25,
        "yaw": 5.078908123303499
      },
      "foilHash": "076fcb14"
    }