@meshsdk/transaction 1.7.5 → 1.7.7

package/dist/index.cjs

@@ -905,6 +905,22 @@ var MeshTxBuilderCore = class {
     });
     return this;
   };
+  /**
+   * Update DRep certificate, and adds it to the transaction
+   * @param drepId The bech32 drep id (i.e. starts with `drep1xxxxx`)
+   * @param anchor The DRep anchor, consists of a URL and a hash of the doc
+   */
+  drepUpdateCertificate = (drepId, anchor) => {
+    this.meshTxBuilderBody.certificates.push({
+      type: "BasicCertificate",
+      certType: {
+        type: "DRepUpdate",
+        drepId,
+        anchor
+      }
+    });
+    return this;
+  };
   /**
    * Dregister DRep certificate, and adds it to the transaction
    * @param drepId The bech32 drep id (i.e. starts with `drep1xxxxx`)
@@ -1710,6 +1726,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.
    *
@@ -2195,6 +2253,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

@@ -336,6 +336,12 @@ declare class MeshTxBuilderCore {
      * @returns The MeshTxBuilder instance
      */
     drepDeregistrationCertificate: (drepId: string, coin?: string) => this;
+    /**
+     * Update DRep certificate, and adds it to the transaction
+     * @param drepId The bech32 drep id (i.e. starts with `drep1xxxxx`)
+     * @param anchor The DRep anchor, consists of a URL and a hash of the doc
+     */
+    drepUpdateCertificate: (drepId: string, anchor?: Anchor) => this;
     /**
      * Dregister DRep certificate, and adds it to the transaction
      * @param drepId The bech32 drep id (i.e. starts with `drep1xxxxx`)
@@ -507,6 +513,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

@@ -336,6 +336,12 @@ declare class MeshTxBuilderCore {
      * @returns The MeshTxBuilder instance
      */
     drepDeregistrationCertificate: (drepId: string, coin?: string) => this;
+    /**
+     * Update DRep certificate, and adds it to the transaction
+     * @param drepId The bech32 drep id (i.e. starts with `drep1xxxxx`)
+     * @param anchor The DRep anchor, consists of a URL and a hash of the doc
+     */
+    drepUpdateCertificate: (drepId: string, anchor?: Anchor) => this;
     /**
      * Dregister DRep certificate, and adds it to the transaction
      * @param drepId The bech32 drep id (i.e. starts with `drep1xxxxx`)
@@ -507,6 +513,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

@@ -872,6 +872,22 @@ var MeshTxBuilderCore = class {
     });
     return this;
   };
+  /**
+   * Update DRep certificate, and adds it to the transaction
+   * @param drepId The bech32 drep id (i.e. starts with `drep1xxxxx`)
+   * @param anchor The DRep anchor, consists of a URL and a hash of the doc
+   */
+  drepUpdateCertificate = (drepId, anchor) => {
+    this.meshTxBuilderBody.certificates.push({
+      type: "BasicCertificate",
+      certType: {
+        type: "DRepUpdate",
+        drepId,
+        anchor
+      }
+    });
+    return this;
+  };
   /**
    * Dregister DRep certificate, and adds it to the transaction
    * @param drepId The bech32 drep id (i.e. starts with `drep1xxxxx`)
@@ -1683,9 +1699,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;
@@ -1695,6 +1716,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.
    *
@@ -2180,6 +2243,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,8 +1,9 @@
 {
   "name": "@meshsdk/transaction",
-  "version": "1.7.5",
+  "version": "1.7.7",
   "description": "",
   "main": "./dist/index.cjs",
+  "browser": "./dist/index.js",
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
   "type": "module",
@@ -34,9 +35,9 @@
     "typescript": "^5.3.3"
   },
   "dependencies": {
-    "@meshsdk/common": "1.7.5",
-    "@meshsdk/core-csl": "1.7.5",
-    "@meshsdk/core-cst": "1.7.5",
+    "@meshsdk/common": "1.7.7",
+    "@meshsdk/core-csl": "1.7.7",
+    "@meshsdk/core-cst": "1.7.7",
     "json-bigint": "^1.0.0"
   },
   "prettier": "@meshsdk/configs/prettier",