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

package/dist/src/features/onboarding-flow/utils/depositPolling.d.ts

@@ -0,0 +1 @@
+export { createDepositPoller } from './deposit/depositPolling';

package/dist/src/features/onboarding-flow/utils/depositPolling.js

@@ -0,0 +1,3 @@
+// Convenience re-export for backwards compatibility with older imports/tests.
+export { createDepositPoller } from './deposit/depositPolling';
+//# sourceMappingURL=depositPolling.js.map

package/dist/src/features/onboarding-flow/utils/depositPolling.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"depositPolling.js","sourceRoot":"","sources":["../../../../../src/features/onboarding-flow/utils/depositPolling.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC","sourcesContent":["// Convenience re-export for backwards compatibility with older imports/tests.\nexport { createDepositPoller } from './deposit/depositPolling';\n\n\n\n"]}

package/dist/src/features/onboarding-flow/utils/explorerUrl.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Builds an explorer URL by appending transaction hash to base URL.
+ * Normalizes trailing slashes to prevent double slashes.
+ */
+export declare const buildExplorerUrl: (baseUrl: string | null | undefined, tx: string | null | undefined) => string | null;
+/**
+ * Selects explorer URL: uses provided URL if available, otherwise builds from fallback base.
+ */
+export declare const pickExplorerUrl: (provided?: string | null, fallbackBase?: string | null, tx?: string | null) => string | null;
+/**
+ * Returns the explorer base URL for a given chain, reading from environment variables.
+ * Falls back to Etherscan for EVM chains if chain-specific explorer is not configured.
+ */
+export declare const explorerBaseForChain: (chain: string | null | undefined) => string | null;

package/dist/src/features/onboarding-flow/utils/explorerUrl.js

@@ -0,0 +1,44 @@
+/**
+ * Builds an explorer URL by appending transaction hash to base URL.
+ * Normalizes trailing slashes to prevent double slashes.
+ */
+export var buildExplorerUrl = function (baseUrl, tx) {
+    if (!baseUrl || !tx) {
+        return null;
+    }
+    var trimmed = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;
+    return "".concat(trimmed, "/").concat(tx);
+};
+/**
+ * Selects explorer URL: uses provided URL if available, otherwise builds from fallback base.
+ */
+export var pickExplorerUrl = function (provided, fallbackBase, tx) {
+    if (provided)
+        return provided;
+    return buildExplorerUrl(fallbackBase, tx);
+};
+/**
+ * Returns the explorer base URL for a given chain, reading from environment variables.
+ * Falls back to Etherscan for EVM chains if chain-specific explorer is not configured.
+ */
+export var explorerBaseForChain = function (chain) {
+    var _a, _b, _c, _d, _e, _f;
+    if (!chain)
+        return null;
+    switch (chain.toLowerCase()) {
+        case 'ethereum':
+        case 'evm':
+            return (_a = process.env.NEXT_PUBLIC_ETHERSCAN_BASE) !== null && _a !== void 0 ? _a : null;
+        case 'arbitrum':
+        case 'arb':
+        case 'arbitrum-one':
+            return (_c = (_b = process.env.NEXT_PUBLIC_ARBITRUM_EXPLORER_BASE) !== null && _b !== void 0 ? _b : process.env.NEXT_PUBLIC_ETHERSCAN_BASE) !== null && _c !== void 0 ? _c : null;
+        case 'base':
+            return (_e = (_d = process.env.NEXT_PUBLIC_BASE_EXPLORER_BASE) !== null && _d !== void 0 ? _d : process.env.NEXT_PUBLIC_ETHERSCAN_BASE) !== null && _e !== void 0 ? _e : null;
+        case 'solana':
+            return (_f = process.env.NEXT_PUBLIC_SOLANA_EXPLORER_BASE) !== null && _f !== void 0 ? _f : null;
+        default:
+            return null;
+    }
+};
+//# sourceMappingURL=explorerUrl.js.map

