@openzeppelin/miden-multisig-client 0.12.6

package/dist/account.d.ts

@@ -0,0 +1,104 @@
+/**
+ * MultisigAccount wrapper class.
+ *
+ * Provides a typed wrapper around Miden accounts with multisig + PSM configuration.
+ * Mirrors the Rust MultisigAccount struct from miden-multisig-client.
+ */
+/**
+ * Wrapper around a Miden account with multisig + PSM configuration.
+ *
+ * Provides typed accessors for storage slots following the layout:
+ *
+ * **Multisig Component (4 slots):**
+ * - Slot 0: Threshold config `[threshold, num_signers, 0, 0]`
+ * - Slot 1: Signer public keys map `[index, 0, 0, 0] => COMMITMENT`
+ * - Slot 2: Executed transactions map (for replay protection)
+ * - Slot 3: Procedure threshold overrides map
+ *
+ * **PSM Component (2 slots, offset by 4):**
+ * - Slot 4: PSM selector `[1, 0, 0, 0]` (ON) or `[0, 0, 0, 0]` (OFF)
+ * - Slot 5: PSM public key map `[0, 0, 0, 0] => PSM_COMMITMENT`
+ */
+export declare class MultisigAccount {
+    /**
+     * The underlying Miden account (from SDK).
+     */
+    readonly account: unknown;
+    /**
+     * The account ID as hex string.
+     */
+    readonly id: string;
+    /**
+     * The PSM server endpoint for this account.
+     */
+    readonly psmEndpoint: string;
+    /**
+     * Configuration values extracted from storage.
+     */
+    private readonly _threshold;
+    private readonly _numSigners;
+    private readonly _cosignerCommitments;
+    private readonly _psmEnabled;
+    private readonly _psmCommitment;
+    /**
+     * Creates a MultisigAccount wrapper.
+     *
+     * @param account - The underlying Miden account
+     * @param id - The account ID
+     * @param psmEndpoint - The PSM server endpoint
+     * @param config - Pre-extracted configuration
+     */
+    constructor(account: unknown, id: string, psmEndpoint: string, config: {
+        threshold: number;
+        numSigners: number;
+        cosignerCommitments: string[];
+        psmEnabled: boolean;
+        psmCommitment: string;
+    });
+    /**
+     * The number of signatures required to authorize a transaction.
+     */
+    get threshold(): number;
+    /**
+     * The number of cosigners.
+     */
+    get numSigners(): number;
+    /**
+     * The public key commitments of all cosigners.
+     */
+    get cosignerCommitments(): readonly string[];
+    /**
+     * Whether PSM verification is enabled.
+     */
+    get psmEnabled(): boolean;
+    /**
+     * The PSM server's public key commitment.
+     */
+    get psmCommitment(): string;
+    /**
+     * Checks if a commitment belongs to a cosigner of this account.
+     *
+     * @param commitment - The commitment to check (hex string)
+     * @returns True if the commitment is a cosigner
+     */
+    isCosigner(commitment: string): boolean;
+    /**
+     * Creates a MultisigAccount from a newly created account and config.
+     *
+     * @param account - The created Miden account
+     * @param id - The account ID
+     * @param psmEndpoint - The PSM server endpoint
+     * @param config - The multisig configuration used to create the account
+     */
+    static fromConfig(account: unknown, id: string, psmEndpoint: string, config: {
+        threshold: number;
+        signerCommitments: string[];
+        psmCommitment: string;
+        psmEnabled?: boolean;
+    }): MultisigAccount;
+    /**
+     * Serializes the account configuration to JSON.
+     */
+    toJSON(): object;
+}
+//# sourceMappingURL=account.d.ts.map

