@talken/talkenkit 2.4.28 → 2.4.29

package/dist/wallets/walletConnectors/chunk-CPAYLZZL.js

@@ -0,0 +1,205 @@
+"use client";
+import {
+  BaseApiClient
+} from "./chunk-7ZCM4DCC.js";
+import {
+  createAbcError
+} from "./chunk-6LH6ZME2.js";
+import {
+  DEFAULT_HEADERS
+} from "./chunk-DHHVIM22.js";
+
+// src/wallets/walletConnectors/abcWallet/api/BitcoinApi.ts
+var BitcoinApi = class extends BaseApiClient {
+  /**
+   * Generate Bitcoin wallet
+   * Uses V3 API with secp256k1 curve (same as EVM but compressed public key)
+   *
+   * @param pin - Hashed PIN (SHA-256)
+   * @param network - Bitcoin network (mainnet or testnet)
+   * @param addressType - Bitcoin address type (bech32 recommended)
+   * @returns Bitcoin wallet information
+   */
+  async generateBitcoinWallet(pin, network = "bitcoin", addressType = "bech32") {
+    console.log("[BitcoinApi] Generating Bitcoin wallet...", {
+      network,
+      addressType
+    });
+    const response = await this.request("/v3/wallet/generate", {
+      method: "POST",
+      contentType: "json",
+      body: {
+        curve: "secp256k1",
+        // Same as EVM but compressed public key
+        password: pin,
+        network
+      }
+    });
+    if (response.status !== "success" || !response.result) {
+      console.error("[BitcoinApi] Generation failed:", response);
+      throw createAbcError(
+        "WALLET_NOT_FOUND" /* WALLET_NOT_FOUND */,
+        "Failed to generate Bitcoin wallet",
+        response
+      );
+    }
+    const result = response.result;
+    const addressResult = await this.getBitcoinAddress(
+      result.public_key,
+      network,
+      addressType
+    );
+    return {
+      uid: result.uid || "",
+      sessionId: result.share_id,
+      shareId: result.share_id,
+      publicKey: result.public_key,
+      // Compressed (33 bytes, 0x02 or 0x03 prefix)
+      address: addressResult,
+      addressType,
+      keyId: result.key_id || result.share_id,
+      encryptedShare: result.encrypted_share || "",
+      network
+    };
+  }
+  /**
+   * Recover Bitcoin wallet
+   * Uses V3 API wallet recovery endpoint
+   *
+   * @param pin - Hashed PIN (SHA-256)
+   * @param network - Bitcoin network
+   * @param addressType - Bitcoin address type
+   * @returns Recovered Bitcoin wallet information
+   */
+  async recoverBitcoinWallet(pin, network = "bitcoin", addressType = "bech32") {
+    console.log("[BitcoinApi] Recovering Bitcoin wallet...", {
+      network,
+      addressType
+    });
+    const response = await this.request("/v3/wallet/recover", {
+      method: "POST",
+      contentType: "json",
+      body: {
+        curve: "secp256k1",
+        password: pin,
+        network
+      }
+    });
+    if (response.status !== "success" || !response.result) {
+      console.error("[BitcoinApi] Recovery failed:", response);
+      throw createAbcError(
+        "WALLET_NOT_FOUND" /* WALLET_NOT_FOUND */,
+        "Failed to recover Bitcoin wallet",
+        response
+      );
+    }
+    const result = response.result;
+    const addressResult = await this.getBitcoinAddress(
+      result.public_key,
+      network,
+      addressType
+    );
+    return {
+      uid: result.uid || "",
+      sessionId: result.share_id,
+      shareId: result.share_id,
+      publicKey: result.public_key,
+      address: addressResult,
+      addressType,
+      keyId: result.key_id || result.share_id,
+      encryptedShare: result.encrypted_share || "",
+      network
+    };
+  }
+  /**
+   * Get Bitcoin address from compressed public key
+   *
+   * @param publicKey - Compressed public key (33 bytes, hex)
+   * @param network - Bitcoin network
+   * @param addressType - Address format type (currently not used by API)
+   * @returns Bitcoin address
+   */
+  async getBitcoinAddress(publicKey, network, _addressType = "bech32") {
+    const url = `${this.baseURL}/wapi/v2/btc/address`;
+    const params = new URLSearchParams({
+      pubkey: publicKey,
+      network
+    });
+    const response = await fetch(`${url}?${params}`, {
+      method: "GET",
+      headers: {
+        ...this.accessToken ? { Authorization: `Bearer ${this.accessToken}` } : {}
+      }
+    });
+    const data = await response.json();
+    if (!response.ok) {
+      throw createAbcError(
+        "NETWORK_ERROR" /* NETWORK_ERROR */,
+        "Failed to get Bitcoin address",
+        data
+      );
+    }
+    return data.address;
+  }
+  /**
+   * Get UTXOs (Unspent Transaction Outputs) for address
+   *
+   * @param address - Bitcoin address
+   * @param network - Bitcoin network
+   * @returns Array of UTXOs
+   */
+  async getUtxos(address, network) {
+    const url = `${this.baseURL}/wapi/v2/bitcoin/utxo/list`;
+    const params = new URLSearchParams({ network, address });
+    const response = await fetch(`${url}?${params}`, {
+      method: "GET",
+      headers: {
+        ...DEFAULT_HEADERS,
+        ...this.accessToken ? { Authorization: `Bearer ${this.accessToken}` } : {}
+      }
+    });
+    const data = await response.json();
+    if (!response.ok || data.status !== "success") {
+      throw createAbcError(
+        "NETWORK_ERROR" /* NETWORK_ERROR */,
+        "Failed to get UTXOs",
+        data
+      );
+    }
+    return data.result?.utxos || [];
+  }
+  /**
+   * Broadcast signed Bitcoin transaction
+   *
+   * @param params - Transaction broadcast parameters
+   * @returns Transaction hash
+   */
+  async sendBitcoinTransaction(params) {
+    const url = `${this.baseURL}/wapi/v2/bitcoin/tx/sendTransaction`;
+    const response = await fetch(url, {
+      method: "POST",
+      headers: {
+        ...DEFAULT_HEADERS,
+        ...this.accessToken ? { Authorization: `Bearer ${this.accessToken}` } : {}
+      },
+      body: JSON.stringify({
+        network: params.network,
+        rawTransaction: params.rawTransaction,
+        ...params.psbt && { psbt: params.psbt }
+      })
+    });
+    const data = await response.json();
+    if (!response.ok || data.status !== "success") {
+      throw createAbcError(
+        "NETWORK_ERROR" /* NETWORK_ERROR */,
+        "Failed to send Bitcoin transaction",
+        data
+      );
+    }
+    return { txHash: data.result?.data };
+  }
+};
+
+export {
+  BitcoinApi
+};

