@n1xyz/wallet-widget 0.0.34 → 0.0.35-alpha.1

package/dist/src/utils/chain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chain.js","sourceRoot":"","sources":["../../../src/utils/chain.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Chain utilities for handling chain IDs and network identification.\n * Centralizes chain handling that was previously scattered across multiple files.\n *\n * Integrates with:\n * - viem's Chain type for EVM chains\n * - Project's src/config/chains.tsx for network configuration\n */\n\nimport type { Chain as ViemChain } from 'viem';\n\n// ---------------------------------------------------------------------------\n// Types\n// ---------------------------------------------------------------------------\n\nexport type NetworkType = 'solana' | 'evm';\n\nexport interface ChainInfo {\n  id: string;\n  name: string;\n  network: NetworkType;\n  chainId?: number;\n}\n\n// ---------------------------------------------------------------------------\n// Chain ID Normalization (from createWalletProvider.ts)\n// ---------------------------------------------------------------------------\n\n/**\n * Normalizes a chain ID to hexadecimal format (e.g., \"0x1\").\n * This is the format expected by EIP-1193 providers.\n *\n * Handles:\n * - Numbers (1 -> \"0x1\")\n * - Hex strings (\"0x1\" -> \"0x1\")\n * - Decimal strings (\"1\" -> \"0x1\")\n * - Objects with chainId or id properties (viem Chain objects)\n *\n * Replaces the normalizeChainId function in createWalletProvider.ts\n */\nexport function normalizeChainId(value: unknown): string {\n  // Handle objects with chainId or id properties (including viem Chain objects)\n  if (value && typeof value === 'object') {\n    const candidate = value as { chainId?: unknown; id?: unknown };\n    if (typeof candidate.chainId === 'number' || typeof candidate.chainId === 'string') {\n      return normalizeChainId(candidate.chainId);\n    }\n    if (typeof candidate.id === 'number' || typeof candidate.id === 'string') {\n      return normalizeChainId(candidate.id);\n    }\n  }\n\n  // Handle numbers\n  if (typeof value === 'number') {\n    return `0x${value.toString(16)}`;\n  }\n\n  // Handle strings\n  if (typeof value === 'string') {\n    // Already hex format\n    if (value.startsWith('0x')) {\n      return value;\n    }\n    // Try to parse as decimal\n    const numeric = Number(value);\n    if (!Number.isNaN(numeric)) {\n      return `0x${numeric.toString(16)}`;\n    }\n    // Return as-is (might be a chain name)\n    return value;\n  }\n\n  // Default to Ethereum mainnet\n  return '0x1';\n}\n\n/**\n * Converts a chain ID to a number.\n * Handles hex strings, decimal strings, numbers, and viem Chain objects.\n */\nexport function chainIdToNumber(value: unknown): number | null {\n  // Handle viem Chain objects\n  if (value && typeof value === 'object') {\n    const candidate = value as { chainId?: unknown; id?: unknown };\n    if (typeof candidate.id === 'number') return candidate.id;\n    if (typeof candidate.chainId === 'number') return candidate.chainId;\n  }\n\n  if (typeof value === 'number') {\n    return value;\n  }\n\n  if (typeof value === 'string') {\n    if (value.startsWith('0x')) {\n      return parseInt(value, 16);\n    }\n    const parsed = parseInt(value, 10);\n    return Number.isNaN(parsed) ? null : parsed;\n  }\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Chain Name Normalization (from bridgeUtils.ts)\n// ---------------------------------------------------------------------------\n\n/**\n * Chain name aliases mapped to canonical names.\n */\nconst CHAIN_ALIASES: Record<string, string> = {\n  // Ethereum\n  eth: 'ethereum',\n  mainnet: 'ethereum',\n  evm: 'ethereum',\n  // Arbitrum\n  arb: 'arbitrum',\n  'arbitrum-one': 'arbitrum',\n  // Solana\n  sol: 'solana',\n};\n\n/**\n * Known EVM chain IDs to canonical names.\n */\nconst CHAIN_ID_TO_NAME: Record<number, string> = {\n  // Mainnets\n  1: 'ethereum',\n  42161: 'arbitrum',\n  8453: 'base',\n  // Testnets\n  11155111: 'ethereum',\n  421614: 'arbitrum',\n  84532: 'base',\n};\n\n/**\n * Normalizes a chain identifier to a canonical name.\n * Handles various formats: names, aliases, chain IDs (number or hex).\n *\n * Examples:\n * - \"arb\" -> \"arbitrum\"\n * - \"ETH\" -> \"ethereum\"\n * - \"arbitrum-one\" -> \"arbitrum\"\n * - \"0x1\" -> \"ethereum\"\n * - 42161 -> \"arbitrum\"\n */\nexport function normalizeChainName(chain: string | number | null | undefined): string {\n  if (chain === null || chain === undefined) return 'ethereum';\n\n  // Handle numeric chain IDs\n  if (typeof chain === 'number') {\n    return CHAIN_ID_TO_NAME[chain] ?? 'ethereum';\n  }\n\n  const lower = chain.toLowerCase().trim();\n\n  // Check if it's a hex chain ID\n  if (lower.startsWith('0x')) {\n    const numericId = parseInt(lower, 16);\n    return CHAIN_ID_TO_NAME[numericId] ?? 'ethereum';\n  }\n\n  // Check if it's a decimal chain ID string\n  const numeric = parseInt(lower, 10);\n  if (!Number.isNaN(numeric) && CHAIN_ID_TO_NAME[numeric]) {\n    return CHAIN_ID_TO_NAME[numeric];\n  }\n\n  // Check aliases\n  if (CHAIN_ALIASES[lower]) {\n    return CHAIN_ALIASES[lower];\n  }\n\n  // Return as-is if it's a known chain name or unknown\n  return lower;\n}\n\n/**\n * Normalizes a chain for CCTP (Circle's Cross-Chain Transfer Protocol).\n * Replaces normalizeCctpChain in bridgeUtils.ts\n */\nexport function normalizeCctpChain(chain: string | null | undefined): string {\n  if (!chain) return 'ethereum';\n  const lower = chain.toLowerCase();\n  if (lower === 'evm') return 'ethereum';\n  if (lower === 'arb' || lower === 'arbitrum' || lower === 'arbitrum-one') return 'arbitrum';\n  if (lower === 'base') return 'base';\n  return lower;\n}\n\n// ---------------------------------------------------------------------------\n// Chain Info & Labels (from bridgeUtils.ts)\n// ---------------------------------------------------------------------------\n\nconst CHAIN_DISPLAY_NAMES: Record<string, string> = {\n  solana: 'Solana',\n  ethereum: 'Ethereum',\n  arbitrum: 'Arbitrum',\n  base: 'Base',\n};\n\n/**\n * Derives a chain label for display.\n * Returns both an id and a display name.\n * Replaces deriveChainLabel in bridgeUtils.ts\n */\nexport function deriveChainLabel(chainId: string | null | undefined): { id: string; name: string } {\n  if (!chainId) return { id: 'solana', name: 'Solana' };\n\n  const normalized = normalizeChainName(chainId);\n  const displayName = CHAIN_DISPLAY_NAMES[normalized] ?? chainId;\n\n  return { id: normalized, name: displayName };\n}\n\n/**\n * Gets chain information from a chain identifier.\n */\nexport function getChainInfo(chain: string | number | null | undefined): ChainInfo | null {\n  if (chain === null || chain === undefined) return null;\n\n  const normalized = normalizeChainName(chain);\n  const displayName = CHAIN_DISPLAY_NAMES[normalized];\n\n  if (!displayName) return null;\n\n  const network: NetworkType = normalized === 'solana' ? 'solana' : 'evm';\n\n  return {\n    id: normalized,\n    name: displayName,\n    network,\n  };\n}\n\n// ---------------------------------------------------------------------------\n// Network Type Detection\n// ---------------------------------------------------------------------------\n\n/**\n * Checks if a chain is Solana.\n */\nexport function isSolanaChain(chain: string | null | undefined): boolean {\n  if (!chain) return false;\n  return normalizeChainName(chain) === 'solana';\n}\n\n/**\n * Checks if a chain is an EVM chain.\n */\nexport function isEVMChain(chain: string | number | null | undefined): boolean {\n  if (chain === null || chain === undefined) return false;\n\n  // Numeric chain IDs are always EVM\n  if (typeof chain === 'number') return true;\n\n  const lower = chain.toLowerCase().trim();\n\n  // Hex chain IDs are EVM\n  if (lower.startsWith('0x')) return true;\n\n  // Normalize and check\n  const normalized = normalizeChainName(chain);\n  return normalized !== 'solana';\n}\n\n/**\n * Detects the network type from a chain identifier.\n */\nexport function detectNetworkType(chain: string | number | null | undefined): NetworkType | null {\n  if (chain === null || chain === undefined) return null;\n\n  if (isSolanaChain(chain as string)) return 'solana';\n  if (isEVMChain(chain)) return 'evm';\n\n  return null;\n}\n\n// ---------------------------------------------------------------------------\n// Viem Chain Helpers\n// ---------------------------------------------------------------------------\n\n/**\n * Extracts the chain ID from a viem Chain object.\n */\nexport function getChainIdFromViemChain(chain: ViemChain | null | undefined): number | null {\n  if (!chain) return null;\n  return chain.id;\n}\n\n/**\n * Checks if a chain ID matches a viem Chain object.\n */\nexport function chainIdMatchesViemChain(chainId: unknown, chain: ViemChain): boolean {\n  const numericId = chainIdToNumber(chainId);\n  return numericId === chain.id;\n}\n\n// ---------------------------------------------------------------------------\n// Chain ID Validation\n// ---------------------------------------------------------------------------\n\n/**\n * Validates a chain ID format.\n * Returns true if it's a valid hex string or positive number.\n */\nexport function isValidChainId(value: unknown): boolean {\n  if (typeof value === 'number' && Number.isFinite(value) && value > 0) {\n    return true;\n  }\n\n  if (typeof value === 'string') {\n    if (value.startsWith('0x')) {\n      const hex = value.slice(2);\n      return /^[0-9a-fA-F]+$/.test(hex) && hex.length > 0;\n    }\n    const numeric = parseInt(value, 10);\n    return !Number.isNaN(numeric) && numeric > 0;\n  }\n\n  return false;\n}\n"]}

