@openzeppelin/miden-multisig-client 0.14.5 → 0.14.8

package/src/types/proposal.ts

@@ -49,9 +49,27 @@ export interface UpdateProcedureThresholdProposalMetadata extends BaseProposalMe
   targetThreshold: number;
 }
 
+/** `consume_notes` metadata version. Absence on the wire => v1 (issue #229). */
+export const CONSUME_NOTES_METADATA_VERSION_V2 = 2 as const;
+
+/** Max serialized v2 metadata, enforced at creation (FR-011). */
+export const MAX_CONSUME_NOTES_METADATA_BYTES = 256 * 1024;
+
 export interface ConsumeNotesProposalMetadata extends BaseProposalMetadata {
   proposalType: 'consume_notes';
   noteIds: string[];
+  /** Absent or `1` => v1 (legacy), `2` => v2 (issue #229). */
+  metadataVersion?: 1 | 2;
+  /** v2: base64-encoded `note.serialize()` output, index-aligned with `noteIds`. */
+  notes?: string[];
+}
+
+export function isConsumeNotesV2(md: ConsumeNotesProposalMetadata): boolean {
+  return md.metadataVersion === CONSUME_NOTES_METADATA_VERSION_V2;
+}
+
+export function isConsumeNotesV1(md: ConsumeNotesProposalMetadata): boolean {
+  return md.metadataVersion === undefined || md.metadataVersion === 1;
 }
 
 export interface P2IdProposalMetadata extends BaseProposalMetadata {

package/src/utils/encoding.ts

@@ -40,6 +40,19 @@ export function uint8ArrayToBase64(bytes: Uint8Array): string {
   throw new Error('No base64 encoder available in this environment');
 }
 
+/** Serialize a Miden `Note` to base64 (v2 `consume_notes` metadata, issue #229). */
+export function noteToBase64(note: { serialize(): Uint8Array }): string {
+  return uint8ArrayToBase64(note.serialize());
+}
+
+/** Decode a base64 note. `noteCtor` is `Note` from `@miden-sdk/miden-sdk`. */
+export function noteFromBase64<TNote>(
+  base64: string,
+  noteCtor: { deserialize(bytes: Uint8Array): TNote },
+): TNote {
+  return noteCtor.deserialize(base64ToUint8Array(base64));
+}
+
 export function base64ToUint8Array(base64: string): Uint8Array {
   const binary =
     typeof atob === 'function'