@openzeppelin/miden-multisig-client 0.13.0 → 0.13.1

package/dist/transaction/rpoRandomCoin.test.js

@@ -0,0 +1,52 @@
+import { describe, expect, it, vi } from 'vitest';
+const { mockHashElements, seedFelts } = vi.hoisted(() => {
+    const seedFelts = [
+        { id: 'seed-0' },
+        { id: 'seed-1' },
+        { id: 'seed-2' },
+        { id: 'seed-3' },
+    ];
+    return {
+        mockHashElements: vi.fn().mockReturnValue({ id: 'drawn-word' }),
+        seedFelts,
+    };
+});
+vi.mock('@miden-sdk/miden-sdk', () => {
+    class Felt {
+        value;
+        constructor(value) {
+            this.value = value;
+        }
+    }
+    class FeltArray {
+        values;
+        constructor(values) {
+            this.values = values;
+        }
+    }
+    return {
+        Felt,
+        FeltArray,
+        Rpo256: {
+            hashElements: mockHashElements,
+        },
+    };
+});
+import { RpoRandomCoin } from './rpoRandomCoin.js';
+describe('RpoRandomCoin', () => {
+    it('drawWord hashes seed felts plus four zero felts', () => {
+        const seed = { toFelts: () => seedFelts };
+        const coin = new RpoRandomCoin(seed);
+        const drawn = coin.drawWord();
+        expect(drawn).toEqual({ id: 'drawn-word' });
+        expect(mockHashElements).toHaveBeenCalledTimes(1);
+        const [feltArrayArg] = mockHashElements.mock.calls[0];
+        const values = feltArrayArg.values;
+        expect(values).toHaveLength(8);
+        expect(values.slice(0, 4)).toEqual(seedFelts);
+        for (const felt of values.slice(4)) {
+            expect(felt.value).toBe(0n);
+        }
+    });
+});
+//# sourceMappingURL=rpoRandomCoin.test.js.map

package/dist/transaction/rpoRandomCoin.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpoRandomCoin.test.js","sourceRoot":"","sources":["../../src/transaction/rpoRandomCoin.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAGlD,MAAM,EAAE,gBAAgB,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE;IACtD,MAAM,SAAS,GAAG;QAChB,EAAE,EAAE,EAAE,QAAQ,EAAE;QAChB,EAAE,EAAE,EAAE,QAAQ,EAAE;QAChB,EAAE,EAAE,EAAE,QAAQ,EAAE;QAChB,EAAE,EAAE,EAAE,QAAQ,EAAE;KACjB,CAAC;IAEF,OAAO;QACL,gBAAgB,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,eAAe,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC;QAC/D,SAAS;KACV,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,EAAE,CAAC,IAAI,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACnC,MAAM,IAAI;QACC,KAAK,CAAS;QAEvB,YAAY,KAAa;YACvB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACrB,CAAC;KACF;IAED,MAAM,SAAS;QACJ,MAAM,CAAY;QAE3B,YAAY,MAAiB;YAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACvB,CAAC;KACF;IAED,OAAO;QACL,IAAI;QACJ,SAAS;QACT,MAAM,EAAE;YACN,YAAY,EAAE,gBAAgB;SAC/B;KACF,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,QAAQ,CAAC,eAAe,EAAE,GAAG,EAAE;IAC7B,EAAE,CAAC,iDAAiD,EAAE,GAAG,EAAE;QACzD,MAAM,IAAI,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,SAAS,EAAqB,CAAC;QAC7D,MAAM,IAAI,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAE9B,MAAM,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,EAAE,EAAE,EAAE,YAAY,EAAE,CAAC,CAAC;QAC5C,MAAM,CAAC,gBAAgB,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;QAElD,MAAM,CAAC,YAAY,CAAC,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAA4B,CAAC;QACjF,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC;QAEnC,MAAM,CAAC,MAAM,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;QAC/B,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC9C,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACnC,MAAM,CAAE,IAA0B,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACrD,CAAC;IACH,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/utils/state-validation.d.ts