package/dist/{utils → src/utils}/ed25519.d.ts

@@ -4,5 +4,3 @@ export interface Ed25519KeyPair {
 }
 export declare function generateEd25519KeyPair(): Promise<Ed25519KeyPair>;
 export declare function signEd25519Message(message: Uint8Array, privateKey: Uint8Array): Promise<Uint8Array>;
-export declare function getEd25519PublicKeyFromPrivate(privateKey: Uint8Array): Promise<Uint8Array>;
-export declare function generateRandomUint8Array(length: number): Uint8Array;

package/dist/{utils → src/utils}/ed25519.js

@@ -36,6 +36,10 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
 };
 import { getPublicKey, sign, utils, hashes } from '@noble/ed25519';
 import { sha512 } from '@noble/hashes/sha2';
+/**
+ * Ed25519 cryptographic utilities for session key generation and message signing.
+ * Configures @noble/ed25519 with SHA-512 hashing dependency.
+ */
 // Configure hashing dependency for @noble/ed25519 v3
 if (!hashes.sha512) {
     hashes.sha512 = sha512;
@@ -65,23 +69,4 @@ export function signEd25519Message(message, privateKey) {
         });
     });
 }
-export function getEd25519PublicKeyFromPrivate(privateKey) {
-    return __awaiter(this, void 0, void 0, function () {
-        return __generator(this, function (_a) {
-            return [2 /*return*/, getPublicKey(privateKey)];
-        });
-    });
-}
-export function generateRandomUint8Array(length) {
-    var buffer = new Uint8Array(length);
-    if (typeof crypto !== 'undefined' && typeof crypto.getRandomValues === 'function') {
-        crypto.getRandomValues(buffer);
-        return buffer;
-    }
-    // Fallback for environments without Web Crypto
-    for (var i = 0; i < length; i++) {
-        buffer[i] = Math.floor(Math.random() * 256);
-    }
-    return buffer;
-}
 //# sourceMappingURL=ed25519.js.map

