\n {shortAddress}\n \n
\n );\n }\n\n return (\n \n {connectors.map(connector => (\n connectWallet(connector.id)}\n disabled={isConnecting || !connector.ready}\n >\n Connect {connector.name}\n \n ))}\n
\n );\n}\n```\n\n### `useAccount()`\n\nHook for working with the connected account.\n\n```typescript\nimport { useAccount } from '@solana/connector';\n\nfunction Component() {\n const {\n address, // string | null - Full wallet address\n formatted, // string - Shortened address (e.g., \"5Gv8...x3kF\")\n copy, // () => PromiseConnected: {account}
;\n }\n}\n```\n\n### `useWalletConnectors()`\n\nGet available wallet connectors with stable IDs.\n\n```typescript\nimport { useWalletConnectors } from '@solana/connector/react';\n\nfunction WalletList() {\n const connectors = useWalletConnectors();\n\n return (\n- \n {connectors.map(connector => (\n
- \n
\n {connector.name}\n {connector.ready ? '✓' : 'Not Ready'}\n
\n ))}\n
\n {connectors.map(connector => (\n connect(connector.id)}\n disabled={isConnecting || !connector.ready}\n >\n Connect {connector.name}\n \n ))}\n {error && (\n
\n );\n}\n```\n\n### `useDisconnectWallet()`\n\nDisconnect the current wallet session.\n\n```typescript\nimport { useDisconnectWallet, useWallet } from '@solana/connector/react';\n\nfunction DisconnectButton() {\n const { isConnected } = useWallet();\n const { disconnect, isDisconnecting } = useDisconnectWallet();\n\n if (!isConnected) return null;\n\n return (\n \n );\n}\n```\n\n### Silent Session Restore\n\nSilent reconnection is handled automatically: with `autoConnect` enabled (the default), the wallet plugin silently restores the persisted session on startup without prompting the user. Explicit `connect()` calls are always interactive.\n\n```typescript\nconst config = getDefaultConfig({\n appName: 'My App',\n autoConnect: true, // silent restore of the persisted session on load\n});\n```\n\n> The `silent` and `allowInteractiveFallback` fields on `ConnectOptions` are deprecated no-ops under the kit wallet plugin backend and will be removed in the next major.\n\n---\n\n## Migration Guide (Legacy → vNext)\n\n### Connect by Wallet Name → Connect by Connector ID\n\n**Before (Legacy):**\n\n```typescript\nconst { select, wallets } = useConnector();\nawait select('Phantom');\n```\n\n**After (vNext):**\n\n```typescript\nconst { connect } = useConnectWallet();\nawait connect('wallet-standard:phantom');\n// Or use connectors from useWalletConnectors()\n```\n\n### Check Connection Status\n\n**Before (Legacy):**\n\n```typescript\nconst { connected, connecting } = useConnector();\nif (connected) {\n /* ... */\n}\n```\n\n**After (vNext):**\n\n```typescript\nconst { status, isConnected, isConnecting } = useWallet();\nif (status === 'connected') {\n /* ... */\n}\n// Or use the boolean shorthand:\nif (isConnected) {\n /* ... */\n}\n```\n\n### Get Selected Account\n\n**Before (Legacy):**\n\n```typescript\nconst { selectedAccount } = useConnector();\n```\n\n**After (vNext):**\n\n```typescript\nconst { account } = useWallet();\n// Or for full account info:\nconst { accounts, account } = useWallet();\n```\n\n### Disconnect\n\n**Before (Legacy):**\n\n```typescript\nconst { disconnect } = useConnector();\nawait disconnect();\n```\n\n**After (vNext):**\n\n```typescript\nconst { disconnect } = useDisconnectWallet();\nawait disconnect();\n```\n\n---\n\n## Transaction Signing\n\nConnectorKit provides powerful transaction signing capabilities with support for both legacy `@solana/web3.js` and modern `@solana/kit` APIs.\n\n### Modern API (`@solana/kit`)\n\nUse `useKitTransactionSigner()` for modern, type-safe transaction building:\n\n```typescript\n'use client';\n\nimport { useState } from 'react';\nimport {\n address,\n createSolanaRpc,\n pipe,\n createTransactionMessage,\n setTransactionMessageFeePayerSigner,\n setTransactionMessageLifetimeUsingBlockhash,\n appendTransactionMessageInstructions,\n sendAndConfirmTransactionFactory,\n getSignatureFromTransaction,\n signTransactionMessageWithSigners,\n createSolanaRpcSubscriptions,\n lamports,\n assertIsTransactionWithBlockhashLifetime,\n} from '@solana/kit';\nimport { getTransferSolInstruction } from '@solana-program/system';\nimport { useKitTransactionSigner, useCluster, useConnectorClient, LAMPORTS_PER_SOL } from '@solana/connector';\n\nexport function ModernSolTransfer() {\n const { signer, ready } = useKitTransactionSigner();\n const { cluster } = useCluster();\n const client = useConnectorClient();\n const [signature, setSignature] = useState\n Error: {error.message}\n \n
\n )}\n\n {/* Your form UI */}\n \n {signature &&
\n );\n}\n```\n\n### Legacy API (`@solana/web3.js`)\n\nUse `useTransactionSigner()` for legacy web3.js compatibility:\n\n```typescript\nimport { useTransactionSigner } from '@solana/connector';\nimport { Transaction, SystemProgram } from '@solana/web3.js';\n\nfunction SendTransaction() {\n const { signer, ready } = useTransactionSigner();\n\n const handleSend = async () => {\n if (!signer) return;\n\n const transaction = new Transaction().add(\n SystemProgram.transfer({\n fromPubkey: signer.address,\n toPubkey: recipientPubkey,\n lamports: 1000000,\n })\n );\n\n const signature = await signer.signAndSendTransaction(transaction);\n console.log('Transaction sent:', signature);\n };\n\n return ;\n}\n```\n\n---\n\n## Off-Chain Message Signing\n\nSign human-readable v1 off-chain messages ([sRFC 38](https://github.com/solana-foundation/SRFCs/discussions/3)) through wallets that support the `solana:signOffchainMessage` Wallet Standard feature. Unlike raw `signMessage`, off-chain messages carry a standard preamble so wallets can display them uniformly and signatures can never be confused with transaction signatures.\n\nThe signed bytes returned by the wallet are recompiled with `@solana/kit`'s codec and checked byte-for-byte against the canonical encoding, and the resulting envelope's Ed25519 signature is always verified before the result is returned.\n\n```typescript\n'use client';\n\nimport { useSignOffchainMessage } from '@solana/connector/react';\n\nfunction SignInButton() {\n const { signOffchainMessage, canSignOffchainMessage, ready } = useSignOffchainMessage();\n\n // `ready` is true once a wallet is connected; `canSignOffchainMessage`\n // additionally requires the wallet to support v1 off-chain messages.\n if (!ready || !canSignOffchainMessage) return null;\n\n const handleSignIn = async () => {\n const { signature, signedOffchainMessage, envelope } = await signOffchainMessage(\n 'Sign in to Example App',\n );\n // signature: Ed25519 signature over the full off-chain message bytes\n // signedOffchainMessage: preamble + body bytes the wallet signed (send to your verifier)\n // envelope: verified @solana/kit OffchainMessageEnvelope\n };\n\n return ;\n}\n```\n\nFor non-React usage, `createOffchainMessageSigner({ wallet, account })` is available from `@solana/connector/headless`.\n\n---\n\n## UI Elements\n\nConnectorKit provides composable UI elements that handle data fetching and state management for you. Use the render prop pattern to customize the UI.\n\n### Available Elements\n\n- `BalanceElement` - Display SOL balance with refresh\n- `ClusterElement` - Network/cluster selector\n- `TokenListElement` - List of SPL tokens\n- `TransactionHistoryElement` - Recent transaction history\n- `DisconnectElement` - Disconnect button\n- `AccountElement` - Account display and switcher\n- `WalletListElement` - List of available wallets\n\n### Example: Wallet Dropdown\n\n```typescript\n'use client';\n\nimport {\n BalanceElement,\n ClusterElement,\n TokenListElement,\n TransactionHistoryElement,\n DisconnectElement,\n} from '@solana/connector/react';\n\nexport function WalletDropdown() {\n return (\n Transaction: {signature}
}\n \n {/* Balance */}\n (\n (\n \n )}\n />\n\n {/* Tokens */}\n (\n (\n (\n \n )}\n />\n
\n );\n}\n```\n\n---\n\n## Configuration\n\n### Basic Configuration\n\n```typescript\nimport { getDefaultConfig } from '@solana/connector';\n\nconst config = getDefaultConfig({\n appName: 'My App', // Required\n appUrl: 'https://myapp.com', // Optional: for mobile wallet adapter\n autoConnect: true, // Auto-reconnect (default: true)\n network: 'mainnet-beta', // Initial network (default: 'mainnet-beta')\n enableMobile: true, // Mobile Wallet Adapter (default: true)\n debug: false, // Debug logging\n});\n```\n\n### Network Selection\n\n```typescript\nconst config = getDefaultConfig({\n appName: 'My App',\n network: 'devnet', // 'mainnet-beta' | 'devnet' | 'testnet' | 'localnet'\n});\n```\n\n### Custom RPC Endpoints\n\n```typescript\nimport { getDefaultConfig } from '@solana/connector';\n\nconst config = getDefaultConfig({\n appName: 'My App',\n clusters: [\n {\n id: 'solana:mainnet' as const,\n label: 'Mainnet (Custom RPC)',\n url: 'https://my-custom-rpc.com',\n },\n {\n id: 'solana:devnet' as const,\n label: 'Devnet',\n url: 'https://api.devnet.solana.com',\n },\n ],\n});\n```\n\n### Mobile Wallet Adapter\n\n```typescript\nimport { getDefaultMobileConfig } from '@solana/connector/headless';\n\nconst mobile = getDefaultMobileConfig({\n appName: 'My App',\n appUrl: 'https://myapp.com',\n});\n\n\n
\n )}\n />\n\n {/* Network Selector */}\n Balance: {isLoading ? '...' : `${solBalance?.toFixed(4)} SOL`}
\n \n \n {isLoading ? (\n
\n )}\n />\n\n {/* Transaction History */}\n Loading tokens...
\n ) : (\n tokens.map(token => (\n \n {token.symbol}: {token.formatted}\n
\n ))\n )}\n \n {isLoading ? (\n
\n )}\n />\n\n {/* Disconnect */}\n Loading transactions...
\n ) : (\n transactions.map(tx => (\n \n {tx.type} - {tx.formattedTime}\n \n ))\n )}\n \n
\n );\n}\n```\n\nOnce enabled, \"WalletConnect\" appears as a connector (id: `walletconnect`) in your wallet list. When selected, `useConnector().walletConnectUri` will be set to a `wc:` URI that you can display as a QR code or use for deep linking.\n\n**Supported WalletConnect Solana methods:**\n\n- `solana_getAccounts` / `solana_requestAccounts` - Get connected accounts\n- `solana_signMessage` - Sign arbitrary messages\n- `solana_signTransaction` - Sign transactions\n- `solana_signAllTransactions` - Sign multiple transactions\n- `solana_signAndSendTransaction` - Sign and broadcast transactions\n\nSee the [WalletConnect Solana documentation](https://docs.walletconnect.network/wallet-sdk/chain-support/solana) for more details.\n\n---\n\n## Security Considerations\n\n### RPC API Key Protection\n\nIf you're using a paid RPC provider (Helius, QuickNode, etc.), avoid exposing your API key client-side. Anyone can grab it from the browser's network tab.\n\n**Solution: RPC Proxy Route**\n\nCreate an API route that proxies RPC requests, keeping the API key server-side:\n\n```typescript\n// app/api/rpc/route.ts\nimport { NextRequest, NextResponse } from 'next/server';\n\n// Server-side only - not exposed to client\nconst RPC_URL = process.env.SOLANA_RPC_URL || 'https://api.mainnet-beta.solana.com';\n\nexport async function POST(request: NextRequest) {\n try {\n const body = await request.json();\n\n const response = await fetch(RPC_URL, {\n method: 'POST',\n headers: { 'Content-Type': 'application/json' },\n body: JSON.stringify(body),\n });\n\n const data = await response.json();\n return NextResponse.json(data);\n } catch (error) {\n return NextResponse.json({ error: 'RPC request failed' }, { status: 500 });\n }\n}\n```\n\nThen configure the connector to use the proxy:\n\n```typescript\n'use client';\n\nimport { getDefaultConfig } from '@solana/connector/headless';\n\n// Get origin for absolute URL (Kit requires full URLs)\nconst getOrigin = () => {\n if (typeof window !== 'undefined') return window.location.origin;\n return 'http://localhost:3000';\n};\n\nconst config = getDefaultConfig({\n appName: 'My App',\n clusters: [\n {\n id: 'solana:mainnet' as const,\n label: 'Mainnet',\n url: `${getOrigin()}/api/rpc`, // Proxy URL\n },\n // ... other clusters\n ],\n});\n```\n\nYour `.env` file (no `NEXT_PUBLIC_` prefix):\n\n```\nSOLANA_RPC_URL=https://mainnet.helius-rpc.com/?api-key=your-key\n```\n\n### Token Image Privacy\n\nWhen using `useTokens()` or `useTransactions()`, token metadata (including logo URLs) is fetched from external APIs. By default, these image URLs are returned directly, which means when your users' browsers fetch these images, the image host can see:\n\n- User IP addresses\n- Request timing (when users viewed their tokens)\n- User agent and browser information\n\nThis could potentially be exploited by malicious token creators who set tracking URLs in their token metadata.\n\n### Image Proxy Configuration\n\nTo protect user privacy, you can configure an image proxy that fetches images on behalf of your users:\n\n```typescript\nconst config = getDefaultConfig({\n appName: 'My App',\n imageProxy: '/_next/image?w=64&q=75&url=', // Next.js Image Optimization\n});\n```\n\nWhen `imageProxy` is set, all token image URLs returned by `useTokens()` and `useTransactions()` will be automatically transformed:\n\n```\n// Original URL from token metadata\nhttps://raw.githubusercontent.com/.../token-logo.png\n\n// Transformed URL (when imageProxy is set)\n/_next/image?w=64&q=75&url=https%3A%2F%2Fraw.githubusercontent.com%2F...%2Ftoken-logo.png\n```\n\n### Common Proxy Options\n\n| Service | Configuration |\n| ----------------- | ----------------------------------------------------------------- |\n| **Next.js Image** | `imageProxy: '/_next/image?w=64&q=75&url='` |\n| **Cloudflare** | `imageProxy: '/cdn-cgi/image/width=64,quality=75/'` |\n| **imgproxy** | `imageProxy: 'https://imgproxy.example.com/insecure/fill/64/64/'` |\n| **Custom API** | `imageProxy: '/api/image-proxy?url='` |\n\n### Custom Proxy API Route (Next.js Example)\n\n```typescript\n// app/api/image-proxy/route.ts\nimport { NextRequest, NextResponse } from 'next/server';\nimport dns from 'dns/promises';\n\n// Allowlist of permitted domains for image fetching\nconst ALLOWED_DOMAINS = [\n 'raw.githubusercontent.com',\n 'arweave.net',\n 'ipfs.io',\n 'cloudflare-ipfs.com',\n 'nftstorage.link',\n // Add other trusted image domains as needed\n];\n\n// Check if an IP address falls within private/reserved ranges\nfunction isPrivateOrReservedIP(ip: string): boolean {\n // IPv4 private/reserved ranges\n const ipv4PrivateRanges = [\n /^127\\./, // 127.0.0.0/8 (loopback)\n /^10\\./, // 10.0.0.0/8 (private)\n /^172\\.(1[6-9]|2[0-9]|3[0-1])\\./, // 172.16.0.0/12 (private)\n /^192\\.168\\./, // 192.168.0.0/16 (private)\n /^169\\.254\\./, // 169.254.0.0/16 (link-local/metadata)\n /^0\\./, // 0.0.0.0/8 (current network)\n /^100\\.(6[4-9]|[7-9][0-9]|1[0-1][0-9]|12[0-7])\\./, // 100.64.0.0/10 (CGNAT)\n /^192\\.0\\.0\\./, // 192.0.0.0/24 (IETF protocol assignments)\n /^192\\.0\\.2\\./, // 192.0.2.0/24 (TEST-NET-1)\n /^198\\.51\\.100\\./, // 198.51.100.0/24 (TEST-NET-2)\n /^203\\.0\\.113\\./, // 203.0.113.0/24 (TEST-NET-3)\n /^224\\./, // 224.0.0.0/4 (multicast)\n /^240\\./, // 240.0.0.0/4 (reserved)\n /^255\\.255\\.255\\.255$/, // broadcast\n ];\n\n // IPv6 private/reserved ranges\n const ipv6PrivatePatterns = [\n /^::1$/, // loopback\n /^fe80:/i, // link-local\n /^fc00:/i, // unique local (fc00::/7)\n /^fd/i, // unique local (fd00::/8)\n /^::ffff:(127\\.|10\\.|172\\.(1[6-9]|2[0-9]|3[0-1])\\.|192\\.168\\.|169\\.254\\.)/i, // IPv4-mapped\n ];\n\n // Check IPv4\n for (const range of ipv4PrivateRanges) {\n if (range.test(ip)) return true;\n }\n\n // Check IPv6\n for (const pattern of ipv6PrivatePatterns) {\n if (pattern.test(ip)) return true;\n }\n\n return false;\n}\n\n// Validate and parse the URL\nfunction validateUrl(urlString: string): URL | null {\n try {\n const parsed = new URL(urlString);\n // Only allow http and https protocols\n if (parsed.protocol !== 'http:' && parsed.protocol !== 'https:') {\n return null;\n }\n return parsed;\n } catch {\n return null;\n }\n}\n\n// Check if hostname is in the allowlist\nfunction isAllowedDomain(hostname: string): boolean {\n return ALLOWED_DOMAINS.some(domain => hostname === domain || hostname.endsWith(`.${domain}`));\n}\n\nexport async function GET(request: NextRequest) {\n const urlParam = request.nextUrl.searchParams.get('url');\n\n // (1) Ensure URL exists and parses correctly with http/https\n if (!urlParam) {\n return new NextResponse('Missing URL parameter', { status: 400 });\n }\n\n const parsedUrl = validateUrl(urlParam);\n if (!parsedUrl) {\n return new NextResponse('Invalid URL or protocol', { status: 400 });\n }\n\n // (2) Enforce allowlist of permitted domains\n if (!isAllowedDomain(parsedUrl.hostname)) {\n return new NextResponse('Domain not allowed', { status: 403 });\n }\n\n // (3) Resolve hostname and check for private/reserved IPs\n try {\n const addresses = await dns.resolve(parsedUrl.hostname);\n for (const ip of addresses) {\n if (isPrivateOrReservedIP(ip)) {\n return new NextResponse('Resolved IP is not allowed', { status: 403 });\n }\n }\n } catch {\n return new NextResponse('Failed to resolve hostname', { status: 400 });\n }\n\n // (4) All checks passed - perform the fetch\n try {\n const response = await fetch(parsedUrl.toString());\n const buffer = await response.arrayBuffer();\n\n return new NextResponse(buffer, {\n headers: {\n 'Content-Type': response.headers.get('Content-Type') || 'image/png',\n 'Cache-Control': 'public, max-age=86400',\n },\n });\n } catch {\n return new NextResponse('Failed to fetch image', { status: 500 });\n }\n}\n```\n\n---\n\n## CoinGecko API & Rate Limits\n\nThe `useTokens()` hook fetches token prices from CoinGecko. CoinGecko has rate limits that may affect your application:\n\n### Rate Limits (as of 2024)\n\n| Tier | Rate Limit | API Key Required |\n| ----------------- | --------------------- | ---------------- |\n| **Free (Public)** | 10-30 requests/minute | No |\n| **Demo** | 30 requests/minute | Yes (free) |\n| **Analyst** | 500 requests/minute | Yes (paid) |\n| **Pro** | 1000+ requests/minute | Yes (paid) |\n\n### Handling Rate Limits\n\nConnectorKit automatically handles rate limits with:\n\n- **Exponential backoff**: Retries with increasing delays\n- **Jitter**: Random delay added to prevent thundering herd\n- **Retry-After header**: Honors server-specified wait times\n- **Bounded timeout**: Won't block forever (default 30s max)\n\n### Adding a CoinGecko API Key\n\nFor higher rate limits, add a free Demo API key from [CoinGecko](https://www.coingecko.com/en/api/pricing):\n\n```typescript\nconst config = getDefaultConfig({\n appName: 'My App',\n coingecko: {\n apiKey: process.env.COINGECKO_API_KEY, // Demo or Pro API key\n isPro: false, // Set to true for Pro API keys\n },\n});\n```\n\n### Advanced Configuration\n\n```typescript\nconst config = getDefaultConfig({\n appName: 'My App',\n coingecko: {\n // API key for higher rate limits (optional)\n apiKey: process.env.COINGECKO_API_KEY,\n\n // Set to true if using a Pro API key (default: false for Demo keys)\n isPro: false,\n\n // Maximum retry attempts on 429 (default: 3)\n maxRetries: 3,\n\n // Base delay for exponential backoff in ms (default: 1000)\n baseDelay: 1000,\n\n // Maximum total timeout in ms (default: 30000)\n maxTimeout: 30000,\n },\n});\n```\n\n### Caching\n\nToken prices are cached for 60 seconds to minimize API calls. The retry logic only applies to uncached token IDs, so frequently-viewed tokens won't trigger additional API calls.\n\n---\n\n## Advanced Usage\n\n### Error Handling with `tryCatch`\n\nConnectorKit exports a `tryCatch` utility for consistent async error handling:\n\n```typescript\nimport { tryCatch } from '@solana/connector/headless';\n\n// Instead of try/catch blocks\nasync function sendTransaction() {\n const { data: signature, error } = await tryCatch(signer.signAndSendTransaction(transaction));\n\n if (error) {\n console.error('Transaction failed:', error.message);\n return;\n }\n\n console.log('Transaction sent:', signature);\n}\n```\n\nThe `tryCatch` utility returns a `Result\n \n Cancel\n \n
\n Scan with your wallet
\n\n
\n \n Open your WalletConnect-compatible wallet and scan this QR code\n
\nConnect a wallet
;\n return (\n <>\n \n {error ?{String(error)}
: null}\n \n );\n}\n```\n\nThe wallet store's `useSignIn`/`useSignMessage` are not re-exported (they collide with `@solana/react`'s account-based hooks of the same name) — import those from `@solana/kit-plugin-wallet/react` directly.\n\n### Other Exports\n\n| Import | Purpose |\n| -------------------------- | ------------------------------------------------- |\n| `@solana/connector/compat` | Bridge for existing `@solana/wallet-adapter` code |\n| `@solana/connector/remote` | Browser-side remote wallet adapter |\n| `@solana/connector/server` | Server-side route handlers for remote signing |\n\n---\n\n## API Reference\n\n### Hooks\n\n#### vNext Hooks (Recommended)\n\n| Hook | Description | Returns |\n| -------------------------- | ----------------------------------- | ------------------------------------------------------------------------------------------- |\n| `useWallet()` | Wallet status state machine | `{ status, isConnected, isConnecting, account, accounts, error }` |\n| `useWalletConnectors()` | Available wallet connectors | `WalletConnectorMetadata[]` |\n| `useConnectWallet()` | Connect by connector ID | `{ connect, isConnecting, error, resetError }` |\n| `useDisconnectWallet()` | Disconnect current wallet | `{ disconnect, isDisconnecting }` |\n| `useSignOffchainMessage()` | Off-chain message signing (sRFC 38) | `{ signOffchainMessage, canSignOffchainMessage, supportedMessageVersions, ready, address }` |\n\n#### Legacy Hooks\n\n| Hook | Description | Returns |\n| --------------------------- | -------------------------------------------- | ---------------------------------------------------------------- |\n| `useConnector()` | Main wallet connection hook (vNext + legacy) | `ConnectorSnapshot` |\n| `useAccount()` | Account management hook | `{ address, formatted, copy, copied, accounts, selectAccount }` |\n| `useCluster()` | Network/cluster management hook | `{ cluster, clusters, setCluster, isMainnet, isDevnet, rpcUrl }` |\n| `useWalletInfo()` | Wallet metadata hook | `{ name, icon, wallet, connecting }` |\n| `useTransactionSigner()` | Legacy transaction signer (web3.js) | `{ signer, ready, address, capabilities }` |\n| `useKitTransactionSigner()` | Modern transaction signer (@solana/kit) | `{ signer, ready }` |\n| `useBalance()` | SOL balance hook | `{ solBalance, isLoading, refetch }` |\n| `useTokens()` | SPL tokens hook | `{ tokens, isLoading, refetch }` |\n| `useTransactions()` | Transaction history hook | `{ transactions, isLoading, refetch }` |\n\nWith `autoRefresh` (the default), `useBalance()` and `useTokens()` receive live updates via an `accountNotifications` WebSocket subscription; interval polling (`refreshInterval`, default 30s) is kept as an automatic fallback when the subscription errors or WebSocket transport is unavailable.\n\n### Configuration Functions\n\n| Function | Description |\n| --------------------------------- | ------------------------------------------ |\n| `getDefaultConfig(options)` | Create default connector configuration |\n| `getDefaultMobileConfig(options)` | Create mobile wallet adapter configuration |\n\n### Utility Functions\n\n| Function | Description |\n| --------------------------------------- | ----------------------------------- |\n| `formatAddress(address, options?)` | Format Solana address |\n| `formatSOL(lamports, options?)` | Format SOL amount |\n| `copyAddressToClipboard(address)` | Copy address to clipboard |\n| `getTransactionUrl(cluster, signature)` | Get Solana Explorer transaction URL |\n| `getAddressUrl(cluster, address)` | Get Solana Explorer address URL |\n\n---\n\n## Types\n\n```typescript\nimport type {\n // Configuration\n ConnectorConfig,\n WalletDisplayConfig,\n DefaultConfigOptions,\n ExtendedConnectorConfig,\n\n // State & Info\n ConnectorState,\n ConnectorSnapshot,\n WalletInfo,\n AccountInfo,\n\n // Wallet Standard\n Wallet,\n WalletAccount,\n\n // Clusters\n SolanaCluster,\n SolanaClusterId,\n\n // vNext Session Types\n WalletConnectorId,\n WalletConnectorMetadata,\n WalletSession,\n WalletStatus,\n SessionAccount,\n ConnectOptions,\n\n // Hook Returns\n UseClusterReturn,\n UseAccountReturn,\n UseWalletInfoReturn,\n UseTransactionSignerReturn,\n UseKitTransactionSignerReturn,\n} from '@solana/connector';\n```\n\n---\n\n## Development\n\n### Commands\n\n```bash\n# Install dependencies\npnpm install\n\n# Build package\npnpm build\n\n# Development mode with watch\npnpm dev\n\n# Type checking\npnpm type-check\n\n# Linting\npnpm lint\n\n# Run tests\npnpm test\n\n# Test in watch mode\npnpm test:watch\n\n# Coverage report\npnpm test:coverage\n\n# Check bundle size\npnpm size\n```\n\n---\n\n## Examples\n\nCheck out the [examples directory](../../examples/next-js) for complete working examples:\n\n- **Next.js Example** - Full-featured wallet connection UI with shadcn/ui\n- **Transaction Signing** - Modern and legacy transaction examples\n- **Network Switching** - Cluster/network management\n- **Account Management** - Multi-account support\n- **Mobile Support** - Solana Mobile Wallet Adapter\n\n---\n\n## Supported Wallets\n\nCompatible with all [Wallet Standard](https://github.com/wallet-standard/wallet-standard) compliant wallets:\n\n- **Phantom** - Browser extension and mobile\n- **Solflare** - Browser extension and mobile\n- **Backpack** - xNFT and wallet\n- **Glow** - Browser extension\n- **Brave Wallet** - Built-in browser wallet\n- **Solana Mobile** - All mobile wallet adapter compatible wallets\n- **WalletConnect** - Connect any WalletConnect-compatible mobile wallet via QR code\n- **Any Wallet Standard wallet** - Full compatibility\n\n---\n\n## License\n\nMIT\n","readmeFilename":"README.md"}