@lucid-evolution/provider 0.1.40 → 0.1.42

package/dist/index.cjs

@@ -52,7 +52,7 @@ var import_utils = require("@lucid-evolution/utils");
 // package.json
 var package_default = {
   name: "@lucid-evolution/provider",
-  version: "0.1.40",
+  version: "0.1.42",
   description: "",
   main: "./dist/index.js",
   types: "./dist/index.d.ts",
@@ -284,37 +284,99 @@ var Blockfrost = class {
     return result;
   }
   async blockfrostUtxosToUtxos(result) {
-    return await Promise.all(
-      result.map(async (r) => ({
-        txHash: r.tx_hash,
-        outputIndex: r.output_index,
-        assets: Object.fromEntries(
-          r.amount.map(({ unit, quantity }) => [unit, BigInt(quantity)])
-        ),
-        address: r.address,
-        datumHash: !r.inline_datum && r.data_hash || void 0,
-        datum: r.inline_datum || void 0,
-        scriptRef: r.reference_script_hash ? await (async () => {
-          const { type } = await fetch(
-            `${this.url}/scripts/${r.reference_script_hash}`,
-            {
-              headers: { project_id: this.projectId, lucid }
-            }
-          ).then((res) => res.json());
-          if (type === "Native" || type === "native") {
-            throw new Error("Native script ref not implemented!");
-          }
-          const { cbor: script } = await fetch(
-            `${this.url}/scripts/${r.reference_script_hash}/cbor`,
-            { headers: { project_id: this.projectId, lucid } }
-          ).then((res) => res.json());
+    const utxos = [];
+    const batchSize = 10;
+    let count = 0;
+    for (let i = 0; i < result.length; i += batchSize) {
+      const batch = result.slice(i, i + batchSize);
+      count += batchSize;
+      await handleRateLimit(count);
+      const batchResults = await Promise.all(
+        batch.map(async (r) => {
           return {
-            type: type === "plutusV1" ? "PlutusV1" : "PlutusV2",
-            script: (0, import_utils.applyDoubleCborEncoding)(script)
+            txHash: r.tx_hash,
+            outputIndex: r.output_index,
+            assets: Object.fromEntries(
+              r.amount.map(({ unit, quantity }) => [unit, BigInt(quantity)])
+            ),
+            address: r.address,
+            datumHash: !r.inline_datum && r.data_hash || void 0,
+            datum: r.inline_datum || void 0,
+            scriptRef: r.reference_script_hash ? await (async () => {
+              const { type } = await fetch(
+                `${this.url}/scripts/${r.reference_script_hash}`,
+                {
+                  headers: { project_id: this.projectId, lucid }
+                }
+              ).then((res) => res.json());
+              if (type.toLowerCase() === "native") {
+                throw new Error("Native script ref not implemented!");
+              }
+              const { cbor: script } = await fetch(
+                `${this.url}/scripts/${r.reference_script_hash}/cbor`,
+                { headers: { project_id: this.projectId, lucid } }
+              ).then((res) => res.json());
+              return {
+                type: type === "plutusV1" ? "PlutusV1" : "PlutusV2",
+                script: (0, import_utils.applyDoubleCborEncoding)(script)
+              };
+            })() : void 0
           };
-        })() : void 0
-      }))
+        })
+      );
+      utxos.push(...batchResults);
+    }
+    return utxos;
+  }
+  async evaluateTx(tx, additionalUTxOs) {
+    const additionalUTxOSet = (additionalUTxOs || []).map((utxo) => [
+      { txId: utxo.txHash, index: utxo.outputIndex },
+      {
+        address: utxo.address,
+        value: { coins: utxo.assets.lovelace, assets: utxo.assets.restAssets },
+        datum_hash: utxo.datumHash,
+        datum: utxo.datum,
+        script: utxo.scriptRef
+      }
+    ]);
+    const payload = {
+      cbor: tx,
+      additionalUTxOSet
+    };
+    const res = await fetch(`${this.url}/utils/txs/evaluate/utxos`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        project_id: this.projectId,
+        lucid
+      },
+      body: JSON.stringify(
+        payload,
+        (_, value) => typeof value === "bigint" ? value.toString() : value
+      )
+    }).then((res2) => res2.json());
+    if (!res || res.error) {
+      const message = res?.status_code === 400 ? res.message : `Could not evaluate the transaction: ${JSON.stringify(res)}`;
+      throw new Error(message);
+    }
+    const blockfrostRedeemer = res;
+    if (!("EvaluationResult" in blockfrostRedeemer.result)) {
+      throw new Error(
+        `EvaluateTransaction fails: ${JSON.stringify(blockfrostRedeemer.result)}`
+      );
+    }
+    const evalRedeemers = [];
+    Object.entries(blockfrostRedeemer.result.EvaluationResult).forEach(
+      ([redeemerPointer, data]) => {
+        const [pTag, pIndex] = redeemerPointer.split(":");
+        evalRedeemers.push({
+          redeemer_tag: pTag,
+          redeemer_index: Number(pIndex),
+          ex_units: { mem: Number(data.memory), steps: Number(data.steps) }
+        });
+      }
     );
+    return evalRedeemers;
   }
 };
 function datumJsonToCbor(json) {
@@ -353,6 +415,13 @@ function datumJsonToCbor(json) {
   };
   return convert(json).to_cbor_hex();
 }