@@ -0,0 +1,5 @@
+import type { Account, AccountId, WebClient } from '@miden-sdk/miden-sdk';
+export declare function fetchNormalizedOnChainCommitment(webClient: WebClient, accountId: AccountId): Promise<string>;
+export declare function verifyStateCommitmentAgainstOnChain(accountId: AccountId, stateCommitmentHex: string, onChainCommitmentHex: string): void;
+export declare function verifyDeserializedAccountMatchesState(accountId: AccountId, stateCommitmentHex: string, account: Account, onChainCommitmentHex: string): void;
+//# sourceMappingURL=state-validation.d.ts.map

package/dist/utils/state-validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-validation.d.ts","sourceRoot":"","sources":["../../src/utils/state-validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAmB1E,wBAAsB,gCAAgC,CACpD,SAAS,EAAE,SAAS,EACpB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,MAAM,CAAC,CAGjB;AAED,wBAAgB,mCAAmC,CACjD,SAAS,EAAE,SAAS,EACpB,kBAAkB,EAAE,MAAM,EAC1B,oBAAoB,EAAE,MAAM,GAC3B,IAAI,CAON;AAED,wBAAgB,qCAAqC,CACnD,SAAS,EAAE,SAAS,EACpB,kBAAkB,EAAE,MAAM,EAC1B,OAAO,EAAE,OAAO,EAChB,oBAAoB,EAAE,MAAM,GAC3B,IAAI,CAgBN"}

package/dist/utils/state-validation.js

@@ -0,0 +1,30 @@
+import { normalizeHexWord } from './encoding.js';
+function asAccountDetailsReader(webClient) {
+    const candidate = webClient;
+    if (typeof candidate.getAccountDetails !== 'function') {
+        throw new Error('WebClient does not expose getAccountDetails');
+    }
+    return candidate;
+}
+export async function fetchNormalizedOnChainCommitment(webClient, accountId) {
+    const fetchedAccount = await asAccountDetailsReader(webClient).getAccountDetails(accountId);
+    return normalizeHexWord(fetchedAccount.commitment().toHex());
+}
+export function verifyStateCommitmentAgainstOnChain(accountId, stateCommitmentHex, onChainCommitmentHex) {
+    const normalizedStateCommitment = normalizeHexWord(stateCommitmentHex);
+    if (normalizedStateCommitment !== onChainCommitmentHex) {
+        throw new Error(`PSM state commitment does not match on-chain commitment for account ${accountId.toString()}`);
+    }
+}
+export function verifyDeserializedAccountMatchesState(accountId, stateCommitmentHex, account, onChainCommitmentHex) {
+    if (account.id().toString().toLowerCase() !== accountId.toString().toLowerCase()) {
+        throw new Error(`PSM state account ID ${account.id().toString()} does not match requested account ID ${accountId.toString()}`);
+    }
+    const normalizedStateCommitment = normalizeHexWord(stateCommitmentHex);
+    const normalizedAccountCommitment = normalizeHexWord(account.commitment().toHex());
+    if (normalizedAccountCommitment !== normalizedStateCommitment) {
+        throw new Error(`PSM state commitment does not match deserialized account commitment for account ${accountId.toString()}`);
+    }
+    verifyStateCommitmentAgainstOnChain(accountId, normalizedStateCommitment, onChainCommitmentHex);
+}
+//# sourceMappingURL=state-validation.js.map

