@naculus/connect-appkit-react 0.1.8 → 0.2.0

package/src/types/index.ts

@@ -1,99 +0,0 @@
-import type { UniversalWalletSession, Namespace, SessionNamespace } from "@naculus/connect-core";
-import type { Chain } from "viem";
-
-export type WalletChain = {
-  id: number;
-  namespace: Namespace;
-  name: string;
-  rpcUrl?: string;
-  explorerUrl?: string;
-  token?: string;
-};
-
-export type ConnectionStatus = "disconnected" | "connecting" | "authenticating" | "connected" | "reconnecting";
-
-/** SIWx (Sign-In With X) CAIP-122 configuration */
-export interface SIWxConfig {
-  /** Called after wallet connects to build the message to sign */
-  createMessage: (params: { address: string; chainId: string }) => Promise<string>;
-  /** Called after the user signs the message */
-  handleSignComplete?: (params: { message: string; signature: string }) => Promise<void>;
-  /** Whether SIWx is required. If true, wallet disconnects on sign failure (default: true) */
-  required?: boolean;
-}
-
-export interface Web3ConnectConfig {
-  projectId: string;
-  metadata: {
-    name: string;
-    description: string;
-    url: string;
-    icons: string[];
-  };
-  chains?: WalletChain[];
-  /** SIWx (Sign-In With X) post-connection authentication */
-  siwx?: SIWxConfig;
-  storageKey?: string;
-  /** Enable embedded self-custodial wallet */
-  enableEmbedded?: boolean;
-  /** Enable passkeys (WebAuthn) connector */
-  enablePasskeys?: boolean;
-  /** Enable Solana injected wallet connector (Phantom, Solflare) */
-  enableSolana?: boolean;
-  /** Default Solana chain for injected wallet connections (e.g. "solana:0"). */
-  solanaDefaultChain?: string;
-  /** Connection timeout in milliseconds (default: 30000) */
-  connectionTimeout?: number;
-  /** Max retry attempts for reconnection (default: 2) */
-  maxRetries?: number;
-  /**
-   * Optional AES-256-GCM encryption key for session persistence.
-   * When provided, session data is encrypted at rest in localStorage.
-   * When omitted, existing backward-compatible plaintext storage is used.
-   */
-  encryptionKey?: string;
-}
-
-export interface Web3State {
-  status: ConnectionStatus;
-  session: UniversalWalletSession | null;
-  accounts: string[];
-  chainId: string | null;
-  error: Error | null;
-}
-
-export interface Web3Actions {
-  startPairing: () => Promise<string>;
-  completePairing: () => Promise<UniversalWalletSession>;
-  connect: () => Promise<void>;
-  connectInjected: (walletId?: string) => Promise<void>;
-  /** Connect via embedded self-custodial wallet */
-  connectEmbedded: () => Promise<void>;
-  /** Connect via passkeys (WebAuthn) */
-  connectPasskeys: () => Promise<void>;
-  disconnect: () => Promise<void>;
-  reconnect: () => Promise<void>;
-  switchChain: (chainId: string) => Promise<void>;
-  /** Clear the current error state without triggering reconnection */
-  clearError: () => void;
-}
-
-export interface UseWalletReturn extends Web3State, Web3Actions {}
-
-export type EvmTransaction = {
-  to: string;
-  from?: string;
-  value?: string;
-  data?: string;
-  gas?: string;
-  gasPrice?: string;
-  nonce?: string;
-  chainId?: number;
-};
-
-export interface ChainInfo {
-  namespace: Namespace;
-  chainId: string;
-  name: string;
-  selected: boolean;
-}

package/src/utils/chains.ts

