konnekt-wallet 0.1.0

package/README.md

@@ -0,0 +1,125 @@
+# Konnekt
+
+Lightweight, no-bullshit wallet connector for EVM dApps. Pure injected wallet detection via EIP-6963. No WalletConnect, no social logins, no email wallets, no third-party services. Just your users' browser wallets.
+
+**Zero dependencies. Zero API keys. Zero subscriptions.**
+
+## Install
+
+```bash
+npm install konnekt
+```
+
+## Quick Start
+
+```tsx
+import { KonnektProvider, useKonnekt } from 'konnekt';
+
+function App() {
+  return (
+    <KonnektProvider config={{}}>
+      <ConnectButton />
+    </KonnektProvider>
+  );
+}
+
+function ConnectButton() {
+  const { isConnected, address, chainId, openModal, disconnect } = useKonnekt();
+
+  if (isConnected) {
+    return (
+      <div>
+        <p>{address}</p>
+        <button onClick={disconnect}>Disconnect</button>
+      </div>
+    );
+  }
+
+  return <button onClick={openModal}>Connect Wallet</button>;
+}
+```
+
+That's it. No project IDs, no config files, no dashboard signups.
+
+## What it does
+
+- Detects all installed browser wallets automatically via EIP-6963
+- Shows a clean modal with detected wallets
+- Connects with one click
+- Tracks account and chain changes in real-time
+- Provides React hooks for everything
+
+## What it doesn't do
+
+- No WalletConnect (no relay servers, no QR codes)
+- No social logins (no Google, no Discord, no email)
+- No embedded wallets
+- No analytics, no tracking
+- No external API calls whatsoever
+
+## Supported Wallets
+
+Any wallet that implements EIP-6963 (which is all modern wallets):
+
+MetaMask, Coinbase Wallet, Rabby, Phantom, Trust Wallet, OKX Wallet, Brave Wallet, Rainbow, Zerion, and more.
+
+## Theming
+
+```tsx
+<KonnektProvider config={{
+  theme: {
+    accent: '#15803d',
+    background: '#0F0F0F',
+    surface: '#1A1A1A',
+    text: '#F5F0EB',
+    border: '#2A2A2A',
+    radius: '16px',
+    backgroundImage: '/your-project-art.jpg', // optional bg for the modal
+  }
+}}>
+```
+
+## API
+
+### `useKonnekt()`
+
+```ts
+const {
+  status,        // 'disconnected' | 'connecting' | 'connected' | 'error'
+  address,       // string | null
+  chainId,       // number | null
+  walletId,      // string | null (rdns of connected wallet)
+  error,         // string | null
+  isConnected,   // boolean
+  isConnecting,  // boolean
+  availableWallets, // WalletInfo[]
+  connect,       // (walletId: string) => Promise<void>
+  disconnect,    // () => void
+  openModal,     // () => void
+  closeModal,    // () => void
+} = useKonnekt();
+```
+
+### `createKonnekt()` (vanilla JS)
+
+```ts
+import { createKonnekt } from 'konnekt';
+
+const konnekt = createKonnekt();
+
+konnekt.store.subscribe((state) => {
+  console.log(state.address, state.chainId);
+});
+
+await konnekt.connect('io.metamask');
+konnekt.disconnect();
+konnekt.destroy();
+```
+
+## Size
+
+~37KB ESM. Zero runtime dependencies. React 18+ as peer dep.
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,118 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface WalletInfo {
+    id: string;
+    name: string;
+    icon: string;
+    rdns?: string;
+    installed: boolean;
+    type: 'injected';
+    chain: 'evm' | 'solana';
+}
+interface KonnektConfig {
+    chains?: number[];
+    theme?: KonnektTheme;
+    autoConnect?: boolean;
+}
+interface KonnektTheme {
+    accent?: string;
+    background?: string;
+    surface?: string;
+    text?: string;
+    textSecondary?: string;
+    border?: string;
+    radius?: string;
+    fontFamily?: string;
+    backgroundImage?: string;
+}
+type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
+interface KonnektState {
+    status: ConnectionStatus;
+    address: string | null;
+    chainId: number | null;
+    walletId: string | null;
+    error: string | null;
+    availableWallets: WalletInfo[];
+    isModalOpen: boolean;
+}
+interface EIP1193Provider {
+    request: (args: {
+        method: string;
+        params?: unknown[];
+    }) => Promise<unknown>;
+    on: (event: string, handler: (...args: unknown[]) => void) => void;
+    removeListener: (event: string, handler: (...args: unknown[]) => void) => void;
+}
+
+type Listener = (state: KonnektState) => void;
+declare function createStore(): {
+    getState: () => KonnektState;
+    setState: (partial: Partial<KonnektState>) => void;
+    subscribe: (listener: Listener) => () => void;
+    reset: () => void;
+    setWallets: (wallets: WalletInfo[]) => void;
+    setStatus: (status: ConnectionStatus, error?: string) => void;
+    setConnected: (address: string, chainId: number, walletId: string) => void;
+    openModal: () => void;
+    closeModal: () => void;
+};
+type Store = ReturnType<typeof createStore>;
+
+interface KonnektInstance {
+    store: Store;
+    connect: (walletId: string) => Promise<void>;
+    disconnect: () => void;
+    openModal: () => void;
+    closeModal: () => void;
+    destroy: () => void;
+}
+declare function createKonnekt(config?: KonnektConfig): KonnektInstance;
+
+declare function getProviderByRdns(rdns: string): EIP1193Provider | null;
+
+declare function connectSolanaWallet(walletId: string): Promise<{
+    address: string;
+}>;
+declare function getSolanaProvider(walletId: string): any;
+
+interface Props$1 {
+    config: KonnektConfig;
+    children: React.ReactNode;
+}
+declare function KonnektProvider({ config, children }: Props$1): react_jsx_runtime.JSX.Element;
+
+declare function useKonnekt(): {
+    status: ConnectionStatus;
+    address: string | null;
+    chainId: number | null;
+    walletId: string | null;
+    error: string | null;
+    isConnected: boolean;
+    isConnecting: boolean;
+    availableWallets: WalletInfo[];
+    connectedWallet: WalletInfo | null;
+    provider: EIP1193Provider | null;
+    connect: (walletId: string) => Promise<void>;
+    disconnect: () => void;
+    openModal: () => void;
+    closeModal: () => void;
+};
+
+interface Props {
+    theme?: KonnektTheme;
+}
+declare function KonnektModal({ theme }: Props): react_jsx_runtime.JSX.Element | null;
+
+declare function KonnektButton(): react_jsx_runtime.JSX.Element;
+
+declare function MetaMaskIcon(): react_jsx_runtime.JSX.Element;
+declare function CoinbaseIcon(): react_jsx_runtime.JSX.Element;
+declare function RabbyIcon(): react_jsx_runtime.JSX.Element;
+declare function PhantomIcon(): react_jsx_runtime.JSX.Element;
+declare function TrustWalletIcon(): react_jsx_runtime.JSX.Element;
+declare function OKXIcon(): react_jsx_runtime.JSX.Element;
+declare function BraveIcon(): react_jsx_runtime.JSX.Element;
+declare const WALLET_ICON_MAP: Record<string, () => JSX.Element>;
+declare function getWalletIcon(id: string): (() => JSX.Element) | null;
+
+export { BraveIcon, CoinbaseIcon, type ConnectionStatus, type EIP1193Provider, KonnektButton, type KonnektConfig, type KonnektInstance, KonnektModal, KonnektProvider, type KonnektState, type KonnektTheme, MetaMaskIcon, OKXIcon, PhantomIcon, RabbyIcon, type Store, TrustWalletIcon, WALLET_ICON_MAP, type WalletInfo, connectSolanaWallet, createKonnekt, getProviderByRdns, getSolanaProvider, getWalletIcon, useKonnekt };