package/dist/src/features/onboarding-flow/utils/explorerUrl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"explorerUrl.js","sourceRoot":"","sources":["../../../../../src/features/onboarding-flow/utils/explorerUrl.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,CAAC,IAAM,gBAAgB,GAAG,UAAC,OAAkC,EAAE,EAA6B;IAChG,IAAI,CAAC,OAAO,IAAI,CAAC,EAAE,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;IACvE,OAAO,UAAG,OAAO,cAAI,EAAE,CAAE,CAAC;AAC5B,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,IAAM,eAAe,GAAG,UAC7B,QAAwB,EACxB,YAA4B,EAC5B,EAAkB;IAElB,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,gBAAgB,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AAC5C,CAAC,CAAC;AAEF;;;GAGG;AACH,MAAM,CAAC,IAAM,oBAAoB,GAAG,UAAC,KAAgC;;IACnE,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,QAAQ,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;QAC5B,KAAK,UAAU,CAAC;QAChB,KAAK,KAAK;YACR,OAAO,MAAA,OAAO,CAAC,GAAG,CAAC,0BAA0B,mCAAI,IAAI,CAAC;QACxD,KAAK,UAAU,CAAC;QAChB,KAAK,KAAK,CAAC;QACX,KAAK,cAAc;YACjB,OAAO,MAAA,MAAA,OAAO,CAAC,GAAG,CAAC,kCAAkC,mCAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,mCAAI,IAAI,CAAC;QAC1G,KAAK,MAAM;YACT,OAAO,MAAA,MAAA,OAAO,CAAC,GAAG,CAAC,8BAA8B,mCAAI,OAAO,CAAC,GAAG,CAAC,0BAA0B,mCAAI,IAAI,CAAC;QACtG,KAAK,QAAQ;YACX,OAAO,MAAA,OAAO,CAAC,GAAG,CAAC,gCAAgC,mCAAI,IAAI,CAAC;QAC9D;YACE,OAAO,IAAI,CAAC;IAChB,CAAC;AACH,CAAC,CAAC","sourcesContent":["/**\n * Builds an explorer URL by appending transaction hash to base URL.\n * Normalizes trailing slashes to prevent double slashes.\n */\nexport const buildExplorerUrl = (baseUrl: string | null | undefined, tx: string | null | undefined): string | null => {\n  if (!baseUrl || !tx) {\n    return null;\n  }\n  const trimmed = baseUrl.endsWith('/') ? baseUrl.slice(0, -1) : baseUrl;\n  return `${trimmed}/${tx}`;\n};\n\n/**\n * Selects explorer URL: uses provided URL if available, otherwise builds from fallback base.\n */\nexport const pickExplorerUrl = (\n  provided?: string | null,\n  fallbackBase?: string | null,\n  tx?: string | null\n): string | null => {\n  if (provided) return provided;\n  return buildExplorerUrl(fallbackBase, tx);\n};\n\n/**\n * Returns the explorer base URL for a given chain, reading from environment variables.\n * Falls back to Etherscan for EVM chains if chain-specific explorer is not configured.\n */\nexport const explorerBaseForChain = (chain: string | null | undefined): string | null => {\n  if (!chain) return null;\n  switch (chain.toLowerCase()) {\n    case 'ethereum':\n    case 'evm':\n      return process.env.NEXT_PUBLIC_ETHERSCAN_BASE ?? null;\n    case 'arbitrum':\n    case 'arb':\n    case 'arbitrum-one':\n      return process.env.NEXT_PUBLIC_ARBITRUM_EXPLORER_BASE ?? process.env.NEXT_PUBLIC_ETHERSCAN_BASE ?? null;\n    case 'base':\n      return process.env.NEXT_PUBLIC_BASE_EXPLORER_BASE ?? process.env.NEXT_PUBLIC_ETHERSCAN_BASE ?? null;\n    case 'solana':\n      return process.env.NEXT_PUBLIC_SOLANA_EXPLORER_BASE ?? null;\n    default:\n      return null;\n  }\n};\n"]}

package/dist/src/features/onboarding-flow/utils/nordUtils.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Check if Nord is properly configured
+ *
+ * @param nord Nord instance
+ * @returns Whether Nord is properly configured
+ */
+export declare function isNordConfigured(nord: any): boolean;
+export declare function dynamicImportNordUser(): Promise<any>;

package/dist/{features/onboarding-flow/utils/nordUser.js → src/features/onboarding-flow/utils/nordUtils.js}

@@ -34,6 +34,19 @@ var __generator = (this && this.__generator) || function (thisArg, body) {
         if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
     }
 };
+/**
+ * Check if Nord is properly configured
+ *
+ * @param nord Nord instance
+ * @returns Whether Nord is properly configured
+ */
+export function isNordConfigured(nord) {
+    return !!nord && !!nord.webServerUrl && (!!nord.solanaConnection || !!nord.protonClient);
+}
+/**
+ * Lazy-loads the NordUser class from @n1xyz/nord-ts.
+ * Caches the promise to avoid multiple imports.
+ */
 var nordUserCtorPromise;
 export function dynamicImportNordUser() {
     return __awaiter(this, void 0, void 0, function () {
@@ -45,4 +58,4 @@ export function dynamicImportNordUser() {
         });
     });
 }
-//# sourceMappingURL=nordUser.js.map
+//# sourceMappingURL=nordUtils.js.map

package/dist/src/features/onboarding-flow/utils/nordUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nordUtils.js","sourceRoot":"","sources":["../../../../../src/features/onboarding-flow/utils/nordUtils.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAS;IACxC,OAAO,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,gBAAgB,IAAI,CAAC,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;AAC3F,CAAC;AAED;;;GAGG;AACH,IAAI,mBAA6C,CAAC;AAElD,MAAM,UAAgB,qBAAqB;;;YACzC,IAAI,CAAC,mBAAmB,EAAE,CAAC;gBACzB,mBAAmB,GAAG,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,UAAC,MAAM,IAAK,OAAA,MAAM,CAAC,QAAQ,EAAf,CAAe,CAAC,CAAC;YACnF,CAAC;YACD,sBAAO,mBAAmB,EAAC;;;CAC5B","sourcesContent":["/**\n * Check if Nord is properly configured\n *\n * @param nord Nord instance\n * @returns Whether Nord is properly configured\n */\nexport function isNordConfigured(nord: any): boolean {\n  return !!nord && !!nord.webServerUrl && (!!nord.solanaConnection || !!nord.protonClient);\n}\n\n/**\n * Lazy-loads the NordUser class from @n1xyz/nord-ts.\n * Caches the promise to avoid multiple imports.\n */\nlet nordUserCtorPromise: Promise<any> | undefined;\n\nexport async function dynamicImportNordUser() {\n  if (!nordUserCtorPromise) {\n    nordUserCtorPromise = import('@n1xyz/nord-ts').then((module) => module.NordUser);\n  }\n  return nordUserCtorPromise;\n}\n"]}