+var handleRateLimit = async (count) => {
+  if (count % 100 === 0) {
+    await (0, import_core_utils.sleep)(2e3);
+  } else if (count % 10 === 0) {
+    await (0, import_core_utils.sleep)(200);
+  }
+};
 var lucid = package_default.version;
 
 // src/kupmios/kupmios.ts
@@ -627,6 +696,66 @@ var Kupmios = class {
     const { result } = await import_effect.Effect.runPromise(program);
     return result.transaction.id;
   }
+  async evaluateTx(tx, additionalUTxOs) {
+    const utxos = (additionalUTxOs || []).map((utxo) => {
+      const script = utxo.scriptRef ? {
+        language: utxo.scriptRef.type,
+        cbor: utxo.scriptRef.script
+      } : void 0;
+      return [
+        {
+          transaction: { id: utxo.txHash, output: { index: utxo.outputIndex } }
+        },
+        {
+          address: utxo.address,
+          value: {
+            coins: utxo.assets.lovelace,
+            assets: utxo.assets.restAssets
+          },
+          datumHash: utxo.datumHash,
+          datum: utxo.datum,
+          script
+        }
+      ];
+    });
+    const data = {
+      jsonrpc: "2.0",
+      method: "evaluateTransaction",
+      params: { transaction: { cbor: tx }, additionalUTxO: utxos },
+      id: null
+    };
+    const schema = JSONRPCSchema(
+      S2.Array(
+        S2.Struct({
+          validator: S2.Struct({
+            purpose: S2.String,
+            index: S2.Int
+          }),
+          budget: S2.Struct({
+            memory: S2.Int,
+            cpu: S2.Int
+          })
+        })
+      )
+    );
+    const program = fetchOgmiosParse(this.ogmiosUrl, data, schema).pipe(
+      import_effect.Effect.flatMap(
+        (response) => "error" in response ? kupmiosError(response.error) : import_effect.Effect.succeed(response.result)
+      ),
+      import_effect.Effect.timeout(1e4),
+      import_effect.Effect.catchAll(kupmiosError)
+    );
+    const result = await import_effect.Effect.runPromise(program);
+    const evalRedeemers = result.map((item) => ({
+      ex_units: {
+        mem: item.budget.memory,
+        steps: item.budget.cpu
+      },
+      redeemer_index: item.validator.index,
+      redeemer_tag: item.validator.purpose
+    }));
+    return evalRedeemers;
+  }
 };
 var getDatumEffect = (kupoUrl, datum_type, datum_hash) => import_effect.Effect.gen(function* () {
   if (datum_type === "inline" && datum_hash) {
@@ -753,6 +882,7 @@ var import_utils3 = require("@lucid-evolution/utils");
 var import_utils4 = require("@lucid-evolution/utils");
 var import_core_utils2 = require("@lucid-evolution/core-utils");
 var import_wallet = require("@lucid-evolution/wallet");
+var import_cardano_multiplatform_lib_nodejs = require("@anastasia-labs/cardano-multiplatform-lib-nodejs");
 function generateEmulatorAccount(assets) {
   const seedPhrase = (0, import_utils3.generateSeedPhrase)();
   return {
@@ -1340,6 +1470,49 @@ It does not exist or was already spent.`
     }
     return Promise.resolve(txHash);
   }
+  async evaluateTx(tx, additionalUTxOs) {
+    const desTx = CML.Transaction.from_cbor_hex(tx);
+    const redeemers = desTx.witness_set().redeemers();
+    if (!redeemers) {
+      return [];
+    }
+    let evalRedeemers = [];
+    const arrLegacyRedeemer = redeemers.as_arr_legacy_redeemer();
+    if (arrLegacyRedeemer) {
+      for (let i = 0; i < arrLegacyRedeemer.len(); i++) {
+        const legacyRedeemer = arrLegacyRedeemer.get(i);
+        evalRedeemers.push({
+          ex_units: {
+            mem: Number(legacyRedeemer.ex_units().mem()),
+            steps: Number(legacyRedeemer.ex_units().steps())
+          },
+          redeemer_index: Number(legacyRedeemer.index()),
+          redeemer_tag: redeemerTagToString(legacyRedeemer.tag())
+        });
+      }
+      return evalRedeemers;
+    }
+    const mapRedeemerKeyToRedeemerVal = redeemers.as_map_redeemer_key_to_redeemer_val();
+    if (mapRedeemerKeyToRedeemerVal) {
+      const keys = mapRedeemerKeyToRedeemerVal.keys();
+      for (let i = 0; i < keys.len(); i++) {
+        const key = keys.get(i);
+        const redeemerVal = mapRedeemerKeyToRedeemerVal.get(key);
+        if (redeemerVal) {
+          evalRedeemers.push({
+            ex_units: {
+              mem: Number(redeemerVal.ex_units().mem()),
+              steps: Number(redeemerVal.ex_units().steps())
+            },
+            redeemer_index: Number(key.index),
+            redeemer_tag: redeemerTagToString(key.tag())
+          });
+        }
+      }
+      return evalRedeemers;
+    }
+    return evalRedeemers;
+  }
   log() {
     function getRandomColor(unit) {
       const seed = unit === "lovelace" ? "1" : unit;
@@ -1406,6 +1579,24 @@ ${"\u2581".repeat(60)}
     }
   }
 };
+function redeemerTagToString(tag) {
+  switch (tag) {
+    case import_cardano_multiplatform_lib_nodejs.RedeemerTag.Spend:
+      return "spend";
+    case import_cardano_multiplatform_lib_nodejs.RedeemerTag.Mint:
+      return "mint";
+    case import_cardano_multiplatform_lib_nodejs.RedeemerTag.Cert:
+      return "cert";
+    case import_cardano_multiplatform_lib_nodejs.RedeemerTag.Reward:
+      return "reward";
+    case import_cardano_multiplatform_lib_nodejs.RedeemerTag.Voting:
+      return "voting";
+    case import_cardano_multiplatform_lib_nodejs.RedeemerTag.Proposing:
+      return "proposing";
+    default:
+      return "unknown";
+  }
+}
 
 // src/maestro.ts
 var import_utils5 = require("@lucid-evolution/utils");
@@ -1667,6 +1858,33 @@ var Maestro = class {
     }
     return result;
   }
+  async evaluateTx(tx, additionalUTxOs) {
+    const additionalMaestroUTxOs = (additionalUTxOs || []).map((utxo) => ({
+      index: utxo.outputIndex,
+      tx_hash: utxo.txHash,
+      tx_cbor: (0, import_utils5.utxoToCore)(utxo).to_cbor_hex
+    }));
+    const payload = {
+      cbor: tx,
+      additionalMaestroUTxOs
+    };
+    const res = await fetch(`${this.url}/transactions/evaluate`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        "api-key": this.apiKey
+      },
+      body: JSON.stringify(payload)
+    });
+    if (!res.ok) {
+      const body = await res.text();
+      console.error("Response error:", JSON.stringify(res));
+      throw new Error(`Evaluate transaction failed: ${body}`);
+    }
+    const result = await res.json();
+    return result;
+  }
 };
 var lucid2 = package_default.version;
 
@@ -2132,6 +2350,62 @@ var Koios = class {
     }
     return result;
   }
+  async evaluateTx(tx, additionalUTxOs) {
+    const utxos = (additionalUTxOs || []).map((utxo) => {
+      const script = utxo.scriptRef ? {
+        language: utxo.scriptRef.type,
+        cbor: utxo.scriptRef.script
+      } : void 0;
+      return [
+        {
+          transaction: { id: utxo.txHash, output: { index: utxo.outputIndex } }
+        },
+        {
+          address: utxo.address,
+          value: {
+            coins: utxo.assets.lovelace,
+            assets: utxo.assets.restAssets
+          },
+          datumHash: utxo.datumHash,
+          datum: utxo.datum,
+          script
+        }
+      ];
+    });
+    const data = {
+      jsonrpc: "2.0",
+      method: "evaluateTransaction",
+      params: { transaction: { cbor: tx }, additionalUTxO: utxos },
+      id: null
+    };
+    const response = await fetch(`${this.baseUrl}/ogmios`, {
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      body: JSON.stringify(
+        data,
+        (_, value) => typeof value === "bigint" ? value.toString() : value
+      )
+    });
+    if (!response.ok) {
+      const errorBody = await response.text();
+      throw new Error(
+        `Request failed with status ${response.status}: ${errorBody}`
+      );
+    }
+    const result = await response.json();
+    const evalRedeemers = result.result.map((item) => ({
+      ex_units: {
+        mem: item.budget.memory,
+        steps: item.budget.cpu
+      },
+      redeemer_index: item.validator.index,
+      redeemer_tag: item.validator.purpose
+    }));
+    return evalRedeemers;
+  }
 };
 var toUTxO = (koiosUTxO, address) => ({
   txHash: koiosUTxO.tx_hash,

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Provider, ProtocolParameters, Address, Credential, UTxO, Unit, OutRef, RewardAddress, Delegation, DatumHash, Datum, TxHash, Transaction, Assets, OutputData, UnixTime, Lovelace } from '@lucid-evolution/core-types';
+import { Provider, ProtocolParameters, Address, Credential, UTxO, Unit, OutRef, RewardAddress, Delegation, DatumHash, Datum, TxHash, Transaction, EvalRedeemer, Assets, OutputData, UnixTime, Lovelace } from '@lucid-evolution/core-types';
 import * as effect_Cause from 'effect/Cause';
 import * as effect_Types from 'effect/Types';
 import { Effect } from 'effect';
@@ -17,6 +17,7 @@ declare class Blockfrost implements Provider {
     awaitTx(txHash: TxHash, checkInterval?: number): Promise<boolean>;
     submitTx(tx: Transaction): Promise<TxHash>;
     private blockfrostUtxosToUtxos;
+    evaluateTx(tx: Transaction, additionalUTxOs?: UTxO[]): Promise<EvalRedeemer[]>;
 }
 /**
  * This function is temporarily needed only, until Blockfrost returns the datum natively in Cbor.
@@ -60,6 +61,7 @@ declare class Kupmios implements Provider {
     getDatum(datumHash: DatumHash): Promise<Datum>;
     awaitTx(txHash: TxHash, checkInterval?: number): Promise<boolean>;
     submitTx(cbor: Transaction): Promise<TxHash>;
+    evaluateTx(tx: Transaction, additionalUTxOs?: UTxO[]): Promise<EvalRedeemer[]>;
 }
 
 /** Concatentation of txHash + outputIndex */
@@ -111,6 +113,7 @@ declare class Emulator implements Provider {
      */
     distributeRewards(rewards: Lovelace): void;
     submitTx(tx: Transaction): Promise<TxHash>;
+    evaluateTx(tx: Transaction, additionalUTxOs?: UTxO[]): Promise<EvalRedeemer[]>;
     log(): void;
 }
 
@@ -139,6 +142,7 @@ declare class Maestro implements Provider {
     private requireAmountsAsStrings;
     private maestroUtxoToUtxo;
     private getAllPagesData;
+    evaluateTx(tx: Transaction, additionalUTxOs?: UTxO[]): Promise<EvalRedeemer[]>;
 }
 
 /**
@@ -156,6 +160,7 @@ declare class Koios implements Provider {
     getDatum(datumHash: DatumHash): Promise<Datum>;
     awaitTx(txHash: TxHash, checkInterval?: number): Promise<boolean>;
     submitTx(tx: Transaction): Promise<TxHash>;
+    evaluateTx(tx: Transaction, additionalUTxOs?: UTxO[]): Promise<EvalRedeemer[]>;
 }
 
 declare const FetchError_base: new <A extends Record<string, any> = {}>(args: effect_Types.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => effect_Cause.YieldableError & {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Provider, ProtocolParameters, Address, Credential, UTxO, Unit, OutRef, RewardAddress, Delegation, DatumHash, Datum, TxHash, Transaction, Assets, OutputData, UnixTime, Lovelace } from '@lucid-evolution/core-types';
+import { Provider, ProtocolParameters, Address, Credential, UTxO, Unit, OutRef, RewardAddress, Delegation, DatumHash, Datum, TxHash, Transaction, EvalRedeemer, Assets, OutputData, UnixTime, Lovelace } from '@lucid-evolution/core-types';
 import * as effect_Cause from 'effect/Cause';
 import * as effect_Types from 'effect/Types';
 import { Effect } from 'effect';
@@ -17,6 +17,7 @@ declare class Blockfrost implements Provider {
     awaitTx(txHash: TxHash, checkInterval?: number): Promise<boolean>;
     submitTx(tx: Transaction): Promise<TxHash>;
     private blockfrostUtxosToUtxos;
+    evaluateTx(tx: Transaction, additionalUTxOs?: UTxO[]): Promise<EvalRedeemer[]>;
 }
 /**
  * This function is temporarily needed only, until Blockfrost returns the datum natively in Cbor.
@@ -60,6 +61,7 @@ declare class Kupmios implements Provider {
     getDatum(datumHash: DatumHash): Promise<Datum>;
     awaitTx(txHash: TxHash, checkInterval?: number): Promise<boolean>;
     submitTx(cbor: Transaction): Promise<TxHash>;
+    evaluateTx(tx: Transaction, additionalUTxOs?: UTxO[]): Promise<EvalRedeemer[]>;
 }
 
 /** Concatentation of txHash + outputIndex */
@@ -111,6 +113,7 @@ declare class Emulator implements Provider {
      */
     distributeRewards(rewards: Lovelace): void;
     submitTx(tx: Transaction): Promise<TxHash>;
+    evaluateTx(tx: Transaction, additionalUTxOs?: UTxO[]): Promise<EvalRedeemer[]>;
     log(): void;
 }
 
@@ -139,6 +142,7 @@ declare class Maestro implements Provider {
     private requireAmountsAsStrings;
     private maestroUtxoToUtxo;
     private getAllPagesData;
+    evaluateTx(tx: Transaction, additionalUTxOs?: UTxO[]): Promise<EvalRedeemer[]>;
 }
 
 /**
@@ -156,6 +160,7 @@ declare class Koios implements Provider {
     getDatum(datumHash: DatumHash): Promise<Datum>;
     awaitTx(txHash: TxHash, checkInterval?: number): Promise<boolean>;
     submitTx(tx: Transaction): Promise<TxHash>;
+    evaluateTx(tx: Transaction, additionalUTxOs?: UTxO[]): Promise<EvalRedeemer[]>;
 }
 
 declare const FetchError_base: new <A extends Record<string, any> = {}>(args: effect_Types.Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => effect_Cause.YieldableError & {

package/dist/index.js

@@ -8,13 +8,13 @@ var __export = (target, all) => {
 import * as CML from "@anastasia-labs/cardano-multiplatform-lib-nodejs";
 
 // src/blockfrost.ts
-import { fromHex } from "@lucid-evolution/core-utils";
+import { fromHex, sleep } from "@lucid-evolution/core-utils";
 import { applyDoubleCborEncoding } from "@lucid-evolution/utils";
 
 // package.json
 var package_default = {
   name: "@lucid-evolution/provider",
-  version: "0.1.40",
+  version: "0.1.42",
   description: "",
   main: "./dist/index.js",
   types: "./dist/index.d.ts",
@@ -246,37 +246,99 @@ var Blockfrost = class {
     return result;
   }
   async blockfrostUtxosToUtxos(result) {
-    return await Promise.all(
-      result.map(async (r) => ({
-        txHash: r.tx_hash,
-        outputIndex: r.output_index,
-        assets: Object.fromEntries(
-          r.amount.map(({ unit, quantity }) => [unit, BigInt(quantity)])
-        ),
-        address: r.address,
-        datumHash: !r.inline_datum && r.data_hash || void 0,
-        datum: r.inline_datum || void 0,
-        scriptRef: r.reference_script_hash ? await (async () => {
-          const { type } = await fetch(
-            `${this.url}/scripts/${r.reference_script_hash}`,
-            {
-              headers: { project_id: this.projectId, lucid }
-            }
-          ).then((res) => res.json());
-          if (type === "Native" || type === "native") {
-            throw new Error("Native script ref not implemented!");
-          }
-          const { cbor: script } = await fetch(
-            `${this.url}/scripts/${r.reference_script_hash}/cbor`,
-            { headers: { project_id: this.projectId, lucid } }
-          ).then((res) => res.json());
+    const utxos = [];
+    const batchSize = 10;
+    let count = 0;
+    for (let i = 0; i < result.length; i += batchSize) {
+      const batch = result.slice(i, i + batchSize);
+      count += batchSize;
+      await handleRateLimit(count);
+      const batchResults = await Promise.all(
+        batch.map(async (r) => {
           return {
-            type: type === "plutusV1" ? "PlutusV1" : "PlutusV2",
-            script: applyDoubleCborEncoding(script)
+            txHash: r.tx_hash,
+            outputIndex: r.output_index,
+            assets: Object.fromEntries(
+              r.amount.map(({ unit, quantity }) => [unit, BigInt(quantity)])
+            ),
+            address: r.address,
+            datumHash: !r.inline_datum && r.data_hash || void 0,
+            datum: r.inline_datum || void 0,
+            scriptRef: r.reference_script_hash ? await (async () => {
+              const { type } = await fetch(
+                `${this.url}/scripts/${r.reference_script_hash}`,
+                {
+                  headers: { project_id: this.projectId, lucid }
+                }
+              ).then((res) => res.json());
+              if (type.toLowerCase() === "native") {
+                throw new Error("Native script ref not implemented!");
+              }
+              const { cbor: script } = await fetch(
+                `${this.url}/scripts/${r.reference_script_hash}/cbor`,
+                { headers: { project_id: this.projectId, lucid } }
+              ).then((res) => res.json());
+              return {
+                type: type === "plutusV1" ? "PlutusV1" : "PlutusV2",
+                script: applyDoubleCborEncoding(script)
+              };
+            })() : void 0
           };
-        })() : void 0
-      }))
+        })
+      );
+      utxos.push(...batchResults);
+    }
+    return utxos;
+  }
+  async evaluateTx(tx, additionalUTxOs) {
+    const additionalUTxOSet = (additionalUTxOs || []).map((utxo) => [
+      { txId: utxo.txHash, index: utxo.outputIndex },
+      {
+        address: utxo.address,
+        value: { coins: utxo.assets.lovelace, assets: utxo.assets.restAssets },
+        datum_hash: utxo.datumHash,
+        datum: utxo.datum,
+        script: utxo.scriptRef
+      }
+    ]);
+    const payload = {
+      cbor: tx,
+      additionalUTxOSet
+    };
+    const res = await fetch(`${this.url}/utils/txs/evaluate/utxos`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        project_id: this.projectId,
+        lucid
+      },
+      body: JSON.stringify(
+        payload,
+        (_, value) => typeof value === "bigint" ? value.toString() : value
+      )
+    }).then((res2) => res2.json());
+    if (!res || res.error) {
+      const message = res?.status_code === 400 ? res.message : `Could not evaluate the transaction: ${JSON.stringify(res)}`;
+      throw new Error(message);
+    }
+    const blockfrostRedeemer = res;
+    if (!("EvaluationResult" in blockfrostRedeemer.result)) {
+      throw new Error(
+        `EvaluateTransaction fails: ${JSON.stringify(blockfrostRedeemer.result)}`
+      );
+    }
+    const evalRedeemers = [];
+    Object.entries(blockfrostRedeemer.result.EvaluationResult).forEach(
+      ([redeemerPointer, data]) => {
+        const [pTag, pIndex] = redeemerPointer.split(":");
+        evalRedeemers.push({
+          redeemer_tag: pTag,
+          redeemer_index: Number(pIndex),
+          ex_units: { mem: Number(data.memory), steps: Number(data.steps) }
+        });
+      }
     );
+    return evalRedeemers;
   }
 };
 function datumJsonToCbor(json) {
@@ -315,6 +377,13 @@ function datumJsonToCbor(json) {
   };
   return convert(json).to_cbor_hex();
 }
+var handleRateLimit = async (count) => {
+  if (count % 100 === 0) {
+    await sleep(2e3);
+  } else if (count % 10 === 0) {
+    await sleep(200);
+  }
+};
 var lucid = package_default.version;
 
 // src/kupmios/kupmios.ts
@@ -593,6 +662,66 @@ var Kupmios = class {
     const { result } = await Effect.runPromise(program);
     return result.transaction.id;
   }
+  async evaluateTx(tx, additionalUTxOs) {
+    const utxos = (additionalUTxOs || []).map((utxo) => {
+      const script = utxo.scriptRef ? {
+        language: utxo.scriptRef.type,
+        cbor: utxo.scriptRef.script
+      } : void 0;
+      return [
+        {
+          transaction: { id: utxo.txHash, output: { index: utxo.outputIndex } }
+        },
+        {
+          address: utxo.address,
+          value: {
+            coins: utxo.assets.lovelace,
+            assets: utxo.assets.restAssets
+          },
+          datumHash: utxo.datumHash,
+          datum: utxo.datum,
+          script
+        }
+      ];
+    });
+    const data = {
+      jsonrpc: "2.0",
+      method: "evaluateTransaction",
+      params: { transaction: { cbor: tx }, additionalUTxO: utxos },
+      id: null
+    };
+    const schema = JSONRPCSchema(
+      S2.Array(
+        S2.Struct({
+          validator: S2.Struct({
+            purpose: S2.String,
+            index: S2.Int
+          }),
+          budget: S2.Struct({
+            memory: S2.Int,
+            cpu: S2.Int
+          })
+        })
+      )
+    );
+    const program = fetchOgmiosParse(this.ogmiosUrl, data, schema).pipe(
+      Effect.flatMap(
+        (response) => "error" in response ? kupmiosError(response.error) : Effect.succeed(response.result)
+      ),
+      Effect.timeout(1e4),
+      Effect.catchAll(kupmiosError)
+    );
+    const result = await Effect.runPromise(program);
+    const evalRedeemers = result.map((item) => ({
+      ex_units: {
+        mem: item.budget.memory,
+        steps: item.budget.cpu
+      },
+      redeemer_index: item.validator.index,
+      redeemer_tag: item.validator.purpose
+    }));
+    return evalRedeemers;
+  }
 };
 var getDatumEffect = (kupoUrl, datum_type, datum_hash) => Effect.gen(function* () {
   if (datum_type === "inline" && datum_hash) {
@@ -722,6 +851,7 @@ import {
 import { coreToUtxo, getAddressDetails } from "@lucid-evolution/utils";
 import { fromHex as fromHex2 } from "@lucid-evolution/core-utils";
 import { walletFromSeed } from "@lucid-evolution/wallet";
+import { RedeemerTag } from "@anastasia-labs/cardano-multiplatform-lib-nodejs";
 function generateEmulatorAccount(assets) {
   const seedPhrase = generateSeedPhrase();
   return {
@@ -1309,6 +1439,49 @@ It does not exist or was already spent.`
     }
     return Promise.resolve(txHash);
   }
+  async evaluateTx(tx, additionalUTxOs) {
+    const desTx = CML.Transaction.from_cbor_hex(tx);
+    const redeemers = desTx.witness_set().redeemers();
+    if (!redeemers) {
+      return [];
+    }
+    let evalRedeemers = [];
+    const arrLegacyRedeemer = redeemers.as_arr_legacy_redeemer();
+    if (arrLegacyRedeemer) {
+      for (let i = 0; i < arrLegacyRedeemer.len(); i++) {
+        const legacyRedeemer = arrLegacyRedeemer.get(i);
+        evalRedeemers.push({
+          ex_units: {
+            mem: Number(legacyRedeemer.ex_units().mem()),
+            steps: Number(legacyRedeemer.ex_units().steps())
+          },
+          redeemer_index: Number(legacyRedeemer.index()),
+          redeemer_tag: redeemerTagToString(legacyRedeemer.tag())
+        });
+      }
+      return evalRedeemers;
+    }
+    const mapRedeemerKeyToRedeemerVal = redeemers.as_map_redeemer_key_to_redeemer_val();
+    if (mapRedeemerKeyToRedeemerVal) {
+      const keys = mapRedeemerKeyToRedeemerVal.keys();
+      for (let i = 0; i < keys.len(); i++) {
+        const key = keys.get(i);
+        const redeemerVal = mapRedeemerKeyToRedeemerVal.get(key);
+        if (redeemerVal) {
+          evalRedeemers.push({
+            ex_units: {
+              mem: Number(redeemerVal.ex_units().mem()),
+              steps: Number(redeemerVal.ex_units().steps())
+            },
+            redeemer_index: Number(key.index),
+            redeemer_tag: redeemerTagToString(key.tag())
+          });
+        }
+      }
+      return evalRedeemers;
+    }
+    return evalRedeemers;
+  }
   log() {
     function getRandomColor(unit) {
       const seed = unit === "lovelace" ? "1" : unit;
@@ -1375,9 +1548,27 @@ ${"\u2581".repeat(60)}
     }
   }
 };
+function redeemerTagToString(tag) {
+  switch (tag) {
+    case RedeemerTag.Spend:
+      return "spend";
+    case RedeemerTag.Mint:
+      return "mint";
+    case RedeemerTag.Cert:
+      return "cert";
+    case RedeemerTag.Reward:
+      return "reward";
+    case RedeemerTag.Voting:
+      return "voting";
+    case RedeemerTag.Proposing:
+      return "proposing";
+    default:
+      return "unknown";
+  }
+}
 
 // src/maestro.ts
-import { applyDoubleCborEncoding as applyDoubleCborEncoding2 } from "@lucid-evolution/utils";
+import { applyDoubleCborEncoding as applyDoubleCborEncoding2, utxoToCore } from "@lucid-evolution/utils";
 import { fromHex as fromHex3 } from "@lucid-evolution/core-utils";
 var Maestro = class {
   url;
@@ -1636,6 +1827,33 @@ var Maestro = class {
     }
     return result;
   }
+  async evaluateTx(tx, additionalUTxOs) {
+    const additionalMaestroUTxOs = (additionalUTxOs || []).map((utxo) => ({
+      index: utxo.outputIndex,
+      tx_hash: utxo.txHash,
+      tx_cbor: utxoToCore(utxo).to_cbor_hex
+    }));
+    const payload = {
+      cbor: tx,
+      additionalMaestroUTxOs
+    };
+    const res = await fetch(`${this.url}/transactions/evaluate`, {
+      method: "POST",
+      headers: {
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        "api-key": this.apiKey
+      },
+      body: JSON.stringify(payload)
+    });
+    if (!res.ok) {
+      const body = await res.text();
+      console.error("Response error:", JSON.stringify(res));
+      throw new Error(`Evaluate transaction failed: ${body}`);
+    }
+    const result = await res.json();
+    return result;
+  }
 };
 var lucid2 = package_default.version;
 
@@ -2101,6 +2319,62 @@ var Koios = class {
     }
     return result;
   }