package/dist/index.d.ts

@@ -0,0 +1,118 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+
+interface WalletInfo {
+    id: string;
+    name: string;
+    icon: string;
+    rdns?: string;
+    installed: boolean;
+    type: 'injected';
+    chain: 'evm' | 'solana';
+}
+interface KonnektConfig {
+    chains?: number[];
+    theme?: KonnektTheme;
+    autoConnect?: boolean;
+}
+interface KonnektTheme {
+    accent?: string;
+    background?: string;
+    surface?: string;
+    text?: string;
+    textSecondary?: string;
+    border?: string;
+    radius?: string;
+    fontFamily?: string;
+    backgroundImage?: string;
+}
+type ConnectionStatus = 'disconnected' | 'connecting' | 'connected' | 'error';
+interface KonnektState {
+    status: ConnectionStatus;
+    address: string | null;
+    chainId: number | null;
+    walletId: string | null;
+    error: string | null;
+    availableWallets: WalletInfo[];
+    isModalOpen: boolean;
+}
+interface EIP1193Provider {
+    request: (args: {
+        method: string;
+        params?: unknown[];
+    }) => Promise<unknown>;
+    on: (event: string, handler: (...args: unknown[]) => void) => void;
+    removeListener: (event: string, handler: (...args: unknown[]) => void) => void;
+}
+
+type Listener = (state: KonnektState) => void;
+declare function createStore(): {
+    getState: () => KonnektState;
+    setState: (partial: Partial<KonnektState>) => void;
+    subscribe: (listener: Listener) => () => void;
+    reset: () => void;
+    setWallets: (wallets: WalletInfo[]) => void;
+    setStatus: (status: ConnectionStatus, error?: string) => void;
+    setConnected: (address: string, chainId: number, walletId: string) => void;
+    openModal: () => void;
+    closeModal: () => void;
+};
+type Store = ReturnType<typeof createStore>;
+
+interface KonnektInstance {
+    store: Store;
+    connect: (walletId: string) => Promise<void>;
+    disconnect: () => void;
+    openModal: () => void;
+    closeModal: () => void;
+    destroy: () => void;
+}
+declare function createKonnekt(config?: KonnektConfig): KonnektInstance;
+
+declare function getProviderByRdns(rdns: string): EIP1193Provider | null;
+
+declare function connectSolanaWallet(walletId: string): Promise<{
+    address: string;
+}>;
+declare function getSolanaProvider(walletId: string): any;
+
+interface Props$1 {
+    config: KonnektConfig;
+    children: React.ReactNode;
+}
+declare function KonnektProvider({ config, children }: Props$1): react_jsx_runtime.JSX.Element;
+
+declare function useKonnekt(): {
+    status: ConnectionStatus;
+    address: string | null;
+    chainId: number | null;
+    walletId: string | null;
+    error: string | null;
+    isConnected: boolean;
+    isConnecting: boolean;
+    availableWallets: WalletInfo[];
+    connectedWallet: WalletInfo | null;
+    provider: EIP1193Provider | null;
+    connect: (walletId: string) => Promise<void>;
+    disconnect: () => void;
+    openModal: () => void;
+    closeModal: () => void;
+};
+
+interface Props {
+    theme?: KonnektTheme;
+}
+declare function KonnektModal({ theme }: Props): react_jsx_runtime.JSX.Element | null;
+
+declare function KonnektButton(): react_jsx_runtime.JSX.Element;
+
+declare function MetaMaskIcon(): react_jsx_runtime.JSX.Element;
+declare function CoinbaseIcon(): react_jsx_runtime.JSX.Element;
+declare function RabbyIcon(): react_jsx_runtime.JSX.Element;
+declare function PhantomIcon(): react_jsx_runtime.JSX.Element;
+declare function TrustWalletIcon(): react_jsx_runtime.JSX.Element;
+declare function OKXIcon(): react_jsx_runtime.JSX.Element;
+declare function BraveIcon(): react_jsx_runtime.JSX.Element;
+declare const WALLET_ICON_MAP: Record<string, () => JSX.Element>;
+declare function getWalletIcon(id: string): (() => JSX.Element) | null;
+
+export { BraveIcon, CoinbaseIcon, type ConnectionStatus, type EIP1193Provider, KonnektButton, type KonnektConfig, type KonnektInstance, KonnektModal, KonnektProvider, type KonnektState, type KonnektTheme, MetaMaskIcon, OKXIcon, PhantomIcon, RabbyIcon, type Store, TrustWalletIcon, WALLET_ICON_MAP, type WalletInfo, connectSolanaWallet, createKonnekt, getProviderByRdns, getSolanaProvider, getWalletIcon, useKonnekt };