package/dist/account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.d.ts","sourceRoot":"","sources":["../src/account.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAMH;;;;;;;;;;;;;;GAcG;AACH,qBAAa,eAAe;IAC1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAE7B;;OAEG;IACH,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAS;IACpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAU;IACtC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IAExC;;;;;;;OAOG;gBAED,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,mBAAmB,EAAE,MAAM,EAAE,CAAC;QAC9B,UAAU,EAAE,OAAO,CAAC;QACpB,aAAa,EAAE,MAAM,CAAC;KACvB;IAYH;;OAEG;IACH,IAAI,SAAS,IAAI,MAAM,CAEtB;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,MAAM,CAEvB;IAED;;OAEG;IACH,IAAI,mBAAmB,IAAI,SAAS,MAAM,EAAE,CAE3C;IAED;;OAEG;IACH,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED;;;;;OAKG;IACH,UAAU,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO;IAOvC;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CACf,OAAO,EAAE,OAAO,EAChB,EAAE,EAAE,MAAM,EACV,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE;QACN,SAAS,EAAE,MAAM,CAAC;QAClB,iBAAiB,EAAE,MAAM,EAAE,CAAC;QAC5B,aAAa,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,OAAO,CAAC;KACtB,GACA,eAAe;IAUlB;;OAEG;IACH,MAAM,IAAI,MAAM;CAWjB"}

package/dist/account.js

@@ -0,0 +1,136 @@
+/**
+ * MultisigAccount wrapper class.
+ *
+ * Provides a typed wrapper around Miden accounts with multisig + PSM configuration.
+ * Mirrors the Rust MultisigAccount struct from miden-multisig-client.
+ */
+// =============================================================================
+// MultisigAccount Class
+// =============================================================================
+/**
+ * Wrapper around a Miden account with multisig + PSM configuration.
+ *
+ * Provides typed accessors for storage slots following the layout:
+ *
+ * **Multisig Component (4 slots):**
+ * - Slot 0: Threshold config `[threshold, num_signers, 0, 0]`
+ * - Slot 1: Signer public keys map `[index, 0, 0, 0] => COMMITMENT`
+ * - Slot 2: Executed transactions map (for replay protection)
+ * - Slot 3: Procedure threshold overrides map
+ *
+ * **PSM Component (2 slots, offset by 4):**
+ * - Slot 4: PSM selector `[1, 0, 0, 0]` (ON) or `[0, 0, 0, 0]` (OFF)
+ * - Slot 5: PSM public key map `[0, 0, 0, 0] => PSM_COMMITMENT`
+ */
+export class MultisigAccount {
+    /**
+     * The underlying Miden account (from SDK).
+     */
+    account;
+    /**
+     * The account ID as hex string.
+     */
+    id;
+    /**
+     * The PSM server endpoint for this account.
+     */
+    psmEndpoint;
+    /**
+     * Configuration values extracted from storage.
+     */
+    _threshold;
+    _numSigners;
+    _cosignerCommitments;
+    _psmEnabled;
+    _psmCommitment;
+    /**
+     * Creates a MultisigAccount wrapper.
+     *
+     * @param account - The underlying Miden account
+     * @param id - The account ID
+     * @param psmEndpoint - The PSM server endpoint
+     * @param config - Pre-extracted configuration
+     */
+    constructor(account, id, psmEndpoint, config) {
+        this.account = account;
+        this.id = id;
+        this.psmEndpoint = psmEndpoint;
+        this._threshold = config.threshold;
+        this._numSigners = config.numSigners;
+        this._cosignerCommitments = config.cosignerCommitments;
+        this._psmEnabled = config.psmEnabled;
+        this._psmCommitment = config.psmCommitment;
+    }
+    /**
+     * The number of signatures required to authorize a transaction.
+     */
+    get threshold() {
+        return this._threshold;
+    }
+    /**
+     * The number of cosigners.
+     */
+    get numSigners() {
+        return this._numSigners;
+    }
+    /**
+     * The public key commitments of all cosigners.
+     */
+    get cosignerCommitments() {
+        return this._cosignerCommitments;
+    }
+    /**
+     * Whether PSM verification is enabled.
+     */
+    get psmEnabled() {
+        return this._psmEnabled;
+    }
+    /**
+     * The PSM server's public key commitment.
+     */
+    get psmCommitment() {
+        return this._psmCommitment;
+    }
+    /**
+     * Checks if a commitment belongs to a cosigner of this account.
+     *
+     * @param commitment - The commitment to check (hex string)
+     * @returns True if the commitment is a cosigner
+     */
+    isCosigner(commitment) {
+        const normalizedCommitment = commitment.toLowerCase().replace(/^0x/, '');
+        return this._cosignerCommitments.some((c) => c.toLowerCase().replace(/^0x/, '') === normalizedCommitment);
+    }
+    /**
+     * Creates a MultisigAccount from a newly created account and config.
+     *
+     * @param account - The created Miden account
+     * @param id - The account ID
+     * @param psmEndpoint - The PSM server endpoint
+     * @param config - The multisig configuration used to create the account
+     */
+    static fromConfig(account, id, psmEndpoint, config) {
+        return new MultisigAccount(account, id, psmEndpoint, {
+            threshold: config.threshold,
+            numSigners: config.signerCommitments.length,
+            cosignerCommitments: [...config.signerCommitments],
+            psmEnabled: config.psmEnabled !== false,
+            psmCommitment: config.psmCommitment,
+        });
+    }
+    /**
+     * Serializes the account configuration to JSON.
+     */
+    toJSON() {
+        return {
+            id: this.id,
+            psmEndpoint: this.psmEndpoint,
+            threshold: this._threshold,
+            numSigners: this._numSigners,
+            cosignerCommitments: this._cosignerCommitments,
+            psmEnabled: this._psmEnabled,
+            psmCommitment: this._psmCommitment,
+        };
+    }
+}
+//# sourceMappingURL=account.js.map

