Tip jar
Add a "Tip me in crypto" card to your site with one script tag or a plain iframe. Fans tip from any chain and token; you receive your pay link's token, and the card counts your tippers.
The tip jar is a small card for creators' sites: a title, preset amounts, an optional message, "Supported by N tippers" and a pay box. Fans connect any EVM or Solana wallet and tip with whatever they hold; you receive one token on one chain, straight to your wallet. It is driven by your pay link: your ENS name, .sol name or address, and your preferred token.
Build yours at app.layerhop.com/tipjar: it checks the name, previews the live card and copies the code.
How do I add it with a script tag?#
<script async src="https://layerhop.com/tip.js"
data-name="alice.eth"
data-amounts="2,5,10"
data-label="Buy me a coffee"
></script>The script adds the card (an iframe from layerhop.com) right after the tag, or inside the element data-target selects, and resizes it to fit. Attributes:
| Attribute | Meaning |
|---|---|
data-name |
Required. ENS name, .sol name or address. |
data-amounts |
Up to 4 preset amounts in the token you receive, comma-separated. Default 2,5,10. |
data-chain, data-token |
Receive this token instead of your pay link's preference (for example solana and USDC). |
data-label |
Card title, up to 40 characters. Default "Tip me in crypto". |
data-theme |
dark (default) or light. |
data-color |
Accent color, hex (c3f06b). |
data-messages |
1 shows the latest tippers' messages on the card. |
data-target |
CSS selector of the element to put the card in. |
My site blocks third-party scripts. Can I still use it?#
Yes: use the iframe directly. No JavaScript runs on your page.
<iframe src="https://layerhop.com/tip/alice.eth?amounts=2%2C5%2C10&label=Buy+me+a+coffee"
title="Buy me a coffee" width="400" height="560"
style="border:0;max-width:100%;border-radius:20px" allow="clipboard-write" loading="lazy"></iframe>The query takes the same options as the script (amounts, chain, token, label, theme, color, messages=1). Your Content-Security-Policy must allow framing LayerHop: frame-src https://layerhop.com. The iframe can't resize itself without the script, so set the height you need (add about 160 px with messages).
What do tippers pay?#
A tip is a normal LayerHop swap into your token, with you as the recipient, on the widget fee channel: the tipper sees every fee before signing and LayerHop never holds the funds. Preset amounts are what you receive; the card sizes the payment from the first quotes so the tip arrives in full. If a fan already holds your token on your chain, the swap card still works, or they can send it to your address directly.
How does the counter work?#
Tips are quotes with purpose=tip (and the fan's message as note, up to 140 characters). GET /v1/tip-jars/{address} counts distinct wallets with a filled tip to that address, the number of tips, and returns the latest messages:
curl https://api.layerhop.com/v1/tip-jars/0x1111111111111111111111111111111111111111{ "address": "0x1111111111111111111111111111111111111111", "tippers": 42, "tips": 57, "messages": [{ "text": "Love the stream!", "at": "2026-10-28T12:00:00.000Z" }] }It is public and cached for a minute. Messages are shown as plain text, only when you turn them on.
Last updated