Skip to main content
@dzapio/wallet is the multi-chain wallet integration layer used by @dzapio/widget. Connect EVM, Solana, Bitcoin, and Sui from one React provider, then read account state and balances across ecosystems. Install this package directly when you want wallet connection without the swap/zap UI.
If you embed @dzapio/widget, skip this install. The widget already depends on @dzapio/wallet and loads chain data for you.

Features

  • Multi-chain wallets — EVM (Wagmi / WalletConnect), Solana, Bitcoin, and Sui
  • Single account APIuseAccount returns the connected account for the active ecosystem
  • Connect UIConnectButton with a render-prop for custom controls
  • On-chain balancesuseRefetchBalance over RPC (EVM multicall, SPL, BTC, Sui)
  • Address validators — Ecosystem-aware checks via @dzapio/wallet/validators (no React UI)

Requirements

  • Node.js 18+
  • React 18+
Peer dependencies: react and react-dom. EVM connectors use viem and wagmi, which this package depends on.

Installation

Quick start

WalletProviders needs chainsData (InitialChainsData) — the supported-chain payload from the DZap API. The widget builds this for you; a standalone host must supply it.
How to load chainsData: Wallet configuration.

Configuration

WalletProviders, WalletConfig, chainsData.

Connect button

Default control and ConnectButton.Custom.

Hooks

useAccount, balances, Wagmi/Solana re-exports.

Validators

Address checks without pulling in the React UI.
Last modified on August 18, 2026