ConnectorKit

Production-ready Solana wallet infrastructure. A headless, framework-agnostic wallet connector built on Wallet Standard.

Packages

Package	Description
@solana/connector	Core wallet connector with React hooks and headless client
@solana/connector-debugger	Development debug panel with transaction analysis (experimental wip)

Why ConnectorKit?

• Wallet Standard First - Built on the official Wallet Standard protocol for universal wallet compatibility
• Modern & Legacy Support - Works with both @solana/kit and @solana/web3.js (legacy)
• Framework Agnostic - React hooks + headless core for Vue, Svelte, or vanilla JavaScript
• Production Ready - Event system for analytics, health checks for diagnostics, error boundaries for React apps
• Mobile Support - Built-in Solana Mobile Wallet Adapter integration

Quick Start

npm install @solana/connector

import { AppProvider } from '@solana/connector/react';
import { getDefaultConfig } from '@solana/connector/headless';

function App() {
  const config = getDefaultConfig({ appName: 'My App' });

  return (
    <AppProvider connectorConfig={config}>
      <YourApp />
    </AppProvider>
  );
}

import { useConnector } from '@solana/connector/react';

function WalletButton() {
  const { connectors, connectWallet, disconnectWallet, isConnected, isConnecting, account } = useConnector();

  if (!isConnected) {
    return connectors.map(connector => (
      <button
        key={connector.id}
        onClick={() => connectWallet(connector.id)}
        disabled={isConnecting || !connector.ready}
      >
        Connect {connector.name}
      </button>
    ));
  }

  return (
    <div>
      <span>{account}</span>
      <button onClick={disconnectWallet}>
        Disconnect
      </button>
    </div>
  );
}

See the connector package docs for full API reference.

Debug Panel (Development)

npm install @solana/connector-debugger

import { ConnectorDebugPanel } from '@solana/connector-debugger/react';

// Add to your app (development only)
{process.env.NODE_ENV === 'development' && <ConnectorDebugPanel />}

Features:

• Live wallet state monitoring
• Pre-flight transaction simulation
• Transaction size analysis with optimization suggestions
• Address Lookup Table recommendations
• Real-time event stream

See the debugger package docs for full documentation.

Examples

Check out the Next.js example for a complete implementation with shadcn/ui components.

Supported Wallets

Compatible with all Wallet Standard compliant wallets:

• Phantom
• Solflare
• Backpack
• Jupiter
• Any Wallet Standard compatible wallet

Development

# Install dependencies
pnpm install

# Build all packages
pnpm build

# Development mode
pnpm dev

# Type checking
pnpm type-check

# Linting
pnpm lint

License

MIT