@meshsdk/transaction 1.7.6 → 1.7.8

package/dist/index.cjs

@@ -52,10 +52,13 @@ var MeshTxBuilderCore = class {
   plutusMintingScriptVersion;
   addingPlutusWithdrawal = false;
   plutusWithdrawalScriptVersion;
+  addingPlutusVote = false;
+  plutusVoteScriptVersion;
   _protocolParams = import_common.DEFAULT_PROTOCOL_PARAMETERS;
   mintItem;
   txInQueueItem;
   withdrawalItem;
+  voteItem;
   collateralQueueItem;
   refScriptTxInQueueItem;
   meshTxBuilderBody;
@@ -661,7 +664,7 @@ var MeshTxBuilderCore = class {
     return this;
   };
   /**
-   * Set the instruction that it is currently using V1 Plutus withdrawal scripts
+   * Set the instruction that it is currently using a Plutus withdrawal scripts
    * @returns The MeshTxBuilder instance
    */
   withdrawalPlutusScriptV1 = () => {
@@ -789,6 +792,158 @@ var MeshTxBuilderCore = class {
     );
     return this;
   };
+  /**
+   * Set the instruction that it is currently using a Plutus voting scripts
+   * @param languageVersion The Plutus script version
+   * @returns The MeshTxBuilder instance
+   */
+  votePlutusScript = (languageVersion) => {
+    this.addingPlutusVote = true;
+    this.plutusVoteScriptVersion = languageVersion;
+    return this;
+  };
+  /**
+   * Set the instruction that it is currently using V1 Plutus voting scripts
+   * @returns The MeshTxBuilder instance
+   */
+  votePlutusScriptV1 = () => {
+    this.addingPlutusVote = true;
+    this.plutusVoteScriptVersion = "V1";
+    return this;
+  };
+  /**
+   * Set the instruction that it is currently using V2 Plutus voting scripts
+   * @returns The MeshTxBuilder instance
+   */
+  votePlutusScriptV2 = () => {
+    this.addingPlutusVote = true;
+    this.plutusVoteScriptVersion = "V2";
+    return this;
+  };
+  /**
+   * Set the instruction that it is currently using V3 Plutus voting scripts
+   * @returns The MeshTxBuilder instance
+   */
+  votePlutusScriptV3 = () => {
+    this.addingPlutusVote = true;
+    this.plutusVoteScriptVersion = "V3";
+    return this;
+  };
+  /**
+   * Add a vote in the MeshTxBuilder instance
+   * @param voter The voter, can be a ConstitutionalCommitee, a DRep or a StakePool
+   * @param govActionId - The transaction hash and transaction id of the governance action
+   * @param votingProcedure - The voting kind (Yes, No, Abstain) with an optional anchor
+   * @returns The MeshTxBuilder instance
+   */
+  vote = (voter, govActionId, votingProcedure) => {
+    if (this.voteItem) {
+      this.queueVote();
+    }
+    if (this.addingPlutusVote) {
+      const vote = {
+        type: "ScriptVote",
+        vote: {
+          voter,
+          govActionId,
+          votingProcedure
+        }
+      };
+      this.voteItem = vote;
+    } else {
+      const vote = {
+        type: "BasicVote",
+        vote: {
+          voter,
+          govActionId,
+          votingProcedure
+        }
+      };
+      this.voteItem = vote;
+    }
+    return this;
+  };
+  /**
+   * Add a voting script to the MeshTxBuilder instance
+   * @param scriptCbor The script in CBOR format
+   * @returns The MeshTxBuilder instance
+   */
+  voteScript = (scriptCbor) => {
+    if (!this.voteItem) throw Error("voteScript: Undefined vote");
+    if (this.voteItem.type === "BasicVote") {
+      this.voteItem = {
+        type: "SimpleScriptVote",
+        vote: this.voteItem.vote,
+        simpleScriptSource: {
+          type: "Provided",
+          scriptCode: scriptCbor
+        }
+      };
+    } else if (this.voteItem.type === "ScriptVote") {
+      this.voteItem.scriptSource = {
+        type: "Provided",
+        script: {
+          code: scriptCbor,
+          version: this.plutusVoteScriptVersion || "V2"
+        }
+      };
+    } else if (this.voteItem.type === "SimpleScriptVote") {
+      throw Error("voteScript: Script is already defined for current vote");
+    }
+    return this;
+  };
+  /**
+   * Add a vote reference to the MeshTxBuilder instance
+   * @param txHash The transaction hash of reference UTxO
+   * @param txIndex The transaction index of reference UTxO
+   * @param scriptSize The script size in bytes of the vote script (can be obtained by script hex length / 2)
+   * @param scriptHash The script hash of the vote script
+   * @returns The MeshTxBuilder instance
+   */
+  voteTxInReference = (txHash, txIndex, scriptSize, scriptHash) => {
+    if (!this.voteItem) throw Error("voteTxInReference: Undefined vote");
+    if (this.voteItem.type === "BasicVote")
+      throw Error(
+        "voteTxInReference: Adding script reference to a basic vote"
+      );
+    if (this.voteItem.type === "ScriptVote") {
+      this.voteItem.scriptSource = {
+        type: "Inline",
+        txHash,
+        txIndex,
+        scriptHash,
+        version: this.plutusWithdrawalScriptVersion || "V2",
+        scriptSize
+      };
+    } else if (this.voteItem.type === "SimpleScriptVote") {
+      this.voteItem.simpleScriptSource = {
+        type: "Inline",
+        txHash,
+        txIndex,
+        scriptSize,
+        simpleScriptHash: scriptHash
+      };
+    }
+    return this;
+  };
+  /**
+   * Set the transaction vote redeemer value in the MeshTxBuilder instance
+   * @param redeemer The redeemer in Mesh Data type, JSON in raw constructor like format, or CBOR hex string
+   * @param type The redeemer data type, either Mesh Data type, JSON in raw constructor like format, or CBOR hex string
+   * @param exUnits The execution units budget for the redeemer
+   * @returns The MeshTxBuilder instance
+   */
+  voteRedeemerValue = (redeemer, type = "Mesh", exUnits = { ...import_common.DEFAULT_REDEEMER_BUDGET }) => {
+    if (!this.voteItem) throw Error("voteRedeemerValue: Undefined vote");
+    if (!(this.voteItem.type === "ScriptVote"))
+      throw Error("voteRedeemerValue: Adding redeemer to non plutus vote");
+    this.voteItem.redeemer = this.castBuilderDataToRedeemer(
+      redeemer,
+      type,
+      exUnits
+    );
+    return this;
+  };
   /**
    * Creates a pool registration certificate, and adds it to the transaction
    * @param poolParams Parameters for pool registration
@@ -1141,6 +1296,9 @@ var MeshTxBuilderCore = class {
     if (this.withdrawalItem) {
       this.queueWithdrawal();
     }
+    if (this.voteItem) {
+      this.queueVote();
+    }
   };
   queueInput = () => {
     if (!this.txInQueueItem) throw Error("queueInput: Undefined input");
@@ -1192,6 +1350,25 @@ var MeshTxBuilderCore = class {
     this.meshTxBuilderBody.withdrawals.push(this.withdrawalItem);
     this.withdrawalItem = void 0;
   };
+  queueVote = () => {
+    if (!this.voteItem) {
+      throw Error("queueVote: Undefined vote");
+    }
+    if (this.voteItem.type === "ScriptVote") {
+      if (!this.voteItem.scriptSource) {
+        throw Error("queueVote: Missing vote script information");
+      }
+      if (!this.voteItem.redeemer) {
+        throw Error("queueVote: Missing vote redeemer information");
+      }
+    } else if (this.voteItem.type === "SimpleScriptVote") {
+      if (!this.voteItem.simpleScriptSource) {
+        throw Error("queueVote: Missing vote script information");
+      }
+    }
+    this.meshTxBuilderBody.votes.push(this.voteItem);
+    this.voteItem = void 0;
+  };
   castRawDataToJsonString = (rawData) => {
     if (typeof rawData === "object") {
       return import_json_bigint.default.stringify(rawData);
@@ -1391,11 +1568,13 @@ var MeshTxBuilderCore = class {
     this.addingPlutusMint = false;
     this.plutusMintingScriptVersion = void 0;
     this.addingPlutusWithdrawal = false;
+    this.addingPlutusVote = false;
     this.plutusWithdrawalScriptVersion = void 0;
     this._protocolParams = import_common.DEFAULT_PROTOCOL_PARAMETERS;
     this.mintItem = void 0;
     this.txInQueueItem = void 0;
     this.withdrawalItem = void 0;
+    this.voteItem = void 0;
     this.collateralQueueItem = void 0;
     this.refScriptTxInQueueItem = void 0;
   };
@@ -1726,6 +1905,48 @@ var Transaction = class {
     this.txBuilder = new MeshTxBuilder(options);
     this.initiator = options.initiator;
   }
+  static attachMetadata(cborTx, cborTxMetadata) {
+    const tx = (0, import_core_cst2.deserializeTx)(cborTx);
+    const txAuxData = tx.auxiliaryData() ?? new import_core_cst2.Serialization.AuxiliaryData();
+    txAuxData.setMetadata(
+      import_core_cst2.Serialization.GeneralTransactionMetadata.fromCbor(import_core_cst2.CardanoSDKUtil.HexBlob(cborTxMetadata))
+    );
+    if (import_core_cst2.Cardano.computeAuxiliaryDataHash(txAuxData.toCore())?.toString() !== tx.body().auxiliaryDataHash()?.toString()) {
+      throw new Error(
+        "[Transaction] attachMetadata: The metadata hash does not match the auxiliary data hash."
+      );
+    }
+    return new import_core_cst2.Transaction(tx.body(), tx.witnessSet(), txAuxData).toCbor().toString();
+  }
+  static deattachMetadata(cborTx) {
+    const tx = (0, import_core_cst2.deserializeTx)(cborTx);
+    return new import_core_cst2.Transaction(tx.body(), tx.witnessSet()).toCbor().toString();
+  }
+  static maskMetadata(cborTx) {
+    const tx = (0, import_core_cst2.deserializeTx)(cborTx);
+    const txMetadata = tx.auxiliaryData()?.metadata();
+    if (txMetadata !== void 0) {
+      const mockMetadata = /* @__PURE__ */ new Map();
+      txMetadata.metadata()?.forEach((metadatum, label) => mockMetadata.set(label, mask(metadatum)));
+      const txAuxData = tx.auxiliaryData();
+      txMetadata.setMetadata(mockMetadata);
+      txAuxData?.setMetadata(txMetadata);
+      return new import_core_cst2.Transaction(tx.body(), tx.witnessSet(), txAuxData).toCbor().toString();
+    }
+    return cborTx;
+  }
+  static readMetadata(cborTx) {
+    const tx = (0, import_core_cst2.deserializeTx)(cborTx);
+    return tx.auxiliaryData()?.metadata()?.toCbor().toString() ?? "";
+  }
+  static writeMetadata(cborTx, cborTxMetadata) {
+    const tx = (0, import_core_cst2.deserializeTx)(cborTx);
+    const txAuxData = tx.auxiliaryData() ?? new import_core_cst2.Serialization.AuxiliaryData();
+    txAuxData.setMetadata(
+      import_core_cst2.Serialization.GeneralTransactionMetadata.fromCbor(import_core_cst2.CardanoSDKUtil.HexBlob(cborTxMetadata))
+    );
+    return new import_core_cst2.Transaction(tx.body(), tx.witnessSet(), txAuxData).toCbor().toString();
+  }
   /**
    * Adds an output to the transaction.
    *
@@ -2211,6 +2432,31 @@ var Transaction = class {
     }
   }
 };
+function mask(metadatum) {
+  switch (metadatum.getKind()) {
+    case import_core_cst2.Serialization.TransactionMetadatumKind.Text:
+      return import_core_cst2.Serialization.TransactionMetadatum.newText("0".repeat(metadatum.asText()?.length ?? 0));
+    case import_core_cst2.Serialization.TransactionMetadatumKind.Bytes:
+    case import_core_cst2.Serialization.TransactionMetadatumKind.Integer:
+      return metadatum;
+    case import_core_cst2.Serialization.TransactionMetadatumKind.List:
+      const list = new import_core_cst2.Serialization.MetadatumList();
+      for (let i = 0; i < (metadatum.asList()?.getLength() ?? 0); i++) {
+        list.add(mask(metadatum.asList()?.get(i)));
+      }
+      return import_core_cst2.Serialization.TransactionMetadatum.newList(list);
+    case import_core_cst2.Serialization.TransactionMetadatumKind.Map:
+      const map = new import_core_cst2.Serialization.MetadatumMap();
+      for (let i = 0; i < (metadatum.asMap()?.getLength() ?? 0); i++) {
+        const key = metadatum.asMap()?.getKeys().get(i);
+        const value = metadatum.asMap()?.get(key);
+        map.insert(key, mask(value));
+      }
+      return import_core_cst2.Serialization.TransactionMetadatum.newMap(map);
+    default:
+      throw new Error(`Unsupported metadatum kind: ${metadatum.getKind()}`);
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ForgeScript,

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Protocol, MintItem, TxIn, Withdrawal, PubKeyTxIn, RefTxIn, MeshTxBuilderBody, Asset, BuilderData, LanguageVersion, PoolParams, Anchor, DRep, UTxO, UtxoSelectionStrategy, Network, Redeemer, Action, IFetcher, ISubmitter, IEvaluator, IMeshTxSerializer, ScriptSource, SimpleScriptSourceInfo, NativeScript, IInitiator, Recipient, Token, PlutusScript, Budget, Data, Mint } from '@meshsdk/common';
+import { Protocol, MintItem, TxIn, Withdrawal, Vote, PubKeyTxIn, RefTxIn, MeshTxBuilderBody, Asset, BuilderData, LanguageVersion, Voter, VotingProcedure, PoolParams, Anchor, DRep, UTxO, UtxoSelectionStrategy, Network, Redeemer, Action, IFetcher, ISubmitter, IEvaluator, IMeshTxSerializer, ScriptSource, SimpleScriptSourceInfo, NativeScript, IInitiator, Recipient, Token, PlutusScript, Budget, Data, Mint } from '@meshsdk/common';
 
 declare class MeshTxBuilderCore {
     txEvaluationMultiplier: number;
@@ -9,10 +9,13 @@ declare class MeshTxBuilderCore {
     private plutusMintingScriptVersion;
     private addingPlutusWithdrawal;
     private plutusWithdrawalScriptVersion;
+    private addingPlutusVote;
+    private plutusVoteScriptVersion;
     protected _protocolParams: Protocol;
     protected mintItem?: MintItem;
     protected txInQueueItem?: TxIn;
     protected withdrawalItem?: Withdrawal;
+    protected voteItem?: Vote;
     protected collateralQueueItem?: PubKeyTxIn;
     protected refScriptTxInQueueItem?: RefTxIn;
     meshTxBuilderBody: MeshTxBuilderBody;
@@ -241,7 +244,7 @@ declare class MeshTxBuilderCore {
      */
     withdrawalPlutusScript: (languageVersion: LanguageVersion) => this;
     /**
-     * Set the instruction that it is currently using V1 Plutus withdrawal scripts
+     * Set the instruction that it is currently using a Plutus withdrawal scripts
      * @returns The MeshTxBuilder instance
      */
     withdrawalPlutusScriptV1: () => this;