package/dist/utils/state-validation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-validation.js","sourceRoot":"","sources":["../../src/utils/state-validation.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAUjD,SAAS,sBAAsB,CAAC,SAAoB;IAClD,MAAM,SAAS,GAAG,SAAqD,CAAC;IACxE,IAAI,OAAO,SAAS,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;QACtD,MAAM,IAAI,KAAK,CAAC,6CAA6C,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,SAAiC,CAAC;AAC3C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,gCAAgC,CACpD,SAAoB,EACpB,SAAoB;IAEpB,MAAM,cAAc,GAAG,MAAM,sBAAsB,CAAC,SAAS,CAAC,CAAC,iBAAiB,CAAC,SAAS,CAAC,CAAC;IAC5F,OAAO,gBAAgB,CAAC,cAAc,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;AAC/D,CAAC;AAED,MAAM,UAAU,mCAAmC,CACjD,SAAoB,EACpB,kBAA0B,EAC1B,oBAA4B;IAE5B,MAAM,yBAAyB,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;IACvE,IAAI,yBAAyB,KAAK,oBAAoB,EAAE,CAAC;QACvD,MAAM,IAAI,KAAK,CACb,uEAAuE,SAAS,CAAC,QAAQ,EAAE,EAAE,CAC9F,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qCAAqC,CACnD,SAAoB,EACpB,kBAA0B,EAC1B,OAAgB,EAChB,oBAA4B;IAE5B,IAAI,OAAO,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,KAAK,SAAS,CAAC,QAAQ,EAAE,CAAC,WAAW,EAAE,EAAE,CAAC;QACjF,MAAM,IAAI,KAAK,CACb,wBAAwB,OAAO,CAAC,EAAE,EAAE,CAAC,QAAQ,EAAE,wCAAwC,SAAS,CAAC,QAAQ,EAAE,EAAE,CAC9G,CAAC;IACJ,CAAC;IAED,MAAM,yBAAyB,GAAG,gBAAgB,CAAC,kBAAkB,CAAC,CAAC;IACvE,MAAM,2BAA2B,GAAG,gBAAgB,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC;IACnF,IAAI,2BAA2B,KAAK,yBAAyB,EAAE,CAAC;QAC9D,MAAM,IAAI,KAAK,CACb,mFAAmF,SAAS,CAAC,QAAQ,EAAE,EAAE,CAC1G,CAAC;IACJ,CAAC;IAED,mCAAmC,CAAC,SAAS,EAAE,yBAAyB,EAAE,oBAAoB,CAAC,CAAC;AAClG,CAAC"}

package/dist/utils/validation.d.ts

@@ -0,0 +1,6 @@
+import { type Account, type AccountId } from '@miden-sdk/miden-sdk';
+export declare function isMissingAccountRecordError(error: unknown): boolean;
+export declare function getOnChainCommitment(rpcEndpoint: string, accountId: AccountId): Promise<string>;
+export declare function validateStateCommitmentMatchesOnChain(accountId: AccountId, stateCommitmentHex: string, onChainCommitmentHex: string): void;
+export declare function validateAccountMatchesState(accountId: AccountId, stateCommitmentHex: string, account: Account): void;
+//# sourceMappingURL=validation.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../../src/utils/validation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,SAAS,EAAuB,MAAM,sBAAsB,CAAC;AAGzF,wBAAgB,2BAA2B,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAMnE;AAED,wBAAsB,oBAAoB,CACxC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,SAAS,GACnB,OAAO,CAAC,MAAM,CAAC,CAejB;AAED,wBAAgB,qCAAqC,CACnD,SAAS,EAAE,SAAS,EACpB,kBAAkB,EAAE,MAAM,EAC1B,oBAAoB,EAAE,MAAM,GAC3B,IAAI,CAON;AAED,wBAAgB,2BAA2B,CACzC,SAAS,EAAE,SAAS,EACpB,kBAAkB,EAAE,MAAM,EAC1B,OAAO,EAAE,OAAO,GACf,IAAI,CAyBN"}

package/dist/utils/validation.js