package/dist/account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account.js","sourceRoot":"","sources":["../src/account.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF;;;;;;;;;;;;;;GAcG;AACH,MAAM,OAAO,eAAe;IAC1B;;OAEG;IACM,OAAO,CAAU;IAE1B;;OAEG;IACM,EAAE,CAAS;IAEpB;;OAEG;IACM,WAAW,CAAS;IAE7B;;OAEG;IACc,UAAU,CAAS;IACnB,WAAW,CAAS;IACpB,oBAAoB,CAAW;IAC/B,WAAW,CAAU;IACrB,cAAc,CAAS;IAExC;;;;;;;OAOG;IACH,YACE,OAAgB,EAChB,EAAU,EACV,WAAmB,EACnB,MAMC;QAED,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC,mBAAmB,CAAC;QACvD,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,UAAU,CAAC;QACrC,IAAI,CAAC,cAAc,GAAG,MAAM,CAAC,aAAa,CAAC;IAC7C,CAAC;IAED;;OAEG;IACH,IAAI,SAAS;QACX,OAAO,IAAI,CAAC,UAAU,CAAC;IACzB,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,mBAAmB;QACrB,OAAO,IAAI,CAAC,oBAAoB,CAAC;IACnC,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAC;IAC7B,CAAC;IAED;;;;;OAKG;IACH,UAAU,CAAC,UAAkB;QAC3B,MAAM,oBAAoB,GAAG,UAAU,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACzE,OAAO,IAAI,CAAC,oBAAoB,CAAC,IAAI,CACnC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,oBAAoB,CACnE,CAAC;IACJ,CAAC;IAED;;;;;;;OAOG;IACH,MAAM,CAAC,UAAU,CACf,OAAgB,EAChB,EAAU,EACV,WAAmB,EACnB,MAKC;QAED,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,EAAE,EAAE,WAAW,EAAE;YACnD,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,UAAU,EAAE,MAAM,CAAC,iBAAiB,CAAC,MAAM;YAC3C,mBAAmB,EAAE,CAAC,GAAG,MAAM,CAAC,iBAAiB,CAAC;YAClD,UAAU,EAAE,MAAM,CAAC,UAAU,KAAK,KAAK;YACvC,aAAa,EAAE,MAAM,CAAC,aAAa;SACpC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM;QACJ,OAAO;YACL,EAAE,EAAE,IAAI,CAAC,EAAE;YACX,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,UAAU;YAC1B,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,mBAAmB,EAAE,IAAI,CAAC,oBAAoB;YAC9C,UAAU,EAAE,IAAI,CAAC,WAAW;YAC5B,aAAa,EAAE,IAAI,CAAC,cAAc;SACnC,CAAC;IACJ,CAAC;CACF"}