@@ -288,6 +291,61 @@ declare class MeshTxBuilderCore {
         mem: number;
         steps: number;
     }) => this;
+    /**
+     * Set the instruction that it is currently using a Plutus voting scripts
+     * @param languageVersion The Plutus script version
+     * @returns The MeshTxBuilder instance
+     */
+    votePlutusScript: (languageVersion: LanguageVersion) => this;
+    /**
+     * Set the instruction that it is currently using V1 Plutus voting scripts
+     * @returns The MeshTxBuilder instance
+     */
+    votePlutusScriptV1: () => this;
+    /**
+     * Set the instruction that it is currently using V2 Plutus voting scripts
+     * @returns The MeshTxBuilder instance
+     */
+    votePlutusScriptV2: () => this;
+    /**
+     * Set the instruction that it is currently using V3 Plutus voting scripts
+     * @returns The MeshTxBuilder instance
+     */
+    votePlutusScriptV3: () => this;
+    /**
+     * Add a vote in the MeshTxBuilder instance
+     * @param voter The voter, can be a ConstitutionalCommitee, a DRep or a StakePool
+     * @param govActionId - The transaction hash and transaction id of the governance action
+     * @param votingProcedure - The voting kind (Yes, No, Abstain) with an optional anchor
+     * @returns The MeshTxBuilder instance
+     */
+    vote: (voter: Voter, govActionId: RefTxIn, votingProcedure: VotingProcedure) => this;
+    /**
+     * Add a voting script to the MeshTxBuilder instance
+     * @param scriptCbor The script in CBOR format
+     * @returns The MeshTxBuilder instance
+     */
+    voteScript: (scriptCbor: string) => this;
+    /**
+     * Add a vote reference to the MeshTxBuilder instance
+     * @param txHash The transaction hash of reference UTxO
+     * @param txIndex The transaction index of reference UTxO
+     * @param scriptSize The script size in bytes of the vote script (can be obtained by script hex length / 2)
+     * @param scriptHash The script hash of the vote script
+     * @returns The MeshTxBuilder instance
+     */
+    voteTxInReference: (txHash: string, txIndex: number, scriptSize?: string, scriptHash?: string) => this;
+    /**
+     * Set the transaction vote redeemer value in the MeshTxBuilder instance
+     * @param redeemer The redeemer in Mesh Data type, JSON in raw constructor like format, or CBOR hex string
+     * @param type The redeemer data type, either Mesh Data type, JSON in raw constructor like format, or CBOR hex string
+     * @param exUnits The execution units budget for the redeemer
+     * @returns The MeshTxBuilder instance
+     */
+    voteRedeemerValue: (redeemer: BuilderData["content"], type?: BuilderData["type"], exUnits?: {
+        mem: number;
+        steps: number;
+    }) => this;
     /**
      * Creates a pool registration certificate, and adds it to the transaction
      * @param poolParams Parameters for pool registration
@@ -422,6 +480,7 @@ declare class MeshTxBuilderCore {
     private queueInput;
     private queueMint;
     private queueWithdrawal;
+    private queueVote;
     protected castRawDataToJsonString: (rawData: object | string) => string;
     protected castBuilderDataToRedeemer: (redeemer: BuilderData["content"], type?: BuilderData["type"], exUnits?: {
         mem: number;
@@ -513,6 +572,11 @@ declare class Transaction {
     initiator: IInitiator;
     isCollateralNeeded: boolean;
     constructor(options: TransactionOptions);
+    static attachMetadata(cborTx: string, cborTxMetadata: string): string;
+    static deattachMetadata(cborTx: string): string;
+    static maskMetadata(cborTx: string): string;
+    static readMetadata(cborTx: string): string;
+    static writeMetadata(cborTx: string, cborTxMetadata: string): string;
     /**
      * Adds an output to the transaction.
      *

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Protocol, MintItem, TxIn, Withdrawal, PubKeyTxIn, RefTxIn, MeshTxBuilderBody, Asset, BuilderData, LanguageVersion, PoolParams, Anchor, DRep, UTxO, UtxoSelectionStrategy, Network, Redeemer, Action, IFetcher, ISubmitter, IEvaluator, IMeshTxSerializer, ScriptSource, SimpleScriptSourceInfo, NativeScript, IInitiator, Recipient, Token, PlutusScript, Budget, Data, Mint } from '@meshsdk/common';
+import { Protocol, MintItem, TxIn, Withdrawal, Vote, PubKeyTxIn, RefTxIn, MeshTxBuilderBody, Asset, BuilderData, LanguageVersion, Voter, VotingProcedure, PoolParams, Anchor, DRep, UTxO, UtxoSelectionStrategy, Network, Redeemer, Action, IFetcher, ISubmitter, IEvaluator, IMeshTxSerializer, ScriptSource, SimpleScriptSourceInfo, NativeScript, IInitiator, Recipient, Token, PlutusScript, Budget, Data, Mint } from '@meshsdk/common';
 
 declare class MeshTxBuilderCore {
     txEvaluationMultiplier: number;
@@ -9,10 +9,13 @@ declare class MeshTxBuilderCore {
     private plutusMintingScriptVersion;
     private addingPlutusWithdrawal;
     private plutusWithdrawalScriptVersion;
+    private addingPlutusVote;
+    private plutusVoteScriptVersion;
     protected _protocolParams: Protocol;
     protected mintItem?: MintItem;
     protected txInQueueItem?: TxIn;
     protected withdrawalItem?: Withdrawal;
+    protected voteItem?: Vote;
     protected collateralQueueItem?: PubKeyTxIn;
     protected refScriptTxInQueueItem?: RefTxIn;
     meshTxBuilderBody: MeshTxBuilderBody;
@@ -241,7 +244,7 @@ declare class MeshTxBuilderCore {
      */
     withdrawalPlutusScript: (languageVersion: LanguageVersion) => this;
     /**
-     * Set the instruction that it is currently using V1 Plutus withdrawal scripts
+     * Set the instruction that it is currently using a Plutus withdrawal scripts
      * @returns The MeshTxBuilder instance
      */
     withdrawalPlutusScriptV1: () => this;
