Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.trustware.io/llms.txt

Use this file to discover all available pages before exploring further.

Trustware is the Universal Deposit Layer. It solves the deposit conversion problem: accept any asset on any chain and settle to your preferred asset on your preferred chain; without building the routing and settlement plumbing yourself. Use the React SDK for a prebuilt deposit widget, or integrate directly via the REST API for full backend control.

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.