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

package/dist/src/turnkey/turnkeySessionStorage.js

@@ -0,0 +1,183 @@
+/**
+ * Manages persistence of a single Turnkey session key in localStorage.
+ * Stores the session key and associated metadata (EVM address, Solana account).
+ * Only one session is active at a time.
+ */
+import { logger } from '../utils/logger';
+import { normalizeEVMAddressLowercase } from '../utils/address';
+var STORAGE_KEY = 'n1_turnkey_session_v1';
+var CLIENT_WALLET_KEY = 'n1_turnkey_client_wallet';
+var readState = function () {
+    var startTime = Date.now();
+    // logger.debug("[TurnkeyStorage] [readState] Starting");
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    try {
+        var raw = window.localStorage.getItem(STORAGE_KEY);
+        if (!raw) {
+            return null;
+        }
+        var parsed = JSON.parse(raw);
+        // Validate structure roughly
+        if (parsed && typeof parsed === 'object' && parsed.sessionKey) {
+            return parsed;
+        }
+        return null;
+    }
+    catch (error) {
+        logger.warn("[TurnkeyStorage] [readState] Error reading state", {
+            error: error,
+            duration: "".concat(Date.now() - startTime, "ms"),
+        });
+        return null;
+    }
+};
+var persistState = function (state) {
+    var startTime = Date.now();
+    if (typeof window === 'undefined') {
+        return;
+    }
+    try {
+        if (!state) {
+            window.localStorage.removeItem(STORAGE_KEY);
+            return;
+        }
+        var serialized = JSON.stringify(state);
+        window.localStorage.setItem(STORAGE_KEY, serialized);
+    }
+    catch (error) {
+        logger.warn("[TurnkeyStorage] [persistState] Storage failure", {
+            error: error,
+            duration: "".concat(Date.now() - startTime, "ms"),
+        });
+    }
+};
+/**
+ * Normalizes an EVM address to lowercase for consistent storage lookups.
+ * Uses centralized address normalization utility.
+ */
+var normalizeAddress = function (address) {
+    return address ? normalizeEVMAddressLowercase(address) || null : null;
+};
+export function readTurnkeyClientAddress() {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    try {
+        var raw = window.localStorage.getItem(CLIENT_WALLET_KEY);
+        return normalizeAddress(raw);
+    }
+    catch (_a) {
+        return null;
+    }
+}
+export function storeTurnkeyClientAddress(address) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    var normalized = normalizeAddress(address);
+    if (!normalized) {
+        return;
+    }
+    try {
+        window.localStorage.setItem(CLIENT_WALLET_KEY, normalized);
+    }
+    catch (_a) {
+        // ignore
+    }
+}
+/**
+ * Stores a Turnkey session key. Replaces any existing session.
+ */
+export function storeTurnkeySessionKey(address, sessionKey, options) {
+    var _a, _b, _c;
+    var startTime = Date.now();
+    if (typeof window === 'undefined') {
+        return;
+    }
+    var normalized = normalizeAddress(address);
+    if (!normalized) {
+        return;
+    }
+    var current = readState();
+    var existingSolanaAccount = null;
+    if (current && normalizeAddress(current.evmAddress) === normalized) {
+        existingSolanaAccount = (_a = current.solanaAccount) !== null && _a !== void 0 ? _a : null;
+    }
+    var entry = {
+        sessionKey: sessionKey,
+        evmAddress: (_b = options === null || options === void 0 ? void 0 : options.evmAddress) !== null && _b !== void 0 ? _b : normalized,
+        solanaAccount: (_c = options === null || options === void 0 ? void 0 : options.solanaAccount) !== null && _c !== void 0 ? _c : existingSolanaAccount,
+        session: options === null || options === void 0 ? void 0 : options.session,
+    };
+    persistState(entry);
+    logger.debug("[TurnkeyStorage] [storeTurnkeySessionKey] Stored session", {
+        address: normalized.substring(0, 10) + "...",
+        duration: "".concat(Date.now() - startTime, "ms"),
+    });
+}
+export function updateTurnkeyStoredSolanaAccount(address, solanaAccount) {
+    var normalized = normalizeAddress(address);
+    if (!normalized) {
+        return;
+    }
+    var currentSession = readState();
+    // Only update if the session belongs to the address
+    if (!currentSession || normalizeAddress(currentSession.evmAddress) !== normalized) {
+        return;
+    }
+    currentSession.solanaAccount = solanaAccount;
+    persistState(currentSession);
+    logger.debug("[TurnkeyStorage] [updateTurnkeyStoredSolanaAccount] Updated", {
+        walletId: solanaAccount.walletId,
+    });
+}
+/**
+ * Clears the stored Turnkey session.
+ */
+export function clearTurnkeySessionKey(address) {
+    // If address is provided, only clear if it matches?
+    // For now, user requested "only storing one turnkey session", so clearing usually means clearing the current one.
+    // But if an address is passed, we should probably check if the stored session matches it before clearing?
+    // The previous implementation supported clearing specific address.
+    // The user said "when we call logout on turnkey client we should clean up sessions".
+    // Simplest is just clearing everything since we only store one.
+    if (address) {
+        var current = readState();
+        var normalized = normalizeAddress(address);
+        if (current && normalizeAddress(current.evmAddress) !== normalized) {
+            // Do not clear if it belongs to someone else (unlikely given one session, but safe)
+            return;
+        }
+    }
+    persistState(null);
+    logger.debug("[TurnkeyStorage] [clearTurnkeySessionKey] Cleared session");
+}
+/**
+ * Retrieves the stored Turnkey session.
+ * If address is provided, validates that the session belongs to that address.
+ */
+export function readTurnkeyStoredSession(address) {
+    var session = readState();
+    if (!session) {
+        return null;
+    }
+    if (address) {
+        var normalized = normalizeAddress(address);
+        var sessionAddress = normalizeAddress(session.evmAddress);
+        if (normalized && sessionAddress !== normalized) {
+            logger.debug("[TurnkeyStorage] [readTurnkeyStoredSession] Session address mismatch", {
+                expected: normalized,
+                actual: sessionAddress
+            });
+            return null;
+        }
+    }
+    return session;
+}
+export function readTurnkeySessionKey(address) {
+    var _a, _b;
+    return (_b = (_a = readTurnkeyStoredSession(address)) === null || _a === void 0 ? void 0 : _a.sessionKey) !== null && _b !== void 0 ? _b : null;
+}
+//# sourceMappingURL=turnkeySessionStorage.js.map

