Embeds

How it works#

1. 1

   Open the Studio, pick a tool and your colors, and copy the one line.

2. 2

   Paste it where the widget should appear on your site. Use one tag per widget.

3. 3

   Visitors see live data in place. When they act, a pop-up on our site opens so their wallet can sign.

The short version#

One script tag per tool, with the tool and the token address. The Embed guide lists every attribute, the first sizes, the plain iframe and the wallet pop-up in full.

What it costs#

Free. Embedding costs nothing. Fees that belong to a tool, such as a Burn Wall post, apply when someone uses it.

Good to know#

• Wallets cannot be relied on inside another site's iframe. Phantom's own documentation says it does not inject into iframes. So an embed shows information and sends every action to a pop-up on our domain, where wallets work.
• If the pop-up is blocked, or a strict browser policy cuts the link back, the widget reads the chain again, because the chain is the source of truth.
• The iframe is sandboxed. It cannot navigate your page, and our script reads nothing from your page except its own tag and your page's origin.
• Only the embed paths on our site can be framed. Every other page of ours refuses framing.
• The loader resizes the frame as content changes. A plain iframe tag works too, without automatic resizing.

Under the hood#

• The loader at /embed.js reads data-widget, data-mint, data-accent, data-bg, data-radius and data-compact from its own tag, validates every value, and inserts an iframe that points to our own origin.
• The embedded page tells the loader its height. The loader accepts that message only from its own frame and from our origin, and only for heights from 40 to 4000 px.
• Actions open a pop-up on our site. The pop-up reports the result only to our own origin and closes itself after a success.