package/dist/wallets/walletConnectors/chunk-D5EFTEOM.js

@@ -0,0 +1,56 @@
+"use client";
+
+// src/wallets/walletConnectors/abcWallet/types.ts
+var AbcStorageKey = /* @__PURE__ */ ((AbcStorageKey2) => {
+  AbcStorageKey2["USER"] = "user";
+  AbcStorageKey2["WALLET"] = "wallet";
+  AbcStorageKey2["SOLANA_WALLET"] = "solana_wallet";
+  AbcStorageKey2["BITCOIN_WALLET"] = "bitcoin_wallet";
+  AbcStorageKey2["TRON_WALLET"] = "tron_wallet";
+  AbcStorageKey2["ACCESS_TOKEN"] = "access_token";
+  AbcStorageKey2["REFRESH_TOKEN"] = "refresh_token";
+  AbcStorageKey2["EXPIRES_AT"] = "expires_at";
+  AbcStorageKey2["PIN"] = "pin";
+  AbcStorageKey2["AUTH_STATE"] = "auth_state";
+  AbcStorageKey2["ENCRYPTED_TOKENS"] = "encrypted_tokens";
+  AbcStorageKey2["TOKEN_SALT"] = "token_salt";
+  return AbcStorageKey2;
+})(AbcStorageKey || {});
+var AbcErrorCode = /* @__PURE__ */ ((AbcErrorCode2) => {
+  AbcErrorCode2["INVALID_CREDENTIALS"] = "INVALID_CREDENTIALS";
+  AbcErrorCode2["TOKEN_EXPIRED"] = "TOKEN_EXPIRED";
+  AbcErrorCode2["WALLET_NOT_FOUND"] = "WALLET_NOT_FOUND";
+  AbcErrorCode2["INVALID_PIN"] = "INVALID_PIN";
+  AbcErrorCode2["NETWORK_ERROR"] = "NETWORK_ERROR";
+  AbcErrorCode2["SIGNATURE_FAILED"] = "SIGNATURE_FAILED";
+  AbcErrorCode2["USER_CANCELLED"] = "USER_CANCELLED";
+  AbcErrorCode2["UNKNOWN_ERROR"] = "UNKNOWN_ERROR";
+  AbcErrorCode2["ENCRYPTION_FAILED"] = "ENCRYPTION_FAILED";
+  AbcErrorCode2["DECRYPTION_FAILED"] = "DECRYPTION_FAILED";
+  return AbcErrorCode2;
+})(AbcErrorCode || {});
+var AbcError = class extends Error {
+  constructor(code, message, details, statusCode) {
+    super(message);
+    this.name = "AbcError";
+    this.code = code;
+    this.details = details;
+    this.statusCode = statusCode;
+  }
+};
+var TalkenApiError = class extends Error {
+  constructor(code, message, statusCode, details) {
+    super(message);
+    this.name = "TalkenApiError";
+    this.code = code;
+    this.statusCode = statusCode;
+    this.details = details;
+  }
+};
+
+export {
+  AbcStorageKey,
+  AbcErrorCode,
+  AbcError,
+  TalkenApiError
+};