@@ -1,115 +0,0 @@
-import type { WalletChain } from "../types";
-import { CHAINS, getRpcUrl, DEFAULT_RPC_URLS } from "@naculus/connect-core";
-
-// ─── Static Overrides ──────────────────────────────────────────────
-// Chains that exist in the old default list but are NOT in chain-registry.
-// These are deprecated testnets; keep for backward compatibility.
-
-const STATIC_TESTNETS: WalletChain[] = [
-  {
-    id: 5,
-    namespace: "eip155",
-    name: "Goerli",
-    rpcUrl: "https://goerli.blockpi.network/v1/rpc/public",
-    explorerUrl: "https://goerli.etherscan.io",
-    token: "ETH",
-  },
-  {
-    id: 80001,
-    namespace: "eip155",
-    name: "Mumbai",
-    rpcUrl: "https://rpc-mumbai.maticvigil.com",
-    explorerUrl: "https://mumbai.polygonscan.com",
-    token: "MATIC",
-  },
-  {
-    id: 421613,
-    namespace: "eip155",
-    name: "Arbitrum Goerli",
-    rpcUrl: "https://goerli-rollup.arbitrum.io/rpc",
-    explorerUrl: "https://goerli.arbiscan.io",
-    token: "ETH",
-  },
-  {
-    id: 420,
-    namespace: "eip155",
-    name: "Optimism Goerli",
-    rpcUrl: "https://goerli.optimism.io",
-    explorerUrl: "https://goerli-optimism.etherscan.io",
-    token: "ETH",
-  },
-];
-
-// ─── Build from Registry ───────────────────────────────────────────
-// Derive WalletChain entries from the single-source-of-truth chain-registry
-// and the RPC URL defaults from rpc.ts.
-
-function toWalletChain(chainId: number): WalletChain | null {
-  const info = CHAINS[chainId];
-  if (!info) return null;
-
-  // Only include chains with an explorer URL (meaningful for UI display)
-  if (!info.explorerUrl) return null;
-
-  const caip2Id = info.caip2Id;
-
-  return {
-    id: chainId,
-    namespace: "eip155",
-    name: info.name,
-    rpcUrl: getRpcUrl(caip2Id, DEFAULT_RPC_URLS[caip2Id] ?? ""),
-    explorerUrl: info.explorerUrl,
-    token: info.nativeCurrency.symbol,
-  };
-}
-
-function buildDefaultChains(): WalletChain[] {
-  if (!CHAINS) return [];
-
-  const registryChains: WalletChain[] = [];
-
-  // Order by chain ID for deterministic output
-  const chainIds = Object.keys(CHAINS)
-    .map(Number)
-    .sort((a, b) => a - b);
-
-  for (const id of chainIds) {
-    const chain = toWalletChain(id);
-    if (chain) {
-      registryChains.push(chain);
-    }
-  }
-
-  // Append static testnets that aren't in the registry
-  for (const testnet of STATIC_TESTNETS) {
-    if (!CHAINS[testnet.id]) {
-      registryChains.push(testnet);
-    }
-  }
-
-  return registryChains;
-}
-
-export const DEFAULT_EVM_CHAINS: WalletChain[] = buildDefaultChains();
-
-// ─── Helpers ───────────────────────────────────────────────────────
-
-export function getChainById(chains: WalletChain[], chainId: string): WalletChain | undefined {
-  return chains.find((chain) => {
-    const chainNamespace = chainId.startsWith("eip155:")
-      ? "eip155"
-      : null;
-
-    if (!chainNamespace) return false;
-
-    const chainNum = chainId.includes(":")
-      ? parseInt(chainId.split(":")[1], 10)
-      : parseInt(chainId, 10);
-
-    return chain.namespace === chainNamespace && chain.id === chainNum;
-  });
-}
-
-export function getDefaultChains(): WalletChain[] {
-  return [...DEFAULT_EVM_CHAINS];
-}

package/src/utils/errorMessages.ts