package/dist/src/features/onboarding-flow/utils/pendingDepositCookie.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Legacy compatibility layer for older tests and callers.
+ *
+ * The widget now standardizes pending deposit persistence via `utils/deposit/storage.ts`
+ * (localStorage in browser + in-memory fallback in Node/test).
+ *
+ * These exports keep the previous API surface so existing tests keep working.
+ */
+import { advancePendingDeposit, createPendingDepositDraft, PendingDepositStage, PendingDepositState, reconcileStages } from './deposit/storage';
+export type { PendingDepositStage, PendingDepositState };
+export declare const clearPendingDepositCookie: () => void;
+export declare const readPendingDepositCookie: (now?: number) => PendingDepositState | null;
+export { createPendingDepositDraft, advancePendingDeposit, reconcileStages };

package/dist/src/features/onboarding-flow/utils/pendingDepositCookie.js

@@ -0,0 +1,15 @@
+/**
+ * Legacy compatibility layer for older tests and callers.
+ *
+ * The widget now standardizes pending deposit persistence via `utils/deposit/storage.ts`
+ * (localStorage in browser + in-memory fallback in Node/test).
+ *
+ * These exports keep the previous API surface so existing tests keep working.
+ */
+import { advancePendingDeposit, clearPendingDeposit, createPendingDepositDraft, readPendingDeposit, reconcileStages, } from './deposit/storage';
+export var clearPendingDepositCookie = function () { return clearPendingDeposit(); };
+export var readPendingDepositCookie = function (now) {
+    return readPendingDeposit(now);
+};
+export { createPendingDepositDraft, advancePendingDeposit, reconcileStages };
+//# sourceMappingURL=pendingDepositCookie.js.map

package/dist/src/features/onboarding-flow/utils/pendingDepositCookie.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pendingDepositCookie.js","sourceRoot":"","sources":["../../../../../src/features/onboarding-flow/utils/pendingDepositCookie.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,yBAAyB,EAGzB,kBAAkB,EAClB,eAAe,GAChB,MAAM,mBAAmB,CAAC;AAI3B,MAAM,CAAC,IAAM,yBAAyB,GAAG,cAAY,OAAA,mBAAmB,EAAE,EAArB,CAAqB,CAAC;AAE3E,MAAM,CAAC,IAAM,wBAAwB,GAAG,UAAC,GAAY;IACnD,OAAA,kBAAkB,CAAC,GAAG,CAAC;AAAvB,CAAuB,CAAC;AAE1B,OAAO,EAAE,yBAAyB,EAAE,qBAAqB,EAAE,eAAe,EAAE,CAAC","sourcesContent":["/**\n * Legacy compatibility layer for older tests and callers.\n *\n * The widget now standardizes pending deposit persistence via `utils/deposit/storage.ts`\n * (localStorage in browser + in-memory fallback in Node/test).\n *\n * These exports keep the previous API surface so existing tests keep working.\n */\nimport {\n  advancePendingDeposit,\n  clearPendingDeposit,\n  createPendingDepositDraft,\n  PendingDepositStage,\n  PendingDepositState,\n  readPendingDeposit,\n  reconcileStages,\n} from './deposit/storage';\n\nexport type { PendingDepositStage, PendingDepositState };\n\nexport const clearPendingDepositCookie = (): void => clearPendingDeposit();\n\nexport const readPendingDepositCookie = (now?: number): PendingDepositState | null =>\n  readPendingDeposit(now);\n\nexport { createPendingDepositDraft, advancePendingDeposit, reconcileStages };\n\n\n\n"]}

package/dist/src/features/onboarding-flow/utils/pendingDepositStorage.d.ts

@@ -0,0 +1,15 @@
+export interface PendingDeposit {
+    depositId: string;
+    bridgeTx: string;
+    amount: string;
+    timestamp: number;
+    status: 'pending' | 'submitted' | 'completed' | 'failed';
+    attestationId?: string | null;
+    sourceChain?: string;
+    destinationChain?: string;
+}
+export declare const readPendingDeposits: () => PendingDeposit[];
+export declare const addPendingDeposit: (deposit: PendingDeposit) => void;
+export declare const updatePendingDeposit: (bridgeTx: string, updates: Partial<PendingDeposit>) => void;
+export declare const removePendingDeposit: (bridgeTx: string) => void;
+export declare const clearAllPendingDeposits: () => void;

package/dist/src/features/onboarding-flow/utils/pendingDepositStorage.js

@@ -0,0 +1,94 @@
+var __assign = (this && this.__assign) || function () {
+    __assign = Object.assign || function(t) {
+        for (var s, i = 1, n = arguments.length; i < n; i++) {
+            s = arguments[i];
+            for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p))
+                t[p] = s[p];
+        }
+        return t;
+    };
+    return __assign.apply(this, arguments);
+};
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
+import { logger } from '../../../utils/logger';
+import { createDepositError } from '../../../utils/errors';
+var PENDING_META_KEY = 'n1_pending_deposits';
+export var readPendingDeposits = function () {
+    if (typeof window === 'undefined')
+        return [];
+    var raw = window.localStorage.getItem(PENDING_META_KEY);
+    if (!raw)
+        return [];
+    try {
+        var parsed = JSON.parse(raw);
+        if (Array.isArray(parsed)) {
+            return parsed;
+        }
+        return [];
+    }
+    catch (_a) {
+        return [];
+    }
+};
+export var addPendingDeposit = function (deposit) {
+    if (typeof window === 'undefined')
+        return;
+    var current = readPendingDeposits();
+    // Avoid duplicates
+    if (current.some(function (d) { return d.bridgeTx === deposit.bridgeTx; }))
+        return;
+    var updated = __spreadArray(__spreadArray([], current, true), [deposit], false);
+    try {
+        window.localStorage.setItem(PENDING_META_KEY, JSON.stringify(updated));
+    }
+    catch (e) {
+        logger.logError(createDepositError('BRIDGE_FAILED', 'Failed to save pending deposit', {
+            cause: e instanceof Error ? e : undefined,
+        }));
+    }
+};
+export var updatePendingDeposit = function (bridgeTx, updates) {
+    if (typeof window === 'undefined')
+        return;
+    var current = readPendingDeposits();
+    var index = current.findIndex(function (d) { return d.bridgeTx === bridgeTx; });
+    if (index === -1)
+        return;
+    current[index] = __assign(__assign({}, current[index]), updates);
+    try {
+        window.localStorage.setItem(PENDING_META_KEY, JSON.stringify(current));
+    }
+    catch (e) {
+        logger.logError(createDepositError('BRIDGE_FAILED', 'Failed to update pending deposit', {
+            cause: e instanceof Error ? e : undefined,
+        }));
+    }
+};
+export var removePendingDeposit = function (bridgeTx) {
+    if (typeof window === 'undefined')
+        return;
+    var current = readPendingDeposits();
+    var updated = current.filter(function (d) { return d.bridgeTx !== bridgeTx; });
+    try {
+        window.localStorage.setItem(PENDING_META_KEY, JSON.stringify(updated));
+    }
+    catch (e) {
+        logger.logError(createDepositError('BRIDGE_FAILED', 'Failed to remove pending deposit', {
+            cause: e instanceof Error ? e : undefined,
+        }));
+    }
+};
+export var clearAllPendingDeposits = function () {
+    if (typeof window === 'undefined')
+        return;
+    window.localStorage.removeItem(PENDING_META_KEY);
+};
+//# sourceMappingURL=pendingDepositStorage.js.map

package/dist/src/features/onboarding-flow/utils/pendingDepositStorage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pendingDepositStorage.js","sourceRoot":"","sources":["../../../../../src/features/onboarding-flow/utils/pendingDepositStorage.ts"],"names":[],"mappings":"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","sourcesContent":["import { logger } from '../../../utils/logger';\nimport { createDepositError } from '../../../utils/errors';\n\nconst PENDING_META_KEY = 'n1_pending_deposits';\n\nexport interface PendingDeposit {\n  depositId: string;\n  bridgeTx: string;\n  amount: string;\n  timestamp: number;\n  status: 'pending' | 'submitted' | 'completed' | 'failed';\n  attestationId?: string | null;\n  sourceChain?: string;\n  destinationChain?: string;\n}\n\nexport const readPendingDeposits = (): PendingDeposit[] => {\n  if (typeof window === 'undefined') return [];\n  const raw = window.localStorage.getItem(PENDING_META_KEY);\n  if (!raw) return [];\n  try {\n    const parsed = JSON.parse(raw);\n    if (Array.isArray(parsed)) {\n      return parsed as PendingDeposit[];\n    }\n    return [];\n  } catch {\n    return [];\n  }\n};\n\nexport const addPendingDeposit = (deposit: PendingDeposit) => {\n  if (typeof window === 'undefined') return;\n  const current = readPendingDeposits();\n  // Avoid duplicates\n  if (current.some(d => d.bridgeTx === deposit.bridgeTx)) return;\n  \n  const updated = [...current, deposit];\n  try {\n    window.localStorage.setItem(PENDING_META_KEY, JSON.stringify(updated));\n  } catch (e) {\n    logger.logError(createDepositError('BRIDGE_FAILED', 'Failed to save pending deposit', {\n      cause: e instanceof Error ? e : undefined,\n    }));\n  }\n};\n\nexport const updatePendingDeposit = (bridgeTx: string, updates: Partial<PendingDeposit>) => {\n  if (typeof window === 'undefined') return;\n  const current = readPendingDeposits();\n  const index = current.findIndex(d => d.bridgeTx === bridgeTx);\n  if (index === -1) return;\n\n  current[index] = { ...current[index], ...updates };\n  try {\n    window.localStorage.setItem(PENDING_META_KEY, JSON.stringify(current));\n  } catch (e) {\n    logger.logError(createDepositError('BRIDGE_FAILED', 'Failed to update pending deposit', {\n      cause: e instanceof Error ? e : undefined,\n    }));\n  }\n};\n\nexport const removePendingDeposit = (bridgeTx: string) => {\n  if (typeof window === 'undefined') return;\n  const current = readPendingDeposits();\n  const updated = current.filter(d => d.bridgeTx !== bridgeTx);\n  try {\n    window.localStorage.setItem(PENDING_META_KEY, JSON.stringify(updated));\n  } catch (e) {\n    logger.logError(createDepositError('BRIDGE_FAILED', 'Failed to remove pending deposit', {\n      cause: e instanceof Error ? e : undefined,\n    }));\n  }\n};\n\nexport const clearAllPendingDeposits = () => {\n    if (typeof window === 'undefined') return;\n    window.localStorage.removeItem(PENDING_META_KEY);\n}\n"]}

package/dist/{features → src/features}/onboarding-flow/utils/utils.d.ts

@@ -1,14 +1,21 @@
-import { generateEd25519KeyPair, generateRandomUint8Array as createRandomUint8Array } from '../../../utils/ed25519';
+import { generateEd25519KeyPair } from '../../../utils/ed25519';
 export declare const generateSessionKeyPair: typeof generateEd25519KeyPair;
-export declare const generateRandomUint8Array: typeof createRandomUint8Array;
 export declare function arrayBufferToBase64(buffer: Uint8Array): string;
 export declare function base64ToUint8Array(base64String: string): Uint8Array<ArrayBuffer>;
+/**
+ * Stores Ed25519 session key pair in localStorage, keyed by wallet address.
+ * Keys are base64-encoded for storage. Used to persist session keys across page reloads.
+ */
 export declare function storeSessionKeysInLocalStorage({ privKey, publicKey, walletPublicKey, chainName, }: {
     privKey: Uint8Array;
     publicKey: Uint8Array;
     walletPublicKey: string;
     chainName: string;
 }): void;
+/**
+ * Retrieves and decodes session keys from localStorage.
+ * Validates that public key is 32 bytes. Throws if keys are missing or invalid.
+ */
 export declare function getSessionKeysFromLocalStorage(walletPublicKey: string): {
     ed25519PrivateKey: Uint8Array;
     ed25519PublicKey: Uint8Array | null;

package/dist/{features → src/features}/onboarding-flow/utils/utils.js

@@ -1,6 +1,5 @@
-import { generateEd25519KeyPair, generateRandomUint8Array as createRandomUint8Array, } from '../../../utils/ed25519';
+import { generateEd25519KeyPair, } from '../../../utils/ed25519';
 export var generateSessionKeyPair = generateEd25519KeyPair;
-export var generateRandomUint8Array = createRandomUint8Array;
 export function arrayBufferToBase64(buffer) {
     var binary = '';
     var bytes = new Uint8Array(buffer);
@@ -19,7 +18,10 @@ export function base64ToUint8Array(base64String) {
     }
     return bytes;
 }
-// Function to store keys with a custom ID format in local storage, including private key
+/**
+ * Stores Ed25519 session key pair in localStorage, keyed by wallet address.
+ * Keys are base64-encoded for storage. Used to persist session keys across page reloads.
+ */
 export function storeSessionKeysInLocalStorage(_a) {
     var privKey = _a.privKey, publicKey = _a.publicKey, walletPublicKey = _a.walletPublicKey, chainName = _a.chainName;
     var storageKey = "n1_sessionKey_".concat(walletPublicKey);
@@ -32,7 +34,10 @@ export function storeSessionKeysInLocalStorage(_a) {
     };
     localStorage.setItem(storageKey, JSON.stringify(data));
 }
-// Retrieve data from local storage by wallet key and convert the private and public key back to Uint8Array
+/**
+ * Retrieves and decodes session keys from localStorage.
+ * Validates that public key is 32 bytes. Throws if keys are missing or invalid.
+ */
 export function getSessionKeysFromLocalStorage(walletPublicKey) {
     var storageKey = "n1_sessionKey_".concat(walletPublicKey);
     var data = localStorage.getItem(storageKey);

package/dist/src/features/onboarding-flow/utils/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../../../../src/features/onboarding-flow/utils/utils.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,sBAAsB,GACvB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,CAAC,IAAM,sBAAsB,GAAG,sBAAsB,CAAC;AAE7D,MAAM,UAAU,mBAAmB,CAAC,MAAkB;IACpD,IAAI,MAAM,GAAG,EAAE,CAAC;IAChB,IAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,MAAM,IAAI,MAAM,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,IAAI,CAAC,MAAM,CAAC,CAAC;AACtB,CAAC;AAED,2CAA2C;AAC3C,MAAM,UAAU,kBAAkB,CAAC,YAAoB;IACrD,IAAM,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;IACxC,IAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;IACnC,IAAM,KAAK,GAAG,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAChC,KAAK,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IACxC,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,EAU9C;QATC,OAAO,aAAA,EACP,SAAS,eAAA,EACT,eAAe,qBAAA,EACf,SAAS,eAAA;IAOT,IAAM,UAAU,GAAG,wBAAiB,eAAe,CAAE,CAAC;IAEtD,IAAM,IAAI,GAAG;QACX,iBAAiB,EAAE,mBAAmB,CAAC,OAAO,CAAC;QAC/C,gBAAgB,EAAE,mBAAmB,CAAC,SAAS,CAAC;QAChD,eAAe,iBAAA;QACf,SAAS,WAAA;QACT,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KACpC,CAAC;IAEF,YAAY,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,8BAA8B,CAAC,eAAuB;IAOpE,IAAM,UAAU,GAAG,wBAAiB,eAAe,CAAE,CAAC;IAEtD,IAAM,IAAI,GAAG,YAAY,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC9C,IAAI,IAAI,EAAE,CAAC;QACT,IAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACpC,IAAI,UAAU,CAAC,iBAAiB,EAAE,CAAC;YACjC,UAAU,CAAC,iBAAiB,GAAG,kBAAkB,CAC/C,UAAU,CAAC,iBAAiB,CAC7B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QACD,IAAI,UAAU,CAAC,gBAAgB,EAAE,CAAC;YAChC,UAAU,CAAC,gBAAgB,GAAG,kBAAkB,CAC9C,UAAU,CAAC,gBAAgB,CAC5B,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;QACjE,CAAC;QACD,iFAAiF;QACjF,IAAI,CAAC,UAAU,CAAC,gBAAgB,IAAI,CAAC,CAAC,UAAU,CAAC,gBAAgB,YAAY,UAAU,CAAC,IAAI,UAAU,CAAC,gBAAgB,CAAC,MAAM,KAAK,EAAE,EAAE,CAAC;YACtI,MAAM,IAAI,KAAK,CAAC,uCAAuC,CAAC,CAAC;QAC3D,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,2DAA2D;AAC3D,MAAM,UAAU,0BAA0B,CAAC,eAAuB;IAChE,IAAM,UAAU,GAAG,wBAAiB,eAAe,CAAE,CAAC;IAEtD,YAAY,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC","sourcesContent":["import {\n  generateEd25519KeyPair,\n} from '../../../utils/ed25519';\n\nexport const generateSessionKeyPair = generateEd25519KeyPair;\n\nexport function arrayBufferToBase64(buffer: Uint8Array) {\n  let binary = '';\n  const bytes = new Uint8Array(buffer);\n  for (let i = 0; i < bytes.length; i++) {\n    binary += String.fromCharCode(bytes[i]);\n  }\n  return btoa(binary);\n}\n\n// Convert Base64 string back to Uint8Array\nexport function base64ToUint8Array(base64String: string) {\n  const binaryString = atob(base64String);\n  const length = binaryString.length;\n  const bytes = new Uint8Array(length);\n  for (let i = 0; i < length; i++) {\n    bytes[i] = binaryString.charCodeAt(i);\n  }\n  return bytes;\n}\n\n/**\n * Stores Ed25519 session key pair in localStorage, keyed by wallet address.\n * Keys are base64-encoded for storage. Used to persist session keys across page reloads.\n */\nexport function storeSessionKeysInLocalStorage({\n  privKey,\n  publicKey,\n  walletPublicKey,\n  chainName,\n}: {\n  privKey: Uint8Array;\n  publicKey: Uint8Array;\n  walletPublicKey: string;\n  chainName: string;\n}) {\n  const storageKey = `n1_sessionKey_${walletPublicKey}`;\n\n  const data = {\n    ed25519PrivateKey: arrayBufferToBase64(privKey),\n    ed25519PublicKey: arrayBufferToBase64(publicKey),\n    walletPublicKey,\n    chainName,\n    createdAt: new Date().toISOString(),\n  };\n\n  localStorage.setItem(storageKey, JSON.stringify(data));\n}\n\n/**\n * Retrieves and decodes session keys from localStorage.\n * Validates that public key is 32 bytes. Throws if keys are missing or invalid.\n */\nexport function getSessionKeysFromLocalStorage(walletPublicKey: string): {\n  ed25519PrivateKey: Uint8Array;\n  ed25519PublicKey: Uint8Array | null;\n  walletPublicKey: string;\n  chainName: string;\n  createdAt: string;\n} | null {\n  const storageKey = `n1_sessionKey_${walletPublicKey}`;\n\n  const data = localStorage.getItem(storageKey);\n  if (data) {\n    const parsedData = JSON.parse(data);\n    if (parsedData.ed25519PrivateKey) {\n      parsedData.ed25519PrivateKey = base64ToUint8Array(\n        parsedData.ed25519PrivateKey\n      );\n    } else {\n      throw new Error('Missing ed25519PrivateKey in session storage');\n    }\n    if (parsedData.ed25519PublicKey) {\n      parsedData.ed25519PublicKey = base64ToUint8Array(\n        parsedData.ed25519PublicKey\n      );\n    } else {\n      throw new Error('Missing ed25519PublicKey in session storage');\n    }\n    // Validate keys: check that public key is present and is Uint8Array of length 32\n    if (!parsedData.ed25519PublicKey || !(parsedData.ed25519PublicKey instanceof Uint8Array) || parsedData.ed25519PublicKey.length !== 32) {\n      throw new Error('Invalid public key in session storage');\n    }\n    return parsedData;\n  }\n  return null;\n}\n\n// Function to remove data from local storage by wallet key\nexport function removeKeysFromLocalStorage(walletPublicKey: string) {\n  const storageKey = `n1_sessionKey_${walletPublicKey}`;\n\n  localStorage.removeItem(storageKey);\n}\n"]}

package/dist/src/features/onboarding-flow/utils/withImageFallback.d.ts

@@ -0,0 +1,6 @@
+import React, { ComponentType } from 'react';
+/**
+ * HOC that recursively replaces all <img> elements in a component's render tree
+ * with ImageWithFallback components to handle broken image URLs gracefully.
+ */
+export declare function withImageFallback<P extends object>(WrappedComponent: ComponentType<P>): React.FC<P>;

package/dist/{features → src/features}/onboarding-flow/utils/withImageFallback.js

@@ -24,9 +24,8 @@ import { jsx as _jsx } from "react/jsx-runtime";
 import React from 'react';
 import { ImageWithFallback } from '../components';
 /**
- * A Higher-Order Component (HOC) that adds image fallback functionality to a component
- * @param WrappedComponent The component to wrap
- * @returns A new component with image fallback functionality
+ * HOC that recursively replaces all <img> elements in a component's render tree
+ * with ImageWithFallback components to handle broken image URLs gracefully.
  */
 export function withImageFallback(WrappedComponent) {
     // Create a new component that wraps the original component

package/dist/src/features/onboarding-flow/utils/withImageFallback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"withImageFallback.js","sourceRoot":"","sources":["../../../../../src/features/onboarding-flow/utils/withImageFallback.tsx"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AAAA,OAAO,KAAwB,MAAM,OAAO,CAAC;AAC7C,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAC/B,gBAAkC;IAElC,2DAA2D;IAC3D,IAAM,iBAAiB,GAAgB,UAAC,KAAK;QAC3C,iDAAiD;QACjD,IAAM,WAAW,GAAG,UAAC,IAAqB;YACxC,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,EAAE,CAAC;gBAChC,OAAO,IAAI,CAAC;YACd,CAAC;YAED,IAAM,OAAO,GAAG,IAA+B,CAAC;YAEhD,4DAA4D;YAC5D,IAAI,OAAO,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;gBAC3B,IAAM,KAAkD,OAAO,CAAC,KAA4B,EAApF,GAAG,SAAA,EAAE,GAAG,SAAA,EAAE,KAAK,WAAA,EAAE,MAAM,YAAA,EAAE,SAAS,eAAA,EAAK,IAAI,cAA7C,8CAA+C,CAAuC,CAAC;gBAE7F,OAAO,CACL,KAAC,iBAAiB,aAChB,GAAG,EAAE,GAAG,EACR,GAAG,EAAE,GAAG,IAAI,OAAO,EACnB,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,SAAS,IAChB,IAAI,EACR,CACH,CAAC;YACJ,CAAC;YAED,+CAA+C;YAC/C,IAAI,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC,KAAK,CAAC,QAAQ,EAAE,CAAC;gBAC5C,IAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CACjC,OAAO,CAAC,KAAK,CAAC,QAAQ,EACtB,WAAW,CACZ,CAAC;gBAEF,OAAO,KAAK,CAAC,YAAY,CAAC,OAAO,eAAO,OAAO,CAAC,KAAK,GAAI,QAAQ,CAAC,CAAC;YACrE,CAAC;YAED,OAAO,OAAO,CAAC;QACjB,CAAC,CAAC;QAEF,sDAAsD;QACtD,IAAM,iBAAiB,GAAG,KAAC,gBAAgB,eAAK,KAAK,EAAI,CAAC;QAC1D,OAAO,WAAW,CAAC,iBAAiB,CAAuB,CAAC;IAC9D,CAAC,CAAC;IAEF,iCAAiC;IACjC,IAAM,oBAAoB,GACxB,gBAAgB,CAAC,WAAW,IAAI,gBAAgB,CAAC,IAAI,IAAI,WAAW,CAAC;IACvE,iBAAiB,CAAC,WAAW,GAAG,4BAAqB,oBAAoB,MAAG,CAAC;IAE7E,OAAO,iBAAiB,CAAC;AAC3B,CAAC","sourcesContent":["import React, { ComponentType } from 'react';\nimport { ImageWithFallback } from '../components';\n\n/**\n * HOC that recursively replaces all <img> elements in a component's render tree\n * with ImageWithFallback components to handle broken image URLs gracefully.\n */\nexport function withImageFallback<P extends object>(\n  WrappedComponent: ComponentType<P>\n): React.FC<P> {\n  // Create a new component that wraps the original component\n  const WithImageFallback: React.FC<P> = (props) => {\n    // Function to recursively process React elements\n    const processNode = (node: React.ReactNode): React.ReactNode => {\n      if (!React.isValidElement(node)) {\n        return node;\n      }\n\n      const element = node as React.ReactElement<any>;\n\n      // If it's an img element, replace it with ImageWithFallback\n      if (element.type === 'img') {\n        const { src, alt, width, height, className, ...rest } = element.props as Record<string, any>;\n\n        return (\n          <ImageWithFallback\n            src={src}\n            alt={alt || 'Image'}\n            width={width}\n            height={height}\n            className={className}\n            {...rest}\n          />\n        );\n      }\n\n      // If it has children, process them recursively\n      if (element.props && element.props.children) {\n        const children = React.Children.map(\n          element.props.children,\n          processNode\n        );\n\n        return React.cloneElement(element, { ...element.props }, children);\n      }\n\n      return element;\n    };\n\n    // Render the wrapped component and process its output\n    const renderedComponent = <WrappedComponent {...props} />;\n    return processNode(renderedComponent) as React.ReactElement;\n  };\n\n  // Set display name for debugging\n  const wrappedComponentName =\n    WrappedComponent.displayName || WrappedComponent.name || 'Component';\n  WithImageFallback.displayName = `withImageFallback(${wrappedComponentName})`;\n\n  return WithImageFallback;\n}\n"]}

package/dist/src/hooks/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/hooks/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,6BAA6B,CAAC","sourcesContent":["export * from './useN1Wallet';\nexport * from './useNordUserInitialization';\n\n\n"]}

package/dist/src/hooks/useN1Wallet.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Hook to access the public N1 wallet context.
+ * Provides wallet state, connection status, and user-facing actions.
+ * Throws if used outside N1WalletProvider.
+ */
+export declare function useN1WalletContext(): import("../types/wallet").N1WalletState;
+/**
+ * Hook to access the internal N1 wallet context.
+ * Provides internal state and setters for Dynamic SDK integration.
+ * Should only be used by internal components within the widget.
+ */
+export declare function useN1WalletInternalContext(): import("../types/wallet").N1InternalWalletState;

package/dist/{hooks → src/hooks}/useN1Wallet.js

@@ -1,5 +1,10 @@
 import { useContext } from 'react';
 import { N1WalletContext, N1InternalWalletContext } from '../context/n1-wallet-context';
+/**
+ * Hook to access the public N1 wallet context.
+ * Provides wallet state, connection status, and user-facing actions.
+ * Throws if used outside N1WalletProvider.
+ */
 export function useN1WalletContext() {
     var context = useContext(N1WalletContext);
     if (context === undefined) {
@@ -7,6 +12,11 @@ export function useN1WalletContext() {
     }
     return context;
 }
+/**
+ * Hook to access the internal N1 wallet context.
+ * Provides internal state and setters for Dynamic SDK integration.
+ * Should only be used by internal components within the widget.
+ */
 export function useN1WalletInternalContext() {
     var context = useContext(N1InternalWalletContext);
     if (context === undefined) {

package/dist/src/hooks/useN1Wallet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useN1Wallet.js","sourceRoot":"","sources":["../../../src/hooks/useN1Wallet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,OAAO,CAAC;AACnC,OAAO,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAExF;;;;GAIG;AACH,MAAM,UAAU,kBAAkB;IAChC,IAAM,OAAO,GAAG,UAAU,CAAC,eAAe,CAAC,CAAC;IAC5C,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,2DAA2D,CAC5D,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B;IACxC,IAAM,OAAO,GAAG,UAAU,CAAC,uBAAuB,CAAC,CAAC;IACpD,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CACb,mEAAmE,CACpE,CAAC;IACJ,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC","sourcesContent":["import { useContext } from 'react';\nimport { N1WalletContext, N1InternalWalletContext } from '../context/n1-wallet-context';\n\n/**\n * Hook to access the public N1 wallet context.\n * Provides wallet state, connection status, and user-facing actions.\n * Throws if used outside N1WalletProvider.\n */\nexport function useN1WalletContext() {\n  const context = useContext(N1WalletContext);\n  if (context === undefined) {\n    throw new Error(\n      'useN1WalletContext must be used within a N1WalletProvider'\n    );\n  }\n  return context;\n}\n\n/**\n * Hook to access the internal N1 wallet context.\n * Provides internal state and setters for Dynamic SDK integration.\n * Should only be used by internal components within the widget.\n */\nexport function useN1WalletInternalContext() {\n  const context = useContext(N1InternalWalletContext);\n  if (context === undefined) {\n    throw new Error(\n      'useN1WalletInternalContext must be used within a N1WalletProvider'\n    );\n  }\n  return context;\n}\n"]}

package/dist/src/hooks/useNordUserInitialization.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Hook that initializes NordUser and signing functions when a wallet is connected.
+ *
+ * Sets up:
+ * - Session key pair generation/storage
+ * - Wallet message signing (Solana)
+ * - Wallet transaction signing (Solana)
+ * - NordUser instance creation with session keys
+ *
+ * Runs automatically when address and solanaWallet are available.
+ */
+export declare function useNordUserInitialization(): void;