package/dist/wallets/walletConnectors/chunk-DD6KK4BR.js

@@ -0,0 +1,54 @@
+"use client";
+import {
+  abcConnector
+} from "./chunk-JEWCPQJZ.js";
+import {
+  createTalkenApiClient
+} from "./chunk-PYBSONED.js";
+import {
+  resolveTalkenApiUrl
+} from "./chunk-GFWUFYT2.js";
+import {
+  ABC_WALLET_METADATA
+} from "./chunk-TQXCRSMS.js";
+
+// src/wallets/walletConnectors/abcWallet/abcWallet.ts
+import { setTalkenApiClient } from "@talken/talkenkit";
+var abcWallet = (specificOptions) => ({ projectId }) => {
+  const talkenApiUrl = resolveTalkenApiUrl(specificOptions?.talkenApiUrl);
+  const talkenApi = createTalkenApiClient({
+    baseUrl: talkenApiUrl,
+    debug: specificOptions?.environment === "development"
+  });
+  setTalkenApiClient(talkenApi);
+  const config = {
+    talkenApiUrl,
+    apiKey: specificOptions?.apiKey,
+    plain: specificOptions?.plain || "",
+    // Deprecated - not used (secure.ts uses random generation)
+    environment: specificOptions?.environment || "development",
+    defaultChainId: specificOptions?.defaultChainId,
+    defaultSolanaNetwork: specificOptions?.defaultSolanaNetwork,
+    defaultBitcoinNetwork: specificOptions?.defaultBitcoinNetwork,
+    projectId
+  };
+  return {
+    id: ABC_WALLET_METADATA.id,
+    name: ABC_WALLET_METADATA.name,
+    rdns: ABC_WALLET_METADATA.rdns,
+    iconUrl: async () => (await import("./abcWallet-AYWSIGAG.js")).default,
+    iconBackground: ABC_WALLET_METADATA.iconBackground,
+    // Embedded wallet - no installation required
+    installed: void 0,
+    // No download URLs for embedded wallet
+    downloadUrls: void 0,
+    // Create connector - wrapper function required by Wallet type
+    createConnector: (_walletDetails) => abcConnector({ config }),
+    // Embedded wallet always available
+    hidden: () => false
+  };
+};
+
+export {
+  abcWallet
+};