@@ -288,6 +291,61 @@ declare class MeshTxBuilderCore {
         mem: number;
         steps: number;
     }) => this;
+    /**
+     * Set the instruction that it is currently using a Plutus voting scripts
+     * @param languageVersion The Plutus script version
+     * @returns The MeshTxBuilder instance
+     */
+    votePlutusScript: (languageVersion: LanguageVersion) => this;
+    /**
+     * Set the instruction that it is currently using V1 Plutus voting scripts
+     * @returns The MeshTxBuilder instance
+     */
+    votePlutusScriptV1: () => this;
+    /**
+     * Set the instruction that it is currently using V2 Plutus voting scripts
+     * @returns The MeshTxBuilder instance
+     */
+    votePlutusScriptV2: () => this;
+    /**
+     * Set the instruction that it is currently using V3 Plutus voting scripts
+     * @returns The MeshTxBuilder instance
+     */
+    votePlutusScriptV3: () => this;
+    /**
+     * Add a vote in the MeshTxBuilder instance
+     * @param voter The voter, can be a ConstitutionalCommitee, a DRep or a StakePool
+     * @param govActionId - The transaction hash and transaction id of the governance action
+     * @param votingProcedure - The voting kind (Yes, No, Abstain) with an optional anchor
+     * @returns The MeshTxBuilder instance
+     */
+    vote: (voter: Voter, govActionId: RefTxIn, votingProcedure: VotingProcedure) => this;
+    /**
+     * Add a voting script to the MeshTxBuilder instance
+     * @param scriptCbor The script in CBOR format
+     * @returns The MeshTxBuilder instance
+     */
+    voteScript: (scriptCbor: string) => this;
+    /**
+     * Add a vote reference to the MeshTxBuilder instance
+     * @param txHash The transaction hash of reference UTxO
+     * @param txIndex The transaction index of reference UTxO
+     * @param scriptSize The script size in bytes of the vote script (can be obtained by script hex length / 2)
+     * @param scriptHash The script hash of the vote script
+     * @returns The MeshTxBuilder instance
+     */
+    voteTxInReference: (txHash: string, txIndex: number, scriptSize?: string, scriptHash?: string) => this;
+    /**
+     * Set the transaction vote redeemer value in the MeshTxBuilder instance
+     * @param redeemer The redeemer in Mesh Data type, JSON in raw constructor like format, or CBOR hex string
+     * @param type The redeemer data type, either Mesh Data type, JSON in raw constructor like format, or CBOR hex string
+     * @param exUnits The execution units budget for the redeemer
+     * @returns The MeshTxBuilder instance
+     */
+    voteRedeemerValue: (redeemer: BuilderData["content"], type?: BuilderData["type"], exUnits?: {
+        mem: number;
+        steps: number;
+    }) => this;
     /**
      * Creates a pool registration certificate, and adds it to the transaction
      * @param poolParams Parameters for pool registration
@@ -422,6 +480,7 @@ declare class MeshTxBuilderCore {
     private queueInput;
     private queueMint;
     private queueWithdrawal;
+    private queueVote;
     protected castRawDataToJsonString: (rawData: object | string) => string;
     protected castBuilderDataToRedeemer: (redeemer: BuilderData["content"], type?: BuilderData["type"], exUnits?: {
         mem: number;
@@ -513,6 +572,11 @@ declare class Transaction {
     initiator: IInitiator;
     isCollateralNeeded: boolean;
     constructor(options: TransactionOptions);
+    static attachMetadata(cborTx: string, cborTxMetadata: string): string;
+    static deattachMetadata(cborTx: string): string;
+    static maskMetadata(cborTx: string): string;
+    static readMetadata(cborTx: string): string;
+    static writeMetadata(cborTx: string, cborTxMetadata: string): string;
     /**
      * Adds an output to the transaction.
      *

package/dist/index.js

@@ -19,10 +19,13 @@ var MeshTxBuilderCore = class {
   plutusMintingScriptVersion;
   addingPlutusWithdrawal = false;
   plutusWithdrawalScriptVersion;
+  addingPlutusVote = false;
+  plutusVoteScriptVersion;
   _protocolParams = DEFAULT_PROTOCOL_PARAMETERS;
   mintItem;
   txInQueueItem;
   withdrawalItem;
+  voteItem;
   collateralQueueItem;
   refScriptTxInQueueItem;
   meshTxBuilderBody;
@@ -628,7 +631,7 @@ var MeshTxBuilderCore = class {
     return this;
   };
   /**
-   * Set the instruction that it is currently using V1 Plutus withdrawal scripts
+   * Set the instruction that it is currently using a Plutus withdrawal scripts
    * @returns The MeshTxBuilder instance
    */
   withdrawalPlutusScriptV1 = () => {
@@ -756,6 +759,158 @@ var MeshTxBuilderCore = class {
     );
     return this;
   };