package/dist/src/turnkey/turnkeySessionStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"turnkeySessionStorage.js","sourceRoot":"","sources":["../../../src/turnkey/turnkeySessionStorage.ts"],"names":[],"mappings":"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","sourcesContent":["/**\n * Manages persistence of a single Turnkey session key in localStorage.\n * Stores the session key and associated metadata (EVM address, Solana account).\n * Only one session is active at a time.\n */\nimport { logger } from '../utils/logger';\nimport { normalizeEVMAddressLowercase } from '../utils/address';\n\nconst STORAGE_KEY = 'n1_turnkey_session_v1';\nconst CLIENT_WALLET_KEY = 'n1_turnkey_client_wallet';\n\n/**\n * Internal storage structure for Turnkey session.\n */\nexport interface StoredSessionEntry {\n  sessionKey: string;\n  evmAddress?: string | null;\n  solanaAccount?: {\n    walletId: string;\n    account: {\n      address: string;\n      addressFormat?: string;\n    };\n  } | null;\n  session?: unknown;\n}\n\nconst readState = (): StoredSessionEntry | null => {\n  const startTime = Date.now();\n  // logger.debug(\"[TurnkeyStorage] [readState] Starting\");\n\n  if (typeof window === 'undefined') {\n    return null;\n  }\n\n  try {\n    const raw = window.localStorage.getItem(STORAGE_KEY);\n    \n    if (!raw) {\n      return null;\n    }\n\n    const parsed = JSON.parse(raw);\n    \n    // Validate structure roughly\n    if (parsed && typeof parsed === 'object' && parsed.sessionKey) {\n        return parsed as StoredSessionEntry;\n    }\n    \n    return null;\n  } catch (error) {\n    logger.warn(\"[TurnkeyStorage] [readState] Error reading state\", {\n      error,\n      duration: `${Date.now() - startTime}ms`,\n    });\n    return null;\n  }\n};\n\nconst persistState = (state: StoredSessionEntry | null) => {\n  const startTime = Date.now();\n  \n  if (typeof window === 'undefined') {\n    return;\n  }\n\n  try {\n    if (!state) {\n      window.localStorage.removeItem(STORAGE_KEY);\n      return;\n    }\n\n    const serialized = JSON.stringify(state);\n    window.localStorage.setItem(STORAGE_KEY, serialized);\n    \n  } catch (error) {\n    logger.warn(\"[TurnkeyStorage] [persistState] Storage failure\", {\n      error,\n      duration: `${Date.now() - startTime}ms`,\n    });\n  }\n};\n\n/**\n * Normalizes an EVM address to lowercase for consistent storage lookups.\n * Uses centralized address normalization utility.\n */\nconst normalizeAddress = (address?: string | null): string | null =>\n  address ? normalizeEVMAddressLowercase(address) || null : null;\n\nexport function readTurnkeyClientAddress(): string | null {\n  if (typeof window === 'undefined') {\n    return null;\n  }\n  try {\n    const raw = window.localStorage.getItem(CLIENT_WALLET_KEY);\n    return normalizeAddress(raw);\n  } catch {\n    return null;\n  }\n}\n\nexport function storeTurnkeyClientAddress(address: string | null) {\n  if (typeof window === 'undefined') {\n    return;\n  }\n  const normalized = normalizeAddress(address);\n  if (!normalized) {\n    return;\n  }\n  try {\n    window.localStorage.setItem(CLIENT_WALLET_KEY, normalized);\n  } catch {\n    // ignore\n  }\n}\n\n/**\n * Stores a Turnkey session key. Replaces any existing session.\n */\nexport function storeTurnkeySessionKey(\n  address: string,\n  sessionKey: string,\n  options?: {\n    evmAddress?: string | null;\n    solanaAccount?: {\n      walletId: string;\n      account: { address: string; addressFormat?: string };\n    } | null;\n    session?: unknown;\n  }\n) {\n  const startTime = Date.now();\n  \n  if (typeof window === 'undefined') {\n    return;\n  }\n\n  const normalized = normalizeAddress(address);\n  if (!normalized) {\n    return;\n  }\n\n  const current = readState();\n  let existingSolanaAccount: StoredSessionEntry['solanaAccount'] = null;\n  if (current && normalizeAddress(current.evmAddress) === normalized) {\n      existingSolanaAccount = current.solanaAccount ?? null;\n  }\n\n  const entry: StoredSessionEntry = {\n    sessionKey,\n    evmAddress: options?.evmAddress ?? normalized,\n    solanaAccount: options?.solanaAccount ?? existingSolanaAccount,\n    session: options?.session,\n  };\n\n  persistState(entry);\n  \n  logger.debug(\"[TurnkeyStorage] [storeTurnkeySessionKey] Stored session\", {\n    address: normalized.substring(0, 10) + \"...\",\n    duration: `${Date.now() - startTime}ms`,\n  });\n}\n\nexport function updateTurnkeyStoredSolanaAccount(\n  address: string,\n  solanaAccount: { walletId: string; account: { address: string; addressFormat?: string } }\n) {\n  const normalized = normalizeAddress(address);\n  if (!normalized) {\n    return;\n  }\n  \n  const currentSession = readState();\n  \n  // Only update if the session belongs to the address\n  if (!currentSession || normalizeAddress(currentSession.evmAddress) !== normalized) {\n      return;\n  }\n\n  currentSession.solanaAccount = solanaAccount;\n  persistState(currentSession);\n  \n  logger.debug(\"[TurnkeyStorage] [updateTurnkeyStoredSolanaAccount] Updated\", {\n     walletId: solanaAccount.walletId,\n  });\n}\n\n/**\n * Clears the stored Turnkey session.\n */\nexport function clearTurnkeySessionKey(address?: string | null) {\n  // If address is provided, only clear if it matches?\n  // For now, user requested \"only storing one turnkey session\", so clearing usually means clearing the current one.\n  // But if an address is passed, we should probably check if the stored session matches it before clearing?\n  // The previous implementation supported clearing specific address.\n  // The user said \"when we call logout on turnkey client we should clean up sessions\".\n  // Simplest is just clearing everything since we only store one.\n  \n  if (address) {\n      const current = readState();\n      const normalized = normalizeAddress(address);\n      if (current && normalizeAddress(current.evmAddress) !== normalized) {\n          // Do not clear if it belongs to someone else (unlikely given one session, but safe)\n          return;\n      }\n  }\n  \n  persistState(null);\n  logger.debug(\"[TurnkeyStorage] [clearTurnkeySessionKey] Cleared session\");\n}\n\n/**\n * Retrieves the stored Turnkey session.\n * If address is provided, validates that the session belongs to that address.\n */\nexport function readTurnkeyStoredSession(\n  address?: string | null\n): StoredSessionEntry | null {\n  const session = readState();\n  \n  if (!session) {\n      return null;\n  }\n\n  if (address) {\n      const normalized = normalizeAddress(address);\n      const sessionAddress = normalizeAddress(session.evmAddress);\n      \n      if (normalized && sessionAddress !== normalized) {\n          logger.debug(\"[TurnkeyStorage] [readTurnkeyStoredSession] Session address mismatch\", {\n              expected: normalized,\n              actual: sessionAddress\n          });\n          return null;\n      }\n  }\n\n  return session;\n}\n\nexport function readTurnkeySessionKey(address?: string | null): string | null {\n  return readTurnkeyStoredSession(address)?.sessionKey ?? null;\n}\n"]}

