Unich Connectors

A unified blockchain wallet connector library for EVM and Solana chains with mobile-first design.

Overview

Unich Connectors simplifies blockchain wallet integration with a consistent interface for connecting to EVM and Solana chains. Built with React and TypeScript, it handles the complexities of wallet interactions, state management, and error handling.

Key Features

• Multi-chain Support: EVM and Solana chains with a unified API
• Mobile-first Design: Deep linking and responsive behavior for mobile devices
• State Management: Persistent connection state with Zustand
• Error Handling: Structured error system with recovery options
• Type-safe: Full TypeScript support
• Provider Integration: Built on top of Wagmi and Solana Wallet Adapter

Installation

npm install unich-connectors

Peer Dependencies

This package has several peer dependencies that need to be installed in your host application:

npm install @solana/wallet-adapter-phantom @solana/wallet-adapter-solflare @tabler/icons-react @tanstack/react-query react react-dom

Development Setup

1. Clone the repository
2. Install dependencies:

npm install

3. Install peer dependencies for development:

npm run install-peers

4. Start development build with watch mode:

npm run dev

Quick Start

import { WalletProvider, useWalletContext } from 'unich-connectors';

function App() {
  return (
    <WalletProvider>
      <MyDApp />
    </WalletProvider>
  );
}

function ConnectButton() {
  const { connect, disconnect, isConnected, account } = useWalletContext();
  
  return (
    <button onClick={isConnected ? disconnect : () => connect('metamask')}>
      {isConnected ? `Disconnect ${account.slice(0, 6)}...` : 'Connect'}
    </button>
  );
}

Documentation

• Getting Started
• Basic Usage
• Advanced Usage
• Architecture
• Error Handling
• API Reference
• Provider Integration
• Troubleshooting
• Migration Guide
• Examples

Supported Wallets

EVM

• MetaMask
• Coinbase Wallet
• WalletConnect
• Trust Wallet
• OKX Wallet
• Brave Wallet

Solana

• Phantom
• Solflare
• Backpack
• Coin98

Troubleshooting

Module not found errors

If you encounter "module not found" errors in your host application:

1. Make sure all peer dependencies are installed in your host application
2. Try running npm run install-peers in this package if developing locally
3. Check that your bundler is correctly configured to handle the dependencies

License

MIT

Developed by Unich Labs