@zerodev/wallet-core 0.0.1-alpha.3

package/dist/_types/stampers/types.d.ts

@@ -0,0 +1,23 @@
+/** Base stamper that transport depends on */
+export type Stamp = {
+    stampHeaderName: string;
+    stampHeaderValue: string;
+};
+export type Stamper = {
+    /** retrieve public key compressed or otherwise as per the stamper */
+    getPublicKey: () => Promise<string | null>;
+    /** produce Turnkey header value for a given request body */
+    stamp: (payload: string) => Promise<Stamp>;
+    /** clear local state (embedded key, IDB keypair, etc.) */
+    clear: () => Promise<void>;
+};
+export type IframeStamper = Stamper & {
+    init(): Promise<string>;
+    injectCredentialBundle(bundle: string): Promise<boolean>;
+    injectWalletExportBundle(bundle: string, organizationId: string): Promise<boolean>;
+};
+export type IndexedDbStamper = Stamper & {
+    resetKeyPair: (externalKeyPair?: CryptoKeyPair) => Promise<void>;
+};
+export type WebauthnStamper = Stamper;
+//# sourceMappingURL=types.d.ts.map

package/dist/_types/stampers/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/stampers/types.ts"],"names":[],"mappings":"AAAA,6CAA6C;AAC7C,MAAM,MAAM,KAAK,GAAG;IAClB,eAAe,EAAE,MAAM,CAAA;IACvB,gBAAgB,EAAE,MAAM,CAAA;CACzB,CAAA;AAED,MAAM,MAAM,OAAO,GAAG;IACpB,qEAAqE;IACrE,YAAY,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAC1C,4DAA4D;IAC5D,KAAK,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,KAAK,CAAC,CAAA;IAC1C,0DAA0D;IAC1D,KAAK,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,aAAa,GAAG,OAAO,GAAG;IACpC,IAAI,IAAI,OAAO,CAAC,MAAM,CAAC,CAAA;IACvB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACxD,wBAAwB,CACtB,MAAM,EAAE,MAAM,EACd,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,OAAO,CAAC,CAAA;CACpB,CAAA;AAED,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG;IACvC,YAAY,EAAE,CAAC,eAAe,CAAC,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAA;CACjE,CAAA;AACD,MAAM,MAAM,eAAe,GAAG,OAAO,CAAA"}

package/dist/_types/stampers/webauthnStamper.d.ts

@@ -0,0 +1,5 @@
+import type { WebauthnStamper } from './types.js';
+export declare function createWebauthnStamper({ rpId, }: {
+    rpId: string;
+}): Promise<WebauthnStamper>;
+//# sourceMappingURL=webauthnStamper.d.ts.map

package/dist/_types/stampers/webauthnStamper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webauthnStamper.d.ts","sourceRoot":"","sources":["../../../src/stampers/webauthnStamper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,wBAAsB,qBAAqB,CAAC,EAC1C,IAAI,GACL,EAAE;IACD,IAAI,EAAE,MAAM,CAAA;CACb,GAAG,OAAO,CAAC,eAAe,CAAC,CAa3B"}

package/dist/_types/storage/adapters.d.ts

@@ -0,0 +1,3 @@
+import type { StorageAdapter } from './manager.js';
+export declare function createWebStorageAdapter(storage?: Storage): StorageAdapter;
+//# sourceMappingURL=adapters.d.ts.map

package/dist/_types/storage/adapters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapters.d.ts","sourceRoot":"","sources":["../../../src/storage/adapters.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAA;AAElD,wBAAgB,uBAAuB,CACrC,OAAO,GAAE,OAAoC,GAC5C,cAAc,CAchB"}

package/dist/_types/storage/manager.d.ts

@@ -0,0 +1,19 @@
+import type { ZeroDevWalletSession } from '../types/session.js';
+export type StorageAdapter = {
+    getItem(key: string): string | null | Promise<string | null>;
+    setItem(key: string, value: string): void | Promise<void>;
+    removeItem(key: string): void | Promise<void>;
+};
+export type StorageManager = {
+    storeSession(sessionData: ZeroDevWalletSession, sessionKey: string): Promise<void>;
+    getActiveSession(): Promise<ZeroDevWalletSession | undefined>;
+    getActiveSessionKey(): Promise<string | undefined>;
+    getSession(sessionKey: string): Promise<ZeroDevWalletSession | undefined>;
+    listSessionKeys(): Promise<string[]>;
+    listSessions(): Promise<ZeroDevWalletSession[]>;
+    setActiveSession(sessionKey: string): Promise<void>;
+    clearSession(sessionKey: string): Promise<void>;
+    clearAllSessions(): Promise<void>;
+};
+export declare function createStorageManager(adapter: StorageAdapter): StorageManager;
+//# sourceMappingURL=manager.d.ts.map

package/dist/_types/storage/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/storage/manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAG/D,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;IAC5D,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACzD,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC9C,CAAA;AAED,MAAM,MAAM,cAAc,GAAG;IAC3B,YAAY,CACV,WAAW,EAAE,oBAAoB,EACjC,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAAA;IAChB,gBAAgB,IAAI,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAA;IAC7D,mBAAmB,IAAI,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAA;IAClD,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,GAAG,SAAS,CAAC,CAAA;IACzE,eAAe,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IACpC,YAAY,IAAI,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAA;IAC/C,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IACnD,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC/C,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAClC,CAAA;AAED,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAiJ5E"}

package/dist/_types/types/session.d.ts

@@ -0,0 +1,17 @@
+export declare enum SessionType {
+    READ_ONLY = "SESSION_TYPE_READ_ONLY",
+    READ_WRITE = "SESSION_TYPE_READ_WRITE"
+}
+export type StamperType = 'iframe' | 'indexedDb' | 'passkey';
+export type ZeroDevWalletSession = {
+    id: string;
+    userId: string;
+    organizationId: string;
+    stamperType: StamperType;
+    sessionType?: SessionType;
+    token?: string;
+    publicKey?: string;
+    expiry: number;
+    createdAt: number;
+};
+//# sourceMappingURL=session.d.ts.map

package/dist/_types/types/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../../src/types/session.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,SAAS,2BAA2B;IACpC,UAAU,4BAA4B;CACvC;AAED,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,WAAW,GAAG,SAAS,CAAA;AAE5D,MAAM,MAAM,oBAAoB,GAAG;IACjC,EAAE,EAAE,MAAM,CAAA;IACV,MAAM,EAAE,MAAM,CAAA;IACd,cAAc,EAAE,MAAM,CAAA;IACtB,WAAW,EAAE,WAAW,CAAA;IACxB,WAAW,CAAC,EAAE,WAAW,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,MAAM,EAAE,MAAM,CAAA;IACd,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA"}

package/dist/_types/utils/exportWallet.d.ts

@@ -0,0 +1,44 @@
+import type { ZeroDevWalletSDK } from '../core/createZeroDevWallet.js';
+export type ExportWalletParameters = {
+    /** Wallet to use for the export */
+    wallet: ZeroDevWalletSDK;
+    /** Target public key from export iframe for encryption */
+    targetPublicKey: string;
+};
+/**
+ * TODO: Add it as standard action in the SDK when backend is ready
+ * Export a wallet's seed phrase
+ *
+ * This calls Turnkey's export_wallet API to get an encrypted bundle
+ * containing the wallet's mnemonic. The bundle is encrypted with the
+ * targetPublicKey (from Turnkey's export iframe).
+ *
+ * @param params - Export parameters
+ * @returns Encrypted export bundle
+ *
+ * @example
+ * ```ts
+ * // In UI: Initialize export iframe first
+ * const iframeStamper = await createIframeStamper({
+ *   iframeUrl: 'https://export.turnkey.com',
+ *   iframeContainer: document.getElementById('export-container'),
+ *   iframeElementId: 'export-iframe'
+ * });
+ * const targetPublicKey = await iframeStamper.init();
+ *
+ * // Call SDK to get encrypted bundle
+ * const exportBundle = await exportWallet({
+ *   wallet,
+ *   targetPublicKey
+ * });
+ *
+ * // Inject into iframe to display seed phrase
+ * await iframeStamper.injectWalletExportBundle(exportBundle, organizationId);
+ * ```
+ */
+export declare function exportWallet(params: ExportWalletParameters): Promise<{
+    exportBundle: string;
+    walletId: string;
+    organizationId: string;
+}>;
+//# sourceMappingURL=exportWallet.d.ts.map