package/dist/src/utils/ed25519.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ed25519.js","sourceRoot":"","sources":["../../../src/utils/ed25519.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAE5C;;;GAGG;AACH,qDAAqD;AACrD,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;AACzB,CAAC;AACD,IAAI,CAAE,KAAa,CAAC,MAAM,EAAE,CAAC;IAC1B,KAAa,CAAC,MAAM,GAAG,MAAM,CAAC;AACjC,CAAC;AAOD,MAAM,UAAgB,sBAAsB;;;;;;oBACpC,UAAU,GAAG,KAAK,CAAC,eAAe,EAAE,CAAC;oBACzB,qBAAM,YAAY,CAAC,UAAU,CAAC,EAAA;;oBAA1C,SAAS,GAAG,SAA8B;oBAChD,sBAAO,EAAE,UAAU,YAAA,EAAE,SAAS,WAAA,EAAE,EAAC;;;;CAClC;AAED,MAAM,UAAgB,kBAAkB,CACtC,OAAmB,EACnB,UAAsB;;;YAEtB,sBAAO,IAAI,CAAC,OAAO,EAAE,UAAU,CAAC,EAAC;;;CAClC","sourcesContent":["import { getPublicKey, sign, utils, hashes } from '@noble/ed25519';\nimport { sha512 } from '@noble/hashes/sha2';\n\n/**\n * Ed25519 cryptographic utilities for session key generation and message signing.\n * Configures @noble/ed25519 with SHA-512 hashing dependency.\n */\n// Configure hashing dependency for @noble/ed25519 v3\nif (!hashes.sha512) {\n  hashes.sha512 = sha512;\n}\nif (!(utils as any).sha512) {\n  (utils as any).sha512 = sha512;\n}\n\nexport interface Ed25519KeyPair {\n  privateKey: Uint8Array;\n  publicKey: Uint8Array;\n}\n\nexport async function generateEd25519KeyPair(): Promise<Ed25519KeyPair> {\n  const privateKey = utils.randomSecretKey();\n  const publicKey = await getPublicKey(privateKey);\n  return { privateKey, publicKey };\n}\n\nexport async function signEd25519Message(\n  message: Uint8Array,\n  privateKey: Uint8Array\n): Promise<Uint8Array> {\n  return sign(message, privateKey);\n}\n\n"]}

package/dist/src/utils/errors.d.ts

@@ -0,0 +1,68 @@
+/**
+ * N1 Wallet Widget Error Taxonomy
+ *
+ * Standardized error types for all subsystems with consistent structure
+ * for logging, error handling, and user feedback.
+ */
+export type ErrorDomain = 'wallet' | 'turnkey' | 'deposit' | 'modal' | 'network' | 'bootstrap';
+export type WalletErrorCode = 'CONNECT_FAILED' | 'DISCONNECT_FAILED' | 'SIGNATURE_REJECTED' | 'SIGNATURE_FAILED' | 'CHAIN_SWITCH_FAILED' | 'ADAPTER_ERROR' | 'NOT_CONNECTED' | 'INVALID_ADDRESS';
+export type TurnkeyErrorCode = 'AUTH_FAILED' | 'AUTH_REJECTED' | 'SESSION_EXPIRED' | 'SESSION_INVALID' | 'WALLET_CREATE_FAILED' | 'WALLET_FETCH_FAILED' | 'SIGNATURE_FAILED' | 'BOOTSTRAP_FAILED' | 'USER_REJECTED' | 'CONFIG_MISSING';
+export type DepositErrorCode = 'BRIDGE_FAILED' | 'BRIDGE_REJECTED' | 'ATTESTATION_FAILED' | 'ATTESTATION_TIMEOUT' | 'CLAIM_FAILED' | 'SOLANA_TX_FAILED' | 'AMOUNT_INVALID' | 'INSUFFICIENT_BALANCE' | 'WALLET_MISMATCH' | 'LEDGER_UNSUPPORTED';
+export type ModalErrorCode = 'OPEN_FAILED' | 'CLOSE_FAILED' | 'FLOW_TRANSITION_FAILED';
+export type NetworkErrorCode = 'RPC_FAILED' | 'CHAIN_UNSUPPORTED' | 'TIMEOUT';
+export type BootstrapErrorCode = 'CONFIG_MISSING' | 'SDK_LOAD_FAILED' | 'INIT_FAILED';
+export type N1ErrorCode = WalletErrorCode | TurnkeyErrorCode | DepositErrorCode | ModalErrorCode | NetworkErrorCode | BootstrapErrorCode;
+export interface N1Error {
+    /** The subsystem where the error originated */
+    domain: ErrorDomain;
+    /** Specific error code for programmatic handling */
+    code: N1ErrorCode;
+    /** Human-readable error message */
+    message: string;
+    /** Whether the user can retry/recover from this error */
+    recoverable: boolean;
+    /** Additional context for debugging */
+    context?: Record<string, unknown>;
+    /** Original error that caused this error */
+    cause?: Error;
+    /** Timestamp when the error occurred */
+    timestamp: number;
+}
+interface ErrorOptions {
+    recoverable?: boolean;
+    context?: Record<string, unknown>;
+    cause?: Error;
+}
+/**
+ * Create a wallet-related error
+ */
+export declare function createWalletError(code: WalletErrorCode, message: string, options?: ErrorOptions): N1Error;
+/**
+ * Create a Turnkey-related error
+ */
+export declare function createTurnkeyError(code: TurnkeyErrorCode, message: string, options?: ErrorOptions): N1Error;
+/**
+ * Create a deposit-related error
+ */
+export declare function createDepositError(code: DepositErrorCode, message: string, options?: ErrorOptions): N1Error;
+/**
+ * Create a modal-related error
+ */
+export declare function createModalError(code: ModalErrorCode, message: string, options?: ErrorOptions): N1Error;
+/**
+ * Create a network-related error
+ */
+export declare function createNetworkError(code: NetworkErrorCode, message: string, options?: ErrorOptions): N1Error;
+/**
+ * Create a bootstrap/initialization error
+ */
+export declare function createBootstrapError(code: BootstrapErrorCode, message: string, options?: ErrorOptions): N1Error;
+/**
+ * Check if an error represents a user rejection (wallet popup dismissed, etc.)
+ */
+export declare function isUserRejectionError(error: unknown): boolean;
+/**
+ * Convert a native Error to an N1Error
+ */
+export declare function toN1Error(error: unknown, domain: ErrorDomain, defaultCode: N1ErrorCode, defaultMessage: string): N1Error;
+export {};

package/dist/src/utils/errors.js