package/dist/{turnkey → src/turnkey}/types.d.ts

@@ -1,5 +1,6 @@
 import type { CreateWalletParams, SignMessageParams, Wallet } from "@turnkey/core";
 import type { Session, v1SignRawPayloadResult } from "@turnkey/sdk-types";
+export type TurnkeyBootstrapStatus = "idle" | "authenticating" | "creating" | "ready" | "error";
 export interface TurnkeyProviderConfig {
     organizationId: string;
     authProxyConfigId: string;
@@ -11,7 +12,7 @@ export interface TurnkeyProviderConfig {
      */
     sessionExpirationSeconds?: string;
 }
-export declare enum AuthState {
+export declare enum TurnkeyAuthState {
     Unauthenticated = "unauthenticated",
     Authenticating = "authenticating",
     Authenticated = "authenticated"
@@ -32,17 +33,29 @@ export interface DynamicEvmWallet {
             icon?: string;
         };
         getNetwork?: () => Promise<string | number | undefined>;
+        getWalletClient?: (chainId?: number) => Promise<any>;
+        getProvider?: () => Promise<any>;
         signMessage?: (message: string, withAddress?: string) => Promise<string | undefined>;
     };
 }
 export interface TurnkeyContextValue {
-    authState: AuthState;
-    session: TurnkeySession | null;
-    wallets: Wallet[];
-    createWallet: (params: CreateWalletParams) => Promise<unknown>;
-    refreshWallets: () => Promise<Wallet[]>;
-    signMessage: (params: SignMessageParams) => Promise<v1SignRawPayloadResult>;
-    loginWithWallet: (wallet: DynamicEvmWallet, options?: {
+    turnkeyAuthState: TurnkeyAuthState;
+    turnkeySession: TurnkeySession | null;
+    turnkeyWallets: Wallet[];
+    isHydratingSession: boolean;
+    turnkeyStatus: TurnkeyBootstrapStatus;
+    turnkeyError: string | null;
+    turnkeyAddress: string | null;
+    createTurnkeyWallet: (params: CreateWalletParams) => Promise<unknown>;
+    refreshTurnkeyWallets: (options?: {
+        force?: boolean;
+    }) => Promise<Wallet[]>;
+    signTurnkeyMessage: (params: SignMessageParams) => Promise<v1SignRawPayloadResult>;
+    waitForSessionHydration: (expectedWalletAddress?: string | null) => Promise<void>;
+    loginWithTurnkeyWallet: (wallet: DynamicEvmWallet, options?: {
         sessionKey?: string;
+        forceLogin?: boolean;
     }) => Promise<void>;
+    prepareTurnkeyWallet: () => Promise<void>;
+    retryTurnkeyBootstrap: () => void;
 }

package/dist/src/turnkey/types.js

@@ -0,0 +1,12 @@
+/**
+ * Type definitions for Turnkey integration.
+ * Includes provider configuration, authentication state, session management, and Dynamic wallet compatibility.
+ */
+"use client";
+export var TurnkeyAuthState;
+(function (TurnkeyAuthState) {
+    TurnkeyAuthState["Unauthenticated"] = "unauthenticated";
+    TurnkeyAuthState["Authenticating"] = "authenticating";
+    TurnkeyAuthState["Authenticated"] = "authenticated";
+})(TurnkeyAuthState || (TurnkeyAuthState = {}));
+//# sourceMappingURL=types.js.map

package/dist/src/turnkey/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/turnkey/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,YAAY,CAAC;AA4Bb,MAAM,CAAN,IAAY,gBAIX;AAJD,WAAY,gBAAgB;IAC1B,uDAAmC,CAAA;IACnC,qDAAiC,CAAA;IACjC,mDAA+B,CAAA;AACjC,CAAC,EAJW,gBAAgB,KAAhB,gBAAgB,QAI3B","sourcesContent":["/**\n * Type definitions for Turnkey integration.\n * Includes provider configuration, authentication state, session management, and Dynamic wallet compatibility.\n */\n\"use client\";\n\nimport type {\n  CreateWalletParams,\n  SignMessageParams,\n  Wallet,\n} from \"@turnkey/core\";\nimport type { Session, v1SignRawPayloadResult } from \"@turnkey/sdk-types\";\n\nexport type TurnkeyBootstrapStatus =\n  | \"idle\"\n  | \"authenticating\"\n  | \"creating\"\n  | \"ready\"\n  | \"error\";\n\nexport interface TurnkeyProviderConfig {\n  organizationId: string;\n  authProxyConfigId: string;\n  authProxyUrl?: string;\n  apiBaseUrl?: string;\n  /**\n   * Optional session length to use when stamping logins,\n   * expressed in seconds (string per Turnkey API expectations).\n   */\n  sessionExpirationSeconds?: string;\n}\n\nexport enum TurnkeyAuthState {\n  Unauthenticated = \"unauthenticated\",\n  Authenticating = \"authenticating\",\n  Authenticated = \"authenticated\",\n}\n\nexport interface TurnkeySession extends Session {\n  sessionKey: string;\n}\n\nexport interface DynamicEvmWallet {\n  id?: string;\n  key?: string;\n  address?: string | null;\n  chain?: string | null;\n  signMessage?: (message: string) => Promise<string | undefined>;\n  connector?: {\n    name?: string;\n    key?: string;\n    metadata?: {\n      icon?: string;\n    };\n    getNetwork?: () => Promise<string | number | undefined>;\n    getWalletClient?: (chainId?: number) => Promise<any>;\n    getProvider?: () => Promise<any>;\n    signMessage?: (\n      message: string,\n      withAddress?: string,\n    ) => Promise<string | undefined>;\n  };\n}\n\nexport interface TurnkeyContextValue {\n  turnkeyAuthState: TurnkeyAuthState;\n  turnkeySession: TurnkeySession | null;\n  turnkeyWallets: Wallet[];\n  isHydratingSession: boolean;\n  turnkeyStatus: TurnkeyBootstrapStatus;\n  turnkeyError: string | null;\n  turnkeyAddress: string | null;\n  createTurnkeyWallet: (params: CreateWalletParams) => Promise<unknown>;\n  refreshTurnkeyWallets: (options?: { force?: boolean }) => Promise<Wallet[]>;\n  signTurnkeyMessage: (params: SignMessageParams) => Promise<v1SignRawPayloadResult>;\n  waitForSessionHydration: (expectedWalletAddress?: string | null) => Promise<void>;\n  loginWithTurnkeyWallet: (\n    wallet: DynamicEvmWallet,\n    options?: { sessionKey?: string; forceLogin?: boolean },\n  ) => Promise<void>;\n  prepareTurnkeyWallet: () => Promise<void>;\n  retryTurnkeyBootstrap: () => void;\n}\n"]}

package/dist/{types → src/types}/wallet.d.ts

@@ -1,5 +1,11 @@
-import type { WalletError } from '../errors/types';
+/**
+ * Core type definitions for the N1 wallet widget.
+ * Includes modal view modes, session modes, provider props, wallet state interfaces,
+ * and Nord API function signatures.
+ */
+import type { WalletError, N1Error } from '../errors/types';
 import type { Nord } from '@n1xyz/nord-ts';
+import type { ModalState } from '../store/types';
 export declare enum N1ModalViewMode {
     Connect = 0,
     CreateSession = 1,
@@ -25,8 +31,14 @@ export interface CssColorOverride {
 export interface N1WalletProviderProps {
     children: React.ReactNode;
     providedSessionMode: N1SessionMode;
-    onError?: (error: WalletError) => void;
+    /**
+     * Callback for handling widget errors.
+     * Receives either an N1Error (new) or WalletError (legacy) object.
+     */
+    onError?: (error: WalletError | N1Error) => void;
     nord?: Nord | null;
+    dynamicEnvironmentId?: string | null;
+    enableTurnkey?: boolean;
     /**
      * Optional array of color overrides: [{color: '#original', replacement: '#new'}]
      */
@@ -93,9 +105,13 @@ export interface N1NordFunctions {
 }
 export interface N1WalletState {
     address: string;
+    walletNetwork: 'solana' | 'evm' | null;
+    isSolanaMode: boolean;
+    isEvmMode: boolean;
     balances: Balance[];
-    chain: string;
     isConnected: boolean;
+    evmAddress: string | null;
+    evmChain: string | null;
     sessionMode: N1SessionMode;
     sessionPubKey: Uint8Array | null;
     setShowLogin: (show: boolean) => void;
@@ -105,8 +121,6 @@ export interface N1WalletState {
     signMessageWithSessionKey: ((message: any) => Promise<any>) | null;
     signMessageWithWalletKey: ((message: any) => Promise<any>) | null;
     signTransactionWithWalletKey: ((transaction: any) => Promise<any>) | null;
-    userChain: string | null;
-    username: string;
     viewMode: N1ModalViewMode;
     walletPubKey: Uint8Array | null;
     throwTestError: () => Promise<void>;
@@ -116,26 +130,32 @@ export interface N1WalletState {
 }
 export interface N1InternalWalletState {
     dynamicHandleLogOut: any;
-    dynamicWallet: any;
+    solanaWallet: any;
+    evmWallet: any;
     loading: boolean;
+    preferredWalletNetwork: 'evm' | 'solana' | null;
     dynamicSdkHasLoaded: any;
-    handleError: (error: WalletError) => void;
+    handleError: (error: WalletError | N1Error) => void;
     setDynamicSdkHasLoaded: (loaded: any) => void;
-    setAddress: (address: string) => void;
+    setSolanaAddress: (address: string) => void;
     setBalances: (balances: Balance[]) => void;
-    setChain: (chain: string) => void;
     setDynamicHandleLogOut: (handler: any) => void;
-    setDynamicWallet: (wallet: any) => void;
+    setSolanaWallet: (wallet: any) => void;
+    setEvmWallet: (wallet: any) => void;
+    setEvmAddress: React.Dispatch<React.SetStateAction<string | null>>;
+    setEvmChain: React.Dispatch<React.SetStateAction<string | null>>;
     setIsConnected: (connected: boolean) => void;
     setLoading: (loading: boolean) => void;
-    blockModalReopen: (duration?: number) => void;
+    /** @deprecated Use closeModal() instead - cooldown is now automatic */
+    blockModalReopen?: (duration?: number) => void;
     setSessionPubKey: (key: Uint8Array | null) => void;
     setSignMessageWithSessionKey: React.Dispatch<React.SetStateAction<((message: any) => Promise<any>) | null>>;
     setSignMessageWithWalletKey: React.Dispatch<React.SetStateAction<((message: any) => Promise<any>) | null>>;
     setSignTransactionWithWalletKey: React.Dispatch<React.SetStateAction<((transaction: any) => Promise<any>) | null>>;
+    /** @deprecated Use closeModal() instead - closing is now handled by state machine */
     setStartClosingLogin: (closing: boolean) => void;
-    setUsername: (username: string) => void;
-    setUserChain: (chain: string | null) => void;
+    setWalletConnectCancelledHandler: (handler: () => void) => void;
+    setPreferredWalletNetwork: (network: 'evm' | 'solana' | null) => void;
     setViewMode: (mode: N1ModalViewMode) => void;
     setWalletPubKey: (key: Uint8Array | null) => void;
     setNordUser: (user: any) => void;
@@ -146,4 +166,10 @@ export interface N1InternalWalletState {
     sessionMode: N1SessionMode;
     skipFinalScreen?: boolean;
     depositFlowRequestId: number;
+    turnkeyEnabled: boolean;
+    walletConnectCancelledHandler: () => void;
+    openModal: () => void;
+    closeModal: () => void;
+    onCloseComplete: () => void;
+    modalState: ModalState;
 }

package/dist/src/types/wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.js","sourceRoot":"","sources":["../../../src/types/wallet.ts"],"names":[],"mappings":"AASA,MAAM,CAAN,IAAY,eAcX;AAdD,WAAY,eAAe;IACzB,2DAAW,CAAA;IACX,uEAAiB,CAAA;IACjB,2DAAW,CAAA;IACX,qEAAgB,CAAA;IAChB,2DAAW,CAAA;IACX,yEAAkB,CAAA;IAClB,yEAAkB,CAAA;IAClB,uDAAS,CAAA;IACT,mEAA0B,CAAA;IAC1B,2EAAyB,CAAA;IACzB,mEAA2B,CAAA;IAC3B,qEAAsB,CAAA;IACtB,gEAAc,CAAA;AAChB,CAAC,EAdW,eAAe,KAAf,eAAe,QAc1B;AAED,MAAM,CAAN,IAAY,aAEX;AAFD,WAAY,aAAa;IACvB,iDAAI,CAAA;AACN,CAAC,EAFW,aAAa,KAAb,aAAa,QAExB","sourcesContent":["/**\n * Core type definitions for the N1 wallet widget.\n * Includes modal view modes, session modes, provider props, wallet state interfaces,\n * and Nord API function signatures.\n */\nimport type { WalletError, N1Error } from '../errors/types';\nimport type { Nord } from '@n1xyz/nord-ts';\nimport type { ModalState } from '../store/types';\n\nexport enum N1ModalViewMode {\n  Connect = 0,\n  CreateSession = 1,\n  Signing = 2,\n  CreatingUser = 3,\n  Success = 4,\n  ChainSelection = 6,\n  DepositSuccess = 7,\n  Error = 8,\n  AmountInput = CreatingUser,\n  DepositProgress = Signing,\n  AuthLoading = CreateSession,\n  FinalSuccess = Success,\n  Automatic = 99,\n}\n\nexport enum N1SessionMode {\n  Nord,\n}\n\nexport interface CssColorOverride {\n  color: string; // Color to find in CSS (e.g. '#3b82f6')\n  replacement: string; // Replacement color (e.g. '#afafaf')\n}\n\nexport interface N1WalletProviderProps {\n  children: React.ReactNode;\n  providedSessionMode: N1SessionMode;\n  /**\n   * Callback for handling widget errors.\n   * Receives either an N1Error (new) or WalletError (legacy) object.\n   */\n  onError?: (error: WalletError | N1Error) => void;\n  nord?: Nord | null;\n  dynamicEnvironmentId?: string | null;\n  enableTurnkey?: boolean;\n  /**\n   * Optional array of color overrides: [{color: '#original', replacement: '#new'}]\n   */\n  colorOverrides?: CssColorOverride[];\n  /**\n   * If true, skip the final success screen and immediately call onDone\n   */\n  skipFinalScreen?: boolean;\n}\n\nexport interface Balance {\n  mint: string;\n  balance: bigint;\n  appType: string;\n}\n\nexport interface N1NordFunctions {\n  // Market information functions\n  getMarkets: () => Promise<any[]>;\n  getOrderbook: (symbol: string) => Promise<any>;\n  getTrades: (params: any) => Promise<any>;\n  getMarketsStats: () => Promise<any>;\n\n  // Trading functions\n  placeOrder: (params: {\n    sessionId: bigint | string;\n    marketId: number;\n    side: 'BUY' | 'SELL';\n    fillMode: 'GTC' | 'IOC' | 'FOK' | 'POST_ONLY';\n    isReduceOnly: boolean;\n    size?: number | string;\n    price?: number | string;\n    quoteSize?: number | string;\n    clientOrderId?: bigint | string;\n  }) => Promise<bigint | undefined>;\n\n  cancelOrder: (params: {\n    sessionId: bigint | string;\n    orderId: bigint | string;\n  }) => Promise<bigint>;\n\n  // Account management\n  createSession: (params: {\n    userPubkey: Uint8Array;\n    sessionPubkey: Uint8Array;\n    expiryTimestamp?: bigint;\n  }) => Promise<bigint>;\n\n  revokeSession: (params: { sessionId: bigint | string }) => Promise<void>;\n\n  withdraw: (params: {\n    sessionId: bigint | string;\n    tokenId: number;\n    amount: number;\n  }) => Promise<void>;\n\n  transfer: (params: {\n    sessionId: bigint | string;\n    fromAccountId: number;\n    toAccountId?: number;\n    tokenId: number;\n    tokenDecimals: number;\n    amount: number | string;\n  }) => Promise<number | undefined>;\n\n  // Blockchain information\n  getTimestamp: () => Promise<bigint>;\n  getActionNonce: () => Promise<number>;\n\n  // Block and action queries\n  queryBlock: (query: any) => Promise<any>;\n  queryLastNBlocks: () => Promise<any>;\n  queryRecentBlocks: (last_n: number) => Promise<any>;\n  queryAction: (query: any) => Promise<any>;\n  queryRecentActions: (last_n: number) => Promise<any>;\n  getActions: (fromActionId: number, toActionId: number) => Promise<any>;\n}\n\nexport interface N1WalletState {\n  address: string;\n  walletNetwork: 'solana' | 'evm' | null;\n  isSolanaMode: boolean;\n  isEvmMode: boolean;\n  balances: Balance[];\n  isConnected: boolean;\n  evmAddress: string | null;\n  evmChain: string | null;\n  sessionMode: N1SessionMode;\n  sessionPubKey: Uint8Array | null;\n  setShowLogin: (show: boolean) => void;\n  startDepositFlow: () => boolean;\n  setViewMode: (mode: N1ModalViewMode) => void;\n  showLogin: boolean;\n  signMessageWithSessionKey: ((message: any) => Promise<any>) | null;\n  signMessageWithWalletKey: ((message: any) => Promise<any>) | null;\n  signTransactionWithWalletKey: ((transaction: any) => Promise<any>) | null;\n  viewMode: N1ModalViewMode;\n  walletPubKey: Uint8Array | null;\n  throwTestError: () => Promise<void>;\n  nord?: Nord | null;\n  nordUser?: any;\n  disconnectWallet: () => void;\n}\n\nexport interface N1InternalWalletState {\n  dynamicHandleLogOut: any;\n  solanaWallet: any;\n  evmWallet: any;\n  loading: boolean;\n  preferredWalletNetwork: 'evm' | 'solana' | null;\n  dynamicSdkHasLoaded: any;\n  handleError: (error: WalletError | N1Error) => void;\n  setDynamicSdkHasLoaded: (loaded: any) => void;\n  setSolanaAddress: (address: string) => void;\n  setBalances: (balances: Balance[]) => void;\n  setDynamicHandleLogOut: (handler: any) => void;\n  setSolanaWallet: (wallet: any) => void;\n  setEvmWallet: (wallet: any) => void;\n  setEvmAddress: React.Dispatch<React.SetStateAction<string | null>>;\n  setEvmChain: React.Dispatch<React.SetStateAction<string | null>>;\n  setIsConnected: (connected: boolean) => void;\n  setLoading: (loading: boolean) => void;\n  /** @deprecated Use closeModal() instead - cooldown is now automatic */\n  blockModalReopen?: (duration?: number) => void;\n  setSessionPubKey: (key: Uint8Array | null) => void;\n  setSignMessageWithSessionKey: React.Dispatch<\n    React.SetStateAction<((message: any) => Promise<any>) | null>\n  >;\n  setSignMessageWithWalletKey: React.Dispatch<\n    React.SetStateAction<((message: any) => Promise<any>) | null>\n  >;\n  setSignTransactionWithWalletKey: React.Dispatch<\n    React.SetStateAction<((transaction: any) => Promise<any>) | null>\n  >;\n  /** @deprecated Use closeModal() instead - closing is now handled by state machine */\n  setStartClosingLogin: (closing: boolean) => void;\n  setWalletConnectCancelledHandler: (handler: () => void) => void;\n  setPreferredWalletNetwork: (network: 'evm' | 'solana' | null) => void;\n  setViewMode: (mode: N1ModalViewMode) => void;\n  setWalletPubKey: (key: Uint8Array | null) => void;\n  setNordUser: (user: any) => void;\n  setDisconnectWalletHandler: (handler: () => void) => void;\n  startClosingLogin: boolean;\n  showDynamicWidget: any;\n  setShowDynamicWidget: (show: any) => void;\n  sessionMode: N1SessionMode;\n  skipFinalScreen?: boolean;\n  depositFlowRequestId: number;\n  turnkeyEnabled: boolean;\n  walletConnectCancelledHandler: () => void;\n  // New modal state machine API\n  openModal: () => void;\n  closeModal: () => void;\n  onCloseComplete: () => void;\n  modalState: ModalState;\n}\n"]}

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

@@ -0,0 +1,130 @@
+/**
+ * Address utilities for validation and normalization across Solana and EVM chains.
+ * Uses library functions from @solana/web3.js and viem for proper validation.
+ * Centralizes address handling that was previously scattered across multiple files.
+ */
+import { PublicKey } from '@solana/web3.js';
+/**
+ * Validates a Solana address by attempting to construct a PublicKey.
+ * This validates the base58 encoding and length.
+ *
+ * @param address - The address to validate
+ * @returns true if valid Solana address format
+ */
+export declare function isValidSolanaAddress(address: string): boolean;
+/**
+ * Validates a Solana wallet address (must be on the ed25519 curve).
+ * PDAs (Program Derived Addresses) are intentionally off-curve and will return false.
+ * Use isValidSolanaAddress() if you need to accept PDAs.
+ *
+ * @param address - The address to validate
+ * @returns true if valid Solana wallet address on the ed25519 curve
+ */
+export declare function isValidSolanaWalletAddress(address: string): boolean;
+/**
+ * Validates an EVM address using viem's isAddress function.
+ * Uses strict: false to accept addresses regardless of checksum.
+ *
+ * @param address - The address to validate
+ * @returns true if valid EVM address format
+ */
+export declare function isValidEVMAddress(address: string): boolean;
+/**
+ * Validates an EVM address with strict checksum validation.
+ *
+ * @param address - The address to validate
+ * @returns true if valid EVM address with correct checksum
+ */
+export declare function isValidEVMAddressStrict(address: string): boolean;
+/**
+ * Validates an address for either Solana or EVM.
+ *
+ * @param address - The address to validate
+ * @returns Object with isValid flag and detected network type
+ */
+export declare function validateAddress(address: string): {
+    isValid: boolean;
+    network: 'solana' | 'evm' | null;
+};
+/**
+ * Normalizes an EVM address to checksummed format using viem.
+ * This is the canonical format for EVM addresses.
+ *
+ * @param address - The EVM address to normalize
+ * @returns Checksummed address, or empty string if invalid
+ */
+export declare function normalizeEVMAddress(address: string | null | undefined): string;
+/**
+ * Normalizes an EVM address to lowercase for comparison purposes.
+ * This replaces the duplicated normalizeAddress functions in TurnkeyProvider.tsx
+ * and turnkeySessionStorage.ts.
+ *
+ * @param address - The EVM address to normalize
+ * @returns Lowercase address, or empty string if invalid
+ */
+export declare function normalizeEVMAddressLowercase(address: string | null | undefined): string;
+/**
+ * Normalizes a Solana address (trimming whitespace).
+ * Solana addresses are case-sensitive (base58), so we only trim.
+ *
+ * @param address - The Solana address to normalize
+ * @returns Trimmed address, or empty string if invalid
+ */
+export declare function normalizeSolanaAddress(address: string | null | undefined): string;
+/**
+ * Normalizes any address based on detected type.
+ * EVM addresses are lowercased, Solana addresses are trimmed.
+ *
+ * @param address - The address to normalize
+ * @returns Normalized address
+ */
+export declare function normalizeAddress(address: string | null | undefined): string;
+/**
+ * Compares two addresses for equality.
+ * Handles case-insensitive comparison for EVM and case-sensitive for Solana.
+ *
+ * @param a - First address
+ * @param b - Second address
+ * @returns true if addresses are equal
+ */
+export declare function compareAddresses(a: string | null | undefined, b: string | null | undefined): boolean;
+/**
+ * Compares two EVM addresses for equality using viem's address comparison.
+ * More robust than string comparison.
+ *
+ * @param a - First EVM address
+ * @param b - Second EVM address
+ * @returns true if addresses are equal
+ */
+export declare function compareEVMAddresses(a: string | null | undefined, b: string | null | undefined): boolean;
+/**
+ * Shortens an address for display.
+ * Example: "0x1234567890abcdef1234567890abcdef12345678" -> "0x1234...5678"
+ *
+ * @param address - The address to shorten
+ * @param chars - Number of characters to show at start/end (default: 4)
+ * @returns Shortened address
+ */
+export declare function shortenAddress(address: string | null | undefined, chars?: number): string;
+/**
+ * Converts a Solana PublicKey to its base58 string representation.
+ *
+ * @param pubkey - The PublicKey to convert (can be PublicKey object or Uint8Array)
+ * @returns Base58 string representation
+ */
+export declare function solanaPublicKeyToString(pubkey: PublicKey | Uint8Array): string;
+/**
+ * Converts a base58 string to a Solana PublicKey.
+ *
+ * @param address - The base58 address string
+ * @returns PublicKey object, or null if invalid
+ */
+export declare function stringToSolanaPublicKey(address: string): PublicKey | null;
+/**
+ * Type guard to check if an address is a valid EVM address.
+ */
+export declare function isEVMAddress(address: unknown): address is string;
+/**
+ * Type guard to check if an address is a valid Solana address.
+ */
+export declare function isSolanaAddress(address: unknown): address is string;