package/dist/_types/utils/exportWallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exportWallet.d.ts","sourceRoot":"","sources":["../../../src/utils/exportWallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAA;AAEtE,MAAM,MAAM,sBAAsB,GAAG;IACnC,mCAAmC;IACnC,MAAM,EAAE,gBAAgB,CAAA;IACxB,0DAA0D;IAC1D,eAAe,EAAE,MAAM,CAAA;CACxB,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAsB,YAAY,CAChC,MAAM,EAAE,sBAAsB,GAC7B,OAAO,CAAC;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,cAAc,EAAE,MAAM,CAAA;CAAE,CAAC,CAiF7E"}

package/dist/_types/utils/utils.d.ts

@@ -0,0 +1,52 @@
+import type { PartialBy } from 'viem';
+import type { ZeroDevWalletSession } from '../types/session.js';
+/**
+ * Parses a session from a JWT.
+ *
+ * @param token - The JWT to parse.
+ * @returns {PartialBy<ZeroDevWalletSession, "createdAt" | "id" | "stamperType">} - The parsed session.
+ */
+export declare function parseSession(token: string | ZeroDevWalletSession): PartialBy<ZeroDevWalletSession, 'createdAt' | 'id' | 'stamperType'>;
+/**
+ * Normalizes a timestamp to milliseconds.
+ *
+ * @param timestamp - The timestamp to normalize.
+ * @returns {number} - The normalized timestamp.
+ */
+export declare function normalizeTimestamp(timestamp: number): number;
+/**
+ * Generates a random buffer of 32 bytes.
+ *
+ * @returns {ArrayBuffer} - The random buffer.
+ */
+export declare const generateRandomBuffer: () => ArrayBuffer;
+/**
+ * Encodes a challenge in base64url format.
+ *
+ * @param challenge - The challenge to encode.
+ * @returns {string} - The encoded challenge.
+ */
+export declare const base64UrlEncode: (challenge: ArrayBuffer) => string;
+/**
+ * Compresses an uncompressed P-256 public key into its 33-byte compressed form.
+ *
+ * @param {Uint8Array} raw - The uncompressed public key (65 bytes, starting with 0x04).
+ * @returns {Uint8Array} - The compressed public key (33 bytes, starting with 0x02 or 0x03).
+ * @throws {Error} - If the input key is not a valid uncompressed P-256 key.
+ */
+export declare function pointEncode(raw: Uint8Array): Uint8Array;
+/**
+ * Converts a Uint8Array into a lowercase hex string.
+ *
+ * @param {Uint8Array} input - The input byte array.
+ * @returns {string} - The resulting hex string.
+ */
+export declare function uint8ArrayToHexString(input: Uint8Array): string;
+/**
+ * Generates a compressed public key from a key pair.
+ *
+ * @returns {Promise<string>} - The compressed public key.
+ */
+export declare function generateCompressedPublicKeyFromKeyPair(keyPair: CryptoKeyPair): Promise<string>;
+export declare const humanReadableDateTime: () => string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/_types/utils/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/utils/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,MAAM,CAAA;AACrC,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAA;AAE/D;;;;;GAKG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,GAAG,oBAAoB,GACnC,SAAS,CAAC,oBAAoB,EAAE,WAAW,GAAG,IAAI,GAAG,aAAa,CAAC,CA6BrE;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,QAAO,WAIvC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,eAAe,GAAI,WAAW,WAAW,KAAG,MAMxD,CAAA;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,UAAU,GAAG,UAAU,CAkBvD;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,CAK/D;AAED;;;;GAIG;AACH,wBAAsB,sCAAsC,CAC1D,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,MAAM,CAAC,CAOjB;AAED,eAAO,MAAM,qBAAqB,QAAO,MAExC,CAAA"}