+  async evaluateTx(tx, additionalUTxOs) {
+    const utxos = (additionalUTxOs || []).map((utxo) => {
+      const script = utxo.scriptRef ? {
+        language: utxo.scriptRef.type,
+        cbor: utxo.scriptRef.script
+      } : void 0;
+      return [
+        {
+          transaction: { id: utxo.txHash, output: { index: utxo.outputIndex } }
+        },
+        {
+          address: utxo.address,
+          value: {
+            coins: utxo.assets.lovelace,
+            assets: utxo.assets.restAssets
+          },
+          datumHash: utxo.datumHash,
+          datum: utxo.datum,
+          script
+        }
+      ];
+    });
+    const data = {
+      jsonrpc: "2.0",
+      method: "evaluateTransaction",
+      params: { transaction: { cbor: tx }, additionalUTxO: utxos },
+      id: null
+    };
+    const response = await fetch(`${this.baseUrl}/ogmios`, {
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      body: JSON.stringify(
+        data,
+        (_, value) => typeof value === "bigint" ? value.toString() : value
+      )
+    });
+    if (!response.ok) {
+      const errorBody = await response.text();
+      throw new Error(
+        `Request failed with status ${response.status}: ${errorBody}`
+      );
+    }
+    const result = await response.json();
+    const evalRedeemers = result.result.map((item) => ({
+      ex_units: {
+        mem: item.budget.memory,
+        steps: item.budget.cpu
+      },
+      redeemer_index: item.validator.index,
+      redeemer_tag: item.validator.purpose
+    }));
+    return evalRedeemers;
+  }
 };
 var toUTxO = (koiosUTxO, address) => ({
   txHash: koiosUTxO.tx_hash,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucid-evolution/provider",
-  "version": "0.1.40",
+  "version": "0.1.42",
   "description": "",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -30,10 +30,10 @@
     "@effect/platform": "^0.59.2",
     "@effect/schema": "^0.68.26",
     "effect": "^3.5.6",
-    "@lucid-evolution/core-types": "0.1.12",
-    "@lucid-evolution/core-utils": "0.1.11",
-    "@lucid-evolution/utils": "0.1.31",
-    "@lucid-evolution/wallet": "0.1.35"
+    "@lucid-evolution/core-types": "0.1.13",
+    "@lucid-evolution/core-utils": "0.1.13",
+    "@lucid-evolution/utils": "0.1.33",
+    "@lucid-evolution/wallet": "0.1.37"
   },
   "devDependencies": {
     "@types/node": "^20.12.8",