@meshsdk/transaction 1.9.0-beta.54 → 1.9.0-beta.56

package/dist/index.cjs

@@ -33,8 +33,14 @@ __export(index_exports, {
   ForgeScript: () => ForgeScript,
   MeshTxBuilder: () => MeshTxBuilder,
   Transaction: () => Transaction,
+  TxParser: () => TxParser,
+  cloneOutput: () => cloneOutput,
+  getLovelace: () => getLovelace,
+  getOutputMinLovelace: () => getOutputMinLovelace,
+  getUtxoMinLovelace: () => getUtxoMinLovelace,
   mergeContents: () => mergeContents,
   metadataObjToMap: () => metadataObjToMap,
+  setLoveLace: () => setLoveLace,
   utxoToTxIn: () => utxoToTxIn
 });
 module.exports = __toCommonJS(index_exports);
@@ -1385,6 +1391,7 @@ var bignumber_default = BigNumber;
 
 // src/mesh-tx-builder/index.ts
 var import_json_bigint3 = __toESM(require("json-bigint"), 1);
+var import_common3 = require("@meshsdk/common");
 var import_core_cst3 = require("@meshsdk/core-cst");
 
 // src/mesh-tx-builder/coin-selection/cardano-sdk-adapter.ts
@@ -3584,6 +3591,7 @@ var MeshTxBuilderCore = class {
 };
 
 // src/mesh-tx-builder/utils.ts
+var import_common2 = require("@meshsdk/common");
 var utxoToTxIn = (utxo) => {
   return [
     utxo.input.txHash,
@@ -3592,6 +3600,36 @@ var utxoToTxIn = (utxo) => {
     utxo.output.address
   ];
 };
+var getUtxoMinLovelace = (utxo, coinsPerUtxoSize = import_common2.DEFAULT_PROTOCOL_PARAMETERS.coinsPerUtxoSize) => {
+  const referenceScript = utxo.scriptRef ? { code: utxo.scriptRef, version: "V3" } : void 0;
+  let datum;
+  if (utxo.plutusData) {
+    datum = {
+      type: "Inline",
+      data: {
+        content: utxo.plutusData,
+        type: "CBOR"
+      }
+    };
+  } else if (utxo.dataHash) {
+    datum = {
+      type: "Hash",
+      data: {
+        content: utxo.dataHash,
+        // usually this should be entire datum cbor, but irrelevant in min utxo calculation
+        type: "CBOR"
+      }
+    };
+  }
+  const output = {
+    address: utxo.address,
+    amount: utxo.amount,
+    referenceScript,
+    datum
+  };
+  const minLovelace = getOutputMinLovelace(output, coinsPerUtxoSize);
+  return minLovelace;
+};
 
 // src/mesh-tx-builder/index.ts
 var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
@@ -4353,6 +4391,7 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
   };
   collectAllRequiredSignatures = () => {
     const { paymentCreds, byronAddresses } = this.getInputsRequiredSignatures();
+    const { collateralPaymentCreds, collateralByronAddresses } = this.getCollateralRequiredSignatures();
     const withdrawalCreds = this.getWithdrawalRequiredSignatures();
     const certCreds = this.getCertificatesRequiredSignatures();
     const voteCreds = this.getVoteRequiredSignatures();
@@ -4361,12 +4400,17 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
     const allCreds = /* @__PURE__ */ new Set([
       ...paymentCreds,
       ...withdrawalCreds,
+      ...collateralPaymentCreds,
       ...certCreds,
       ...voteCreds,
       ...requiredSignatures,
       ...mintCreds
     ]);
-    return { keyHashes: allCreds, byronAddresses };
+    const allByronAddresses = /* @__PURE__ */ new Set([
+      ...byronAddresses,
+      ...collateralByronAddresses
+    ]);
+    return { keyHashes: allCreds, byronAddresses: allByronAddresses };
   };
   getInputsRequiredSignatures() {
     const byronAddresses = /* @__PURE__ */ new Set();
@@ -4399,6 +4443,29 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
     }
     return { paymentCreds, byronAddresses };
   }
+  getCollateralRequiredSignatures() {
+    const collateralByronAddresses = /* @__PURE__ */ new Set();
+    const collateralPaymentCreds = /* @__PURE__ */ new Set();
+    for (let collateral of this.meshTxBuilderBody.collaterals) {
+      if (collateral.type === "PubKey") {
+        if (collateral.txIn.address) {
+          const address = import_core_cst3.Address.fromString(collateral.txIn.address);
+          if (!address) {
+            continue;
+          }
+          const addressDetails = address.getProps();
+          const paymentCred = addressDetails.paymentPart;
+          if (paymentCred?.type === import_core_cst3.CredentialType.KeyHash) {
+            collateralPaymentCreds.add(paymentCred.hash);
+          }
+          if (addressDetails.type === import_core_cst3.AddressType.Byron) {
+            collateralByronAddresses.add(collateral.txIn.address);
+          }
+        }
+      }
+    }
+    return { collateralPaymentCreds, collateralByronAddresses };
+  }
   getWithdrawalRequiredSignatures() {
     const withdrawalCreds = /* @__PURE__ */ new Set();
     for (let withdrawal of this.meshTxBuilderBody.withdrawals) {
@@ -4980,24 +5047,7 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
     );
   };
   calculateMinLovelaceForOutput = (output) => {
-    let currentOutput = cloneOutput(output);
-    let lovelace = getLovelace(currentOutput);
-    let minAda = 0n;
-    for (let i = 0; i < 3; i++) {
-      const txOutSize = BigInt(
-        this.serializer.serializeOutput(currentOutput).length / 2
-      );
-      const txOutByteCost = BigInt(this._protocolParams.coinsPerUtxoSize);
-      const totalOutCost = (160n + BigInt(txOutSize)) * txOutByteCost;
-      minAda = totalOutCost;
-      if (lovelace < totalOutCost) {
-        lovelace = totalOutCost;
-      } else {
-        break;
-      }
-      currentOutput = setLoveLace(currentOutput, lovelace);
-    }
-    return minAda;
+    return getOutputMinLovelace(output, this._protocolParams.coinsPerUtxoSize);
   };
   clone() {
     const newBuilder = super._cloneCore(() => {
@@ -5076,6 +5126,27 @@ var getLovelace = (output) => {
   }
   return 0n;
 };
+var getOutputMinLovelace = (output, coinsPerUtxoSize = import_common3.DEFAULT_PROTOCOL_PARAMETERS.coinsPerUtxoSize) => {
+  const serializer = new import_core_cst3.CardanoSDKSerializer();
+  let currentOutput = cloneOutput(output);
+  let lovelace = getLovelace(currentOutput);
+  let minLovelace = 0n;
+  for (let i = 0; i < 3; i++) {
+    const txOutSize = BigInt(
+      serializer.serializeOutput(currentOutput).length / 2
+    );
+    const txOutByteCost = BigInt(coinsPerUtxoSize);
+    const totalOutCost = (160n + BigInt(txOutSize)) * txOutByteCost;
+    minLovelace = totalOutCost;
+    if (lovelace < totalOutCost) {
+      lovelace = totalOutCost;
+    } else {
+      break;
+    }
+    currentOutput = setLoveLace(currentOutput, lovelace);
+  }
+  return minLovelace;
+};
 
 // src/scripts/forge.script.ts
 var import_core_cst4 = require("@meshsdk/core-cst");
@@ -5125,7 +5196,7 @@ var ForgeScript = class {
 };
 
 // src/transaction/index.ts
-var import_common2 = require("@meshsdk/common");
+var import_common4 = require("@meshsdk/common");
 var import_core_cst5 = require("@meshsdk/core-cst");
 var Transaction = class {
   txBuilder;
@@ -5254,7 +5325,7 @@ var Transaction = class {
    * @see {@link https://meshjs.dev/apis/transaction#sendToken}
    */
   sendToken(recipient, ticker, amount) {
-    const assets = [{ unit: import_common2.SUPPORTED_TOKENS[ticker], quantity: amount }];
+    const assets = [{ unit: import_common4.SUPPORTED_TOKENS[ticker], quantity: amount }];
     return this.sendAssets(recipient, assets);
   }
   /**
@@ -5340,7 +5411,7 @@ var Transaction = class {
     const { value, script, datum, redeemer } = options;
     const red = redeemer || {
       data: { alternative: 0, fields: ["mesh"] },
-      budget: import_common2.DEFAULT_REDEEMER_BUDGET
+      budget: import_common4.DEFAULT_REDEEMER_BUDGET
     };
     if ("code" in script) {
       this.isCollateralNeeded = true;
@@ -5386,10 +5457,10 @@ var Transaction = class {
    */
   mintAsset(forgeScript, mint, redeemer) {
     const assetQuantity = mint.assetQuantity;
-    let assetNameHex = (0, import_common2.stringToHex)(mint.assetName);
-    const referenceAssetNameHex = (0, import_common2.CIP68_100)(assetNameHex);
+    let assetNameHex = (0, import_common4.stringToHex)(mint.assetName);
+    const referenceAssetNameHex = (0, import_common4.CIP68_100)(assetNameHex);
     if (mint.cip68ScriptAddress) {
-      assetNameHex = (0, import_common2.CIP68_222)(assetNameHex);
+      assetNameHex = (0, import_common4.CIP68_222)(assetNameHex);
     }
     let policyId = "";
     switch (typeof forgeScript) {
@@ -5461,7 +5532,7 @@ var Transaction = class {
       this.sendAssets(
         {
           address: mint.cip68ScriptAddress,
-          datum: { inline: true, value: (0, import_common2.metadataToCip68)(mint.metadata) }
+          datum: { inline: true, value: (0, import_common4.metadataToCip68)(mint.metadata) }
         },
         [
           {
@@ -5502,7 +5573,7 @@ var Transaction = class {
   burnAsset(forgeScript, asset, redeemer) {
     const assetQuantity = "-" + asset.quantity;
     const mint = {
-      assetName: (0, import_common2.hexToString)(asset.unit.slice(import_common2.POLICY_ID_LENGTH)),
+      assetName: (0, import_common4.hexToString)(asset.unit.slice(import_common4.POLICY_ID_LENGTH)),
       assetQuantity
     };
     try {
@@ -5776,12 +5847,67 @@ function mask(metadatum) {
       throw new Error(`Unsupported metadatum kind: ${metadatum.getKind()}`);
   }
 }
+
+// src/tx-parser/index.ts
+var TxParser = class {
+  constructor(serializer, fetcher) {
+    this.serializer = serializer;
+    this.fetcher = fetcher;
+  }
+  parse = async (txHex, providedUtxos = []) => {
+    const resolvedUtxos = [...providedUtxos];
+    const resolvedUtxosSet = new Set(
+      providedUtxos.map(
+        (utxo) => `${utxo.input.txHash}#${utxo.input.outputIndex}`
+      )
+    );
+    const toResolveUtxos = {};
+    const fetchResult = {};
+    this.serializer.parser.getRequiredInputs(txHex).forEach((input) => {
+      if (!resolvedUtxosSet.has(`${input.txHash}#${input.outputIndex}`)) {
+        if (!toResolveUtxos[input.txHash]) {
+          toResolveUtxos[input.txHash] = [];
+        }
+        toResolveUtxos[input.txHash].push(input.outputIndex);
+      }
+    });
+    for (const txHash in toResolveUtxos) {
+      const outputIndices = toResolveUtxos[txHash];
+      if (!this.fetcher) {
+        throw new Error(
+          "Fetcher is not provided. Cannot resolve UTxOs without fetcher."
+        );
+      }
+      const utxos = await this.fetcher.fetchUTxOs(txHash);
+      outputIndices?.forEach((outputIndex) => {
+        const utxoData = utxos.find(
+          (utxo) => utxo.input.outputIndex === outputIndex
+        );
+        if (!utxoData) {
+          throw new Error(`UTxO not found: ${txHash}:${outputIndex}`);
+        }
+        resolvedUtxos.push(utxoData);
+      });
+    }
+    this.serializer.parser.parse(txHex, resolvedUtxos);
+    return this.serializer.parser.getBuilderBody();
+  };
+  getBuilderBody = () => this.serializer.parser.getBuilderBody();
+  getBuilderBodyWithoutChange = () => this.serializer.parser.getBuilderBodyWithoutChange();
+  toTester = () => this.serializer.parser.toTester();
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ForgeScript,
   MeshTxBuilder,
   Transaction,
+  TxParser,
+  cloneOutput,
+  getLovelace,
+  getOutputMinLovelace,
+  getUtxoMinLovelace,
   mergeContents,
   metadataObjToMap,
+  setLoveLace,
   utxoToTxIn
 });

package/dist/index.d.cts

@@ -1,3 +1,4 @@
+import * as _meshsdk_common from '@meshsdk/common';
 import { UTxO, TxOutput, Action, Protocol, MintItem, TxIn, Withdrawal, Vote, PubKeyTxIn, RefTxIn, MeshTxBuilderBody, Asset, BuilderData, LanguageVersion, Voter, VotingProcedure, PoolParams, Anchor, DRep, Metadatum, Network, Redeemer, IFetcher, ISubmitter, IEvaluator, IMeshTxSerializer, ScriptSource, SimpleScriptSourceInfo, Certificate, MintParam, Output, NativeScript as NativeScript$1, IInitiator, Recipient, Token, PlutusScript, Budget, Data, Mint } from '@meshsdk/common';
 import { CredentialCore, NativeScript } from '@meshsdk/core-cst';
 
@@ -541,6 +542,13 @@ declare class MeshTxBuilderCore {
  * @returns [txHash, outputIndex, amount, address]
  */
 declare const utxoToTxIn: (utxo: UTxO) => [string, number, Asset[], string];
+/**
+ * Calculate minimum lovelace required for a UTxO output
+ * @param utxo Output of utxo
+ * @param coinsPerUtxoSize From protocol parameters
+ * @returns Minimum lovelace required for the UTxO
+ */
+declare const getUtxoMinLovelace: (utxo: TxOutput, coinsPerUtxoSize?: number) => bigint;
 
 interface MeshTxBuilderOptions {
     fetcher?: IFetcher;
@@ -632,6 +640,10 @@ declare class MeshTxBuilder extends MeshTxBuilderCore {
         paymentCreds: Set<string>;
         byronAddresses: Set<string>;
     };
+    protected getCollateralRequiredSignatures(): {
+        collateralPaymentCreds: Set<string>;
+        collateralByronAddresses: Set<string>;
+    };
     protected getWithdrawalRequiredSignatures(): Set<string>;
     protected getCertificatesRequiredSignatures(): Set<string>;
     protected getVoteRequiredSignatures(): Set<string>;
@@ -669,6 +681,10 @@ declare class MeshTxBuilder extends MeshTxBuilderCore {
     calculateMinLovelaceForOutput: (output: Output) => bigint;
     protected clone(): MeshTxBuilder;
 }
+declare const cloneOutput: (output: Output) => Output;
+declare const setLoveLace: (output: Output, lovelace: bigint) => Output;
+declare const getLovelace: (output: Output) => bigint;
+declare const getOutputMinLovelace: (output: Output, coinsPerUtxoSize?: number) => bigint;
 
 declare class ForgeScript {
     static withOneSignature(address: string): string;
@@ -942,4 +958,19 @@ declare const metadataObjToMap: (metadata: any) => Metadatum;
  */
 declare const mergeContents: (a: Metadatum, b: Metadatum, currentDepth: number) => Metadatum;
 
-export { ForgeScript, MeshTxBuilder, type MeshTxBuilderOptions, type MetadataMergeLevel, Transaction, type TransactionOptions, mergeContents, metadataObjToMap, utxoToTxIn };
+/**
+ * TxParser class to parse transaction hex strings and resolve UTxOs.
+ *
+ * It is used for either manipulating transactions or for unit testing transaction buildings.
+ */
+declare class TxParser {
+    serializer: IMeshTxSerializer;
+    fetcher?: IFetcher | undefined;
+    constructor(serializer: IMeshTxSerializer, fetcher?: IFetcher | undefined);
+    parse: (txHex: string, providedUtxos?: UTxO[]) => Promise<_meshsdk_common.MeshTxBuilderBody>;
+    getBuilderBody: () => _meshsdk_common.MeshTxBuilderBody;
+    getBuilderBodyWithoutChange: () => _meshsdk_common.MeshTxBuilderBody;
+    toTester: () => _meshsdk_common.TxTester;
+}
+
+export { ForgeScript, MeshTxBuilder, type MeshTxBuilderOptions, type MetadataMergeLevel, Transaction, type TransactionOptions, TxParser, cloneOutput, getLovelace, getOutputMinLovelace, getUtxoMinLovelace, mergeContents, metadataObjToMap, setLoveLace, utxoToTxIn };

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import * as _meshsdk_common from '@meshsdk/common';
 import { UTxO, TxOutput, Action, Protocol, MintItem, TxIn, Withdrawal, Vote, PubKeyTxIn, RefTxIn, MeshTxBuilderBody, Asset, BuilderData, LanguageVersion, Voter, VotingProcedure, PoolParams, Anchor, DRep, Metadatum, Network, Redeemer, IFetcher, ISubmitter, IEvaluator, IMeshTxSerializer, ScriptSource, SimpleScriptSourceInfo, Certificate, MintParam, Output, NativeScript as NativeScript$1, IInitiator, Recipient, Token, PlutusScript, Budget, Data, Mint } from '@meshsdk/common';
 import { CredentialCore, NativeScript } from '@meshsdk/core-cst';
 
@@ -541,6 +542,13 @@ declare class MeshTxBuilderCore {
  * @returns [txHash, outputIndex, amount, address]
  */
 declare const utxoToTxIn: (utxo: UTxO) => [string, number, Asset[], string];
+/**
+ * Calculate minimum lovelace required for a UTxO output
+ * @param utxo Output of utxo
+ * @param coinsPerUtxoSize From protocol parameters
+ * @returns Minimum lovelace required for the UTxO
+ */
+declare const getUtxoMinLovelace: (utxo: TxOutput, coinsPerUtxoSize?: number) => bigint;
 
 interface MeshTxBuilderOptions {
     fetcher?: IFetcher;
@@ -632,6 +640,10 @@ declare class MeshTxBuilder extends MeshTxBuilderCore {
         paymentCreds: Set<string>;
         byronAddresses: Set<string>;
     };
+    protected getCollateralRequiredSignatures(): {
+        collateralPaymentCreds: Set<string>;
+        collateralByronAddresses: Set<string>;
+    };
     protected getWithdrawalRequiredSignatures(): Set<string>;
     protected getCertificatesRequiredSignatures(): Set<string>;
     protected getVoteRequiredSignatures(): Set<string>;
@@ -669,6 +681,10 @@ declare class MeshTxBuilder extends MeshTxBuilderCore {
     calculateMinLovelaceForOutput: (output: Output) => bigint;
     protected clone(): MeshTxBuilder;
 }
+declare const cloneOutput: (output: Output) => Output;
+declare const setLoveLace: (output: Output, lovelace: bigint) => Output;
+declare const getLovelace: (output: Output) => bigint;
+declare const getOutputMinLovelace: (output: Output, coinsPerUtxoSize?: number) => bigint;
 
 declare class ForgeScript {
     static withOneSignature(address: string): string;
@@ -942,4 +958,19 @@ declare const metadataObjToMap: (metadata: any) => Metadatum;
  */
 declare const mergeContents: (a: Metadatum, b: Metadatum, currentDepth: number) => Metadatum;
 
-export { ForgeScript, MeshTxBuilder, type MeshTxBuilderOptions, type MetadataMergeLevel, Transaction, type TransactionOptions, mergeContents, metadataObjToMap, utxoToTxIn };
+/**
+ * TxParser class to parse transaction hex strings and resolve UTxOs.
+ *
+ * It is used for either manipulating transactions or for unit testing transaction buildings.
+ */
+declare class TxParser {
+    serializer: IMeshTxSerializer;
+    fetcher?: IFetcher | undefined;
+    constructor(serializer: IMeshTxSerializer, fetcher?: IFetcher | undefined);
+    parse: (txHex: string, providedUtxos?: UTxO[]) => Promise<_meshsdk_common.MeshTxBuilderBody>;
+    getBuilderBody: () => _meshsdk_common.MeshTxBuilderBody;
+    getBuilderBodyWithoutChange: () => _meshsdk_common.MeshTxBuilderBody;
+    toTester: () => _meshsdk_common.TxTester;
+}
+
+export { ForgeScript, MeshTxBuilder, type MeshTxBuilderOptions, type MetadataMergeLevel, Transaction, type TransactionOptions, TxParser, cloneOutput, getLovelace, getOutputMinLovelace, getUtxoMinLovelace, mergeContents, metadataObjToMap, setLoveLace, utxoToTxIn };

package/dist/index.js

@@ -1344,6 +1344,9 @@ var bignumber_default = BigNumber;
 
 // src/mesh-tx-builder/index.ts
 import JSONBig3 from "json-bigint";
+import {
+  DEFAULT_PROTOCOL_PARAMETERS as DEFAULT_PROTOCOL_PARAMETERS3
+} from "@meshsdk/common";
 import {
   CardanoSDKSerializer,
   toDRep as coreToCstDRep,
@@ -3564,6 +3567,9 @@ var MeshTxBuilderCore = class {
 };
 
 // src/mesh-tx-builder/utils.ts
+import {
+  DEFAULT_PROTOCOL_PARAMETERS as DEFAULT_PROTOCOL_PARAMETERS2
+} from "@meshsdk/common";
 var utxoToTxIn = (utxo) => {
   return [
     utxo.input.txHash,
@@ -3572,6 +3578,36 @@ var utxoToTxIn = (utxo) => {
     utxo.output.address
   ];
 };
+var getUtxoMinLovelace = (utxo, coinsPerUtxoSize = DEFAULT_PROTOCOL_PARAMETERS2.coinsPerUtxoSize) => {
+  const referenceScript = utxo.scriptRef ? { code: utxo.scriptRef, version: "V3" } : void 0;
+  let datum;
+  if (utxo.plutusData) {
+    datum = {
+      type: "Inline",
+      data: {
+        content: utxo.plutusData,
+        type: "CBOR"
+      }
+    };
+  } else if (utxo.dataHash) {
+    datum = {
+      type: "Hash",
+      data: {
+        content: utxo.dataHash,
+        // usually this should be entire datum cbor, but irrelevant in min utxo calculation
+        type: "CBOR"
+      }
+    };
+  }
+  const output = {
+    address: utxo.address,
+    amount: utxo.amount,
+    referenceScript,
+    datum
+  };
+  const minLovelace = getOutputMinLovelace(output, coinsPerUtxoSize);
+  return minLovelace;
+};
 
 // src/mesh-tx-builder/index.ts
 var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
@@ -4333,6 +4369,7 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
   };
   collectAllRequiredSignatures = () => {
     const { paymentCreds, byronAddresses } = this.getInputsRequiredSignatures();
+    const { collateralPaymentCreds, collateralByronAddresses } = this.getCollateralRequiredSignatures();
     const withdrawalCreds = this.getWithdrawalRequiredSignatures();
     const certCreds = this.getCertificatesRequiredSignatures();
     const voteCreds = this.getVoteRequiredSignatures();
@@ -4341,12 +4378,17 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
     const allCreds = /* @__PURE__ */ new Set([
       ...paymentCreds,
       ...withdrawalCreds,
+      ...collateralPaymentCreds,
       ...certCreds,
       ...voteCreds,
       ...requiredSignatures,
       ...mintCreds
     ]);
-    return { keyHashes: allCreds, byronAddresses };
+    const allByronAddresses = /* @__PURE__ */ new Set([
+      ...byronAddresses,
+      ...collateralByronAddresses
+    ]);
+    return { keyHashes: allCreds, byronAddresses: allByronAddresses };
   };
   getInputsRequiredSignatures() {
     const byronAddresses = /* @__PURE__ */ new Set();
@@ -4379,6 +4421,29 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
     }
     return { paymentCreds, byronAddresses };
   }
+  getCollateralRequiredSignatures() {
+    const collateralByronAddresses = /* @__PURE__ */ new Set();
+    const collateralPaymentCreds = /* @__PURE__ */ new Set();
+    for (let collateral of this.meshTxBuilderBody.collaterals) {
+      if (collateral.type === "PubKey") {
+        if (collateral.txIn.address) {
+          const address = CstAddress.fromString(collateral.txIn.address);
+          if (!address) {
+            continue;
+          }
+          const addressDetails = address.getProps();
+          const paymentCred = addressDetails.paymentPart;
+          if (paymentCred?.type === CstCredentialType.KeyHash) {
+            collateralPaymentCreds.add(paymentCred.hash);
+          }
+          if (addressDetails.type === CstAddressType.Byron) {
+            collateralByronAddresses.add(collateral.txIn.address);
+          }
+        }
+      }
+    }
+    return { collateralPaymentCreds, collateralByronAddresses };
+  }
   getWithdrawalRequiredSignatures() {
     const withdrawalCreds = /* @__PURE__ */ new Set();
     for (let withdrawal of this.meshTxBuilderBody.withdrawals) {
@@ -4960,24 +5025,7 @@ var MeshTxBuilder = class _MeshTxBuilder extends MeshTxBuilderCore {
     );
   };
   calculateMinLovelaceForOutput = (output) => {
-    let currentOutput = cloneOutput(output);
-    let lovelace = getLovelace(currentOutput);
-    let minAda = 0n;
-    for (let i = 0; i < 3; i++) {
-      const txOutSize = BigInt(
-        this.serializer.serializeOutput(currentOutput).length / 2
-      );
-      const txOutByteCost = BigInt(this._protocolParams.coinsPerUtxoSize);
-      const totalOutCost = (160n + BigInt(txOutSize)) * txOutByteCost;
-      minAda = totalOutCost;
-      if (lovelace < totalOutCost) {
-        lovelace = totalOutCost;
-      } else {
-        break;
-      }
-      currentOutput = setLoveLace(currentOutput, lovelace);
-    }
-    return minAda;
+    return getOutputMinLovelace(output, this._protocolParams.coinsPerUtxoSize);
   };
   clone() {
     const newBuilder = super._cloneCore(() => {
@@ -5056,6 +5104,27 @@ var getLovelace = (output) => {
   }
   return 0n;
 };
+var getOutputMinLovelace = (output, coinsPerUtxoSize = DEFAULT_PROTOCOL_PARAMETERS3.coinsPerUtxoSize) => {
+  const serializer = new CardanoSDKSerializer();
+  let currentOutput = cloneOutput(output);
+  let lovelace = getLovelace(currentOutput);
+  let minLovelace = 0n;
+  for (let i = 0; i < 3; i++) {
+    const txOutSize = BigInt(
+      serializer.serializeOutput(currentOutput).length / 2
+    );
+    const txOutByteCost = BigInt(coinsPerUtxoSize);
+    const totalOutCost = (160n + BigInt(txOutSize)) * txOutByteCost;
+    minLovelace = totalOutCost;
+    if (lovelace < totalOutCost) {
+      lovelace = totalOutCost;
+    } else {
+      break;
+    }
+    currentOutput = setLoveLace(currentOutput, lovelace);
+  }
+  return minLovelace;
+};
 
 // src/scripts/forge.script.ts
 import {
@@ -5779,11 +5848,66 @@ function mask(metadatum) {
       throw new Error(`Unsupported metadatum kind: ${metadatum.getKind()}`);
   }
 }
+
+// src/tx-parser/index.ts
+var TxParser = class {
+  constructor(serializer, fetcher) {
+    this.serializer = serializer;
+    this.fetcher = fetcher;
+  }
+  parse = async (txHex, providedUtxos = []) => {
+    const resolvedUtxos = [...providedUtxos];
+    const resolvedUtxosSet = new Set(
+      providedUtxos.map(
+        (utxo) => `${utxo.input.txHash}#${utxo.input.outputIndex}`
+      )
+    );
+    const toResolveUtxos = {};
+    const fetchResult = {};
+    this.serializer.parser.getRequiredInputs(txHex).forEach((input) => {
+      if (!resolvedUtxosSet.has(`${input.txHash}#${input.outputIndex}`)) {
+        if (!toResolveUtxos[input.txHash]) {
+          toResolveUtxos[input.txHash] = [];
+        }
+        toResolveUtxos[input.txHash].push(input.outputIndex);
+      }
+    });
+    for (const txHash in toResolveUtxos) {
+      const outputIndices = toResolveUtxos[txHash];
+      if (!this.fetcher) {
+        throw new Error(
+          "Fetcher is not provided. Cannot resolve UTxOs without fetcher."
+        );
+      }
+      const utxos = await this.fetcher.fetchUTxOs(txHash);
+      outputIndices?.forEach((outputIndex) => {
+        const utxoData = utxos.find(
+          (utxo) => utxo.input.outputIndex === outputIndex
+        );
+        if (!utxoData) {
+          throw new Error(`UTxO not found: ${txHash}:${outputIndex}`);
+        }
+        resolvedUtxos.push(utxoData);
+      });
+    }
+    this.serializer.parser.parse(txHex, resolvedUtxos);
+    return this.serializer.parser.getBuilderBody();
+  };
+  getBuilderBody = () => this.serializer.parser.getBuilderBody();
+  getBuilderBodyWithoutChange = () => this.serializer.parser.getBuilderBodyWithoutChange();
+  toTester = () => this.serializer.parser.toTester();
+};
 export {
   ForgeScript,
   MeshTxBuilder,
   Transaction,
+  TxParser,
+  cloneOutput,
+  getLovelace,
+  getOutputMinLovelace,
+  getUtxoMinLovelace,
   mergeContents,
   metadataObjToMap,
+  setLoveLace,
   utxoToTxIn
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshsdk/transaction",
-  "version": "1.9.0-beta.54",
+  "version": "1.9.0-beta.56",
   "description": "Transactions - https://meshjs.dev/apis/transaction",
   "main": "./dist/index.cjs",
   "browser": "./dist/index.js",
@@ -35,8 +35,8 @@
     "typescript": "^5.3.3"
   },
   "dependencies": {
-    "@meshsdk/common": "1.9.0-beta.54",
-    "@meshsdk/core-cst": "1.9.0-beta.54",
+    "@meshsdk/common": "1.9.0-beta.56",
+    "@meshsdk/core-cst": "1.9.0-beta.56",
     "@cardano-sdk/core": "^0.45.5",
     "@cardano-sdk/util": "^0.15.5",
     "@cardano-sdk/input-selection": "^0.13.33",