@@ -1,142 +0,0 @@
-/**
- * User-friendly error messages for WalletError codes and common errors.
- * Maps internal error codes to human-readable messages that can be shown in toasts/UI.
- */
-
-import type { WalletErrorCode } from "@naculus/connect-core";
-
-/**
- * User-friendly title for each WalletError code.
- */
-export const WALLET_ERROR_TITLES: Record<string, string> = {
-  wallet_unavailable: "Wallet Not Detected",
-  user_rejected: "Connection Rejected",
-  deeplink_timeout: "Wallet Connection Timed Out",
-  session_expired: "Session Expired",
-  intent_expired: "Connection Request Expired",
-  namespace_mismatch: "Network Mismatch",
-  chain_unsupported: "Unsupported Network",
-  method_not_allowed: "Action Not Allowed",
-  signature_rejected: "Signature Rejected",
-  tx_failed: "Transaction Failed",
-};
-
-/**
- * User-friendly description for each WalletError code.
- */
-export const WALLET_ERROR_DESCRIPTIONS: Record<string, string> = {
-  wallet_unavailable:
-    "No wallet found. Please install a compatible wallet (e.g., MetaMask, WalletConnect) and try again.",
-  user_rejected: "The connection request was declined in your wallet. You can try again whenever you're ready.",
-  deeplink_timeout:
-    "The wallet didn't respond in time. This can happen if the wallet app isn't installed or takes too long to open.",
-  session_expired:
-    "Your wallet session has expired. Please reconnect to continue.",
-  intent_expired:
-    "The connection request expired. Please try connecting again.",
-  namespace_mismatch:
-    "This wallet doesn't support the required network. Try using a different wallet or network.",
-  chain_unsupported:
-    "This network isn't supported. Please switch to a supported network in your wallet.",
-  method_not_allowed:
-    "This action isn't supported by your current wallet or network.",
-  signature_rejected: "The signature request was declined in your wallet.",
-  tx_failed:
-    "The transaction couldn't be completed. This could be due to insufficient funds, network congestion, or a contract error.",
-};
-
-/**
- * Default title for unknown errors.
- */
-export const UNKNOWN_ERROR_TITLE = "Something went wrong";
-
-/**
- * Default description for unknown errors.
- */
-export const UNKNOWN_ERROR_DESCRIPTION =
-  "An unexpected error occurred. Please try again. If the problem persists, check your connection and wallet configuration.";
-
-/**
- * Get a user-friendly error message object from any error.
- */
-export function getUserFriendlyError(
-  error: unknown
-): { title: string; description: string; code?: string } {
-  if (!error) {
-    return { title: UNKNOWN_ERROR_TITLE, description: UNKNOWN_ERROR_DESCRIPTION };
-  }
-
-  // Check for WalletError with code
-  const maybeWalletError = error as { name?: string; code?: string; message?: string };
-  if (maybeWalletError.name === "WalletError" && maybeWalletError.code) {
-    const code = maybeWalletError.code;
-    const title = WALLET_ERROR_TITLES[code] ?? UNKNOWN_ERROR_TITLE;
-    const description =
-      WALLET_ERROR_DESCRIPTIONS[code] ?? maybeWalletError.message ?? UNKNOWN_ERROR_DESCRIPTION;
-    return { title, description, code };
-  }
-
-  // Check for standard Error
-  if (error instanceof Error) {
-    const message = error.message;
-    // Map common error patterns
-    if (/user rejected/i.test(message) || /rejected/.test(message)) {
-      return {
-        title: "Request Rejected",
-        description: "The request was declined.",
-        code: "user_rejected",
-      };
-    }
-    if (/timeout/i.test(message) || /timed? ?out/i.test(message)) {
-      return {
-        title: "Request Timed Out",
-        description: "The request took too long. Please try again.",
-        code: "deeplink_timeout",
-      };
-    }
-    if (/network/i.test(message) || /chain/i.test(message)) {
-      return {
-        title: "Network Error",
-        description: message,
-        code: "chain_unsupported",
-      };
-    }
-    if (/insufficient funds/i.test(message)) {
-      return {
-        title: "Insufficient Funds",
-        description: "You don't have enough funds to complete this transaction.",
-        code: "tx_failed",
-      };
-    }
-
-    return {
-      title: UNKNOWN_ERROR_TITLE,
-      description: message || UNKNOWN_ERROR_DESCRIPTION,
-    };
-  }
-
-  // String error
-  if (typeof error === "string") {
-    return {
-      title: UNKNOWN_ERROR_TITLE,
-      description: error || UNKNOWN_ERROR_DESCRIPTION,
-    };
-  }
-
-  return { title: UNKNOWN_ERROR_TITLE, description: UNKNOWN_ERROR_DESCRIPTION };
-}
-
-/**
- * Check if an error is retryable (transient).
- */
-export function isRetryableError(error: unknown): boolean {
-  const maybe = error as { name?: string; code?: string; message?: string };
-  if (maybe.name !== "WalletError" || !maybe.code) return false;
-  const retryableCodes: WalletErrorCode[] = [
-    "deeplink_timeout",
-    "session_expired",
-    "intent_expired",
-    "tx_failed",
-  ];
-  return retryableCodes.includes(maybe.code as WalletErrorCode);
-}

package/src/utils/i18n.ts

