Quick Start
Install the SDK and render your first deposit widget in minutes.
Integration Patterns
Choose the right integration style: drop-in widget, host wallet bridge, or headless core.
Configuration
Customize routes, theme, messages, retry behavior, and WalletConnect settings.
API Reference
REST API endpoints for backend integrations: route generation, receipt submission, status polling, and balances.
How it works
The Trustware SDK resolves the best available cross-chain route for a given source token and destination chain, handles wallet connection (or accepts your existing wallet), and walks the user through a guided deposit flow ending in a confirmed on-chain transaction.1
Install the SDK
Add
@trustware/sdk to your React project with npm or pnpm.2
Configure your route
Tell Trustware the destination chain and token. Optionally set amount constraints and theme.
3
Wrap your app with TrustwareProvider
Mount the provider once at the top of your component tree to share config and wallet state.
4
Render TrustwareWidget
Drop
<TrustwareWidget /> anywhere in your app, or call the headless core API directly for full control.Integration styles
Drop-in Widget
Full deposit UX with built-in wallet selection; no extra setup required.
Host Wallet Bridge
Use your Wagmi or viem wallet client with the Trustware widget UI.
Controlled Widget
Programmatically open/close the widget and control its initial state via a ref.
Headless Core
Build a completely custom UI using Trustware’s routing, quoting, and transaction APIs.