@@ -0,0 +1,190 @@
+/**
+ * N1 Wallet Widget Error Taxonomy
+ *
+ * Standardized error types for all subsystems with consistent structure
+ * for logging, error handling, and user feedback.
+ */
+// ============================================
+// FACTORY FUNCTIONS
+// ============================================
+/**
+ * Create a wallet-related error
+ */
+export function createWalletError(code, message, options) {
+    var _a;
+    if (options === void 0) { options = {}; }
+    return {
+        domain: 'wallet',
+        code: code,
+        message: message,
+        recoverable: (_a = options.recoverable) !== null && _a !== void 0 ? _a : isRecoverableWalletError(code),
+        context: options.context,
+        cause: options.cause,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * Create a Turnkey-related error
+ */
+export function createTurnkeyError(code, message, options) {
+    var _a;
+    if (options === void 0) { options = {}; }
+    return {
+        domain: 'turnkey',
+        code: code,
+        message: message,
+        recoverable: (_a = options.recoverable) !== null && _a !== void 0 ? _a : isRecoverableTurnkeyError(code),
+        context: options.context,
+        cause: options.cause,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * Create a deposit-related error
+ */
+export function createDepositError(code, message, options) {
+    var _a;
+    if (options === void 0) { options = {}; }
+    return {
+        domain: 'deposit',
+        code: code,
+        message: message,
+        recoverable: (_a = options.recoverable) !== null && _a !== void 0 ? _a : isRecoverableDepositError(code),
+        context: options.context,
+        cause: options.cause,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * Create a modal-related error
+ */
+export function createModalError(code, message, options) {
+    var _a;
+    if (options === void 0) { options = {}; }
+    return {
+        domain: 'modal',
+        code: code,
+        message: message,
+        recoverable: (_a = options.recoverable) !== null && _a !== void 0 ? _a : true,
+        context: options.context,
+        cause: options.cause,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * Create a network-related error
+ */
+export function createNetworkError(code, message, options) {
+    var _a;
+    if (options === void 0) { options = {}; }
+    return {
+        domain: 'network',
+        code: code,
+        message: message,
+        recoverable: (_a = options.recoverable) !== null && _a !== void 0 ? _a : true,
+        context: options.context,
+        cause: options.cause,
+        timestamp: Date.now(),
+    };
+}
+/**
+ * Create a bootstrap/initialization error
+ */
+export function createBootstrapError(code, message, options) {
+    var _a;
+    if (options === void 0) { options = {}; }
+    return {
+        domain: 'bootstrap',
+        code: code,
+        message: message,
+        recoverable: (_a = options.recoverable) !== null && _a !== void 0 ? _a : false,
+        context: options.context,
+        cause: options.cause,
+        timestamp: Date.now(),
+    };
+}
+// ============================================
+// RECOVERABILITY HELPERS
+// ============================================
+function isRecoverableWalletError(code) {
+    switch (code) {
+        case 'SIGNATURE_REJECTED':
+        case 'CHAIN_SWITCH_FAILED':
+        case 'CONNECT_FAILED':
+            return true;
+        case 'INVALID_ADDRESS':
+        case 'ADAPTER_ERROR':
+            return false;
+        default:
+            return true;
+    }
+}
+function isRecoverableTurnkeyError(code) {
+    switch (code) {
+        case 'USER_REJECTED':
+        case 'AUTH_REJECTED':
+        case 'SESSION_EXPIRED':
+            return true;
+        case 'CONFIG_MISSING':
+            return false;
+        default:
+            return true;
+    }
+}
+function isRecoverableDepositError(code) {
+    switch (code) {
+        case 'BRIDGE_REJECTED':
+        case 'ATTESTATION_TIMEOUT':
+        case 'CLAIM_FAILED':
+            return true;
+        case 'WALLET_MISMATCH':
+        case 'LEDGER_UNSUPPORTED':
+            return false;
+        default:
+            return true;
+    }
+}
+// ============================================
+// ERROR DETECTION UTILITIES
+// ============================================
+/**
+ * Check if an error represents a user rejection (wallet popup dismissed, etc.)
+ */
+export function isUserRejectionError(error) {
+    var _a, _b, _c, _d, _e, _f;
+    if (!error)
+        return false;
+    var err = error;
+    var code = err === null || err === void 0 ? void 0 : err.code;
+    var message = (_c = (_b = (_a = err === null || err === void 0 ? void 0 : err.message) === null || _a === void 0 ? void 0 : _a.toLowerCase) === null || _b === void 0 ? void 0 : _b.call(_a)) !== null && _c !== void 0 ? _c : '';
+    var name = (_f = (_e = (_d = err === null || err === void 0 ? void 0 : err.name) === null || _d === void 0 ? void 0 : _d.toLowerCase) === null || _e === void 0 ? void 0 : _e.call(_d)) !== null && _f !== void 0 ? _f : '';
+    // Check for explicit rejection codes
+    if (code === 'USER_REJECTED' || code === 4001 || code === 'USER_CANCELED' || code === 'USER_CANCELLED') {
+        return true;
+    }
+    // Check error name
+    if (name.includes('user_rejected') || name.includes('user_canceled') || name.includes('user_cancelled')) {
+        return true;
+    }
+    // Check message patterns
+    if (message.includes('user rejected') || message.includes('user denied')) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Convert a native Error to an N1Error
+ */
+export function toN1Error(error, domain, defaultCode, defaultMessage) {
+    var cause = error instanceof Error ? error : undefined;
+    var message = (cause === null || cause === void 0 ? void 0 : cause.message) || defaultMessage;
+    return {
+        domain: domain,
+        code: defaultCode,
+        message: message,
+        recoverable: true,
+        cause: cause,
+        timestamp: Date.now(),
+    };
+}
+//# sourceMappingURL=errors.js.map

package/dist/src/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../src/utils/errors.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * N1 Wallet Widget Error Taxonomy\n *\n * Standardized error types for all subsystems with consistent structure\n * for logging, error handling, and user feedback.\n */\n\n// ============================================\n// ERROR DOMAINS\n// ============================================\n\nexport type ErrorDomain = 'wallet' | 'turnkey' | 'deposit' | 'modal' | 'network' | 'bootstrap';\n\n// ============================================\n// ERROR CODES BY DOMAIN\n// ============================================\n\nexport type WalletErrorCode =\n    | 'CONNECT_FAILED'\n    | 'DISCONNECT_FAILED'\n    | 'SIGNATURE_REJECTED'\n    | 'SIGNATURE_FAILED'\n    | 'CHAIN_SWITCH_FAILED'\n    | 'ADAPTER_ERROR'\n    | 'NOT_CONNECTED'\n    | 'INVALID_ADDRESS';\n\nexport type TurnkeyErrorCode =\n    | 'AUTH_FAILED'\n    | 'AUTH_REJECTED'\n    | 'SESSION_EXPIRED'\n    | 'SESSION_INVALID'\n    | 'WALLET_CREATE_FAILED'\n    | 'WALLET_FETCH_FAILED'\n    | 'SIGNATURE_FAILED'\n    | 'BOOTSTRAP_FAILED'\n    | 'USER_REJECTED'\n    | 'CONFIG_MISSING';\n\nexport type DepositErrorCode =\n    | 'BRIDGE_FAILED'\n    | 'BRIDGE_REJECTED'\n    | 'ATTESTATION_FAILED'\n    | 'ATTESTATION_TIMEOUT'\n    | 'CLAIM_FAILED'\n    | 'SOLANA_TX_FAILED'\n    | 'AMOUNT_INVALID'\n    | 'INSUFFICIENT_BALANCE'\n    | 'WALLET_MISMATCH'\n    | 'LEDGER_UNSUPPORTED';\n\nexport type ModalErrorCode =\n    | 'OPEN_FAILED'\n    | 'CLOSE_FAILED'\n    | 'FLOW_TRANSITION_FAILED';\n\nexport type NetworkErrorCode =\n    | 'RPC_FAILED'\n    | 'CHAIN_UNSUPPORTED'\n    | 'TIMEOUT';\n\nexport type BootstrapErrorCode =\n    | 'CONFIG_MISSING'\n    | 'SDK_LOAD_FAILED'\n    | 'INIT_FAILED';\n\n// Union of all error codes\nexport type N1ErrorCode =\n    | WalletErrorCode\n    | TurnkeyErrorCode\n    | DepositErrorCode\n    | ModalErrorCode\n    | NetworkErrorCode\n    | BootstrapErrorCode;\n\n// ============================================\n// UNIFIED ERROR TYPE\n// ============================================\n\nexport interface N1Error {\n    /** The subsystem where the error originated */\n    domain: ErrorDomain;\n    /** Specific error code for programmatic handling */\n    code: N1ErrorCode;\n    /** Human-readable error message */\n    message: string;\n    /** Whether the user can retry/recover from this error */\n    recoverable: boolean;\n    /** Additional context for debugging */\n    context?: Record<string, unknown>;\n    /** Original error that caused this error */\n    cause?: Error;\n    /** Timestamp when the error occurred */\n    timestamp: number;\n}\n\n// ============================================\n// ERROR OPTIONS\n// ============================================\n\ninterface ErrorOptions {\n    recoverable?: boolean;\n    context?: Record<string, unknown>;\n    cause?: Error;\n}\n\n// ============================================\n// FACTORY FUNCTIONS\n// ============================================\n\n/**\n * Create a wallet-related error\n */\nexport function createWalletError(\n    code: WalletErrorCode,\n    message: string,\n    options: ErrorOptions = {}\n): N1Error {\n    return {\n        domain: 'wallet',\n        code,\n        message,\n        recoverable: options.recoverable ?? isRecoverableWalletError(code),\n        context: options.context,\n        cause: options.cause,\n        timestamp: Date.now(),\n    };\n}\n\n/**\n * Create a Turnkey-related error\n */\nexport function createTurnkeyError(\n    code: TurnkeyErrorCode,\n    message: string,\n    options: ErrorOptions = {}\n): N1Error {\n    return {\n        domain: 'turnkey',\n        code,\n        message,\n        recoverable: options.recoverable ?? isRecoverableTurnkeyError(code),\n        context: options.context,\n        cause: options.cause,\n        timestamp: Date.now(),\n    };\n}\n\n/**\n * Create a deposit-related error\n */\nexport function createDepositError(\n    code: DepositErrorCode,\n    message: string,\n    options: ErrorOptions = {}\n): N1Error {\n    return {\n        domain: 'deposit',\n        code,\n        message,\n        recoverable: options.recoverable ?? isRecoverableDepositError(code),\n        context: options.context,\n        cause: options.cause,\n        timestamp: Date.now(),\n    };\n}\n\n/**\n * Create a modal-related error\n */\nexport function createModalError(\n    code: ModalErrorCode,\n    message: string,\n    options: ErrorOptions = {}\n): N1Error {\n    return {\n        domain: 'modal',\n        code,\n        message,\n        recoverable: options.recoverable ?? true,\n        context: options.context,\n        cause: options.cause,\n        timestamp: Date.now(),\n    };\n}\n\n/**\n * Create a network-related error\n */\nexport function createNetworkError(\n    code: NetworkErrorCode,\n    message: string,\n    options: ErrorOptions = {}\n): N1Error {\n    return {\n        domain: 'network',\n        code,\n        message,\n        recoverable: options.recoverable ?? true,\n        context: options.context,\n        cause: options.cause,\n        timestamp: Date.now(),\n    };\n}\n\n/**\n * Create a bootstrap/initialization error\n */\nexport function createBootstrapError(\n    code: BootstrapErrorCode,\n    message: string,\n    options: ErrorOptions = {}\n): N1Error {\n    return {\n        domain: 'bootstrap',\n        code,\n        message,\n        recoverable: options.recoverable ?? false,\n        context: options.context,\n        cause: options.cause,\n        timestamp: Date.now(),\n    };\n}\n\n// ============================================\n// RECOVERABILITY HELPERS\n// ============================================\n\nfunction isRecoverableWalletError(code: WalletErrorCode): boolean {\n    switch (code) {\n        case 'SIGNATURE_REJECTED':\n        case 'CHAIN_SWITCH_FAILED':\n        case 'CONNECT_FAILED':\n            return true;\n        case 'INVALID_ADDRESS':\n        case 'ADAPTER_ERROR':\n            return false;\n        default:\n            return true;\n    }\n}\n\nfunction isRecoverableTurnkeyError(code: TurnkeyErrorCode): boolean {\n    switch (code) {\n        case 'USER_REJECTED':\n        case 'AUTH_REJECTED':\n        case 'SESSION_EXPIRED':\n            return true;\n        case 'CONFIG_MISSING':\n            return false;\n        default:\n            return true;\n    }\n}\n\nfunction isRecoverableDepositError(code: DepositErrorCode): boolean {\n    switch (code) {\n        case 'BRIDGE_REJECTED':\n        case 'ATTESTATION_TIMEOUT':\n        case 'CLAIM_FAILED':\n            return true;\n        case 'WALLET_MISMATCH':\n        case 'LEDGER_UNSUPPORTED':\n            return false;\n        default:\n            return true;\n    }\n}\n\n// ============================================\n// ERROR DETECTION UTILITIES\n// ============================================\n\n/**\n * Check if an error represents a user rejection (wallet popup dismissed, etc.)\n */\nexport function isUserRejectionError(error: unknown): boolean {\n    if (!error) return false;\n\n    const err = error as { code?: string | number; message?: string; name?: string };\n    const code = err?.code;\n    const message = err?.message?.toLowerCase?.() ?? '';\n    const name = err?.name?.toLowerCase?.() ?? '';\n\n    // Check for explicit rejection codes\n    if (code === 'USER_REJECTED' || code === 4001 || code === 'USER_CANCELED' || code === 'USER_CANCELLED') {\n        return true;\n    }\n\n    // Check error name\n    if (name.includes('user_rejected') || name.includes('user_canceled') || name.includes('user_cancelled')) {\n        return true;\n    }\n\n    // Check message patterns\n    if (message.includes('user rejected') || message.includes('user denied')) {\n        return true;\n    }\n\n    return false;\n}\n\n/**\n * Convert a native Error to an N1Error\n */\nexport function toN1Error(\n    error: unknown,\n    domain: ErrorDomain,\n    defaultCode: N1ErrorCode,\n    defaultMessage: string\n): N1Error {\n    const cause = error instanceof Error ? error : undefined;\n    const message = cause?.message || defaultMessage;\n\n    return {\n        domain,\n        code: defaultCode,\n        message,\n        recoverable: true,\n        cause,\n        timestamp: Date.now(),\n    };\n}\n"]}

package/dist/src/utils/events.d.ts

@@ -0,0 +1,124 @@
+/**
+ * N1 Wallet Widget Structured Events
+ *
+ * Typed event constants and helpers for logging critical operations.
+ * Events provide consistent naming and structure for observability.
+ */
+export type EventCategory = 'wallet' | 'modal' | 'deposit' | 'turnkey' | 'bootstrap';
+export interface N1Event {
+    /** High-level category of the event */
+    category: EventCategory;
+    /** Specific action that occurred */
+    action: string;
+    /** When the event occurred */
+    timestamp: number;
+    /** Additional context for the event */
+    context?: Record<string, unknown>;
+}
+export declare const EVENTS: {
+    /**
+     * Wallet connection lifecycle events
+     */
+    readonly WALLET: {
+        /** User initiated wallet connection */
+        readonly CONNECT_START: "wallet.connect.start";
+        /** Wallet successfully connected */
+        readonly CONNECT_SUCCESS: "wallet.connect.success";
+        /** Wallet connection failed */
+        readonly CONNECT_FAILED: "wallet.connect.failed";
+        /** User initiated wallet disconnection */
+        readonly DISCONNECT: "wallet.disconnect";
+        /** Wallet switched (address changed) */
+        readonly SWITCH: "wallet.switch";
+        /** Chain/network changed */
+        readonly CHAIN_CHANGE: "wallet.chain.change";
+    };
+    /**
+     * Modal visibility and flow events
+     */
+    readonly MODAL: {
+        /** Modal opened */
+        readonly OPEN: "modal.open";
+        /** Modal closed */
+        readonly CLOSE: "modal.close";
+        /** Flow step changed (e.g., CHAIN_SELECTION -> AMOUNT_INPUT) */
+        readonly FLOW_CHANGE: "modal.flow.change";
+        /** Deposit-only flow triggered */
+        readonly DEPOSIT_FLOW_START: "modal.deposit_flow.start";
+    };
+    /**
+     * Deposit lifecycle events
+     */
+    readonly DEPOSIT: {
+        /** Deposit flow initiated */
+        readonly START: "deposit.start";
+        /** Bridge transaction submitted */
+        readonly BRIDGE_SUBMIT: "deposit.bridge.submit";
+        /** Bridge transaction confirmed on source chain */
+        readonly BRIDGE_CONFIRM: "deposit.bridge.confirm";
+        /** CCTP attestation received */
+        readonly ATTESTATION_RECEIVED: "deposit.attestation.received";
+        /** Claim transaction started */
+        readonly CLAIM_START: "deposit.claim.start";
+        /** Claim transaction succeeded */
+        readonly CLAIM_SUCCESS: "deposit.claim.success";
+        /** Solana deposit started (native flow) */
+        readonly SOLANA_START: "deposit.solana.start";
+        /** Solana deposit confirmed */
+        readonly SOLANA_CONFIRM: "deposit.solana.confirm";
+        /** Deposit completed successfully */
+        readonly COMPLETE: "deposit.complete";
+        /** Deposit failed */
+        readonly FAILED: "deposit.failed";
+        /** Recovery flow initiated */
+        readonly RECOVERY_START: "deposit.recovery.start";
+    };
+    /**
+     * Turnkey authentication events
+     */
+    readonly TURNKEY: {
+        /** Turnkey auth flow started */
+        readonly AUTH_START: "turnkey.auth.start";
+        /** Turnkey auth succeeded */
+        readonly AUTH_SUCCESS: "turnkey.auth.success";
+        /** Turnkey auth failed */
+        readonly AUTH_FAILED: "turnkey.auth.failed";
+        /** Session hydrated from storage */
+        readonly SESSION_HYDRATE: "turnkey.session.hydrate";
+        /** Turnkey Solana wallet created */
+        readonly WALLET_CREATE: "turnkey.wallet.create";
+        /** Turnkey bootstrap completed */
+        readonly READY: "turnkey.ready";
+    };
+    /**
+     * Bootstrap/initialization events
+     */
+    readonly BOOTSTRAP: {
+        /** Dynamic SDK loaded */
+        readonly DYNAMIC_READY: "bootstrap.dynamic.ready";
+        /** Store initialized */
+        readonly STORE_READY: "bootstrap.store.ready";
+        /** All systems ready */
+        readonly COMPLETE: "bootstrap.complete";
+    };
+};
+/**
+ * Create a wallet event
+ */
+export declare function createWalletEvent(action: (typeof EVENTS.WALLET)[keyof typeof EVENTS.WALLET], context?: Record<string, unknown>): N1Event;
+/**
+ * Create a modal event
+ */
+export declare function createModalEvent(action: (typeof EVENTS.MODAL)[keyof typeof EVENTS.MODAL], context?: Record<string, unknown>): N1Event;
+/**
+ * Create a deposit event
+ */
+export declare function createDepositEvent(action: (typeof EVENTS.DEPOSIT)[keyof typeof EVENTS.DEPOSIT], context?: Record<string, unknown>): N1Event;
+/**
+ * Create a Turnkey event
+ */
+export declare function createTurnkeyEvent(action: (typeof EVENTS.TURNKEY)[keyof typeof EVENTS.TURNKEY], context?: Record<string, unknown>): N1Event;
+/**
+ * Create a bootstrap event
+ */
+export declare function createBootstrapEvent(action: (typeof EVENTS.BOOTSTRAP)[keyof typeof EVENTS.BOOTSTRAP], context?: Record<string, unknown>): N1Event;

package/dist/src/utils/events.js

@@ -0,0 +1,155 @@
+/**
+ * N1 Wallet Widget Structured Events
+ *
+ * Typed event constants and helpers for logging critical operations.
+ * Events provide consistent naming and structure for observability.
+ */
+// ============================================
+// EVENT CONSTANTS
+// ============================================
+export var EVENTS = {
+    /**
+     * Wallet connection lifecycle events
+     */
+    WALLET: {
+        /** User initiated wallet connection */
+        CONNECT_START: 'wallet.connect.start',
+        /** Wallet successfully connected */
+        CONNECT_SUCCESS: 'wallet.connect.success',
+        /** Wallet connection failed */
+        CONNECT_FAILED: 'wallet.connect.failed',
+        /** User initiated wallet disconnection */
+        DISCONNECT: 'wallet.disconnect',
+        /** Wallet switched (address changed) */
+        SWITCH: 'wallet.switch',
+        /** Chain/network changed */
+        CHAIN_CHANGE: 'wallet.chain.change',
+    },
+    /**
+     * Modal visibility and flow events
+     */
+    MODAL: {
+        /** Modal opened */
+        OPEN: 'modal.open',
+        /** Modal closed */
+        CLOSE: 'modal.close',
+        /** Flow step changed (e.g., CHAIN_SELECTION -> AMOUNT_INPUT) */
+        FLOW_CHANGE: 'modal.flow.change',
+        /** Deposit-only flow triggered */
+        DEPOSIT_FLOW_START: 'modal.deposit_flow.start',
+    },
+    /**
+     * Deposit lifecycle events
+     */
+    DEPOSIT: {
+        /** Deposit flow initiated */
+        START: 'deposit.start',
+        /** Bridge transaction submitted */
+        BRIDGE_SUBMIT: 'deposit.bridge.submit',
+        /** Bridge transaction confirmed on source chain */
+        BRIDGE_CONFIRM: 'deposit.bridge.confirm',
+        /** CCTP attestation received */
+        ATTESTATION_RECEIVED: 'deposit.attestation.received',
+        /** Claim transaction started */
+        CLAIM_START: 'deposit.claim.start',
+        /** Claim transaction succeeded */
+        CLAIM_SUCCESS: 'deposit.claim.success',
+        /** Solana deposit started (native flow) */
+        SOLANA_START: 'deposit.solana.start',
+        /** Solana deposit confirmed */
+        SOLANA_CONFIRM: 'deposit.solana.confirm',
+        /** Deposit completed successfully */
+        COMPLETE: 'deposit.complete',
+        /** Deposit failed */
+        FAILED: 'deposit.failed',
+        /** Recovery flow initiated */
+        RECOVERY_START: 'deposit.recovery.start',
+    },
+    /**
+     * Turnkey authentication events
+     */
+    TURNKEY: {
+        /** Turnkey auth flow started */
+        AUTH_START: 'turnkey.auth.start',
+        /** Turnkey auth succeeded */
+        AUTH_SUCCESS: 'turnkey.auth.success',
+        /** Turnkey auth failed */
+        AUTH_FAILED: 'turnkey.auth.failed',
+        /** Session hydrated from storage */
+        SESSION_HYDRATE: 'turnkey.session.hydrate',
+        /** Turnkey Solana wallet created */
+        WALLET_CREATE: 'turnkey.wallet.create',
+        /** Turnkey bootstrap completed */
+        READY: 'turnkey.ready',
+    },
+    /**
+     * Bootstrap/initialization events
+     */
+    BOOTSTRAP: {
+        /** Dynamic SDK loaded */
+        DYNAMIC_READY: 'bootstrap.dynamic.ready',
+        /** Store initialized */
+        STORE_READY: 'bootstrap.store.ready',
+        /** All systems ready */
+        COMPLETE: 'bootstrap.complete',
+    },
+};
+// ============================================
+// EVENT FACTORY FUNCTIONS
+// ============================================
+/**
+ * Create a wallet event
+ */
+export function createWalletEvent(action, context) {
+    return {
+        category: 'wallet',
+        action: action,
+        timestamp: Date.now(),
+        context: context,
+    };
+}
+/**
+ * Create a modal event
+ */
+export function createModalEvent(action, context) {
+    return {
+        category: 'modal',
+        action: action,
+        timestamp: Date.now(),
+        context: context,
+    };
+}
+/**
+ * Create a deposit event
+ */
+export function createDepositEvent(action, context) {
+    return {
+        category: 'deposit',
+        action: action,
+        timestamp: Date.now(),
+        context: context,
+    };
+}
+/**
+ * Create a Turnkey event
+ */
+export function createTurnkeyEvent(action, context) {
+    return {
+        category: 'turnkey',
+        action: action,
+        timestamp: Date.now(),
+        context: context,
+    };
+}
+/**
+ * Create a bootstrap event
+ */
+export function createBootstrapEvent(action, context) {
+    return {
+        category: 'bootstrap',
+        action: action,
+        timestamp: Date.now(),
+        context: context,
+    };
+}
+//# sourceMappingURL=events.js.map