@@ -1,90 +0,0 @@
-/**
- * i18n — ponytail approach: static key-value map, no framework dependency.
- *
- * All UI strings go through here. No hardcoded text in components.
- * To add a language: copy this file and translate the values.
- */
-
-export type Locale = "en" | "zh";
-
-const en = {
-  // Storage security
-  "storage.critical.title": "Insecure Storage Detected",
-  "storage.critical.body": "Your browser does not support IndexedDB. Wallet data is stored in plaintext in localStorage and could be exposed to XSS attacks. We strongly recommend switching to a modern browser.",
-  "storage.warning.title": "Storage Security Warning",
-  "storage.warning.body": "Your browser does not support IndexedDB, but your wallet data is encrypted with AES-256-GCM. Consider switching browsers for better origin isolation.",
-
-  // Address validation
-  "address.empty": "Address is empty",
-  "address.invalid_format": "Invalid address format (expected 0x + 40 hex chars)",
-  "address.zero_address": "Address is the zero address — funds would be permanently lost",
-  "address.burn_address": "Address appears to be a burn address — funds would be permanently lost",
-
-  // General wallet
-  "wallet.connect": "Connect Wallet",
-  "wallet.disconnect": "Disconnect",
-  "wallet.connecting": "Connecting...",
-  "wallet.copy_address": "Copy address",
-  "wallet.copied": "Copied!",
-  "wallet.view_on_explorer": "View on Explorer",
-  "wallet.retry": "Retry",
-  "wallet.connection_failed": "Connection failed",
-  "wallet.scan_qr": "Scan with your wallet app",
-
-  // Embedded wallet
-  "embedded.generate": "Create Wallet",
-  "embedded.import": "Import Wallet",
-  "embedded.backup_seed": "Back up your seed phrase",
-  "embedded.backup_warning": "Anyone with your seed phrase can access your funds. Store it securely.",
-  "embedded.backup_done": "I've saved my seed phrase",
-  "embedded.wipe": "Remove Wallet",
-  "embedded.wipe_confirm": "Are you sure? This cannot be undone.",
-} as const;
-
-const zh: Record<keyof typeof en, string> = {
-  "storage.critical.title": "偵測到不安全儲存",
-  "storage.critical.body": "您的瀏覽器不支援 IndexedDB。錢包資料以明文儲存在 localStorage 中，可能暴露於 XSS 攻擊。強烈建議更換至現代瀏覽器。",
-  "storage.warning.title": "儲存安全警告",
-  "storage.warning.body": "您的瀏覽器不支援 IndexedDB，但錢包資料已使用 AES-256-GCM 加密。建議更換瀏覽器以獲得更好的隔離保護。",
-
-  "address.empty": "地址為空",
-  "address.invalid_format": "無效的地址格式（應為 0x + 40 個十六進位字元）",
-  "address.zero_address": "此為零地址 — 資金將永久丟失",
-  "address.burn_address": "此地址為燒毀地址 — 資金將永久丟失",
-
-  "wallet.connect": "連接錢包",
-  "wallet.disconnect": "斷開連線",
-  "wallet.connecting": "連線中...",
-  "wallet.copy_address": "複製地址",
-  "wallet.copied": "已複製！",
-  "wallet.view_on_explorer": "在瀏覽器查看",
-  "wallet.retry": "重試",
-  "wallet.connection_failed": "連線失敗",
-  "wallet.scan_qr": "使用錢包 App 掃描",
-
-  "embedded.generate": "建立錢包",
-  "embedded.import": "匯入錢包",
-  "embedded.backup_seed": "備份助記詞",
-  "embedded.backup_warning": "任何人取得您的助記詞都可以存取您的資金。請安全儲存。",
-  "embedded.backup_done": "我已儲存助記詞",
-  "embedded.wipe": "移除錢包",
-  "embedded.wipe_confirm": "確定要移除嗎？此操作無法復原。",
-};
-
-const locales = { en, zh } as const;
-
-let currentLocale: Locale = "en";
-
-export function setLocale(locale: Locale): void {
-  currentLocale = locale;
-}
-
-export function getLocale(): Locale {
-  return currentLocale;
-}
-
-export function t(key: keyof typeof en): string {
-  return locales[currentLocale][key] ?? locales.en[key] ?? key;
-}
-
-export { en, zh };