+  /**
+   * Set the instruction that it is currently using a Plutus voting scripts
+   * @param languageVersion The Plutus script version
+   * @returns The MeshTxBuilder instance
+   */
+  votePlutusScript = (languageVersion) => {
+    this.addingPlutusVote = true;
+    this.plutusVoteScriptVersion = languageVersion;
+    return this;
+  };
+  /**
+   * Set the instruction that it is currently using V1 Plutus voting scripts
+   * @returns The MeshTxBuilder instance
+   */
+  votePlutusScriptV1 = () => {
+    this.addingPlutusVote = true;
+    this.plutusVoteScriptVersion = "V1";
+    return this;
+  };
+  /**
+   * Set the instruction that it is currently using V2 Plutus voting scripts
+   * @returns The MeshTxBuilder instance
+   */
+  votePlutusScriptV2 = () => {
+    this.addingPlutusVote = true;
+    this.plutusVoteScriptVersion = "V2";
+    return this;
+  };
+  /**
+   * Set the instruction that it is currently using V3 Plutus voting scripts
+   * @returns The MeshTxBuilder instance
+   */
+  votePlutusScriptV3 = () => {
+    this.addingPlutusVote = true;
+    this.plutusVoteScriptVersion = "V3";
+    return this;
+  };
+  /**
+   * Add a vote in the MeshTxBuilder instance
+   * @param voter The voter, can be a ConstitutionalCommitee, a DRep or a StakePool
+   * @param govActionId - The transaction hash and transaction id of the governance action
+   * @param votingProcedure - The voting kind (Yes, No, Abstain) with an optional anchor
+   * @returns The MeshTxBuilder instance
+   */
+  vote = (voter, govActionId, votingProcedure) => {
+    if (this.voteItem) {
+      this.queueVote();
+    }
+    if (this.addingPlutusVote) {
+      const vote = {
+        type: "ScriptVote",
+        vote: {
+          voter,
+          govActionId,
+          votingProcedure
+        }
+      };
+      this.voteItem = vote;
+    } else {
+      const vote = {
+        type: "BasicVote",
+        vote: {
+          voter,
+          govActionId,
+          votingProcedure
+        }
+      };
+      this.voteItem = vote;
+    }
+    return this;
+  };
+  /**
+   * Add a voting script to the MeshTxBuilder instance
+   * @param scriptCbor The script in CBOR format
+   * @returns The MeshTxBuilder instance
+   */
+  voteScript = (scriptCbor) => {
+    if (!this.voteItem) throw Error("voteScript: Undefined vote");
+    if (this.voteItem.type === "BasicVote") {
+      this.voteItem = {
+        type: "SimpleScriptVote",
+        vote: this.voteItem.vote,
+        simpleScriptSource: {
+          type: "Provided",
+          scriptCode: scriptCbor
+        }
+      };
+    } else if (this.voteItem.type === "ScriptVote") {
+      this.voteItem.scriptSource = {
+        type: "Provided",
+        script: {
+          code: scriptCbor,
+          version: this.plutusVoteScriptVersion || "V2"
+        }
+      };
+    } else if (this.voteItem.type === "SimpleScriptVote") {
+      throw Error("voteScript: Script is already defined for current vote");
+    }
+    return this;
+  };
+  /**
+   * Add a vote reference to the MeshTxBuilder instance
+   * @param txHash The transaction hash of reference UTxO
+   * @param txIndex The transaction index of reference UTxO
+   * @param scriptSize The script size in bytes of the vote script (can be obtained by script hex length / 2)
+   * @param scriptHash The script hash of the vote script
+   * @returns The MeshTxBuilder instance
+   */
+  voteTxInReference = (txHash, txIndex, scriptSize, scriptHash) => {
+    if (!this.voteItem) throw Error("voteTxInReference: Undefined vote");
+    if (this.voteItem.type === "BasicVote")
+      throw Error(
+        "voteTxInReference: Adding script reference to a basic vote"
+      );
+    if (this.voteItem.type === "ScriptVote") {
+      this.voteItem.scriptSource = {
+        type: "Inline",
+        txHash,
+        txIndex,
+        scriptHash,
+        version: this.plutusWithdrawalScriptVersion || "V2",
+        scriptSize
+      };
+    } else if (this.voteItem.type === "SimpleScriptVote") {
+      this.voteItem.simpleScriptSource = {
+        type: "Inline",
+        txHash,
+        txIndex,
+        scriptSize,
+        simpleScriptHash: scriptHash
+      };
+    }
+    return this;
+  };
+  /**
+   * Set the transaction vote redeemer value in the MeshTxBuilder instance
+   * @param redeemer The redeemer in Mesh Data type, JSON in raw constructor like format, or CBOR hex string
+   * @param type The redeemer data type, either Mesh Data type, JSON in raw constructor like format, or CBOR hex string
+   * @param exUnits The execution units budget for the redeemer
+   * @returns The MeshTxBuilder instance
+   */
+  voteRedeemerValue = (redeemer, type = "Mesh", exUnits = { ...DEFAULT_REDEEMER_BUDGET }) => {
+    if (!this.voteItem) throw Error("voteRedeemerValue: Undefined vote");
+    if (!(this.voteItem.type === "ScriptVote"))
+      throw Error("voteRedeemerValue: Adding redeemer to non plutus vote");
+    this.voteItem.redeemer = this.castBuilderDataToRedeemer(
+      redeemer,
+      type,
+      exUnits
+    );
+    return this;
+  };
   /**
    * Creates a pool registration certificate, and adds it to the transaction
    * @param poolParams Parameters for pool registration
@@ -1108,6 +1263,9 @@ var MeshTxBuilderCore = class {
     if (this.withdrawalItem) {
       this.queueWithdrawal();
     }
+    if (this.voteItem) {
+      this.queueVote();
+    }
   };
   queueInput = () => {
     if (!this.txInQueueItem) throw Error("queueInput: Undefined input");
@@ -1159,6 +1317,25 @@ var MeshTxBuilderCore = class {
     this.meshTxBuilderBody.withdrawals.push(this.withdrawalItem);
     this.withdrawalItem = void 0;
   };
+  queueVote = () => {
+    if (!this.voteItem) {
+      throw Error("queueVote: Undefined vote");
+    }
+    if (this.voteItem.type === "ScriptVote") {
+      if (!this.voteItem.scriptSource) {
+        throw Error("queueVote: Missing vote script information");
+      }
+      if (!this.voteItem.redeemer) {
+        throw Error("queueVote: Missing vote redeemer information");
+      }
+    } else if (this.voteItem.type === "SimpleScriptVote") {
+      if (!this.voteItem.simpleScriptSource) {
+        throw Error("queueVote: Missing vote script information");
+      }
+    }
+    this.meshTxBuilderBody.votes.push(this.voteItem);
+    this.voteItem = void 0;
+  };
   castRawDataToJsonString = (rawData) => {
     if (typeof rawData === "object") {
       return JSONBig.stringify(rawData);
@@ -1358,11 +1535,13 @@ var MeshTxBuilderCore = class {
     this.addingPlutusMint = false;
     this.plutusMintingScriptVersion = void 0;
     this.addingPlutusWithdrawal = false;
+    this.addingPlutusVote = false;
     this.plutusWithdrawalScriptVersion = void 0;
     this._protocolParams = DEFAULT_PROTOCOL_PARAMETERS;
     this.mintItem = void 0;
     this.txInQueueItem = void 0;
     this.withdrawalItem = void 0;
+    this.voteItem = void 0;
     this.collateralQueueItem = void 0;
     this.refScriptTxInQueueItem = void 0;
   };
@@ -1699,9 +1878,14 @@ import {
   SUPPORTED_TOKENS
 } from "@meshsdk/common";
 import {
+  Cardano,
+  CardanoSDKUtil,
+  deserializeTx,
   deserializeNativeScript,
   deserializePlutusScript,
-  fromScriptRef
+  fromScriptRef,
+  Serialization,
+  Transaction as Tx
 } from "@meshsdk/core-cst";
 var Transaction = class {
   txBuilder;
@@ -1711,6 +1895,48 @@ var Transaction = class {
     this.txBuilder = new MeshTxBuilder(options);
     this.initiator = options.initiator;
   }
+  static attachMetadata(cborTx, cborTxMetadata) {
+    const tx = deserializeTx(cborTx);
+    const txAuxData = tx.auxiliaryData() ?? new Serialization.AuxiliaryData();
+    txAuxData.setMetadata(
+      Serialization.GeneralTransactionMetadata.fromCbor(CardanoSDKUtil.HexBlob(cborTxMetadata))
+    );
+    if (Cardano.computeAuxiliaryDataHash(txAuxData.toCore())?.toString() !== tx.body().auxiliaryDataHash()?.toString()) {
+      throw new Error(
+        "[Transaction] attachMetadata: The metadata hash does not match the auxiliary data hash."
+      );
+    }
+    return new Tx(tx.body(), tx.witnessSet(), txAuxData).toCbor().toString();
+  }
+  static deattachMetadata(cborTx) {
+    const tx = deserializeTx(cborTx);
+    return new Tx(tx.body(), tx.witnessSet()).toCbor().toString();
+  }
+  static maskMetadata(cborTx) {
+    const tx = deserializeTx(cborTx);
+    const txMetadata = tx.auxiliaryData()?.metadata();
+    if (txMetadata !== void 0) {
+      const mockMetadata = /* @__PURE__ */ new Map();
+      txMetadata.metadata()?.forEach((metadatum, label) => mockMetadata.set(label, mask(metadatum)));
+      const txAuxData = tx.auxiliaryData();
+      txMetadata.setMetadata(mockMetadata);
+      txAuxData?.setMetadata(txMetadata);
+      return new Tx(tx.body(), tx.witnessSet(), txAuxData).toCbor().toString();
+    }
+    return cborTx;
+  }
+  static readMetadata(cborTx) {
+    const tx = deserializeTx(cborTx);
+    return tx.auxiliaryData()?.metadata()?.toCbor().toString() ?? "";
+  }
+  static writeMetadata(cborTx, cborTxMetadata) {
+    const tx = deserializeTx(cborTx);
+    const txAuxData = tx.auxiliaryData() ?? new Serialization.AuxiliaryData();
+    txAuxData.setMetadata(
+      Serialization.GeneralTransactionMetadata.fromCbor(CardanoSDKUtil.HexBlob(cborTxMetadata))
+    );
+    return new Tx(tx.body(), tx.witnessSet(), txAuxData).toCbor().toString();
+  }
   /**
    * Adds an output to the transaction.
    *
@@ -2196,6 +2422,31 @@ var Transaction = class {
     }
   }
 };
+function mask(metadatum) {
+  switch (metadatum.getKind()) {
+    case Serialization.TransactionMetadatumKind.Text:
+      return Serialization.TransactionMetadatum.newText("0".repeat(metadatum.asText()?.length ?? 0));
+    case Serialization.TransactionMetadatumKind.Bytes:
+    case Serialization.TransactionMetadatumKind.Integer:
+      return metadatum;
+    case Serialization.TransactionMetadatumKind.List:
+      const list = new Serialization.MetadatumList();
+      for (let i = 0; i < (metadatum.asList()?.getLength() ?? 0); i++) {
+        list.add(mask(metadatum.asList()?.get(i)));
+      }
+      return Serialization.TransactionMetadatum.newList(list);
+    case Serialization.TransactionMetadatumKind.Map:
+      const map = new Serialization.MetadatumMap();
+      for (let i = 0; i < (metadatum.asMap()?.getLength() ?? 0); i++) {
+        const key = metadatum.asMap()?.getKeys().get(i);
+        const value = metadatum.asMap()?.get(key);
+        map.insert(key, mask(value));
+      }
+      return Serialization.TransactionMetadatum.newMap(map);
+    default:
+      throw new Error(`Unsupported metadatum kind: ${metadatum.getKind()}`);
+  }
+}
 export {
   ForgeScript,
   MeshTxBuilder,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshsdk/transaction",
-  "version": "1.7.6",
+  "version": "1.7.8",
   "description": "",
   "main": "./dist/index.cjs",
   "browser": "./dist/index.js",
@@ -35,9 +35,9 @@
     "typescript": "^5.3.3"
   },
   "dependencies": {
-    "@meshsdk/common": "1.7.6",
-    "@meshsdk/core-csl": "1.7.6",
-    "@meshsdk/core-cst": "1.7.6",
+    "@meshsdk/common": "1.7.8",
+    "@meshsdk/core-csl": "1.7.8",
+    "@meshsdk/core-cst": "1.7.8",
     "json-bigint": "^1.0.0"
   },
   "prettier": "@meshsdk/configs/prettier",