Core Package
Ecosystem Dependencies
Install the peer dependencies for each blockchain ecosystem you want to support. You only need the ecosystems your application uses.EVM (Ethereum)
Solana
Bitcoin
Sui
Tron
The Tron handler is library-agnostic — you pass wallet state explicitly. Only@lifi/widget-light is required for that API. If you follow the documented integration using @tronweb3/tronwallet-adapter-react-hooks, install it alongside the core package:
All Ecosystems
To install everything at once:Quick Start — EVM Only (wagmi)
This is the minimal setup for EVM chains using wagmi. It assumes you already have a wagmi provider configured in your app.1. Configure your wallet provider
Set up wagmi as you normally would. Widget Light reads wallet state from your existing wagmi context.2. Set up the provider tree
3. Render the widget
Full Multi-Ecosystem Setup
To support Solana, Bitcoin, Sui, and Tron alongside EVM, install the additional handler peer dependencies and pass all handlers to the widget.Only include the handlers you need. If you only support EVM and Solana, pass
[ethHandler, solHandler]. Unused ecosystem packages are fully tree-shaken from your bundle.
