Partner Documentation

High-level overview of CryptoWidgetHub capabilities. Full documentation provided to approved partners.

Widget Capabilities

The CryptoWidgetHub widget offers extensive customization options to match your platform's needs.

Multi-Chain Support

SUI, Solana, and all major EVM chains

Token Locking

Force specific destination tokens

Custom Theming

Light, dark, or auto mode

Flexible UI

Show/hide specific controls

Partner Tracking

Built-in analytics and reporting

Event Callbacks

Real-time trade status updates

Widget Events

The widget communicates with your page via postMessage. Listen for these events:

  • WIDGET_READY: Widget has loaded and is ready
  • QUOTE_RECEIVED: User received a quote for their trade
  • TRADE_SUBMITTED: User submitted a trade transaction
  • TRADE_COMPLETED: Trade successfully completed
  • TRADE_FAILED: Trade failed or was rejected

Security & Sandbox

Styling

Height & Width

Recommended: width: 100%, height: 720px minimum. Adjust via className or inline styles.

Border Radius

Use Tailwind classes like rounded-2xl or CSS border-radius property.

Theme

Use the theme parameter to control light/dark mode within the widget.

Locking Destination Token

When lockDestination=true, the destination token selector is hidden and the user can only trade to the specified toToken. This is useful for:

  • Directing users to buy your project token
  • Creating token-specific landing pages
  • Simplifying the user experience

Network Coverage

CryptoWidgetHub supports cross-chain trading across:

  • SUI: Sui blockchain
  • Solana: Solana blockchain
  • EVM: All Ethereum Virtual Machine compatible chains (Ethereum, Polygon, Arbitrum, BNB Chain, Optimism, Base, Abstract Chain, etc.)