Integrate the fan-out widget

Drop cross-chain disperse into your product: your users send to many wallets, across 26 networks (EVM + TON, Solana, Bitcoin, XRP and more), in one signature — and you earn on every swap. Non-custodial, no KYB, no forms: your wallet address is the whole registration.

¶Quick start — iframe

The simplest path: copy, replace integrator with your wallet, done. The listener auto-sizes the frame as the widget grows.

<iframe id="cherum-widget"
  src="https://app.cherum.io/en/embed?integrator=0xYourWalletAddress&integratorBps=20&theme=dark&accent=%238B6FE6"
  style="width:100%;max-width:460px;height:600px;border:0;border-radius:18px"
  allow="clipboard-write" loading="lazy"></iframe>
<script>
  window.addEventListener('message', function (e) {
    if (e.origin !== 'https://app.cherum.io') return;
    if (e.data && e.data.type === 'cherum-embed:height') {
      document.getElementById('cherum-widget').style.height = e.data.height + 'px';
    }
  });
</script>

Try configurations live in the playground — it generates this snippet for you.

¶Quick start — script tag

One tag, auto-height included. The loader mounts the same secure iframe under the hood and wires the resize listener for you.

<script src="https://cdn.cherum.io/widget.js" async></script>
<div id="cherum-widget"></div>
<script>
  window.addEventListener('load', function () {
    Cherum.mount('#cherum-widget', {
      integrator: '0xYourWalletAddress',  // your wallet — receives your fee
      integratorBps: 20,                  // your cut · default 20 (0.2%) · cap 500
      theme: 'dark',
      accent: '#8B6FE6'                   // any hex — your brand color
    });
  });
</script>

¶Quick start — React

The typed component wraps the same embed. Config maps 1:1 to the script loader.

// npm install @cherum/widget-react
import { CherumWidget } from '@cherum/widget-react';

export default function Pay() {
  return (
    <CherumWidget
      integrator="0xYourWalletAddress"
      integratorBps={20}
      theme="dark"
      accent="#8B6FE6"
      source={{ chain: 'arbitrum', token: 'USDC', amount: '1000' }}
      recipients={[
        { chain: 'base', token: 'USDC' },
        { chain: 'ton', token: 'USDT' },
      ]}
    />
  );
}

¶Parameters

Same fields in all three forms (URL query for the raw iframe, config object for the loader and React). Everything is optional except integrator — required to earn.

¶Source & recipients

Pre-set destinations are chain × token pairs — the user fills addresses and split percentages inside the widget (they must confirm where their money goes; that stays in their hands).

source: { chain: 'arbitrum', token: 'USDC', amount: '1000' },
recipients: [
  { chain: 'base', token: 'USDC' },
  { chain: 'ton',  token: 'USDT' },
  { chain: 'tron', token: 'USDT' },
]

¶Fees & integrator

Two models, two rails — they never blend, and your earnings never come out of Cherum's fee (or vice versa):

• EVM (Model A): your integratorBps markup is collected by the Cherum contract and routed to your integrator wallet on-chain, in the same transaction as the swap. Settled the moment the swap settles — nothing to withdraw.
• non-EVM (Model B): for swaps from TON, Solana, Bitcoin, XRP, Cardano and other non-EVM sources there is no contract to split on, so your markup accrues off-chain — set your rate in the cabinet (default 0.2%, up to 1%) and withdraw in USDC on Base.

¶Cabinet & payouts

• Sign in at partners.cherum.io with your integrator wallet — signature only, no email or password.
• Dashboard: earnings by chain, swap history with transactions, your non-EVM rate setting, embed snippets with your wallet baked in.
• Payouts: request a withdrawal once your non-EVM balance reaches $50 — paid in USDC on Base to your integrator wallet.

¶CSP & embedding

• The widget runs in an isolated iframe on app.cherum.io — no styles or scripts leak into your page, and your page cannot touch user funds.
• Allow framing: nothing needed on your side — the embed sends frame-ancestors *. Your CSP needs frame-src https://app.cherum.io (and script-src https://cdn.cherum.io if you use the loader).
• Auto-height uses postMessage with origin checks on both sides.
• No trackers, no external fonts — everything is served from Cherum domains.