Guides

Set up each app

Step-by-step with a short video. Do Partner account first, then add widgets to your site. Mainnet only. Wallet is never iframed.

1. 1
   Partner account

   Create your partner, get a slug, then allowlist your website origin.
2. 2
   Swap widget

   Drop-in DEX on your site. Users swap; you earn a share of the platform fee.
3. 3
   Bridge widget

   Cross-chain bridge embed. Two payments: platform fee first, then deposit.
4. 4
   Marketplace (Cafe)

   Cafe NFT / broker widget on your site. Same partner slug and origin allowlist.
5. 5
   Login with Riddle Wallet

   Site login for other websites. Wallet opens as a popup — never an iframe of the wallet.
6. 6
   Create wallet widget

   Let visitors create or import a Riddle Wallet. Wallet is a popup, never an iframe.
7. 7
   Sign widget + API

   Create an unsigned session, mount the sign widget, user signs in Riddle Wallet.
8. 8
   Fee control

   Platform bps are Riddle-owned. You set an optional surcharge 0–50 bps.
9. 9
   REST API keys

   One key per connection. Test keys quote only; live keys prepare, create, report, sign.

Package: @riddlewallet/partners · npm install @riddlewallet/partners