@meshsdk/core-csl 1.7.15 → 1.7.17

package/dist/index.cjs

@@ -32,6 +32,7 @@ var src_exports = {};
 __export(src_exports, {
   CSLSerializer: () => CSLSerializer,
   LANGUAGE_VERSIONS: () => LANGUAGE_VERSIONS,
+  OfflineEvaluator: () => OfflineEvaluator,
   POLICY_ID_LENGTH: () => POLICY_ID_LENGTH,
   REDEEMER_TAGS: () => REDEEMER_TAGS,
   addrBech32ToHex: () => addrBech32ToHex,
@@ -65,9 +66,11 @@ __export(src_exports, {
   deserializeTxUnspentOutput: () => deserializeTxUnspentOutput,
   deserializeTxWitnessSet: () => deserializeTxWitnessSet,
   deserializeValue: () => deserializeValue,
+  evaluateTransaction: () => evaluateTransaction,
   fromBytes: () => fromBytes,
   fromLovelace: () => fromLovelace,
   fromUTF8: () => fromUTF8,
+  getTransactionInputs: () => getTransactionInputs,
   getV2ScriptHash: () => getV2ScriptHash,
   keyHashToRewardAddress: () => keyHashToRewardAddress,
   meshTxBuilderBodyToObj: () => meshTxBuilderBodyToObj,
@@ -524,6 +527,86 @@ var signTransaction = (txHex, signingKeys) => {
   const result = csl.js_sign_transaction(txHex, cslSigningKeys);
   return parseWasmResult(result);
 };
+var evaluateTransaction = (txHex, resolvedUtxos, network) => {
+  const additionalTxs = csl.JsVecString.new();
+  const mappedUtxos = csl.JsVecString.new();
+  for (const utxo of resolvedUtxos) {
+    mappedUtxos.add(JSON.stringify(utxo));
+  }
+  const result = csl.evaluate_tx_scripts_js(txHex, mappedUtxos, additionalTxs, network);
+  const unwrappedResult = parseWasmResult(result);
+  try {
+    const actions = JSON.parse(unwrappedResult);
+    return actions.map(mapAction);
+  } catch (e) {
+    throw new Error("Cannot parse result from evaluate_tx_scripts_js. Expected Action[] type");
+  }
+};
+var mapAction = (action) => {
+  return {
+    index: action.index,
+    budget: mapBudget(action.budget),
+    tag: mapRedeemerTag(action.tag)
+  };
+};
+var mapBudget = (budget) => {
+  return {
+    mem: budget.mem,
+    steps: budget.steps
+  };
+};
+var mapRedeemerTag = (tag) => {
+  switch (tag) {
+    case "cert":
+      return "CERT";
+    case "mint":
+      return "MINT";
+    case "reward":
+      return "REWARD";
+    case "spend":
+      return "SPEND";
+    case "vote":
+      return "VOTE";
+    case "propose":
+      return "PROPOSE";
+    default:
+      throw new Error(`Unknown RedeemerTag: ${tag}`);
+  }
+};
+var getTransactionInputs = (txHex) => {
+  const inputs = [];
+  const deserializedTx = deserializeTx(txHex);
+  const body = deserializedTx.body();
+  const cslInputs = body.inputs();
+  for (let i = 0; i < cslInputs.len(); i++) {
+    const input = cslInputs.get(i);
+    inputs.push({
+      txHash: input.transaction_id().to_hex(),
+      index: input.index()
+    });
+  }
+  const cslCollaterals = body.collateral();
+  if (cslCollaterals) {
+    for (let i = 0; i < cslCollaterals.len(); i++) {
+      const collateral = cslCollaterals.get(i);
+      inputs.push({
+        txHash: collateral.transaction_id().to_hex(),
+        index: collateral.index()
+      });
+    }
+  }
+  const cslRefInputs = body.reference_inputs();
+  if (cslRefInputs) {
+    for (let i = 0; i < cslRefInputs.len(); i++) {
+      const refInput = cslRefInputs.get(i);
+      inputs.push({
+        txHash: refInput.transaction_id().to_hex(),
+        index: refInput.index()
+      });
+    }
+  }
+  return inputs;
+};
 
 // src/utils/aiken.ts
 var applyParamsToScript = (rawScript, params, type = "Mesh") => {
@@ -1298,10 +1381,63 @@ var CSLSerializer = class {
     }
   };
 };
+
+// src/offline-providers/offline-evaluator.ts
+var OfflineEvaluator = class {
+  fetcher;
+  network;
+  /**
+   * Creates a new instance of OfflineEvaluator.
+   * @param fetcher - An implementation of IFetcher to resolve transaction UTXOs
+   * @param network - The network to evaluate scripts for
+   */
+  constructor(fetcher, network) {
+    this.fetcher = fetcher;
+    this.network = network;
+  }
+  /**
+   * Evaluates Plutus scripts in a transaction by resolving its input UTXOs and calculating execution costs.
+   *
+   * The method performs these steps:
+   * 1. Extracts input references from the transaction
+   * 2. Resolves the corresponding UTXOs using the fetcher
+   * 3. Verifies all required UTXOs are available
+   * 4. Evaluates each Plutus script to determine its memory and CPU costs
+   *
+   * @param tx - Transaction in CBOR hex format
+   * @returns Promise resolving to array of script evaluation results, each containing:
+   *   - tag: Type of script (CERT | MINT | REWARD | SPEND | VOTE | PROPOSE)
+   *   - index: Script execution index
+   *   - budget: Memory units and CPU steps required
+   * @throws Error if any required UTXOs cannot be resolved or if script evaluation fails
+   */
+  async evaluateTx(tx) {
+    const inputsToResolve = getTransactionInputs(tx);
+    const txHashesSet = new Set(inputsToResolve.map((input) => input.txHash));
+    const resolvedUTXOs = [];
+    for (const txHash of txHashesSet) {
+      const utxos = await this.fetcher.fetchUTxOs(txHash);
+      for (const utxo of utxos) {
+        if (utxo) {
+          if (inputsToResolve.find((input) => input.txHash === txHash && input.index === utxo.input.outputIndex)) {
+            resolvedUTXOs.push(utxo);
+          }
+        }
+      }
+    }
+    if (resolvedUTXOs.length !== inputsToResolve.length) {
+      const missing = inputsToResolve.filter((input) => !resolvedUTXOs.find((utxo) => utxo.input.txHash === input.txHash && utxo.input.outputIndex === input.index));
+      const missingList = missing.map((m) => `${m.txHash}:${m.index}`).join(", ");
+      throw new Error(`Can't resolve these UTXOs to execute plutus scripts: ${missingList}`);
+    }
+    return evaluateTransaction(tx, resolvedUTXOs, this.network);
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   CSLSerializer,
   LANGUAGE_VERSIONS,
+  OfflineEvaluator,
   POLICY_ID_LENGTH,
   REDEEMER_TAGS,
   addrBech32ToHex,
@@ -1335,9 +1471,11 @@ var CSLSerializer = class {
   deserializeTxUnspentOutput,
   deserializeTxWitnessSet,
   deserializeValue,
+  evaluateTransaction,
   fromBytes,
   fromLovelace,
   fromUTF8,
+  getTransactionInputs,
   getV2ScriptHash,
   keyHashToRewardAddress,
   meshTxBuilderBodyToObj,

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as _meshsdk_common from '@meshsdk/common';
-import { DeserializedAddress, PubKeyAddress, ScriptAddress, Data, IMeshTxSerializer, Protocol, MeshTxBuilderBody, BuilderData, IDeserializer, IResolver, Certificate, CertificateType, PoolParams, PoolMetadata, Relay, Redeemer, MintItem, Output, ScriptSource, SimpleScriptSourceInfo, TxIn, TxInParameter, ScriptTxInParameter, SimpleScriptTxInParameter, UTxO, Withdrawal, LanguageVersion, PlutusScript, NativeScript } from '@meshsdk/common';
+import { DeserializedAddress, PubKeyAddress, ScriptAddress, UTxO, Network, Action, Data, IMeshTxSerializer, Protocol, MeshTxBuilderBody, BuilderData, IDeserializer, IResolver, Certificate, CertificateType, PoolParams, PoolMetadata, Relay, Redeemer, MintItem, Output, ScriptSource, SimpleScriptSourceInfo, TxIn, TxInParameter, ScriptTxInParameter, SimpleScriptTxInParameter, Withdrawal, LanguageVersion, PlutusScript, NativeScript, IEvaluator, IFetcher } from '@meshsdk/common';
 import * as csl from '@sidan-lab/sidan-csl-rs-nodejs';
 export { csl };
 
@@ -30,6 +30,11 @@ declare const keyHashToRewardAddress: (keyHashHex: string, network?: number) =>
 
 declare const calculateTxHash: (txHex: string) => string;
 declare const signTransaction: (txHex: string, signingKeys: string[]) => string;
+declare const evaluateTransaction: (txHex: string, resolvedUtxos: UTxO[], network: Network) => Omit<Action, "data">[];
+declare const getTransactionInputs: (txHex: string) => {
+    txHash: string;
+    index: number;
+}[];
 
 /**
  * Apply parameters to a given script blueprint.
@@ -174,4 +179,84 @@ declare const serializePoolId: (hash: string) => string;
 declare const resolveScriptRef: (script: PlutusScript | NativeScript) => string;
 declare const resolveEd25519KeyHash: (bech32: string) => string;
 
-export { CSLSerializer, LANGUAGE_VERSIONS, POLICY_ID_LENGTH, REDEEMER_TAGS, addrBech32ToHex, addrBech32ToObj, applyCborEncoding, applyParamsToScript, baseAddressToStakeAddress, baseCertToObj, builderDataToCbor, calculateTxHash, castDataToPlutusData, castRawDataToJsonString, certificateToObj, collateralTxInToObj, deserializeAddress, deserializeBech32Address, deserializeBip32PrivateKey, deserializeDataHash, deserializeEd25519KeyHash, deserializeEd25519Signature, deserializeNativeScript, deserializePlutusData, deserializePlutusScript, deserializePublicKey, deserializeScriptHash, deserializeScriptRef, deserializeTx, deserializeTxBody, deserializeTxHash, deserializeTxUnspentOutput, deserializeTxWitnessSet, deserializeValue, fromBytes, fromLovelace, fromUTF8, getV2ScriptHash, keyHashToRewardAddress, meshTxBuilderBodyToObj, mintItemToObj, mintParametersObj, nativeMintItemToObj, outputToObj, parseDatumCbor, parseInlineDatum, plutusMintItemToObj, poolIdBech32ToHex, poolIdHexToBech32, poolMetadataToObj, poolParamsToObj, redeemerToObj, relayToObj, resolveDataHash, resolveEd25519KeyHash, resolveNativeScriptAddress, resolveNativeScriptHash, resolveNativeScriptHex, resolvePlutusScriptAddress, resolvePrivateKey, resolveRewardAddress, resolveScriptHashDRepId, resolveScriptRef, resolveStakeKeyHash, rewardAddressToKeyHash, scriptHashToBech32, scriptHashToRewardAddress, scriptSourceToObj, scriptTxInParameterToObj, serializeAddressObj, serializePlutusAddressToBech32, serializePoolId, serialzeAddress, signTransaction, simpleScriptSourceToObj, simpleScriptTxInParameterToObj, skeyToPubKeyHash, toAddress, toBaseAddress, toBytes, toEnterpriseAddress, toLovelace, toNativeScript, toPlutusData, toRewardAddress, toScriptRef, toUTF8, txInParameterToObj, txInToObj, utxoToObj, v2ScriptToBech32, withdrawalToObj };
+/**
+ * OfflineEvaluator implements the IEvaluator interface to provide offline evaluation of Plutus scripts.
+ * This class evaluates Plutus scripts contained in Cardano transactions without requiring network connectivity,
+ * determining their execution costs in terms of memory and CPU steps.
+ *
+ * Each script evaluation returns an Action object (excluding the redeemer data) that contains:
+ * - tag: The type of script being executed (CERT | MINT | REWARD | SPEND | VOTE | PROPOSE)
+ * - index: Execution index of the script within the transaction
+ * - budget: Execution costs including:
+ *   - mem: Memory units required
+ *   - steps: CPU steps required
+ *
+ * Example usage:
+ * ```typescript
+ * import { OfflineEvaluator, OfflineFetcher } from '@meshsdk/core';
+ *
+ * // Create fetcher and evaluator instances
+ * const fetcher = new OfflineFetcher();
+ * const evaluator = new OfflineEvaluator(fetcher, 'preprod');
+ *
+ * // Add required UTXOs that the transaction references
+ * fetcher.addUTxOs([
+ *   {
+ *     input: {
+ *       txHash: "1234...",
+ *       outputIndex: 0
+ *     },
+ *     output: {
+ *       address: "addr1...",
+ *       amount: [{ unit: "lovelace", quantity: "1000000" }],
+ *       scriptHash: "abcd..." // If this is a script UTXO
+ *     }
+ *   }
+ * ]);
+ *
+ * // Evaluate Plutus scripts in a transaction
+ * try {
+ *   const actions = await evaluator.evaluateTx(transactionCbor);
+ *   // Example result for a minting script:
+ *   // [{
+ *   //   index: 0,
+ *   //   tag: "MINT",
+ *   //   budget: {
+ *   //     mem: 508703,    // Memory units used
+ *   //     steps: 164980381 // CPU steps used
+ *   //   }
+ *   // }]
+ * } catch (error) {
+ *   console.error('Plutus script evaluation failed:', error);
+ * }
+ * ```
+ */
+declare class OfflineEvaluator implements IEvaluator {
+    private readonly fetcher;
+    private readonly network;
+    /**
+     * Creates a new instance of OfflineEvaluator.
+     * @param fetcher - An implementation of IFetcher to resolve transaction UTXOs
+     * @param network - The network to evaluate scripts for
+     */
+    constructor(fetcher: IFetcher, network: Network);
+    /**
+     * Evaluates Plutus scripts in a transaction by resolving its input UTXOs and calculating execution costs.
+     *
+     * The method performs these steps:
+     * 1. Extracts input references from the transaction
+     * 2. Resolves the corresponding UTXOs using the fetcher
+     * 3. Verifies all required UTXOs are available
+     * 4. Evaluates each Plutus script to determine its memory and CPU costs
+     *
+     * @param tx - Transaction in CBOR hex format
+     * @returns Promise resolving to array of script evaluation results, each containing:
+     *   - tag: Type of script (CERT | MINT | REWARD | SPEND | VOTE | PROPOSE)
+     *   - index: Script execution index
+     *   - budget: Memory units and CPU steps required
+     * @throws Error if any required UTXOs cannot be resolved or if script evaluation fails
+     */
+    evaluateTx(tx: string): Promise<Omit<Action, "data">[]>;
+}
+
+export { CSLSerializer, LANGUAGE_VERSIONS, OfflineEvaluator, POLICY_ID_LENGTH, REDEEMER_TAGS, addrBech32ToHex, addrBech32ToObj, applyCborEncoding, applyParamsToScript, baseAddressToStakeAddress, baseCertToObj, builderDataToCbor, calculateTxHash, castDataToPlutusData, castRawDataToJsonString, certificateToObj, collateralTxInToObj, deserializeAddress, deserializeBech32Address, deserializeBip32PrivateKey, deserializeDataHash, deserializeEd25519KeyHash, deserializeEd25519Signature, deserializeNativeScript, deserializePlutusData, deserializePlutusScript, deserializePublicKey, deserializeScriptHash, deserializeScriptRef, deserializeTx, deserializeTxBody, deserializeTxHash, deserializeTxUnspentOutput, deserializeTxWitnessSet, deserializeValue, evaluateTransaction, fromBytes, fromLovelace, fromUTF8, getTransactionInputs, getV2ScriptHash, keyHashToRewardAddress, meshTxBuilderBodyToObj, mintItemToObj, mintParametersObj, nativeMintItemToObj, outputToObj, parseDatumCbor, parseInlineDatum, plutusMintItemToObj, poolIdBech32ToHex, poolIdHexToBech32, poolMetadataToObj, poolParamsToObj, redeemerToObj, relayToObj, resolveDataHash, resolveEd25519KeyHash, resolveNativeScriptAddress, resolveNativeScriptHash, resolveNativeScriptHex, resolvePlutusScriptAddress, resolvePrivateKey, resolveRewardAddress, resolveScriptHashDRepId, resolveScriptRef, resolveStakeKeyHash, rewardAddressToKeyHash, scriptHashToBech32, scriptHashToRewardAddress, scriptSourceToObj, scriptTxInParameterToObj, serializeAddressObj, serializePlutusAddressToBech32, serializePoolId, serialzeAddress, signTransaction, simpleScriptSourceToObj, simpleScriptTxInParameterToObj, skeyToPubKeyHash, toAddress, toBaseAddress, toBytes, toEnterpriseAddress, toLovelace, toNativeScript, toPlutusData, toRewardAddress, toScriptRef, toUTF8, txInParameterToObj, txInToObj, utxoToObj, v2ScriptToBech32, withdrawalToObj };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 import * as _meshsdk_common from '@meshsdk/common';
-import { DeserializedAddress, PubKeyAddress, ScriptAddress, Data, IMeshTxSerializer, Protocol, MeshTxBuilderBody, BuilderData, IDeserializer, IResolver, Certificate, CertificateType, PoolParams, PoolMetadata, Relay, Redeemer, MintItem, Output, ScriptSource, SimpleScriptSourceInfo, TxIn, TxInParameter, ScriptTxInParameter, SimpleScriptTxInParameter, UTxO, Withdrawal, LanguageVersion, PlutusScript, NativeScript } from '@meshsdk/common';
+import { DeserializedAddress, PubKeyAddress, ScriptAddress, UTxO, Network, Action, Data, IMeshTxSerializer, Protocol, MeshTxBuilderBody, BuilderData, IDeserializer, IResolver, Certificate, CertificateType, PoolParams, PoolMetadata, Relay, Redeemer, MintItem, Output, ScriptSource, SimpleScriptSourceInfo, TxIn, TxInParameter, ScriptTxInParameter, SimpleScriptTxInParameter, Withdrawal, LanguageVersion, PlutusScript, NativeScript, IEvaluator, IFetcher } from '@meshsdk/common';
 import * as csl from '@sidan-lab/sidan-csl-rs-nodejs';
 export { csl };
 
@@ -30,6 +30,11 @@ declare const keyHashToRewardAddress: (keyHashHex: string, network?: number) =>
 
 declare const calculateTxHash: (txHex: string) => string;
 declare const signTransaction: (txHex: string, signingKeys: string[]) => string;
+declare const evaluateTransaction: (txHex: string, resolvedUtxos: UTxO[], network: Network) => Omit<Action, "data">[];
+declare const getTransactionInputs: (txHex: string) => {
+    txHash: string;
+    index: number;
+}[];
 
 /**
  * Apply parameters to a given script blueprint.
@@ -174,4 +179,84 @@ declare const serializePoolId: (hash: string) => string;
 declare const resolveScriptRef: (script: PlutusScript | NativeScript) => string;
 declare const resolveEd25519KeyHash: (bech32: string) => string;
 
-export { CSLSerializer, LANGUAGE_VERSIONS, POLICY_ID_LENGTH, REDEEMER_TAGS, addrBech32ToHex, addrBech32ToObj, applyCborEncoding, applyParamsToScript, baseAddressToStakeAddress, baseCertToObj, builderDataToCbor, calculateTxHash, castDataToPlutusData, castRawDataToJsonString, certificateToObj, collateralTxInToObj, deserializeAddress, deserializeBech32Address, deserializeBip32PrivateKey, deserializeDataHash, deserializeEd25519KeyHash, deserializeEd25519Signature, deserializeNativeScript, deserializePlutusData, deserializePlutusScript, deserializePublicKey, deserializeScriptHash, deserializeScriptRef, deserializeTx, deserializeTxBody, deserializeTxHash, deserializeTxUnspentOutput, deserializeTxWitnessSet, deserializeValue, fromBytes, fromLovelace, fromUTF8, getV2ScriptHash, keyHashToRewardAddress, meshTxBuilderBodyToObj, mintItemToObj, mintParametersObj, nativeMintItemToObj, outputToObj, parseDatumCbor, parseInlineDatum, plutusMintItemToObj, poolIdBech32ToHex, poolIdHexToBech32, poolMetadataToObj, poolParamsToObj, redeemerToObj, relayToObj, resolveDataHash, resolveEd25519KeyHash, resolveNativeScriptAddress, resolveNativeScriptHash, resolveNativeScriptHex, resolvePlutusScriptAddress, resolvePrivateKey, resolveRewardAddress, resolveScriptHashDRepId, resolveScriptRef, resolveStakeKeyHash, rewardAddressToKeyHash, scriptHashToBech32, scriptHashToRewardAddress, scriptSourceToObj, scriptTxInParameterToObj, serializeAddressObj, serializePlutusAddressToBech32, serializePoolId, serialzeAddress, signTransaction, simpleScriptSourceToObj, simpleScriptTxInParameterToObj, skeyToPubKeyHash, toAddress, toBaseAddress, toBytes, toEnterpriseAddress, toLovelace, toNativeScript, toPlutusData, toRewardAddress, toScriptRef, toUTF8, txInParameterToObj, txInToObj, utxoToObj, v2ScriptToBech32, withdrawalToObj };
+/**
+ * OfflineEvaluator implements the IEvaluator interface to provide offline evaluation of Plutus scripts.
+ * This class evaluates Plutus scripts contained in Cardano transactions without requiring network connectivity,
+ * determining their execution costs in terms of memory and CPU steps.
+ *
+ * Each script evaluation returns an Action object (excluding the redeemer data) that contains:
+ * - tag: The type of script being executed (CERT | MINT | REWARD | SPEND | VOTE | PROPOSE)
+ * - index: Execution index of the script within the transaction
+ * - budget: Execution costs including:
+ *   - mem: Memory units required
+ *   - steps: CPU steps required
+ *
+ * Example usage:
+ * ```typescript
+ * import { OfflineEvaluator, OfflineFetcher } from '@meshsdk/core';
+ *
+ * // Create fetcher and evaluator instances
+ * const fetcher = new OfflineFetcher();
+ * const evaluator = new OfflineEvaluator(fetcher, 'preprod');
+ *
+ * // Add required UTXOs that the transaction references
+ * fetcher.addUTxOs([
+ *   {
+ *     input: {
+ *       txHash: "1234...",
+ *       outputIndex: 0
+ *     },
+ *     output: {
+ *       address: "addr1...",
+ *       amount: [{ unit: "lovelace", quantity: "1000000" }],
+ *       scriptHash: "abcd..." // If this is a script UTXO
+ *     }
+ *   }
+ * ]);
+ *
+ * // Evaluate Plutus scripts in a transaction
+ * try {
+ *   const actions = await evaluator.evaluateTx(transactionCbor);
+ *   // Example result for a minting script:
+ *   // [{
+ *   //   index: 0,
+ *   //   tag: "MINT",
+ *   //   budget: {
+ *   //     mem: 508703,    // Memory units used
+ *   //     steps: 164980381 // CPU steps used
+ *   //   }
+ *   // }]
+ * } catch (error) {
+ *   console.error('Plutus script evaluation failed:', error);
+ * }
+ * ```
+ */
+declare class OfflineEvaluator implements IEvaluator {
+    private readonly fetcher;
+    private readonly network;
+    /**
+     * Creates a new instance of OfflineEvaluator.
+     * @param fetcher - An implementation of IFetcher to resolve transaction UTXOs
+     * @param network - The network to evaluate scripts for
+     */
+    constructor(fetcher: IFetcher, network: Network);
+    /**
+     * Evaluates Plutus scripts in a transaction by resolving its input UTXOs and calculating execution costs.
+     *
+     * The method performs these steps:
+     * 1. Extracts input references from the transaction
+     * 2. Resolves the corresponding UTXOs using the fetcher
+     * 3. Verifies all required UTXOs are available
+     * 4. Evaluates each Plutus script to determine its memory and CPU costs
+     *
+     * @param tx - Transaction in CBOR hex format
+     * @returns Promise resolving to array of script evaluation results, each containing:
+     *   - tag: Type of script (CERT | MINT | REWARD | SPEND | VOTE | PROPOSE)
+     *   - index: Script execution index
+     *   - budget: Memory units and CPU steps required
+     * @throws Error if any required UTXOs cannot be resolved or if script evaluation fails
+     */
+    evaluateTx(tx: string): Promise<Omit<Action, "data">[]>;
+}
+
+export { CSLSerializer, LANGUAGE_VERSIONS, OfflineEvaluator, POLICY_ID_LENGTH, REDEEMER_TAGS, addrBech32ToHex, addrBech32ToObj, applyCborEncoding, applyParamsToScript, baseAddressToStakeAddress, baseCertToObj, builderDataToCbor, calculateTxHash, castDataToPlutusData, castRawDataToJsonString, certificateToObj, collateralTxInToObj, deserializeAddress, deserializeBech32Address, deserializeBip32PrivateKey, deserializeDataHash, deserializeEd25519KeyHash, deserializeEd25519Signature, deserializeNativeScript, deserializePlutusData, deserializePlutusScript, deserializePublicKey, deserializeScriptHash, deserializeScriptRef, deserializeTx, deserializeTxBody, deserializeTxHash, deserializeTxUnspentOutput, deserializeTxWitnessSet, deserializeValue, evaluateTransaction, fromBytes, fromLovelace, fromUTF8, getTransactionInputs, getV2ScriptHash, keyHashToRewardAddress, meshTxBuilderBodyToObj, mintItemToObj, mintParametersObj, nativeMintItemToObj, outputToObj, parseDatumCbor, parseInlineDatum, plutusMintItemToObj, poolIdBech32ToHex, poolIdHexToBech32, poolMetadataToObj, poolParamsToObj, redeemerToObj, relayToObj, resolveDataHash, resolveEd25519KeyHash, resolveNativeScriptAddress, resolveNativeScriptHash, resolveNativeScriptHex, resolvePlutusScriptAddress, resolvePrivateKey, resolveRewardAddress, resolveScriptHashDRepId, resolveScriptRef, resolveStakeKeyHash, rewardAddressToKeyHash, scriptHashToBech32, scriptHashToRewardAddress, scriptSourceToObj, scriptTxInParameterToObj, serializeAddressObj, serializePlutusAddressToBech32, serializePoolId, serialzeAddress, signTransaction, simpleScriptSourceToObj, simpleScriptTxInParameterToObj, skeyToPubKeyHash, toAddress, toBaseAddress, toBytes, toEnterpriseAddress, toLovelace, toNativeScript, toPlutusData, toRewardAddress, toScriptRef, toUTF8, txInParameterToObj, txInToObj, utxoToObj, v2ScriptToBech32, withdrawalToObj };

package/dist/index.js

@@ -401,6 +401,86 @@ var signTransaction = (txHex, signingKeys) => {
   const result = csl.js_sign_transaction(txHex, cslSigningKeys);
   return parseWasmResult(result);
 };
+var evaluateTransaction = (txHex, resolvedUtxos, network) => {
+  const additionalTxs = csl.JsVecString.new();
+  const mappedUtxos = csl.JsVecString.new();
+  for (const utxo of resolvedUtxos) {
+    mappedUtxos.add(JSON.stringify(utxo));
+  }
+  const result = csl.evaluate_tx_scripts_js(txHex, mappedUtxos, additionalTxs, network);
+  const unwrappedResult = parseWasmResult(result);
+  try {
+    const actions = JSON.parse(unwrappedResult);
+    return actions.map(mapAction);
+  } catch (e) {
+    throw new Error("Cannot parse result from evaluate_tx_scripts_js. Expected Action[] type");
+  }
+};
+var mapAction = (action) => {
+  return {
+    index: action.index,
+    budget: mapBudget(action.budget),
+    tag: mapRedeemerTag(action.tag)
+  };
+};
+var mapBudget = (budget) => {
+  return {
+    mem: budget.mem,
+    steps: budget.steps
+  };
+};
+var mapRedeemerTag = (tag) => {
+  switch (tag) {
+    case "cert":
+      return "CERT";
+    case "mint":
+      return "MINT";
+    case "reward":
+      return "REWARD";
+    case "spend":
+      return "SPEND";
+    case "vote":
+      return "VOTE";
+    case "propose":
+      return "PROPOSE";
+    default:
+      throw new Error(`Unknown RedeemerTag: ${tag}`);
+  }
+};
+var getTransactionInputs = (txHex) => {
+  const inputs = [];
+  const deserializedTx = deserializeTx(txHex);
+  const body = deserializedTx.body();
+  const cslInputs = body.inputs();
+  for (let i = 0; i < cslInputs.len(); i++) {
+    const input = cslInputs.get(i);
+    inputs.push({
+      txHash: input.transaction_id().to_hex(),
+      index: input.index()
+    });
+  }
+  const cslCollaterals = body.collateral();
+  if (cslCollaterals) {
+    for (let i = 0; i < cslCollaterals.len(); i++) {
+      const collateral = cslCollaterals.get(i);
+      inputs.push({
+        txHash: collateral.transaction_id().to_hex(),
+        index: collateral.index()
+      });
+    }
+  }
+  const cslRefInputs = body.reference_inputs();
+  if (cslRefInputs) {
+    for (let i = 0; i < cslRefInputs.len(); i++) {
+      const refInput = cslRefInputs.get(i);
+      inputs.push({
+        txHash: refInput.transaction_id().to_hex(),
+        index: refInput.index()
+      });
+    }
+  }
+  return inputs;
+};
 
 // src/utils/aiken.ts
 var applyParamsToScript = (rawScript, params, type = "Mesh") => {
@@ -1178,9 +1258,62 @@ var CSLSerializer = class {
     }
   };
 };
+
+// src/offline-providers/offline-evaluator.ts
+var OfflineEvaluator = class {
+  fetcher;
+  network;
+  /**
+   * Creates a new instance of OfflineEvaluator.
+   * @param fetcher - An implementation of IFetcher to resolve transaction UTXOs
+   * @param network - The network to evaluate scripts for
+   */
+  constructor(fetcher, network) {
+    this.fetcher = fetcher;
+    this.network = network;
+  }
+  /**
+   * Evaluates Plutus scripts in a transaction by resolving its input UTXOs and calculating execution costs.
+   *
+   * The method performs these steps:
+   * 1. Extracts input references from the transaction
+   * 2. Resolves the corresponding UTXOs using the fetcher
+   * 3. Verifies all required UTXOs are available
+   * 4. Evaluates each Plutus script to determine its memory and CPU costs
+   *
+   * @param tx - Transaction in CBOR hex format
+   * @returns Promise resolving to array of script evaluation results, each containing:
+   *   - tag: Type of script (CERT | MINT | REWARD | SPEND | VOTE | PROPOSE)
+   *   - index: Script execution index
+   *   - budget: Memory units and CPU steps required
+   * @throws Error if any required UTXOs cannot be resolved or if script evaluation fails
+   */
+  async evaluateTx(tx) {
+    const inputsToResolve = getTransactionInputs(tx);
+    const txHashesSet = new Set(inputsToResolve.map((input) => input.txHash));
+    const resolvedUTXOs = [];
+    for (const txHash of txHashesSet) {
+      const utxos = await this.fetcher.fetchUTxOs(txHash);
+      for (const utxo of utxos) {
+        if (utxo) {
+          if (inputsToResolve.find((input) => input.txHash === txHash && input.index === utxo.input.outputIndex)) {
+            resolvedUTXOs.push(utxo);
+          }
+        }
+      }
+    }
+    if (resolvedUTXOs.length !== inputsToResolve.length) {
+      const missing = inputsToResolve.filter((input) => !resolvedUTXOs.find((utxo) => utxo.input.txHash === input.txHash && utxo.input.outputIndex === input.index));
+      const missingList = missing.map((m) => `${m.txHash}:${m.index}`).join(", ");
+      throw new Error(`Can't resolve these UTXOs to execute plutus scripts: ${missingList}`);
+    }
+    return evaluateTransaction(tx, resolvedUTXOs, this.network);
+  }
+};
 export {
   CSLSerializer,
   LANGUAGE_VERSIONS,
+  OfflineEvaluator,
   POLICY_ID_LENGTH,
   REDEEMER_TAGS,
   addrBech32ToHex,
@@ -1214,9 +1347,11 @@ export {
   deserializeTxUnspentOutput,
   deserializeTxWitnessSet,
   deserializeValue,
+  evaluateTransaction,
   fromBytes,
   fromLovelace,
   fromUTF8,
+  getTransactionInputs,
   getV2ScriptHash,
   keyHashToRewardAddress,
   meshTxBuilderBodyToObj,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@meshsdk/core-csl",
-  "version": "1.7.15",
+  "version": "1.7.17",
   "description": "",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",
@@ -31,6 +31,7 @@
   },
   "devDependencies": {
     "@meshsdk/configs": "*",
+    "@meshsdk/provider": "1.7.17",
     "@types/json-bigint": "^1.0.4",
     "eslint": "^8.57.0",
     "ts-jest": "^29.1.4",
@@ -38,7 +39,7 @@
     "typescript": "^5.3.3"
   },
   "dependencies": {
-    "@meshsdk/common": "1.7.15",
+    "@meshsdk/common": "1.7.17",
     "@sidan-lab/sidan-csl-rs-browser": "0.9.5",
     "@sidan-lab/sidan-csl-rs-nodejs": "0.9.5",
     "json-bigint": "^1.0.0"
@@ -55,4 +56,4 @@
     "blockchain",
     "sdk"
   ]
-}
+}