package/dist/wallets/walletConnectors/chunk-DHHVIM22.js

@@ -0,0 +1,259 @@
+"use client";
+
+// src/wallets/walletConnectors/abcWallet/constants.ts
+var DEFAULT_ABC_CONFIG = {
+  environment: "development",
+  waasUrl: ""
+  // All operations routed through TalkenApiClient
+};
+var TOKEN_EXPIRY = {
+  ACCESS_TOKEN: 10 * 60 * 1e3,
+  // 10 minutes
+  REFRESH_TOKEN: 60 * 60 * 1e3,
+  // 60 minutes
+  REFRESH_BUFFER: 60 * 1e3
+  // Refresh 60s before expiry (increased for network latency tolerance)
+};
+var ABC_ENDPOINTS = {
+  // Authentication
+  SNS_LOGIN: "/abc/snsLogin",
+  // Legacy - may need to update
+  REGISTER_SNS_USER: "/abc/registerSnsUser",
+  // Legacy - may need to update
+  // Secure channel
+  SECURE_CHANNEL_CREATE: "/secure/channel/create",
+  // Email OTP
+  SEND_OTP: "/member/mail-service/{email}/sendcode",
+  // {email} placeholder
+  VERIFY_OTP: "/member/mail-service/{email}/verifycode",
+  // {email} placeholder
+  // Wallet operations (EVM)
+  // Based on tg-wallet-frontend reference
+  MPC_WALLETS: "/wapi/v2/mpc/wallets",
+  // EVM wallet generation/recovery
+  MPC_WALLETS_INFO: "/wapi/v2/mpc/wallets/info",
+  // Get wallet info
+  // Signing operations
+  // Based on tg-wallet-frontend reference implementation
+  SIGN_HASH: "/wapi/v2/sign/hash",
+  // Personal sign with hash (EIP-191)
+  SIGN_TYPED: "/wapi/v2/sign/typed-data",
+  // Typed data sign (EIP-712)
+  SIGN_TRANSACTION: "/wapi/v2/sign",
+  // EVM transaction sign (LEGACY, EIP1559, PERSONAL)
+  // Transaction operations
+  SEND_RAW_TX: "/wapi/v2/transactions/raw-tx/send",
+  // Send signed transaction
+  TRANSACTION_COUNT: "/wapi/v2/transactions/count",
+  // Get transaction count (nonce)
+  // Gas estimation and fee data
+  GAS_SUGGESTED_FEES: "/wapi/v2/gas/suggestedGasFees",
+  // Get suggested gas fees for EIP-1559
+  GAS_ESTIMATE_EIP1559: "/wapi/v2/gas/estimate/eip1559",
+  // Estimate gas limit for EIP-1559
+  // Token info (Walletscan)
+  WALLETSCAN_TOKEN: "/wapi/v2/walletscan/token",
+  // GET /{contractAddress}?networks=xxx
+  WALLETSCAN_NATIVES: "/wapi/v2/walletscan/natives",
+  // GET ?walletAddress=xxx&networks=xxx
+  WALLETSCAN_NFTS: "/wapi/v2/walletscan/nfts",
+  // GET /{contractAddress}?walletAddress=xxx&networks=xxx
+  // Token refresh (based on tg-wallet-frontend reference)
+  REFRESH_TOKEN: "/abc/abcRefresh",
+  // Token refresh endpoint
+  // Legacy endpoints (kept for compatibility)
+  WALLETS_V3: "/abc/wallets/v3",
+  // Solana only
+  INFO: "/abc/info"
+};
+var AUTH_PROVIDERS = {
+  EMAIL: "email",
+  GOOGLE: "google",
+  APPLE: "apple",
+  TELEGRAM: "telegram",
+  TWITTER: "twitter"
+};
+var CHAIN_TYPES = {
+  EVM: "evm",
+  SOLANA: "solana",
+  BITCOIN: "bitcoin"
+};
+var SOLANA_CHAIN_ID = 900;
+var BITCOIN_CHAIN_ID = 800;
+var EVM_CHAINS = {
+  ETHEREUM_MAINNET: 1,
+  ETHEREUM_GOERLI: 5,
+  ETHEREUM_SEPOLIA: 11155111,
+  POLYGON_MAINNET: 137,
+  POLYGON_MUMBAI: 80001,
+  BSC_MAINNET: 56,
+  BSC_TESTNET: 97,
+  ARBITRUM_MAINNET: 42161,
+  ARBITRUM_GOERLI: 421613,
+  OPTIMISM_MAINNET: 10,
+  OPTIMISM_GOERLI: 420,
+  AVALANCHE_MAINNET: 43114,
+  AVALANCHE_FUJI: 43113,
+  KLAYTN_MAINNET: 8217,
+  KLAYTN_BAOBAB: 1001
+};
+var ABC_AUDIENCE = "https://mw.myabcwallet.com";
+var PIN_CONFIG = {
+  MIN_LENGTH: 6,
+  MAX_LENGTH: 6,
+  MAX_ATTEMPTS: 5,
+  LOCKOUT_DURATION: 15 * 60 * 1e3
+  // 15 minutes
+};
+var STORAGE_VERSION = "1.0.0";
+var REQUEST_TIMEOUT = 3e4;
+var RETRY_CONFIG = {
+  MAX_RETRIES: 3,
+  RETRY_DELAY: 1e3,
+  // 1 second
+  BACKOFF_MULTIPLIER: 2
+};
+var ABC_WALLET_METADATA = {
+  id: "abc",
+  name: "ABC Wallet",
+  iconBackground: "#ffffff",
+  rdns: "com.abcwallet"
+};
+var MODAL_CONFIG = {
+  WIDTH: 400,
+  MAX_WIDTH: "90vw",
+  BORDER_RADIUS: 16,
+  PADDING: 24
+};
+var SOCIAL_BUTTONS = [
+  {
+    provider: AUTH_PROVIDERS.GOOGLE,
+    label: "Google",
+    iconName: "google"
+  },
+  {
+    provider: AUTH_PROVIDERS.APPLE,
+    label: "Apple",
+    iconName: "apple"
+  },
+  {
+    provider: AUTH_PROVIDERS.TELEGRAM,
+    label: "Telegram",
+    iconName: "telegram"
+  },
+  {
+    provider: AUTH_PROVIDERS.TWITTER,
+    label: "X (Twitter)",
+    iconName: "twitter"
+  }
+];
+var ERROR_MESSAGES = {
+  INVALID_CREDENTIALS: "Invalid email or password",
+  TOKEN_EXPIRED: "Your session has expired. Please login again.",
+  WALLET_NOT_FOUND: "Wallet not found. Please create a new wallet.",
+  INVALID_PIN: "Invalid PIN code",
+  NETWORK_ERROR: "Network error. Please check your connection.",
+  SIGNATURE_FAILED: "Failed to sign transaction",
+  USER_CANCELLED: "User cancelled the operation",
+  UNKNOWN_ERROR: "An unknown error occurred",
+  INVALID_OTP: "Invalid or expired OTP code",
+  EMAIL_REQUIRED: "Email address is required",
+  PIN_REQUIRED: "PIN code is required",
+  WALLET_GENERATION_FAILED: "Failed to generate wallet"
+};
+var SUCCESS_MESSAGES = {
+  LOGIN_SUCCESS: "Successfully logged in",
+  WALLET_CREATED: "Wallet created successfully",
+  TRANSACTION_SENT: "Transaction sent successfully",
+  OTP_SENT: "OTP code sent to your email"
+};
+var ABC_EVENTS = {
+  CONNECT: "abc:connect",
+  DISCONNECT: "abc:disconnect",
+  ACCOUNTS_CHANGED: "abc:accountsChanged",
+  CHAIN_CHANGED: "abc:chainChanged",
+  ERROR: "abc:error",
+  AUTH_STATE_CHANGED: "abc:authStateChanged"
+};
+var STORAGE_PREFIX = "talkenkit_abc_";
+var DEBUG_MODE = true;
+var DEFAULT_HEADERS = {
+  "Content-Type": "application/x-www-form-urlencoded",
+  Accept: "application/json"
+};
+var ABC_FEATURES = {
+  EMAIL_LOGIN: true,
+  SOCIAL_LOGIN: true,
+  MULTI_CHAIN: true,
+  EVM_SUPPORT: true,
+  SOLANA_SUPPORT: true,
+  BITCOIN_SUPPORT: false,
+  // Future feature
+  GASLESS_TRANSACTIONS: false,
+  // Future feature
+  SOCIAL_RECOVERY: false
+  // Future feature
+};
+var DEFAULT_TALKEN_API_CONFIG = {
+  baseUrl: void 0,
+  timeout: REQUEST_TIMEOUT
+};
+var TALKEN_API_ENDPOINTS = {
+  // ── Auth (single action-based endpoint) ─────────────────────────────
+  AUTH: "/wallet/auth",
+  // ── Wallet ──────────────────────────────────────────────────────────
+  WALLET_MPC: "/wallet/mpc",
+  WALLET_ADDRESS: "/wallet/address",
+  WALLET_SCAN: "/wallet/scan",
+  WALLET_BTC: "/wallet/btc",
+  // ── EVM Sign (WaaS proxy) ───────────────────────────────────────────
+  SIGN_EVM: "/wallet/sign/evm",
+  SIGN_TYPED: "/wallet/sign/typed",
+  SIGN_PERSONAL: "/wallet/sign/personal",
+  // ── Hash Sign (secp256k1, universal: EVM/BTC/TVM) ───────────────────
+  SIGN_HASH: "/wallet/sign/hash",
+  // ── SOL Sign (WaaS proxy) ───────────────────────────────────────────
+  SIGN_SVM: "/wallet/sign/sol",
+  // ── TX ──────────────────────────────────────────────────────────────
+  TX_RAW: "/wallet/tx/raw",
+  TX_EVM: "/wallet/tx/evm",
+  TX_SVM: "/wallet/tx/svm",
+  TX_BTC: "/wallet/tx/btc",
+  TX_TVM: "/wallet/tx/tvm",
+  // ── Gas (WaaS proxy) ───────────────────────────────────────────────
+  GAS_PRICE: "/wallet/gas/price",
+  GAS_SUGGESTED: "/wallet/gas/suggested",
+  GAS_ESTIMATE: "/wallet/gas/estimate",
+  // ── Nonce (WaaS proxy) ─────────────────────────────────────────────
+  NONCE: "/wallet/nonce",
+  // ── Relayer ────────────────────────────────────────────────────────
+  RELAYER_FEE_ESTIMATE: "/relayer/fee-estimate"
+};
+
+export {
+  DEFAULT_ABC_CONFIG,
+  TOKEN_EXPIRY,
+  ABC_ENDPOINTS,
+  AUTH_PROVIDERS,
+  CHAIN_TYPES,
+  SOLANA_CHAIN_ID,
+  BITCOIN_CHAIN_ID,
+  EVM_CHAINS,
+  ABC_AUDIENCE,
+  PIN_CONFIG,
+  STORAGE_VERSION,
+  REQUEST_TIMEOUT,
+  RETRY_CONFIG,
+  ABC_WALLET_METADATA,
+  MODAL_CONFIG,
+  SOCIAL_BUTTONS,
+  ERROR_MESSAGES,
+  SUCCESS_MESSAGES,
+  ABC_EVENTS,
+  STORAGE_PREFIX,
+  DEBUG_MODE,
+  DEFAULT_HEADERS,
+  ABC_FEATURES,
+  DEFAULT_TALKEN_API_CONFIG,
+  TALKEN_API_ENDPOINTS
+};