package/dist/builder.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Builder pattern for constructing MultisigClient instances.
+ *
+ * This mirrors the Rust MultisigClientBuilder pattern, providing a fluent API
+ * for client construction.
+ */
+import { MultisigClient } from './client.js';
+import type { Signer } from './types.js';
+/**
+ * Builder for constructing MultisigClient instances.
+ *
+ * Provides a fluent API for configuring and creating clients.
+ *
+ * @example
+ * ```typescript
+ * const client = await MultisigClientBuilder.create()
+ *   .psmEndpoint('http://localhost:8080')
+ *   .withSigner(signer)
+ *   .build();
+ * ```
+ */
+export declare class MultisigClientBuilder {
+    private _psmEndpoint;
+    private _signer;
+    /**
+     * Creates a new builder instance.
+     */
+    static create(): MultisigClientBuilder;
+    /**
+     * Sets the PSM server endpoint.
+     *
+     * @param endpoint - The PSM server URL (e.g., 'http://localhost:8080')
+     */
+    psmEndpoint(endpoint: string): this;
+    /**
+     * Sets the signer.
+     *
+     * @param signer - A Signer instance (created via createSignerFromSecretKey)
+     */
+    withSigner(signer: Signer): this;
+    /**
+     * Builds and returns the MultisigClient.
+     *
+     * @throws Error if required configuration is missing
+     */
+    build(): MultisigClient;
+    /**
+     * Builds the client asynchronously.
+     *
+     * Currently just wraps build(), but allows for future async initialization.
+     */
+    buildAsync(): Promise<MultisigClient>;
+}
+//# sourceMappingURL=builder.d.ts.map

package/dist/builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.d.ts","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAA6B,MAAM,aAAa,CAAC;AACxE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAMzC;;;;;;;;;;;;GAYG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,OAAO,CAAuB;IAEtC;;OAEG;IACH,MAAM,CAAC,MAAM,IAAI,qBAAqB;IAItC;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKnC;;;;OAIG;IACH,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAKhC;;;;OAIG;IACH,KAAK,IAAI,cAAc;IAgBvB;;;;OAIG;IACG,UAAU,IAAI,OAAO,CAAC,cAAc,CAAC;CAG5C"}

package/dist/builder.js

@@ -0,0 +1,78 @@
+/**
+ * Builder pattern for constructing MultisigClient instances.
+ *
+ * This mirrors the Rust MultisigClientBuilder pattern, providing a fluent API
+ * for client construction.
+ */
+import { MultisigClient } from './client.js';
+// =============================================================================
+// Builder
+// =============================================================================
+/**
+ * Builder for constructing MultisigClient instances.
+ *
+ * Provides a fluent API for configuring and creating clients.
+ *
+ * @example
+ * ```typescript
+ * const client = await MultisigClientBuilder.create()
+ *   .psmEndpoint('http://localhost:8080')
+ *   .withSigner(signer)
+ *   .build();
+ * ```
+ */
+export class MultisigClientBuilder {
+    _psmEndpoint = null;
+    _signer = null;
+    /**
+     * Creates a new builder instance.
+     */
+    static create() {
+        return new MultisigClientBuilder();
+    }
+    /**
+     * Sets the PSM server endpoint.
+     *
+     * @param endpoint - The PSM server URL (e.g., 'http://localhost:8080')
+     */
+    psmEndpoint(endpoint) {
+        this._psmEndpoint = endpoint;
+        return this;
+    }
+    /**
+     * Sets the signer.
+     *
+     * @param signer - A Signer instance (created via createSignerFromSecretKey)
+     */
+    withSigner(signer) {
+        this._signer = signer;
+        return this;
+    }
+    /**
+     * Builds and returns the MultisigClient.
+     *
+     * @throws Error if required configuration is missing
+     */
+    build() {
+        if (!this._psmEndpoint) {
+            throw new Error('PSM endpoint is required. Call psmEndpoint() first.');
+        }
+        if (!this._signer) {
+            throw new Error('Signer is required. Call withSigner() first.');
+        }
+        const config = {
+            psmEndpoint: this._psmEndpoint,
+            signer: this._signer,
+        };
+        return new MultisigClient(config);
+    }
+    /**
+     * Builds the client asynchronously.
+     *
+     * Currently just wraps build(), but allows for future async initialization.
+     */
+    async buildAsync() {
+        return this.build();
+    }
+}
+//# sourceMappingURL=builder.js.map

