@openzeppelin/miden-multisig-client 0.12.6

package/dist/inspector.js

@@ -0,0 +1,120 @@
+/**
+ * Account Inspector - Inspects account storage to detect multisig configuration.
+ */
+import { Account, Word } from '@demox-labs/miden-sdk';
+import { base64ToUint8Array } from './utils/encoding.js';
+import { wordElementToBigInt, wordToHex } from './utils/word.js';
+import { getProcedureRoot, getProcedureNames } from './procedures.js';
+/**
+ * Inspects an account to detect its multisig configuration.
+ *
+ * @example
+ * ```typescript
+ * // From base64-encoded state
+ * const config = AccountInspector.fromBase64(stateDataBase64);
+ * console.log(`${config.threshold}-of-${config.numSigners} multisig`);
+ *
+ * // From Miden SDK Account
+ * const config = AccountInspector.fromAccount(account);
+ * ```
+ */
+export class AccountInspector {
+    constructor() { }
+    /**
+     * Inspect a base64-encoded serialized account.
+     *
+     * @param base64Data - Base64-encoded Account bytes
+     * @returns Detected multisig configuration
+     */
+    static fromBase64(base64Data) {
+        const bytes = base64ToUint8Array(base64Data);
+        const account = Account.deserialize(bytes);
+        return AccountInspector.fromAccount(account);
+    }
+    /**
+     * Inspect a Miden SDK Account object.
+     *
+     * @param account - The Account object from Miden SDK
+     * @returns Detected multisig configuration
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    static fromAccount(account) {
+        const storage = account.storage();
+        const slot0 = storage.getItem(0);
+        const threshold = Number(wordElementToBigInt(slot0, 0));
+        const numSigners = Number(wordElementToBigInt(slot0, 1));
+        const signerCommitments = [];
+        for (let i = 0; i < numSigners; i++) {
+            try {
+                const key = new Word(new BigUint64Array([BigInt(i), 0n, 0n, 0n]));
+                const commitment = storage.getMapItem(1, key);
+                if (commitment) {
+                    signerCommitments.push(wordToHex(commitment));
+                }
+            }
+            catch (error) {
+                console.warn(error);
+            }
+        }
+        let psmEnabled = false;
+        let psmCommitment = null;
+        try {
+            const psmSlot0 = storage.getItem(4);
+            const selector = Number(wordElementToBigInt(psmSlot0, 0));
+            psmEnabled = selector === 1;
+            if (psmEnabled) {
+                const zeroKey = new Word(new BigUint64Array([0n, 0n, 0n, 0n]));
+                const psmKey = storage.getMapItem(5, zeroKey);
+                if (psmKey) {
+                    psmCommitment = wordToHex(psmKey);
+                }
+            }
+        }
+        catch (error) {
+            console.warn(error);
+        }
+        const vaultBalances = [];
+        try {
+            const vault = account.vault();
+            const fungibleAssets = vault.fungibleAssets();
+            for (const asset of fungibleAssets) {
+                vaultBalances.push({
+                    faucetId: asset.faucetId().toString(),
+                    amount: BigInt(asset.amount()),
+                });
+            }
+        }
+        catch (error) {
+            console.warn(error);
+        }
+        // Read procedure threshold overrides from storage slot 3
+        // Storage layout: slot 3 is a map of PROC_ROOT => [threshold, 0, 0, 0]
+        const procedureThresholds = new Map();
+        for (const procName of getProcedureNames()) {
+            try {
+                const rootHex = getProcedureRoot(procName);
+                const rootWord = Word.fromHex(rootHex);
+                const value = storage.getMapItem(3, rootWord);
+                if (value) {
+                    const procThreshold = Number(wordElementToBigInt(value, 0));
+                    if (procThreshold > 0) {
+                        procedureThresholds.set(procName, procThreshold);
+                    }
+                }
+            }
+            catch {
+                // Procedure threshold not set - use default
+            }
+        }
+        return {
+            threshold,
+            numSigners,
+            signerCommitments,
+            psmEnabled,
+            psmCommitment,
+            vaultBalances,
+            procedureThresholds,
+        };
+    }
+}
+//# sourceMappingURL=inspector.js.map

package/dist/inspector.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.js","sourceRoot":"","sources":["../src/inspector.ts"],"names":[],"mappings":"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"}

package/dist/inspector.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=inspector.test.d.ts.map

package/dist/inspector.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.test.d.ts","sourceRoot":"","sources":["../src/inspector.test.ts"],"names":[],"mappings":""}

package/dist/inspector.test.js

@@ -0,0 +1,205 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+import { AccountInspector } from './inspector.js';
+// Mock the Miden SDK
+vi.mock('@demox-labs/miden-sdk', () => {
+    const createMockWord = (values) => ({
+        toU64s: () => values,
+        toHex: () => '0x' + values.map(v => v.toString(16).padStart(16, '0')).join(''),
+    });
+    const createMockStorage = (slots, maps) => ({
+        getItem: (index) => slots.get(index) ?? createMockWord([0n, 0n, 0n, 0n]),
+        getMapItem: (slotIndex, key) => {
+            const map = maps.get(slotIndex);
+            if (!map)
+                throw new Error('Map not found');
+            const keyStr = key.toU64s?.()[0]?.toString() ?? '0';
+            const value = map.get(keyStr);
+            if (!value)
+                throw new Error('Key not found');
+            return value;
+        },
+    });
+    const createMockVault = (assets) => ({
+        fungibleAssets: () => assets.map(a => ({
+            faucetId: () => ({ toString: () => a.faucetId }),
+            amount: () => a.amount,
+        })),
+    });
+    return {
+        Account: {
+            deserialize: vi.fn((bytes) => {
+                // Return different mocked accounts based on test scenario
+                // Default: 2-of-3 multisig with PSM enabled
+                const slot0 = createMockWord([2n, 3n, 0n, 0n]); // threshold=2, numSigners=3
+                const slot4 = createMockWord([1n, 0n, 0n, 0n]); // PSM enabled
+                const signerMap = new Map();
+                signerMap.set('0', createMockWord([BigInt('0x1111111111111111'), BigInt('0x2222222222222222'), BigInt('0x3333333333333333'), BigInt('0x4444444444444444')]));
+                signerMap.set('1', createMockWord([BigInt('0x5555555555555555'), BigInt('0x6666666666666666'), BigInt('0x7777777777777777'), BigInt('0x8888888888888888')]));
+                signerMap.set('2', createMockWord([BigInt('0xaaaaaaaaaaaaaaaa'), BigInt('0xbbbbbbbbbbbbbbbb'), BigInt('0xcccccccccccccccc'), BigInt('0xdddddddddddddddd')]));
+                const psmMap = new Map();
+                psmMap.set('0', createMockWord([BigInt('0xeeeeeeeeeeeeeeee'), BigInt('0xffffffffffffffff'), BigInt('0x0000000000000001'), BigInt('0x0000000000000002')]));
+                const slots = new Map();
+                slots.set(0, slot0);
+                slots.set(4, slot4);
+                const maps = new Map();
+                maps.set(1, signerMap);
+                maps.set(5, psmMap);
+                return {
+                    storage: () => createMockStorage(slots, maps),
+                    vault: () => createMockVault([
+                        { faucetId: '0xfaucet1', amount: 1000n },
+                        { faucetId: '0xfaucet2', amount: 500n },
+                    ]),
+                };
+            }),
+        },
+        Word: vi.fn().mockImplementation((arr) => ({
+            toU64s: () => Array.from(arr),
+            toHex: () => '0x' + Array.from(arr).map(v => v.toString(16).padStart(16, '0')).join(''),
+        })),
+    };
+});
+describe('AccountInspector', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    describe('fromBase64', () => {
+        it('deserializes account from base64 and extracts config', () => {
+            const base64 = btoa(String.fromCharCode(...new Uint8Array([1, 2, 3])));
+            const config = AccountInspector.fromBase64(base64);
+            expect(config.threshold).toBe(2);
+            expect(config.numSigners).toBe(3);
+        });
+        it('extracts PSM status', () => {
+            const base64 = btoa(String.fromCharCode(...new Uint8Array([1, 2, 3])));
+            const config = AccountInspector.fromBase64(base64);
+            expect(config.psmEnabled).toBe(true);
+            expect(config.psmCommitment).toMatch(/^0x[a-f0-9]+$/);
+        });
+        it('extracts signer commitments', () => {
+            const base64 = btoa(String.fromCharCode(...new Uint8Array([1, 2, 3])));
+            const config = AccountInspector.fromBase64(base64);
+            expect(config.signerCommitments).toHaveLength(3);
+            config.signerCommitments.forEach(commitment => {
+                expect(commitment).toMatch(/^0x[a-f0-9]+$/);
+            });
+        });
+        it('extracts vault balances', () => {
+            const base64 = btoa(String.fromCharCode(...new Uint8Array([1, 2, 3])));
+            const config = AccountInspector.fromBase64(base64);
+            expect(config.vaultBalances).toHaveLength(2);
+            expect(config.vaultBalances[0]).toEqual({ faucetId: '0xfaucet1', amount: 1000n });
+            expect(config.vaultBalances[1]).toEqual({ faucetId: '0xfaucet2', amount: 500n });
+        });
+    });
+    describe('fromAccount', () => {
+        it('extracts threshold from slot 0', async () => {
+            const { Account } = await import('@demox-labs/miden-sdk');
+            const account = Account.deserialize(new Uint8Array([1, 2, 3]));
+            const config = AccountInspector.fromAccount(account);
+            expect(config.threshold).toBe(2);
+        });
+        it('extracts numSigners from slot 0', async () => {
+            const { Account } = await import('@demox-labs/miden-sdk');
+            const account = Account.deserialize(new Uint8Array([1, 2, 3]));
+            const config = AccountInspector.fromAccount(account);
+            expect(config.numSigners).toBe(3);
+        });
+    });
+});
+describe('AccountInspector edge cases', () => {
+    beforeEach(() => {
+        vi.clearAllMocks();
+    });
+    it('handles account with PSM disabled', async () => {
+        const { Account } = await import('@demox-labs/miden-sdk');
+        // Override mock for this test
+        vi.mocked(Account.deserialize).mockReturnValueOnce({
+            storage: () => ({
+                getItem: (index) => {
+                    if (index === 0)
+                        return { toU64s: () => [1n, 1n, 0n, 0n] };
+                    if (index === 4)
+                        return { toU64s: () => [0n, 0n, 0n, 0n] }; // PSM disabled
+                    return { toU64s: () => [0n, 0n, 0n, 0n] };
+                },
+                getMapItem: (slotIndex, key) => {
+                    if (slotIndex === 1 && key.toU64s?.()[0] === 0n) {
+                        return {
+                            toHex: () => '0x' + 'a'.repeat(64),
+                            toU64s: () => [1n, 2n, 3n, 4n],
+                        };
+                    }
+                    throw new Error('Not found');
+                },
+            }),
+            vault: () => ({
+                fungibleAssets: () => [],
+            }),
+        });
+        const account = Account.deserialize(new Uint8Array([1, 2, 3]));
+        const config = AccountInspector.fromAccount(account);
+        expect(config.psmEnabled).toBe(false);
+        expect(config.psmCommitment).toBeNull();
+    });
+    it('handles account with empty vault', async () => {
+        const { Account } = await import('@demox-labs/miden-sdk');
+        vi.mocked(Account.deserialize).mockReturnValueOnce({
+            storage: () => ({
+                getItem: () => ({ toU64s: () => [1n, 1n, 0n, 0n] }),
+                getMapItem: () => {
+                    throw new Error('Not found');
+                },
+            }),
+            vault: () => ({
+                fungibleAssets: () => [],
+            }),
+        });
+        const account = Account.deserialize(new Uint8Array([1, 2, 3]));
+        const config = AccountInspector.fromAccount(account);
+        expect(config.vaultBalances).toEqual([]);
+    });
+    it('handles missing signer map entries gracefully', async () => {
+        const { Account } = await import('@demox-labs/miden-sdk');
+        vi.mocked(Account.deserialize).mockReturnValueOnce({
+            storage: () => ({
+                getItem: (index) => {
+                    if (index === 0)
+                        return { toU64s: () => [2n, 5n, 0n, 0n] }; // threshold=2, numSigners=5
+                    if (index === 4)
+                        return { toU64s: () => [0n, 0n, 0n, 0n] };
+                    return { toU64s: () => [0n, 0n, 0n, 0n] };
+                },
+                getMapItem: () => {
+                    throw new Error('Map entry not found');
+                },
+            }),
+            vault: () => ({
+                fungibleAssets: () => [],
+            }),
+        });
+        const account = Account.deserialize(new Uint8Array([1, 2, 3]));
+        const config = AccountInspector.fromAccount(account);
+        // Should gracefully handle missing entries
+        expect(config.numSigners).toBe(5);
+        expect(config.signerCommitments).toEqual([]); // All entries missing
+    });
+    it('handles vault access error gracefully', async () => {
+        const { Account } = await import('@demox-labs/miden-sdk');
+        vi.mocked(Account.deserialize).mockReturnValueOnce({
+            storage: () => ({
+                getItem: () => ({ toU64s: () => [1n, 1n, 0n, 0n] }),
+                getMapItem: () => {
+                    throw new Error('Not found');
+                },
+            }),
+            vault: () => {
+                throw new Error('Vault access failed');
+            },
+        });
+        const account = Account.deserialize(new Uint8Array([1, 2, 3]));
+        const config = AccountInspector.fromAccount(account);
+        expect(config.vaultBalances).toEqual([]);
+    });
+});
+//# sourceMappingURL=inspector.test.js.map

package/dist/inspector.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inspector.test.js","sourceRoot":"","sources":["../src/inspector.test.ts"],"names":[],"mappings":"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"}

package/dist/keystore.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Web keystore for managing Falcon keys in the browser.
+ *
+ * Keys are stored in localStorage and can be used for signing transactions.
+ * This module mirrors the KeyManager trait from the Rust miden-multisig-client.
+ */
+import { SecretKey } from '@miden-sdk/miden-sdk';
+/**
+ * A stored key entry in the keystore.
+ */
+export interface KeyEntry {
+    /** Unique identifier for the key */
+    id: string;
+    /** Human-readable name for the key */
+    name: string;
+    /** Public key commitment as hex string (64 chars) */
+    commitment: string;
+    /** Serialized secret key as base64 */
+    secretKeyBase64: string;
+    /** Creation timestamp */
+    createdAt: number;
+}
+/**
+ * Loads all keys from localStorage.
+ */
+export declare function loadKeys(): KeyEntry[];
+/**
+ * Generates a new Falcon key pair and stores it in the keystore.
+ *
+ * @param name - Human-readable name for the key
+ * @returns The created key entry
+ */
+export declare function generateKey(name: string): KeyEntry;
+/**
+ * Loads a secret key from a key entry.
+ *
+ * @param entry - The key entry to load
+ * @returns The deserialized secret key
+ */
+export declare function loadSecretKey(entry: KeyEntry): SecretKey;
+/**
+ * Deletes a key from the keystore.
+ *
+ * @param keyId - The ID of the key to delete
+ */
+export declare function deleteKey(keyId: string): void;
+/**
+ * Gets a key by ID.
+ *
+ * @param keyId - The ID of the key to get
+ * @returns The key entry or undefined if not found
+ */
+export declare function getKey(keyId: string): KeyEntry | undefined;
+/**
+ * Renames a key.
+ *
+ * @param keyId - The ID of the key to rename
+ * @param newName - The new name for the key
+ */
+export declare function renameKey(keyId: string, newName: string): void;
+/**
+ * Clears all keys from the keystore.
+ */
+export declare function clearKeystore(): void;
+//# sourceMappingURL=keystore.d.ts.map

package/dist/keystore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keystore.d.ts","sourceRoot":"","sources":["../src/keystore.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAQlD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACvB,oCAAoC;IACpC,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,UAAU,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,eAAe,EAAE,MAAM,CAAC;IACxB,yBAAyB;IACzB,SAAS,EAAE,MAAM,CAAC;CACnB;AAaD;;GAEG;AACH,wBAAgB,QAAQ,IAAI,QAAQ,EAAE,CAQrC;AASD;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,CAgClD;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAGxD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAI7C;AAED;;;;;GAKG;AACH,wBAAgB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,CAG1D;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAO9D;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAEpC"}

package/dist/keystore.js

@@ -0,0 +1,121 @@
+/**
+ * Web keystore for managing Falcon keys in the browser.
+ *
+ * Keys are stored in localStorage and can be used for signing transactions.
+ * This module mirrors the KeyManager trait from the Rust miden-multisig-client.
+ */
+import { SecretKey } from '@demox-labs/miden-sdk';
+const KEYSTORE_STORAGE_KEY = 'miden_keystore';
+// =============================================================================
+// Keystore Functions
+// =============================================================================
+/**
+ * Generates a unique ID for a new key.
+ */
+function generateKeyId() {
+    return crypto.randomUUID();
+}
+/**
+ * Loads all keys from localStorage.
+ */
+export function loadKeys() {
+    try {
+        const stored = localStorage.getItem(KEYSTORE_STORAGE_KEY);
+        if (!stored)
+            return [];
+        return JSON.parse(stored);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * Saves keys to localStorage.
+ */
+function saveKeys(keys) {
+    localStorage.setItem(KEYSTORE_STORAGE_KEY, JSON.stringify(keys));
+}
+/**
+ * Generates a new Falcon key pair and stores it in the keystore.
+ *
+ * @param name - Human-readable name for the key
+ * @returns The created key entry
+ */
+export function generateKey(name) {
+    // Generate a random seed for the key
+    const seed = new Uint8Array(32);
+    crypto.getRandomValues(seed);
+    // Generate the Falcon secret key
+    const secretKey = SecretKey.rpoFalconWithRNG(seed);
+    // Get the public key and its commitment
+    const publicKey = secretKey.publicKey();
+    const commitment = publicKey.toCommitment();
+    const commitmentHex = commitment.toHex();
+    // Serialize the secret key for storage
+    const secretKeyBytes = secretKey.serialize();
+    const secretKeyBase64 = btoa(String.fromCharCode(...secretKeyBytes));
+    // Create the key entry
+    const entry = {
+        id: generateKeyId(),
+        name,
+        commitment: commitmentHex,
+        secretKeyBase64,
+        createdAt: Date.now(),
+    };
+    // Save to keystore
+    const keys = loadKeys();
+    keys.push(entry);
+    saveKeys(keys);
+    return entry;
+}
+/**
+ * Loads a secret key from a key entry.
+ *
+ * @param entry - The key entry to load
+ * @returns The deserialized secret key
+ */
+export function loadSecretKey(entry) {
+    const bytes = Uint8Array.from(atob(entry.secretKeyBase64), (c) => c.charCodeAt(0));
+    return SecretKey.deserialize(bytes);
+}
+/**
+ * Deletes a key from the keystore.
+ *
+ * @param keyId - The ID of the key to delete
+ */
+export function deleteKey(keyId) {
+    const keys = loadKeys();
+    const filtered = keys.filter((k) => k.id !== keyId);
+    saveKeys(filtered);
+}
+/**
+ * Gets a key by ID.
+ *
+ * @param keyId - The ID of the key to get
+ * @returns The key entry or undefined if not found
+ */
+export function getKey(keyId) {
+    const keys = loadKeys();
+    return keys.find((k) => k.id === keyId);
+}
+/**
+ * Renames a key.
+ *
+ * @param keyId - The ID of the key to rename
+ * @param newName - The new name for the key
+ */
+export function renameKey(keyId, newName) {
+    const keys = loadKeys();
+    const key = keys.find((k) => k.id === keyId);
+    if (key) {
+        key.name = newName;
+        saveKeys(keys);
+    }
+}
+/**
+ * Clears all keys from the keystore.
+ */
+export function clearKeystore() {
+    localStorage.removeItem(KEYSTORE_STORAGE_KEY);
+}
+//# sourceMappingURL=keystore.js.map

package/dist/keystore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keystore.js","sourceRoot":"","sources":["../src/keystore.ts"],"names":[],"mappings":"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"}

package/dist/miden.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Miden SDK utilities.
+ */
+/**
+ * Clear all IndexedDB databases.
+ * Useful for resetting the Miden client state in browser environments.
+ */
+export declare function clearIndexedDB(): Promise<void>;
+//# sourceMappingURL=miden.d.ts.map

package/dist/miden.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"miden.d.ts","sourceRoot":"","sources":["../src/miden.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH;;;GAGG;AACH,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAkBpD"}

package/dist/miden.js

@@ -0,0 +1,26 @@
+/**
+ * Miden SDK utilities.
+ */
+// =============================================================================
+// IndexedDB Utilities
+// =============================================================================
+/**
+ * Clear all IndexedDB databases.
+ * Useful for resetting the Miden client state in browser environments.
+ */
+export async function clearIndexedDB() {
+    if (typeof indexedDB === 'undefined') {
+        return; // Not in browser environment
+    }
+    const databases = await indexedDB.databases();
+    const deletePromises = databases
+        .filter((db) => db.name)
+        .map((db) => new Promise((resolve, reject) => {
+        const request = indexedDB.deleteDatabase(db.name);
+        request.onsuccess = () => resolve();
+        request.onerror = () => reject(request.error);
+        request.onblocked = () => resolve();
+    }));
+    await Promise.all(deletePromises);
+}
+//# sourceMappingURL=miden.js.map

package/dist/miden.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"miden.js","sourceRoot":"","sources":["../src/miden.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc;IAClC,IAAI,OAAO,SAAS,KAAK,WAAW,EAAE,CAAC;QACrC,OAAO,CAAC,6BAA6B;IACvC,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,SAAS,CAAC,SAAS,EAAE,CAAC;IAC9C,MAAM,cAAc,GAAG,SAAS;SAC7B,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC;SACvB,GAAG,CACF,CAAC,EAAE,EAAE,EAAE,CACL,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACpC,MAAM,OAAO,GAAG,SAAS,CAAC,cAAc,CAAC,EAAE,CAAC,IAAK,CAAC,CAAC;QACnD,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QACpC,OAAO,CAAC,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;QAC9C,OAAO,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IACtC,CAAC,CAAC,CACL,CAAC;IACJ,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;AACpC,CAAC"}

package/dist/multisig/helpers.d.ts

@@ -0,0 +1,4 @@
+import { Account } from '@demox-labs/miden-sdk';
+export declare function computeCommitmentFromTxSummary(txSummaryBase64: string): string;
+export declare function accountIdToHex(account: Account): string;
+//# sourceMappingURL=helpers.d.ts.map

package/dist/multisig/helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/multisig/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAA4B,MAAM,uBAAuB,CAAC;AAG1E,wBAAgB,8BAA8B,CAAC,eAAe,EAAE,MAAM,GAAG,MAAM,CAK9E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAWvD"}

package/dist/multisig/helpers.js

@@ -0,0 +1,21 @@
+import { TransactionSummary } from '@demox-labs/miden-sdk';
+import { base64ToUint8Array } from '../utils/encoding.js';
+export function computeCommitmentFromTxSummary(txSummaryBase64) {
+    const bytes = base64ToUint8Array(txSummaryBase64);
+    const summary = TransactionSummary.deserialize(bytes);
+    const commitment = summary.toCommitment();
+    return commitment.toHex();
+}
+export function accountIdToHex(account) {
+    const accountId = account.id();
+    const str = accountId.toString();
+    if (str.startsWith('0x') || str.startsWith('0X')) {
+        return str;
+    }
+    const prefix = accountId.prefix().asInt();
+    const suffix = accountId.suffix().asInt();
+    const prefixHex = prefix.toString(16).padStart(16, '0');
+    const suffixHex = suffix.toString(16).padStart(16, '0');
+    return `0x${prefixHex}${suffixHex.slice(0, 14)}`;
+}
+//# sourceMappingURL=helpers.js.map

package/dist/multisig/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/multisig/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,kBAAkB,EAAQ,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,UAAU,8BAA8B,CAAC,eAAuB;IACpE,MAAM,KAAK,GAAG,kBAAkB,CAAC,eAAe,CAAC,CAAC;IAClD,MAAM,OAAO,GAAG,kBAAkB,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,UAAU,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC;IAC1C,OAAO,UAAU,CAAC,KAAK,EAAE,CAAC;AAC5B,CAAC;AAED,MAAM,UAAU,cAAc,CAAC,OAAgB;IAC7C,MAAM,SAAS,GAAG,OAAO,CAAC,EAAE,EAAE,CAAC;IAC/B,MAAM,GAAG,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC;IACjC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;QACjD,OAAO,GAAG,CAAC;IACb,CAAC;IACD,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;IAC1C,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC;IAC1C,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IACxD,OAAO,KAAK,SAAS,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AACnD,CAAC"}

package/dist/multisig/helpers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=helpers.test.d.ts.map

package/dist/multisig/helpers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.test.d.ts","sourceRoot":"","sources":["../../src/multisig/helpers.test.ts"],"names":[],"mappings":""}