@openzeppelin/miden-multisig-client 0.14.8 → 0.14.9

package/dist/proposal/metadata.test.js

@@ -40,4 +40,48 @@ describe('ProposalMetadataCodec consume_notes v2 round-trip (issue #229)', () =>
         expect(back.notes).toBeUndefined();
     });
 });
+describe('ProposalMetadataCodec custom proposal types (issue #266)', () => {
+    it('fromGuardian collapses an unmodeled type to the custom bucket, keeping the raw label', () => {
+        const wire = {
+            proposalType: 'b2agg',
+            description: 'agglayer bridge note',
+        };
+        const md = ProposalMetadataCodec.fromGuardian(wire);
+        expect(md.proposalType).toBe('custom');
+        expect(md.rawProposalType).toBe('b2agg');
+    });
+    it('toGuardian round-trips the raw label, not the custom bucket', () => {
+        const md = {
+            proposalType: 'custom',
+            description: 'agglayer bridge note',
+            rawProposalType: 'b2agg',
+        };
+        const wire = ProposalMetadataCodec.toGuardian(md);
+        expect(wire.proposalType).toBe('b2agg');
+        const back = ProposalMetadataCodec.fromGuardian(wire);
+        expect(back.proposalType).toBe('custom');
+        expect(back.rawProposalType).toBe('b2agg');
+    });
+    it('validate accepts a custom proposal', () => {
+        const md = {
+            proposalType: 'custom',
+            description: 'opaque',
+            rawProposalType: 'b2agg',
+        };
+        expect(ProposalMetadataCodec.validate(md)).toBe(md);
+    });
+    it('round-trips update_procedure_threshold through the codec', () => {
+        const wire = {
+            proposalType: 'update_procedure_threshold',
+            targetProcedure: 'send_asset',
+            targetThreshold: 2,
+        };
+        const md = ProposalMetadataCodec.fromGuardian(wire);
+        expect(md.proposalType).toBe('update_procedure_threshold');
+        const back = ProposalMetadataCodec.toGuardian(md);
+        expect(back.proposalType).toBe('update_procedure_threshold');
+        expect(back.targetProcedure).toBe('send_asset');
+        expect(back.targetThreshold).toBe(2);
+    });
+});
 //# sourceMappingURL=metadata.test.js.map