package/dist/builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"builder.js","sourceRoot":"","sources":["../src/builder.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAA6B,MAAM,aAAa,CAAC;AAGxE,gFAAgF;AAChF,UAAU;AACV,gFAAgF;AAEhF;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,qBAAqB;IACxB,YAAY,GAAkB,IAAI,CAAC;IACnC,OAAO,GAAkB,IAAI,CAAC;IAEtC;;OAEG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,qBAAqB,EAAE,CAAC;IACrC,CAAC;IAED;;;;OAIG;IACH,WAAW,CAAC,QAAgB;QAC1B,IAAI,CAAC,YAAY,GAAG,QAAQ,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,MAAc;QACvB,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAClE,CAAC;QAED,MAAM,MAAM,GAAyB;YACnC,WAAW,EAAE,IAAI,CAAC,YAAY;YAC9B,MAAM,EAAE,IAAI,CAAC,OAAO;SACrB,CAAC;QAEF,OAAO,IAAI,cAAc,CAAC,MAAM,CAAC,CAAC;IACpC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;CACF"}

package/dist/client.d.ts

@@ -0,0 +1,73 @@
+/**
+ * MultisigClient - Factory for creating and loading multisig accounts.
+ *
+ * This is the main entry point for the multisig SDK. It provides methods
+ * to create new multisig accounts and load existing ones.
+ */
+import { type WebClient } from '@demox-labs/miden-sdk';
+import { PsmHttpClient } from '@openzeppelin/psm-client';
+import { Multisig } from './multisig.js';
+import type { MultisigConfig, Signer } from './types.js';
+/**
+ * Configuration for MultisigClient.
+ */
+export interface MultisigClientConfig {
+    /** PSM server endpoint */
+    psmEndpoint?: string;
+}
+/**
+ * Client for creating and loading multisig accounts.
+ *
+ * @example
+ * ```typescript
+ * import { MultisigClient, FalconSigner } from '@openzeppelin/miden-multisig-client';
+ * import { WebClient, SecretKey } from '@demox-labs/miden-sdk';
+ *
+ * // Initialize
+ * const webClient = await WebClient.createClient('https://rpc.testnet.miden.io:443');
+ * const secretKey = SecretKey.rpoFalconWithRNG(seed);
+ * const signer = new FalconSigner(secretKey);
+ *
+ * // Create client
+ * const client = new MultisigClient(webClient, { psmEndpoint: 'http://localhost:3000' });
+ *
+ * // Get PSM pubkey for config
+ * const psmCommitment = await client.psmClient.getPubkey();
+ *
+ * // Create multisig
+ * const config = { threshold: 2, signerCommitments: [...], psmCommitment };
+ * const multisig = await client.create(config, signer);
+ * ```
+ */
+export declare class MultisigClient {
+    private readonly webClient;
+    private _psmClient;
+    constructor(webClient: WebClient, config?: MultisigClientConfig);
+    /**
+     * Change the PSM endpoint.
+     *
+     * @param endpoint - The new PSM server endpoint URL
+     */
+    setPsmEndpoint(endpoint: string): void;
+    /**
+     * Access the internal PSM client.
+     */
+    get psmClient(): PsmHttpClient;
+    /**
+     * Create a new multisig account.
+     *
+     * @param config - Multisig configuration (threshold, signers, PSM commitment)
+     * @param signer - The signer for this client (one of the cosigners)
+     * @returns A Multisig instance wrapping the created account
+     */
+    create(config: MultisigConfig, signer: Signer): Promise<Multisig>;
+    /**
+     * Load an existing multisig account from PSM.
+     *
+     * @param accountId - The account ID to load
+     * @param signer - The signer for this client
+     * @returns A Multisig instance for the loaded account
+     */
+    load(accountId: string, signer: Signer): Promise<Multisig>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,SAAS,EAAsB,MAAM,uBAAuB,CAAC;AAC3E,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAEzD;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,0BAA0B;IAC1B,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;IACtC,OAAO,CAAC,UAAU,CAAgB;gBAEtB,SAAS,EAAE,SAAS,EAAE,MAAM,GAAE,oBAAyB;IAKnE;;;;OAIG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAItC;;OAEG;IACH,IAAI,SAAS,IAAI,aAAa,CAE7B;IAED;;;;;;OAMG;IACG,MAAM,CAAC,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAQvE;;;;;;OAMG;IACG,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;CAmCjE"}

package/dist/client.js

@@ -0,0 +1,104 @@
+/**
+ * MultisigClient - Factory for creating and loading multisig accounts.
+ *
+ * This is the main entry point for the multisig SDK. It provides methods
+ * to create new multisig accounts and load existing ones.
+ */
+import { Account, AccountId } from '@demox-labs/miden-sdk';
+import { PsmHttpClient } from '@openzeppelin/psm-client';
+import { Multisig } from './multisig.js';
+import { createMultisigAccount } from './account/index.js';
+import { AccountInspector } from './inspector.js';
+/**
+ * Client for creating and loading multisig accounts.
+ *
+ * @example
+ * ```typescript
+ * import { MultisigClient, FalconSigner } from '@openzeppelin/miden-multisig-client';
+ * import { WebClient, SecretKey } from '@demox-labs/miden-sdk';
+ *
+ * // Initialize
+ * const webClient = await WebClient.createClient('https://rpc.testnet.miden.io:443');
+ * const secretKey = SecretKey.rpoFalconWithRNG(seed);
+ * const signer = new FalconSigner(secretKey);
+ *
+ * // Create client
+ * const client = new MultisigClient(webClient, { psmEndpoint: 'http://localhost:3000' });
+ *
+ * // Get PSM pubkey for config
+ * const psmCommitment = await client.psmClient.getPubkey();
+ *
+ * // Create multisig
+ * const config = { threshold: 2, signerCommitments: [...], psmCommitment };
+ * const multisig = await client.create(config, signer);
+ * ```
+ */
+export class MultisigClient {
+    webClient;
+    _psmClient;
+    constructor(webClient, config = {}) {
+        this.webClient = webClient;
+        this._psmClient = new PsmHttpClient(config.psmEndpoint ?? 'http://localhost:3000');
+    }
+    /**
+     * Change the PSM endpoint.
+     *
+     * @param endpoint - The new PSM server endpoint URL
+     */
+    setPsmEndpoint(endpoint) {
+        this._psmClient = new PsmHttpClient(endpoint);
+    }
+    /**
+     * Access the internal PSM client.
+     */
+    get psmClient() {
+        return this._psmClient;
+    }
+    /**
+     * Create a new multisig account.
+     *
+     * @param config - Multisig configuration (threshold, signers, PSM commitment)
+     * @param signer - The signer for this client (one of the cosigners)
+     * @returns A Multisig instance wrapping the created account
+     */
+    async create(config, signer) {
+        this._psmClient.setSigner(signer);
+        const { account } = await createMultisigAccount(this.webClient, config);
+        return new Multisig(account, config, this._psmClient, signer, this.webClient);
+    }
+    /**
+     * Load an existing multisig account from PSM.
+     *
+     * @param accountId - The account ID to load
+     * @param signer - The signer for this client
+     * @returns A Multisig instance for the loaded account
+     */
+    async load(accountId, signer) {
+        this._psmClient.setSigner(signer);
+        const stateResponse = await this._psmClient.getState(accountId);
+        const accountBase64 = stateResponse.stateJson.data;
+        if (!accountBase64) {
+            throw new Error('No account data found in PSM state');
+        }
+        const binaryString = atob(accountBase64);
+        const accountBytes = new Uint8Array(binaryString.length);
+        for (let i = 0; i < binaryString.length; i++) {
+            accountBytes[i] = binaryString.charCodeAt(i);
+        }
+        const account = Account.deserialize(accountBytes);
+        const detected = AccountInspector.fromAccount(account);
+        const config = {
+            threshold: detected.threshold,
+            signerCommitments: detected.signerCommitments,
+            psmCommitment: detected.psmCommitment ?? '',
+            psmEnabled: detected.psmEnabled,
+            procedureThresholds: Array.from(detected.procedureThresholds.entries()).map(([procedure, threshold]) => ({ procedure, threshold })),
+        };
+        const existingAccount = await this.webClient.getAccount(AccountId.fromHex(accountId));
+        if (!existingAccount) {
+            await this.webClient.newAccount(account, true);
+        }
+        return new Multisig(null, config, this._psmClient, signer, this.webClient, accountId);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/client.test.d.ts

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

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

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