@@ -0,0 +1,52 @@
+import { Endpoint, RpcClient } from '@miden-sdk/miden-sdk';
+import { normalizeHexWord } from './encoding.js';
+export function isMissingAccountRecordError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return (message.includes('No account header record found for given ID') ||
+        message.includes('null pointer passed to rust'));
+}
+export async function getOnChainCommitment(rpcEndpoint, accountId) {
+    const rpcClient = new RpcClient(new Endpoint(rpcEndpoint));
+    try {
+        const fetchedAccount = await rpcClient.getAccountDetails(accountId);
+        if (!fetchedAccount) {
+            throw new Error('No account header record found for given ID');
+        }
+        return normalizeHexWord(fetchedAccount.commitment().toHex());
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes('null pointer passed to rust')) {
+            throw new Error('No account header record found for given ID');
+        }
+        throw error;
+    }
+}
+export function validateStateCommitmentMatchesOnChain(accountId, stateCommitmentHex, onChainCommitmentHex) {
+    const normalizedStateCommitment = normalizeHexWord(stateCommitmentHex);
+    if (normalizedStateCommitment !== onChainCommitmentHex) {
+        throw new Error(`PSM state commitment does not match on-chain commitment for account ${accountId.toString()}`);
+    }
+}
+export function validateAccountMatchesState(accountId, stateCommitmentHex, account) {
+    try {
+        const accountIdString = account.id().toString().toLowerCase();
+        const requestedIdString = accountId.toString().toLowerCase();
+        if (accountIdString !== requestedIdString) {
+            throw new Error(`PSM state account ID ${accountIdString} does not match requested account ID ${requestedIdString}`);
+        }
+        const normalizedStateCommitment = normalizeHexWord(stateCommitmentHex);
+        const normalizedAccountCommitment = normalizeHexWord(account.commitment().toHex());
+        if (normalizedAccountCommitment !== normalizedStateCommitment) {
+            throw new Error(`PSM state commitment does not match deserialized account commitment for account ${requestedIdString}`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        if (message.includes('null pointer passed to rust')) {
+            throw new Error('No account header record found for given ID');
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=validation.js.map

package/dist/utils/validation.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openzeppelin/miden-multisig-client",
-  "version": "0.13.0",
+  "version": "0.13.1",
   "description": "TypeScript SDK for Miden multisig accounts with PSM integration",
   "type": "module",
   "main": "./dist/index.js",
@@ -28,7 +28,7 @@
   "dependencies": {
     "@miden-sdk/miden-sdk": "^0.13.0",
     "@noble/hashes": "^2.0.1",
-    "@openzeppelin/psm-client": "^0.13.0"
+    "@openzeppelin/psm-client": "^0.13.1"
   },
   "devDependencies": {
     "typescript": "^5.7.2",

package/src/multisig/proposal/execution.ts

@@ -91,6 +91,50 @@ export async function executeProposalWorkflow(
   await submitTransaction(params.webClient, params.accountId, finalRequest);
 }
 
+
+export async function createTransactionProposalRequest(
+  params: ExecuteProposalWorkflowParams,
+): Promise<TransactionRequest> {
+  ensureProposalReady(
+    params.proposal,
+    params.threshold,
+    params.getEffectiveThreshold,
+  );
+
+  const isSwitchPsm = params.proposal.metadata.proposalType === 'switch_psm';
+  const executionSource = await resolveExecutionSource(
+    params.psm,
+    params.accountId,
+    params.proposal,
+    isSwitchPsm,
+  );
+  const executionData = prepareExecutionData(executionSource.txSummaryBase64);
+
+  const adviceMap = buildCosignerAdviceMap(
+    params.proposal,
+    params.signerCommitments,
+    executionData.txCommitmentHex,
+  );
+
+  if (!isSwitchPsm && executionSource.delta) {
+    await appendPsmAckAdvice(
+      params.psm,
+      executionSource.delta,
+      params.psmCommitment,
+      params.psmPublicKey,
+      params.signatureScheme,
+      executionData.txCommitmentHex,
+      adviceMap,
+    );
+  }
+
+  return await buildFinalRequest(
+    params,
+    executionData.saltHex,
+    adviceMap,
+  );
+}
+
 function ensureProposalReady(
   proposal: TransactionProposal,
   defaultThreshold: number,

package/src/multisig.ts

@@ -43,7 +43,7 @@ import {
   toPsmSignature,
   buildPsmSignatureFromSigner,
 } from './multisig/signing.js';
-import { executeProposalWorkflow } from './multisig/proposal/execution.js';
+import { createTransactionProposalRequest, executeProposalWorkflow } from './multisig/proposal/execution.js';
 
 export interface AccountState {
   accountId: string;
@@ -680,6 +680,29 @@ export class Multisig {
     return JSON.stringify(exported, null, 2);
   }
 
+  async createTransactionProposalRequest(commitment: string): Promise<TransactionRequest> {
+
+    const proposal = this.proposals.get(commitment);
+    if (!proposal) {
+      throw new Error(`Proposal not found: ${commitment}`);
+    }
+
+    const request = await createTransactionProposalRequest({
+      proposal,
+      accountId: this._accountId,
+      threshold: this.threshold,
+      signerCommitments: this.signerCommitments,
+      psmCommitment: this.psmCommitment,
+      psmPublicKey: this.psmPublicKey,
+      signatureScheme: this.signatureScheme,
+      getEffectiveThreshold: (proposalType) => this.getEffectiveThreshold(proposalType),
+      psm: this.psm,
+      webClient: this.webClient,
+    });
+
+    return request;
+  }
+
   importTransactionProposal(json: string): TransactionProposalResult {
     const exported: ExportedTransactionProposal = JSON.parse(json);