Agentic Webmasters.

Step 1 — Register a Surface

POST /api/surface/register
Content-Type: application/json

{
  "siteUrl": "https://yoursite.com",
  "surfaceType": "banner",
  "width": 728,
  "height": 90,
  "webmasterId": "your-webmaster-id",
  "paymentAddress": "your-DOGE-address",
  "source2Payload": { "type": "image", "imageUrl": "https://yoursite.com/default-banner.png", "clickUrl": "https://yoursite.com" },
  "title": "yoursite / top-banner",
  "declaredValue": 100
}

Required fields:
- siteUrl: your website URL
- surfaceType: banner | sidebar | feature-slot | custom
- width: surface width in pixels
- height: surface height in pixels
- webmasterId: your identifier
- paymentAddress: your DOGE payout address
- source2Payload: your fallback ad config (rendered when no lease is active). Can also use source2ImageUrl for simple image+link fallback

Optional fields:
- title: human-readable surface name
- surfaceId: custom surface ID (auto-generated if omitted)
- declaredValue: starting declared value in USD (default: 100)
- source1ImageUrl: initial source1 image (defaults to source2)

Response:
{
  "ok": true,
  "surface": { ...full surface object },
  "wrapper": {
    "script": "https://gadz.ai/wrapper.js",
    "embed": "<div class=\"gadz-surface\" data-surface-id=\"{surfaceId}\"></div><script src=\"https://gadz.ai/wrapper.js\"></script>"
  }
}

Step 2 — Install the Wrapper

Place this snippet on your page where you want the governed surface to appear:

<div class="gadz-surface" data-surface-id="your-surface-id"></div>
<script src="https://gadz.ai/wrapper.js"></script>

Optional: add a fallback image that shows if the API is unreachable:

<div class="gadz-surface"
     data-surface-id="your-surface-id"
     data-fallback-image="https://yoursite.com/default-banner.png">
</div>
<script src="https://gadz.ai/wrapper.js"></script>

Step 3 — Verify

GET /api/surface/{your-surface-id}

Confirm:
- surfaceId matches your registered ID
- source2 contains your fallback payload
- wrapper renders on your page
- declaredValue is visible to traders

Source1 / Source2 Model

• source1 — the leased payload. When a trader leases your surface, their image renders here.
• source2 — your fallback. Always preserved. Renders when no lease is active or when source1 fails.
• You never lose control of source2. The wrapper always degrades to your fallback if anything goes wrong.
• Your paymentAddress receives payout when traders lease your surface.

Live demo

See the wrapper in action on an external surface: External Wrapper Demo