package/dist/wallets/walletConnectors/chunk-DSNVWCPD.js

@@ -0,0 +1,131 @@
+"use client";
+import {
+  STORAGE_PREFIX
+} from "./chunk-TQXCRSMS.js";
+
+// src/wallets/walletConnectors/abcWallet/AbcCredentialManager.ts
+var EMAIL_STORAGE_KEY = `${STORAGE_PREFIX}saved_email`;
+var AUTH_STATE_KEY = `${STORAGE_PREFIX}auth_state`;
+var EVM_CREDS_SESSION_KEY = `${STORAGE_PREFIX}evm_signing_creds`;
+var AbcCredentialManager = class _AbcCredentialManager {
+  constructor() {
+    this.pinHash = null;
+    this.email_ = null;
+    this.restoreEmailFromStorage();
+  }
+  static getInstance() {
+    if (!_AbcCredentialManager.instance) {
+      _AbcCredentialManager.instance = new _AbcCredentialManager();
+    }
+    return _AbcCredentialManager.instance;
+  }
+  // ── PIN Hash (memory only) ────────────────────────────────────────
+  setPinHash(hash) {
+    this.pinHash = hash;
+  }
+  getPinHash() {
+    return this.pinHash;
+  }
+  clearPinHash() {
+    this.pinHash = null;
+  }
+  // ── Email ─────────────────────────────────────────────────────────
+  setEmail(email) {
+    this.email_ = email;
+    if (typeof window !== "undefined") {
+      try {
+        localStorage.setItem(EMAIL_STORAGE_KEY, email);
+      } catch {
+      }
+    }
+  }
+  /**
+   * Get recovery email.
+   * Priority: in-memory → auth_state JSON → saved_email localStorage
+   */
+  getEmail() {
+    if (this.email_)
+      return this.email_;
+    if (typeof window === "undefined")
+      return null;
+    try {
+      const authState = localStorage.getItem(AUTH_STATE_KEY);
+      if (authState) {
+        const data = JSON.parse(authState);
+        const email = data?.user?.email || data?.wallet?.email;
+        if (typeof email === "string" && email.trim()) {
+          this.email_ = email.trim();
+          return this.email_;
+        }
+      }
+    } catch {
+    }
+    try {
+      const saved = localStorage.getItem(EMAIL_STORAGE_KEY);
+      if (saved?.trim()) {
+        this.email_ = saved.trim();
+        return this.email_;
+      }
+    } catch {
+    }
+    return null;
+  }
+  // ── EVM Signing Credentials (sessionStorage — tab-scoped) ────────
+  setEvmSigningCredentials(creds) {
+    if (typeof window === "undefined")
+      return;
+    try {
+      sessionStorage.setItem(EVM_CREDS_SESSION_KEY, JSON.stringify(creds));
+    } catch {
+    }
+  }
+  getEvmSigningCredentials() {
+    if (typeof window === "undefined")
+      return null;
+    try {
+      const raw = sessionStorage.getItem(EVM_CREDS_SESSION_KEY);
+      if (!raw)
+        return null;
+      const parsed = JSON.parse(raw);
+      if (parsed?.uid && parsed?.wid && parsed?.sid && parsed?.pvencstr && parsed?.encryptDevicePassword) {
+        return parsed;
+      }
+      return null;
+    } catch {
+      return null;
+    }
+  }
+  clearEvmSigningCredentials() {
+    if (typeof window === "undefined")
+      return;
+    try {
+      sessionStorage.removeItem(EVM_CREDS_SESSION_KEY);
+    } catch {
+    }
+  }
+  // ── Lifecycle ─────────────────────────────────────────────────────
+  /**
+   * Restore email from localStorage on initialization.
+   * PIN hash is intentionally NOT restored (memory-only).
+   */
+  restoreEmailFromStorage() {
+    if (typeof window === "undefined")
+      return;
+    this.getEmail();
+  }
+  /**
+   * Clear all credentials (logout).
+   */
+  clear() {
+    this.pinHash = null;
+    this.email_ = null;
+    this.clearEvmSigningCredentials();
+  }
+};
+function getCredentialManager() {
+  return AbcCredentialManager.getInstance();
+}
+
+export {
+  getCredentialManager
+};