Wallet Guides

Integrate Seismic with popular wallet connection libraries

seismic-react integrates with any wallet library that provides wagmi configuration. This section covers setup for the most popular options.

Supported Libraries

Library	Best For	Key Feature
RainbowKit	dApps wanting polished wallet UI	Built-in modal, chain switching, account display
Privy	Apps needing email/social login	Embedded wallets, onboarding flow
AppKit	WalletConnect ecosystem apps	WalletConnect modal, broad wallet support

Common Integration Pattern

Regardless of which wallet library you choose, the integration follows the same steps:

1. Install the wallet library alongside seismic-react

2. Configure wagmi with Seismic chain definitions

3. Nest providers in the correct order

4. Use hooks from seismic-react in your components

Provider Nesting Order

All wallet integrations require the same provider hierarchy:

WagmiProvider
  └─ QueryClientProvider
       └─ [Wallet Provider] (RainbowKit / Privy / AppKit)
            └─ ShieldedWalletProvider
                 └─ Your App

ShieldedWalletProvider must be nested inside both WagmiProvider and your wallet provider. It reads the connected wallet from wagmi's context, so placing it outside will cause a runtime error.

Chain Configuration

All wallet libraries use the same chain imports from seismic-react/rainbowkit:

import { seismicTestnet } from "seismic-react/rainbowkit";

Choosing a Library

• Want the easiest setup with a beautiful wallet modal? Use RainbowKit

• Need email/social login or embedded wallets? Use Privy

• Want WalletConnect with maximum wallet compatibility? Use AppKit

Pages

Page	Description
RainbowKit	Setup with RainbowKit wallet UI
Privy	Embedded wallets with Privy
AppKit	WalletConnect AppKit integration

See Also

• Installation -- Package setup and peer dependencies

• ShieldedWalletProvider -- Provider reference and configuration

• Hooks Overview -- All available hooks