iframe SDA Widget

You can embed the Rhino.fi SDA Widget into any site with a simple <iframe>. It provides a complete UI for creating Smart Deposit Addresses and settling deposits to a destination address, with no installation or bundling.

⚡ Quick Start

You can design your widget visually in our playground, or use the example code below directly.

Customize Your Theme

Use our playground to visually design and preview your widget, then copy the embed code.

Paste this HTML where you want the widget to appear:

<iframe
  src="https://address.rhino.fi/?apiKey=YOUR_PUBLIC_API_KEY&chainIn=ETHEREUM&chainOut=BASE&token=USDC&recipient=0xYOUR_RECIPIENT_ADDRESS"
  style="width: 400px; height: 581px; max-width: 100%; border: none"
  scrolling="no"
/>

Replace YOUR_PUBLIC_API_KEY with your Rhino.fi public API key, and 0xYOUR_RECIPIENT_ADDRESS with the address that should receive the funds.

Always use a public key in the widget. The key is part of the iframe URL, so anyone visiting your page can see it. Never use a secret key here: it gives access to your full transaction history. See Authentication.

Unlike the bridge widget, the SDA widget has no default configuration: chainIn, chainOut, token and recipient are all required.

Visit the Rhino.fi Console

You can create a project and manage API keys there.

Customization

You can customize the widget’s appearance and default values with URL query parameters:

Query Param	Required	Description	Example
apiKey	✅	Your public API key	`apiKey=YOUR_PUBLIC_API_KEY`
chainIn	✅	Source chain	`chainIn=ETHEREUM`
chainOut	✅	Destination chain	`chainOut=BASE`
token	✅	Source token	`token=USDT`
recipient	✅	Destination (recipient) address	`recipient=0xYOUR_RECIPIENT_ADDRESS`
tokenOut		Destination token	`tokenOut=USDC`
amount		Pre-fills the amount in the deposit QR code	`amount=10`
mode		Widget mode (light or dark)	`mode=dark`
theme		Theme configuration in JSON	`theme={...}` (URL-encoded JSON)

🎨 Theming

You can customize how the widget looks by passing a theme query param as URL-encoded JSON. Supported theme properties:

type WidgetTheme = {
  colors?: {
    primary?: string               // Primary color / CTA color
    primaryLight?: string          // Light variation of the primary color
    secondary?: string             // Secondary color
    widgetBackground?: string      // Background of the full widget
    select?: string                // Background of input/select fields
    textPrimary?: string           // Default widget text color
    textSecondary?: string         // Secondary or muted text
    textPrimaryCta?: string        // Text color for primary buttons
    textSecondaryCta?: string      // Text color for secondary buttons
    stroke?: string                // Border/stroke color
  }
  radius?: {
    widget?: string                // Border radius for main widget container
    actionElements?: string        // Radius for buttons and actions
    tokenSelect?: string           // Radius for token select
  }
  tokenInputStroke?: boolean       // Whether to show stroke or fill on token input
  googleFontFamily?: string        // Google Font family name to load and apply
}

Example with a custom theme:

<iframe
  src="https://address.rhino.fi/?apiKey=YOUR_PUBLIC_API_KEY&chainIn=ETHEREUM&chainOut=BASE&token=USDC&recipient=0xYOUR_RECIPIENT_ADDRESS&mode=light&theme=%7B%22colors%22%3A%7B%22primary%22%3A%22red%22%7D%7D"
  style="width: 400px; height: 581px; max-width: 100%; border: none"
  scrolling="no"
/>

Smart Deposit Addresses guide: how SDAs work, including supported tokens and limits
Track transactions: receive webhooks for widget deposits

Get Started

SDK

Migration guides

Webhook

API Integration

Smart Contracts

Widgets

General information

Embedding the Rhino.fi SDA Widget (iframe)

⚡ Quick Start

Customize Your Theme

Visit the Rhino.fi Console

Customization

🎨 Theming

Embedding the Rhino.fi SDA Widget (iframe)

⚡ Quick Start

Customize Your Theme

Visit the Rhino.fi Console

Customization

🎨 Theming

Related