Quick Start

Get Sei Global Wallet integrated into your application in minutes

Quick Start

Get Sei Global Wallet up and running in your application with a simple installation and import.

Installation

Install the Sei Global Wallet package using your preferred package manager:

npm

npm install @sei-js/sei-global-wallet

Basic Integration

Import the package to register the wallet with the EIP-6963 standard:

import '@sei-js/sei-global-wallet/eip6963';

This single import enables Sei Global Wallet discovery across all EIP-6963 compatible wallet connection libraries including RainbowKit, ConnectKit, Web3-React, and more.

Prerequisites

Before integrating Sei Global Wallet, ensure you understand these key concepts:

EIP-6963 Standard

EIP-6963 is a standard that allows multiple wallets to coexist without conflicts. Instead of fighting over window.ethereum, wallets announce themselves through events, letting users choose which one to use.

Dynamic Infrastructure

Dynamic is the infrastructure powering Sei Global Wallet. It handles authentication, key management, and cross-app wallet persistence while keeping wallets non-custodial.

Supported Authentication Methods

Sei Global Wallet supports multiple authentication methods:

Social Logins

• Google
• X (Twitter)
• Telegram

Traditional Methods

• Email authentication

Next Steps

Choose your preferred wallet connection library for detailed integration instructions:

RainbowKit

Popular React wallet connection library

ConnectKit

Modern wallet connection component

Web3-React

Flexible React hooks for Web3

Wagmi + Dynamic

Type-safe React hooks with Dynamic infrastructure

Dynamic (Next.js)

Full-stack Next.js integration with Dynamic

Testing Your Integration

Once you’ve completed an integration, test it by:

1. Browser Compatibility: Test with multiple browsers (Chrome, Firefox, Safari, Edge)
2. Network Switching: Verify connections work on both Sei mainnet and testnet
3. Authentication Methods: Test different social login options
4. Persistence: Ensure wallet connection persists across page refreshes

Clear your browser cache if wallets aren’t appearing in the connection modal during testing.

Common Issues

Sei Global Wallet doesn't appear in wallet list

Solution: Ensure the import is at the top of your main application file:

import '@sei-js/sei-global-wallet/eip6963';

TypeScript errors about window.ethereum

Solution: Add type declarations to your project:

// Add to your App.tsx or create types/global.d.ts
declare global {
  interface Window {
    ethereum?: any;
  }
}

WalletConnect connection fails

Solution: Get a proper project ID from cloud.walletconnect.com and replace 'YOUR_WALLETCONNECT_PROJECT_ID' with your actual ID.

Support

If you encounter issues:

• Check the browser console for EIP-6963 events and errors
• Verify your WalletConnect project ID is valid
• Test on different networks (mainnet vs testnet)
• Clear browser cache and try again

For additional help, provide:

• Device details
• Browser information
• Clear description of the issue
• Screen recording if possible