package/dist/proposal/metadata.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"metadata.test.js","sourceRoot":"","sources":["../../src/proposal/metadata.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAE9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAGtD,QAAQ,CAAC,gEAAgE,EAAE,GAAG,EAAE;IAC9E,EAAE,CAAC,0DAA0D,EAAE,GAAG,EAAE;QAClE,MAAM,EAAE,GAAiC;YACvC,YAAY,EAAE,eAAe;YAC7B,WAAW,EAAE,kBAAkB;YAC/B,OAAO,EAAE,CAAC,OAAO,CAAC;YAClB,eAAe,EAAE,CAAC;YAClB,KAAK,EAAE,CAAC,kBAAkB,CAAC;SAC5B,CAAC;QACF,MAAM,IAAI,GAAG,qBAAqB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;QACxC,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACjD,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,OAAO,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;IAC/D,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,yCAAyC,EAAE,GAAG,EAAE;QACjD,MAAM,IAAI,GAA6B;YACrC,YAAY,EAAE,eAAe;YAC7B,OAAO,EAAE,CAAC,OAAO,CAAC;YAClB,2BAA2B,EAAE,CAAC;YAC9B,iBAAiB,EAAE,CAAC,kBAAkB,CAAC;SACxC,CAAC;QACF,MAAM,EAAE,GAAG,qBAAqB,CAAC,YAAY,CAAC,IAAI,CAAiC,CAAC;QACpF,MAAM,CAAC,EAAE,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;QAC9C,MAAM,CAAC,EAAE,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,CAAC,kBAAkB,CAAC,CAAC,CAAC;IACjD,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+DAA+D,EAAE,GAAG,EAAE;QACvE,MAAM,EAAE,GAAiC;YACvC,YAAY,EAAE,eAAe;YAC7B,WAAW,EAAE,QAAQ;YACrB,OAAO,EAAE,CAAC,OAAO,CAAC;SACnB,CAAC;QACF,MAAM,IAAI,GAAG,qBAAqB,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;QAClD,MAAM,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC,aAAa,EAAE,CAAC;QACzD,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,aAAa,EAAE,CAAC;QAC/C,MAAM,IAAI,GAAG,qBAAqB,CAAC,YAAY,CAAC,IAAI,CAAiC,CAAC;QACtF,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,aAAa,EAAE,CAAC;QAC7C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,aAAa,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}
+{"version":3,"file":"metadata.test.js","sourceRoot":"","sources":["../../src/proposal/metadata.test.ts"],"names":[],"mappings":"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"}

package/dist/types/proposal.d.ts

@@ -1,6 +1,12 @@
-import type { ProposalSignature, ProposalType as GuardianProposalType, SignatureScheme } from '@openzeppelin/guardian-client';
+import type { ProposalSignature, SignatureScheme } from '@openzeppelin/guardian-client';
 import type { ProcedureName } from '../procedures.js';
-export type ProposalType = Exclude<GuardianProposalType, 'custom'>;
+/**
+ * Closed set of proposal types the multisig SDK models behaviorally, plus the
+ * `'custom'` bucket for any server-defined type the SDK does not model (issue
+ * #266). Defined explicitly (not derived from the now-arbitrary guardian-client
+ * wire union) so the exhaustive switches in the metadata codec stay sound.
+ */
+export type ProposalType = 'add_signer' | 'remove_signer' | 'change_threshold' | 'update_procedure_threshold' | 'switch_guardian' | 'consume_notes' | 'p2id' | 'custom';
 export type ProposalStatus = 'pending' | 'ready' | 'finalized';
 export type TransactionProposalStatus = {
     type: 'pending';
@@ -61,10 +67,15 @@ export interface P2IdProposalMetadata extends BaseProposalMetadata {
     faucetId: string;
     amount: string;
 }
-export interface UnknownProposalMetadata extends BaseProposalMetadata {
-    proposalType: 'unknown';
+export interface CustomProposalMetadata extends BaseProposalMetadata {
+    proposalType: 'custom';
+    /** Original server-defined proposal label, e.g. "b2agg" (issue #266). Mirrors
+     * Rust `ProposalMetadata.proposal_type`; it is what lets a custom proposal
+     * round-trip back to GUARDIAN/export, so it is required in the domain model.
+     * Any wire-level optionality is resolved in the parser/codec boundary. */
+    rawProposalType: string;
 }
-export type ProposalMetadata = UpdateSignersProposalMetadata | SwitchGuardianProposalMetadata | UpdateProcedureThresholdProposalMetadata | ConsumeNotesProposalMetadata | P2IdProposalMetadata | UnknownProposalMetadata;
+export type ProposalMetadata = UpdateSignersProposalMetadata | SwitchGuardianProposalMetadata | UpdateProcedureThresholdProposalMetadata | ConsumeNotesProposalMetadata | P2IdProposalMetadata | CustomProposalMetadata;
 export interface Proposal {
     id: string;
     accountId: string;

package/dist/types/proposal.d.ts.map

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

package/dist/types/proposal.js.map

@@ -1 +1 @@
-{"version":3,"file":"proposal.js","sourceRoot":"","sources":["../../src/types/proposal.ts"],"names":[],"mappings":"AAmDA,gFAAgF;AAChF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAU,CAAC;AAE5D,iEAAiE;AACjE,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,GAAG,IAAI,CAAC;AAW3D,MAAM,UAAU,gBAAgB,CAAC,EAAgC;IAC/D,OAAO,EAAE,CAAC,eAAe,KAAK,iCAAiC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAgC;IAC/D,OAAO,EAAE,CAAC,eAAe,KAAK,SAAS,IAAI,EAAE,CAAC,eAAe,KAAK,CAAC,CAAC;AACtE,CAAC"}
+{"version":3,"file":"proposal.js","sourceRoot":"","sources":["../../src/types/proposal.ts"],"names":[],"mappings":"AA6DA,gFAAgF;AAChF,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAAU,CAAC;AAE5D,iEAAiE;AACjE,MAAM,CAAC,MAAM,gCAAgC,GAAG,GAAG,GAAG,IAAI,CAAC;AAW3D,MAAM,UAAU,gBAAgB,CAAC,EAAgC;IAC/D,OAAO,EAAE,CAAC,eAAe,KAAK,iCAAiC,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,EAAgC;IAC/D,OAAO,EAAE,CAAC,eAAe,KAAK,SAAS,IAAI,EAAE,CAAC,eAAe,KAAK,CAAC,CAAC;AACtE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@openzeppelin/miden-multisig-client",
-  "version": "0.14.8",
+  "version": "0.14.9",
   "description": "TypeScript SDK for Miden multisig accounts with GUARDIAN integration",
   "type": "module",
   "main": "./dist/index.js",
@@ -30,7 +30,7 @@
     "@noble/curves": "^1.9.7",
     "@miden-sdk/miden-sdk": "0.14.5",
     "@noble/hashes": "^2.0.1",
-    "@openzeppelin/guardian-client": "^0.14.8"
+    "@openzeppelin/guardian-client": "^0.14.9"
   },
   "devDependencies": {
     "typescript": "^5.7.2",

package/src/multisig.test.ts

@@ -44,6 +44,9 @@ vi.mock('@miden-sdk/miden-sdk', () => ({
       toPreparedSignature: () => [1, 2, 3],
     }),
   },
+  TransactionRequest: {
+    deserialize: vi.fn().mockReturnValue({}),
+  },
   AdviceMap: vi.fn().mockImplementation(() => ({
     insert: vi.fn(),
   })),
@@ -3144,6 +3147,142 @@ describe('Multisig', () => {
     });
   });
 
+  describe('prepareCustomExecution', () => {
+    const requestBytes = new Uint8Array([9, 8, 7]);
+
+    function customDelta(
+      proposalType: string,
+      cosignerSigs: any[],
+    ): any {
+      return {
+        account_id: '0x' + 'a'.repeat(30),
+        nonce: 1,
+        prev_commitment: '0x' + 'b'.repeat(64),
+        delta_payload: {
+          tx_summary: { data: 'AQID' },
+          signatures: [],
+          metadata: {
+            proposal_type: proposalType,
+            description: '',
+          },
+        },
+        status: {
+          status: 'pending',
+          timestamp: '2024-01-01T00:00:00Z',
+          proposer_id: '0x' + 'c'.repeat(64),
+          cosigner_sigs: cosignerSigs,
+        },
+      };
+    }
+
+    function falconSig(signerId: string): any {
+      return {
+        signer_id: signerId,
+        signature: { scheme: 'falcon', signature: '0x' + 'e'.repeat(128) },
+        timestamp: '2024-01-01T00:00:00Z',
+      };
+    }
+
+    it('rejects a built-in proposal type', async () => {
+      const config = {
+        threshold: 1,
+        signerCommitments: ['0x' + 'a'.repeat(64)],
+        guardianCommitment: '0x' + 'c'.repeat(64),
+      };
+      const multisig = new Multisig(mockAccount, config, guardian, mockSigner, mockWebClient);
+
+      const builtinDelta = {
+        ...customDelta('change_threshold', [falconSig('0x' + 'a'.repeat(64))]),
+      };
+      builtinDelta.delta_payload.metadata = {
+        proposal_type: 'change_threshold',
+        description: '',
+        target_threshold: 1,
+        signer_commitments: ['0x' + 'a'.repeat(64)],
+      } as any;
+
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: async () => builtinDelta,
+      });
+
+      await expect(
+        multisig.prepareCustomExecution('0x' + 'c'.repeat(64), requestBytes),
+      ).rejects.toThrow('prepareCustomExecution is only for custom proposals');
+    });
+
+    it('rejects a proposal that is below its signature threshold', async () => {
+      const config = {
+        threshold: 2,
+        signerCommitments: ['0x' + 'a'.repeat(64), '0x' + 'b'.repeat(64)],
+        guardianCommitment: '0x' + 'c'.repeat(64),
+      };
+      const multisig = new Multisig(mockAccount, config, guardian, mockSigner, mockWebClient);
+
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: async () => customDelta('b2agg', [falconSig('0x' + 'a'.repeat(64))]),
+      });
+
+      await expect(
+        multisig.prepareCustomExecution('0x' + 'c'.repeat(64), requestBytes),
+      ).rejects.toThrow('have 1 of 2 required signatures');
+    });
+
+    it('rejects when the rebuilt request does not reproduce the signed commitment', async () => {
+      const config = {
+        threshold: 1,
+        signerCommitments: ['0x' + 'a'.repeat(64)],
+        guardianCommitment: '0x' + 'c'.repeat(64),
+      };
+      const multisig = new Multisig(mockAccount, config, guardian, mockSigner, mockWebClient);
+
+      // Signed commitment comes from TransactionSummary.deserialize -> 'c' * 64.
+      // Make the binding request derive a different commitment so the check fails.
+      vi.mocked(executeForSummary).mockResolvedValueOnce({
+        toCommitment: () => ({
+          toHex: () => '0x' + '9'.repeat(64),
+        }),
+        serialize: () => new Uint8Array([1, 2, 3]),
+      } as any);
+
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: async () => customDelta('b2agg', [falconSig('0x' + 'a'.repeat(64))]),
+      });
+
+      await expect(
+        multisig.prepareCustomExecution('0x' + 'c'.repeat(64), requestBytes),
+      ).rejects.toThrow('Custom proposal binding mismatch');
+    });
+
+    it('fails when GUARDIAN does not return an acknowledgment signature', async () => {
+      const config = {
+        threshold: 1,
+        signerCommitments: ['0x' + 'a'.repeat(64)],
+        guardianCommitment: '0x' + 'c'.repeat(64),
+      };
+      const multisig = new Multisig(mockAccount, config, guardian, mockSigner, mockWebClient);
+
+      const ready = customDelta('b2agg', [falconSig('0x' + 'a'.repeat(64))]);
+
+      // getDeltaProposal
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: async () => ready,
+      });
+      // pushDelta returns no ack_sig
+      mockFetch.mockResolvedValueOnce({
+        ok: true,
+        json: async () => ({ ...ready, ack_sig: null }),
+      });
+
+      await expect(
+        multisig.prepareCustomExecution('0x' + 'c'.repeat(64), requestBytes),
+      ).rejects.toThrow('GUARDIAN did not return acknowledgment signature');
+    });
+  });
+
   describe('proposal metadata preservation', () => {
     it('should preserve local metadata when syncing proposals', async () => {
       const config = {

package/src/multisig.ts

@@ -13,13 +13,13 @@ import type {
   NoteAsset,
   Proposal,
   ProposalMetadata,
+  ProposalSignatureEntry,
   ProposalType,
 } from './types.js';
 import type { ProcedureName } from './procedures.js';
 import type {
   MidenClient,
   TransactionProver,
-  TransactionRequest,
   WasmWebClient,
 } from '@miden-sdk/miden-sdk';
 import {
@@ -31,6 +31,7 @@ import {
   Note,
   RpcClient,
   Signature,
+  TransactionRequest,
   TransactionSummary,
   Word,
 } from '@miden-sdk/miden-sdk';
@@ -97,6 +98,32 @@ export interface AccountStateVerificationResult {
 /**
  * Represents a multisig account with GUARDIAN integration.
  */
+const BUILTIN_PROPOSAL_TYPES = new Set<string>([
+  'add_signer',
+  'remove_signer',
+  'change_threshold',
+  'update_procedure_threshold',
+  'switch_guardian',
+  'consume_notes',
+  'p2id',
+  // Reserved: the SDK's internal bucket name for unmodeled types. A producer
+  // must not use it as a custom label, or it would collide with the bucket.
+  'custom',
+]);
+
+/**
+ * Deserialize producer-supplied transaction request bytes, wrapping any failure
+ * in a stable message that mirrors the Rust SDK's `deserialize_transaction_request`.
+ */
+function deserializeTransactionRequest(bytes: Uint8Array): TransactionRequest {
+  try {
+    return TransactionRequest.deserialize(bytes);
+  } catch (err) {
+    const detail = err instanceof Error ? err.message : String(err);
+    throw new Error(`failed to decode transaction request: ${detail}`);
+  }
+}
+
 export class Multisig {
   account: Account;
   threshold: number;
@@ -977,6 +1004,220 @@ export class Multisig {
     proposal.status = 'finalized';
   }
 
+  /**
+   * Submit an integration-built transaction (advice already injected). Mirrors
+   * the Rust `submit_transaction`; used by the custom proposal producer flow
+   * after `prepareCustomExecution` rebuilds its request with the returned advice.
+   */
+  async submitTransaction(request: TransactionRequest): Promise<void> {
+    await this.midenClient.transactions.submit(AccountId.fromHex(this._accountId), request);
+  }
+
+  /**
+   * Create a proposal from a producer-built transaction the SDK does not model
+   * (issue #266 producer API). `transactionRequestBytes` is a serialized TransactionRequest;
+   * `proposalType` is a free-form, non-empty label that must not collide with a
+   * built-in type. The integration keeps its own recipe to execute later via
+   * `prepareCustomExecution`.
+   */
+  async createCustomProposal(
+    transactionRequestBytes: Uint8Array,
+    proposalType: string,
+    nonce?: number,
+  ): Promise<Proposal> {
+    const label = proposalType.trim().toLowerCase();
+    if (label.length === 0) {
+      throw new Error('proposalType must not be empty');
+    }
+    if (!/^[a-z0-9_]+$/.test(label)) {
+      throw new Error(
+        `proposalType '${label}' must be lowercase snake_case ([a-z0-9_]): no spaces, hyphens, or other characters`,
+      );
+    }
+    if (BUILTIN_PROPOSAL_TYPES.has(label)) {
+      throw new Error(
+        `'${label}' is a built-in proposal type; use the typed proposal API instead`,
+      );
+    }
+
+    const webClient = await this.getRawClient();
+    const request = deserializeTransactionRequest(transactionRequestBytes);
+    const summary = await executeForSummary(webClient, this._accountId, request);
+    const summaryBase64 = uint8ArrayToBase64(summary.serialize());
+    const proposalNonce = nonce ?? Date.now();
+
+    const metadata: ProposalMetadata = {
+      proposalType: 'custom',
+      description: '',
+      rawProposalType: label,
+      requiredSignatures: this.getEffectiveThreshold('custom'),
+    };
+
+    return this.createProposal(proposalNonce, summaryBase64, metadata);
+  }
+
+  /**
+   * Assemble the validated execution advice (cosigner signatures + GUARDIAN
+   * acknowledgment) for a ready custom proposal, so an integration can rebuild
+   * its transaction with its own recipe and submit (issue #266 producer API).
+   *
+   * `transactionRequestBytes` is the serialized transaction request; it is used only to verify
+   * (binding check) that it reproduces the signed commitment, before the
+   * acknowledgment is requested. Returns the advice the integration folds into
+   * its rebuilt transaction (`builder.extendAdviceMap(advice)`).
+   */
+  async prepareCustomExecution(
+    proposalId: string,
+    transactionRequestBytes: Uint8Array,
+  ): Promise<AdviceMap> {
+    const normalizedProposalId = normalizeHexWord(proposalId);
+    const delta = await this.guardian.getDeltaProposal(this._accountId, normalizedProposalId);
+    const existing = this.getLocalProposal(proposalId);
+    const proposal = this.proposalFactory().fromDelta(
+      delta,
+      normalizedProposalId,
+      existing?.metadata,
+      existing?.signatures ?? [],
+    );
+
+    if (proposal.metadata.proposalType !== 'custom') {
+      throw new Error(
+        'prepareCustomExecution is only for custom proposals; use executeProposal for built-in types',
+      );
+    }
+
+    const effectiveThreshold = this.getEffectiveThreshold('custom');
+    const signaturesForExecution = new ProposalSignatures(
+      proposal.signatures,
+      this.signerCommitments,
+      `Invalid proposal signatures for ${proposalId}`,
+    ).entries();
+    if (signaturesForExecution.length < effectiveThreshold) {
+      throw new Error(
+        `Proposal is not ready for execution: have ${signaturesForExecution.length} of ${effectiveThreshold} required signatures.`,
+      );
+    }
+
+    const txSummary = TransactionSummary.deserialize(
+      base64ToUint8Array(delta.deltaPayload.txSummary.data),
+    );
+    const signedCommitmentHex = normalizeHexWord(txSummary.toCommitment().toHex());
+
+    const bindingRequest = deserializeTransactionRequest(transactionRequestBytes);
+
+    const webClient = await this.getRawClient();
+    const derived = await executeForSummary(webClient, this._accountId, bindingRequest);
+    const derivedCommitmentHex = normalizeHexWord(derived.toCommitment().toHex());
+    if (derivedCommitmentHex !== signedCommitmentHex) {
+      throw new Error(
+        `Custom proposal binding mismatch: expected ${signedCommitmentHex}, got ${derivedCommitmentHex}`,
+      );
+    }
+
+    return this.assembleCustomAdvice(
+      proposalId,
+      signaturesForExecution,
+      signedCommitmentHex,
+      delta,
+    );
+  }
+
+  private async assembleCustomAdvice(
+    proposalId: string,
+    signaturesForExecution: ProposalSignatureEntry[],
+    normalizedTxCommitmentHex: string,
+    delta: DeltaObject,
+  ): Promise<AdviceMap> {
+    const normalizedSignerCommitments = new Set(
+      this.signerCommitments.map((commitment) => normalizeHexWord(commitment)),
+    );
+    const adviceMap = new AdviceMap();
+    const adviceMapKeys = new Set<string>();
+    const createTxCommitmentWord = (): Word => Word.fromHex(normalizedTxCommitmentHex);
+
+    for (const cosignerSig of signaturesForExecution) {
+      let signerCommitmentHex = normalizeHexWord(cosignerSig.signerId);
+      const ecdsaPublicKey =
+        cosignerSig.signature.scheme === 'ecdsa' ? cosignerSig.signature.publicKey : undefined;
+
+      if (cosignerSig.signature.scheme === 'ecdsa') {
+        if (!ecdsaPublicKey) {
+          throw new Error(
+            `ECDSA proposal signature for ${signerCommitmentHex} is missing publicKey`,
+          );
+        }
+        const derivedCommitment = tryComputeEcdsaCommitmentHex(ecdsaPublicKey);
+        if (derivedCommitment && derivedCommitment !== signerCommitmentHex) {
+          if (!normalizedSignerCommitments.has(derivedCommitment)) {
+            throw new Error(
+              `ECDSA public key commitment mismatch: derived commitment ${derivedCommitment} is not in signerCommitments.`,
+            );
+          }
+          signerCommitmentHex = derivedCommitment;
+        }
+      }
+
+      const signerCommitment = Word.fromHex(signerCommitmentHex);
+      const sigBytes = signatureHexToBytes(
+        cosignerSig.signature.signature,
+        cosignerSig.signature.scheme,
+      );
+      const signature = Signature.deserialize(sigBytes);
+      const { key, values } = buildSignatureAdviceEntry(
+        signerCommitment,
+        createTxCommitmentWord(),
+        signature,
+        ecdsaPublicKey,
+        cosignerSig.signature.scheme === 'ecdsa' ? cosignerSig.signature.signature : undefined,
+      );
+      const keyHex = normalizeHexWord(key.toHex());
+      if (adviceMapKeys.has(keyHex)) {
+        throw new Error(`Duplicate advice-map key detected for proposal ${proposalId}`);
+      }
+      adviceMapKeys.add(keyHex);
+      adviceMap.insert(key, new FeltArray(values));
+    }
+
+    const executionDelta = { ...delta, deltaPayload: delta.deltaPayload.txSummary };
+    const pushResult = await this.guardian.pushDelta(executionDelta);
+    const ackSigHex = pushResult.ackSig;
+    if (!ackSigHex) {
+      throw new Error('GUARDIAN did not return acknowledgment signature');
+    }
+
+    const guardianCommitment = Word.fromHex(normalizeHexWord(this.guardianCommitment));
+    const ackScheme = (pushResult.ackScheme as 'ecdsa' | 'falcon') || this.signer.scheme;
+    const ackPubkey = pushResult.ackPubkey || this.guardianPublicKey;
+    if (ackScheme === 'ecdsa' && !ackPubkey) {
+      throw new Error('GUARDIAN acknowledgment is missing ECDSA public key');
+    }
+    if (ackScheme === 'ecdsa' && ackPubkey) {
+      const derivedCommitment = tryComputeEcdsaCommitmentHex(ackPubkey);
+      if (derivedCommitment && derivedCommitment !== normalizeHexWord(this.guardianCommitment)) {
+        throw new Error('GUARDIAN public key commitment mismatch');
+      }
+    }
+    const ackSigBytes = signatureHexToBytes(ackSigHex, ackScheme);
+    const ackSignature = Signature.deserialize(ackSigBytes);
+    const { key: ackKey, values: ackValues } = buildSignatureAdviceEntry(
+      guardianCommitment,
+      createTxCommitmentWord(),
+      ackSignature,
+      ackScheme === 'ecdsa' ? ackPubkey : undefined,
+      ackScheme === 'ecdsa' ? ackSigHex : undefined,
+    );
+    const ackKeyHex = normalizeHexWord(ackKey.toHex());
+    if (adviceMapKeys.has(ackKeyHex)) {
+      throw new Error(
+        `Duplicate advice-map key detected for GUARDIAN acknowledgment in proposal ${proposalId}`,
+      );
+    }
+    adviceMapKeys.add(ackKeyHex);
+    adviceMap.insert(ackKey, new FeltArray(ackValues));
+
+    return adviceMap;
+  }
+
   private getLocalProposal(proposalId: string): Proposal | undefined {
     const normalizedProposalId = normalizeHexWord(proposalId);
     return this.proposals.get(proposalId) ?? this.proposals.get(normalizedProposalId);
@@ -994,6 +1235,15 @@ export class Multisig {
     await this.verifyProposalMetadataBinding(proposal);
 
     const metadata = proposal.metadata;
+    // Reject custom proposals before any advice assembly or GUARDIAN ack push:
+    // the SDK cannot rebuild an opaque custom transaction, and the rejection
+    // must stay side-effect free (mirrors the Rust early guard in execute_proposal).
+    if (metadata.proposalType === 'custom') {
+      throw new Error(
+        'Cannot execute a custom proposal via executeProposal; use prepareCustomExecution to ' +
+          'get the cosigner + GUARDIAN advice, then submitTransaction with your rebuilt request (issue #266).',
+      );
+    }
     const effectiveThreshold = this.getEffectiveThreshold(metadata.proposalType);
     const signatureContext = `Invalid proposal signatures for ${proposalId}`;
     const signaturesForExecution = new ProposalSignatures(
@@ -1299,8 +1549,11 @@ export class Multisig {
 
   private async verifyProposalMetadataBinding(proposal: Proposal): Promise<string> {
     const txSummaryCommitment = this.ensureProposalCommitmentMatchesSummary(proposal);
-    if (proposal.metadata.proposalType === 'unknown') {
-      throw new Error(`Cannot verify proposal metadata for unknown proposal type: ${proposal.id}`);
+    if (proposal.metadata.proposalType === 'custom') {
+      // Custom proposals (issue #266) have no per-type reconstruction recipe;
+      // the id ↔ tx_summary commitment match above is the only available
+      // integrity guarantee for an opaque proposal.
+      return txSummaryCommitment;
     }
 
     const summary = TransactionSummary.deserialize(base64ToUint8Array(proposal.txSummary));
@@ -1410,8 +1663,10 @@ export class Multisig {
         );
         return request;
       }
-      case 'unknown':
-        throw new Error('Unsupported proposal type: unknown');
+      case 'custom':
+        throw new Error(
+          `Cannot build a transaction for a custom proposal type: ${metadata.rawProposalType ?? 'custom'}`,
+        );
     }
   }
 

package/src/proposal/metadata.test.ts

@@ -1,7 +1,10 @@
 import { describe, expect, it } from 'vitest';
 import type { ProposalMetadata as GuardianProposalMetadata } from '@openzeppelin/guardian-client';
 import { ProposalMetadataCodec } from './metadata.js';
-import type { ConsumeNotesProposalMetadata } from '../types/proposal.js';
+import type {
+  ConsumeNotesProposalMetadata,
+  CustomProposalMetadata,
+} from '../types/proposal.js';
 
 describe('ProposalMetadataCodec consume_notes v2 round-trip (issue #229)', () => {
   it('toGuardian threads metadataVersion and notes to the wire', () => {
@@ -45,3 +48,52 @@ describe('ProposalMetadataCodec consume_notes v2 round-trip (issue #229)', () =>
     expect(back.notes).toBeUndefined();
   });
 });
+
+describe('ProposalMetadataCodec custom proposal types (issue #266)', () => {
+  it('fromGuardian collapses an unmodeled type to the custom bucket, keeping the raw label', () => {
+    const wire: GuardianProposalMetadata = {
+      proposalType: 'b2agg',
+      description: 'agglayer bridge note',
+    };
+    const md = ProposalMetadataCodec.fromGuardian(wire) as CustomProposalMetadata;
+    expect(md.proposalType).toBe('custom');
+    expect(md.rawProposalType).toBe('b2agg');
+  });
+
+  it('toGuardian round-trips the raw label, not the custom bucket', () => {
+    const md: CustomProposalMetadata = {
+      proposalType: 'custom',
+      description: 'agglayer bridge note',
+      rawProposalType: 'b2agg',
+    };
+    const wire = ProposalMetadataCodec.toGuardian(md);
+    expect(wire.proposalType).toBe('b2agg');
+
+    const back = ProposalMetadataCodec.fromGuardian(wire) as CustomProposalMetadata;
+    expect(back.proposalType).toBe('custom');
+    expect(back.rawProposalType).toBe('b2agg');
+  });
+
+  it('validate accepts a custom proposal', () => {
+    const md: CustomProposalMetadata = {
+      proposalType: 'custom',
+      description: 'opaque',
+      rawProposalType: 'b2agg',
+    };
+    expect(ProposalMetadataCodec.validate(md)).toBe(md);
+  });
+
+  it('round-trips update_procedure_threshold through the codec', () => {
+    const wire: GuardianProposalMetadata = {
+      proposalType: 'update_procedure_threshold',
+      targetProcedure: 'send_asset',
+      targetThreshold: 2,
+    };
+    const md = ProposalMetadataCodec.fromGuardian(wire);
+    expect(md.proposalType).toBe('update_procedure_threshold');
+    const back = ProposalMetadataCodec.toGuardian(md);
+    expect(back.proposalType).toBe('update_procedure_threshold');
+    expect(back.targetProcedure).toBe('send_asset');
+    expect(back.targetThreshold).toBe(2);
+  });
+});