Skip to main content
Get up and running with Widget Light in minutes. The core package has zero dependencies beyond React — you only add peer dependencies for the blockchain ecosystems you want to support.

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

The widget renders inside an iframe and all EVM transactions are signed through your wagmi-managed wallet.

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.

TypeScript Support

Widget Light is written in TypeScript and provides full type definitions. All configuration options, event payloads, and handler interfaces are fully typed: