← Dobbscoin Promo #1

Field NotesA RADIO SPOT INSIDE AN NFT ON GNOSIS · INCIDENT LOG

This is not a tutorial. It is an incident log. We wanted a 43-second (BOB) Dobbscoin radio spot to live entirely on-chain, play on Gnosisscan, and show live what its sales had locked. It took three tries in public. These are the parts nobody had written down, so you only have to break them once.

Everything below was learned by pressing PLAY on the real Gnosisscan page, which is where the lessons were hiding. Nothing here is theory.

What Gnosisscan does with your animation_url

Gnosisscan is run by Blockscout, and for most people it is the only place a Gnosis NFT gets seen. The frame it loads your HTML into is gnosisscan.io/nft-html-embed.html. Opened directly it is a blank page, because it is an empty frame; use View Source and read the comment at the top before you build. Between that and pressing PLAY:

INCIDENT 1The Silent Spot

Shipped, frozen forever, silent
The record carried the MP3 as <audio src="data:audio/mpeg;base64,…">. Every local test played it. Gnosisscan refused it with media error 4. The item had already been opened, which in that contract meant frozen for good.

It had passed fuzzing, invariants, static analysis and two code reviews. Code review reads code. It does not press PLAY. An earlier test version had played fine, because it handed the sound over as a blob:. The later version "simplified" that into a data: URL and nobody pressed the button again.

Fix: build a Blob from the bytes and give <audio> a URL.createObjectURL address. The failed collection was pulled from our portfolio. It is still on chain, as these things are.

INCIDENT 2The Player That Read Itself Aloud

Caught in rehearsal
The rebuilt player showed its own JavaScript as text where the PLAY button should have been.

A comment inside the script explained that each copy ends with <script>go(…)</script>. The HTML parser does not know what a JavaScript comment is. It saw </script>, ended the script there, and printed the rest of the program onto the page.

The byte-for-byte checks passed, because the bytes were exactly what we wrote. Only the real page showed it. We now refuse to deploy any player whose script contains </script or <!--.

INCIDENT 3The Bell Nobody Heard

Change order, live collection
We swapped a corrected renderer into the live collection and emitted EIP-4906 BatchMetadataUpdate for every copy, as the standard says to. Gnosisscan kept showing the old version.

Gnosisscan did not act on that event in the time we waited. What does work is the "…" menu on a token's page, then Refresh metadata. Press it on every copy people are going to look at. Our own check passed once while the explorer was still showing the old player, so it now also confirms that Gnosisscan is playing the current version.

What works

Dobbscoin Promo #1 is the version that survived. The design, in parts:

The checks we run now

  1. A dress rehearsal with the exact bytes on Gnosis mainnet, from a throwaway account, priced at 1 wei, with one copy minted.
  2. Read everything back through a public RPC: deployed code equals the reviewed build, sound and picture equal the source files, every checked copy's record equals what it should be, field by field.
  3. On the real Gnosisscan page: refresh, press PLAY, and require that time advances, the waveform hears it, the picture draws, the numbers are numbers, and the player is the current version.
  4. A human presses it too.

Only then does anything get opened or locked. The rehearsal caught Incident 2. A code review would not have.

Receipts

Collection
0x740eC4945F0fdd3950B154d160aB5bEF45fC07f3 (source verified on Sourcify)
Media
0xC58C3A154702DD7819F65a5b434BB74434f51918 (source verified on Sourcify)
Copy Nº 1
press PLAY on it
Vault
0x703d19D7B7f037ECFF68545aE90Dd5255a9D7F64: every xDAI becomes GNO, locked four years under wBOB
Mint page
subgenius.finance/wbob/promo/

Sources that helped: OpenSea metadata standards, Zellic on sandboxed NFT iframes. There is no guide to a good NFT experience on Gnosis. Now there is this.

The spot is 43 seconds long. Getting it to play took most of a week. "Bob" would call that Slack well spent, and "Bob" has never been wrong about Slack.