@lucid-evolution/utils 0.1.25 → 0.1.27

package/dist/index.cjs

@@ -53,6 +53,7 @@ __export(src_exports, {
   generatePrivateKey: () => generatePrivateKey,
   generateSeedPhrase: () => generateSeedPhrase,
   getAddressDetails: () => getAddressDetails,
+  getInputIndices: () => getInputIndices,
   getUniqueTokenName: () => getUniqueTokenName,
   isEqualUTxO: () => isEqualUTxO,
   keyHashToCredential: () => keyHashToCredential,
@@ -1152,6 +1153,8 @@ var sortUTxOs = (utxos, order = "LargestFirst") => {
       return [...utxos].sort(largestFirst);
     case "SmallestFirst":
       return [...utxos].sort(smallestFirst);
+    case "Canonical":
+      return [...utxos].sort(canonical);
   }
 };
 var largestFirst = (a, b) => {
@@ -1170,7 +1173,28 @@ var smallestFirst = (a, b) => {
   }
   return lovelaceA - lovelaceB;
 };
+var canonical = (a, b) => {
+  if (a.txHash < b.txHash) {
+    return -1;
+  } else if (a.txHash > b.txHash) {
+    return 1;
+  } else {
+    return a.outputIndex - b.outputIndex;
+  }
+};
 var isEqualUTxO = (self, that) => self.txHash === that.txHash && self.outputIndex === that.outputIndex;
+function getInputIndices(indexInputs, allInputs, sorted = false) {
+  const sortedInputs = sorted ? allInputs : sortUTxOs(allInputs, "Canonical");
+  const indicesMap = /* @__PURE__ */ new Map();
+  sortedInputs.forEach((value, index) => {
+    indicesMap.set(value.txHash + value.outputIndex, BigInt(index));
+  });
+  return indexInputs.flatMap((value) => {
+    const index = indicesMap.get(value.txHash + value.outputIndex);
+    if (index !== void 0) return index;
+    else return [];
+  });
+}
 var calculateMinLovelaceFromUTxO = (coinsPerUtxoByte, utxo) => buildOutput(utxo).with_asset_and_min_required_coin(
   assetsToValue(utxo.assets).multi_asset(),
   coinsPerUtxoByte
@@ -1224,6 +1248,7 @@ var stringify = (data) => JSON.stringify(
   generatePrivateKey,
   generateSeedPhrase,
   getAddressDetails,
+  getInputIndices,
   getUniqueTokenName,
   isEqualUTxO,
   keyHashToCredential,

package/dist/index.d.cts

@@ -119,9 +119,14 @@ type SortOrder =
 /**
  * Smallest amount of "lovelace" with least number of unique assets first
  */
- | "SmallestFirst";
+ | "SmallestFirst"
+/**
+ * Lexicographically sorted as per ledger rules
+ */
+ | "Canonical";
 /**
  * Sorts an array of UTXOs according to specified sort order ("LargestFirst" by default).
+ * The provided array is cloned and reference to the new sorted array is returned.
  *
  * @param {UTxO[]} utxos - The array of UTXO objects to be sorted.
  * @param {SortOrder} [order="LargestFirst"] - The order in which to sort the UTXOs.
@@ -130,6 +135,17 @@ type SortOrder =
  */
 declare const sortUTxOs: (utxos: UTxO[], order?: SortOrder) => UTxO[];
 declare const isEqualUTxO: (self: UTxO, that: UTxO) => boolean;
+/**
+ * Provides an array of input indices for given "indexInputs" UTxOs.
+ * Indices obtained from the list of transaction inputs which are
+ * ordered as per ledger rules.
+ *
+ * @param indexInputs Input utxos whose indices need to be returned
+ * @param allInputs All the inputs utxos being spent by the transaction
+ * @param sorted Whether the provided "allInputs" are sorted canonically or not
+ * @returns Input indices of utxos as they appear in "indexInputs"
+ */
+declare function getInputIndices(indexInputs: UTxO[], allInputs: UTxO[], sorted?: Boolean): bigint[];
 declare const calculateMinLovelaceFromUTxO: (coinsPerUtxoByte: bigint, utxo: UTxO) => bigint;
 
 declare function valueToAssets(value: CML.Value): Assets;
@@ -157,4 +173,4 @@ declare function getUniqueTokenName(utxo: UTxO): Promise<string>;
 
 declare const stringify: (data: any) => string;
 
-export { type CMLNative, PROTOCOL_PARAMETERS_DEFAULT, type SortOrder, addAssets, addressFromHexOrBech32, applyDoubleCborEncoding, applyParamsToScript, assetsToValue, calculateMinLovelaceFromUTxO, coreToOutRef, coreToTxOutput, coreToUtxo, coresToOutRefs, coresToTxOutputs, coresToUtxos, createCostModels, credentialToAddress, credentialToRewardAddress, datumToHash, fromLabel, fromScriptRef, fromUnit, generatePrivateKey, generateSeedPhrase, getAddressDetails, getUniqueTokenName, isEqualUTxO, keyHashToCredential, mintingPolicyToId, networkToId, parseCMLNative, paymentCredentialOf, scriptFromCMLNative, scriptFromNative, scriptHashToCredential, selectUTxOs, slotToUnixTime, sortUTxOs, stakeCredentialOf, stringify, toCMLNativeScript, toLabel, toPublicKey, toScriptRef, toUnit, unixTimeToSlot, utxoToCore, utxoToTransactionInput, utxoToTransactionOutput, utxosToCores, validatorToAddress, validatorToRewardAddress, validatorToScriptHash, valueToAssets };
+export { type CMLNative, PROTOCOL_PARAMETERS_DEFAULT, type SortOrder, addAssets, addressFromHexOrBech32, applyDoubleCborEncoding, applyParamsToScript, assetsToValue, calculateMinLovelaceFromUTxO, coreToOutRef, coreToTxOutput, coreToUtxo, coresToOutRefs, coresToTxOutputs, coresToUtxos, createCostModels, credentialToAddress, credentialToRewardAddress, datumToHash, fromLabel, fromScriptRef, fromUnit, generatePrivateKey, generateSeedPhrase, getAddressDetails, getInputIndices, getUniqueTokenName, isEqualUTxO, keyHashToCredential, mintingPolicyToId, networkToId, parseCMLNative, paymentCredentialOf, scriptFromCMLNative, scriptFromNative, scriptHashToCredential, selectUTxOs, slotToUnixTime, sortUTxOs, stakeCredentialOf, stringify, toCMLNativeScript, toLabel, toPublicKey, toScriptRef, toUnit, unixTimeToSlot, utxoToCore, utxoToTransactionInput, utxoToTransactionOutput, utxosToCores, validatorToAddress, validatorToRewardAddress, validatorToScriptHash, valueToAssets };

package/dist/index.d.ts

@@ -119,9 +119,14 @@ type SortOrder =
 /**
  * Smallest amount of "lovelace" with least number of unique assets first
  */
- | "SmallestFirst";
+ | "SmallestFirst"
+/**
+ * Lexicographically sorted as per ledger rules
+ */
+ | "Canonical";
 /**
  * Sorts an array of UTXOs according to specified sort order ("LargestFirst" by default).
+ * The provided array is cloned and reference to the new sorted array is returned.
  *
  * @param {UTxO[]} utxos - The array of UTXO objects to be sorted.
  * @param {SortOrder} [order="LargestFirst"] - The order in which to sort the UTXOs.
@@ -130,6 +135,17 @@ type SortOrder =
  */
 declare const sortUTxOs: (utxos: UTxO[], order?: SortOrder) => UTxO[];
 declare const isEqualUTxO: (self: UTxO, that: UTxO) => boolean;
+/**
+ * Provides an array of input indices for given "indexInputs" UTxOs.
+ * Indices obtained from the list of transaction inputs which are
+ * ordered as per ledger rules.
+ *
+ * @param indexInputs Input utxos whose indices need to be returned
+ * @param allInputs All the inputs utxos being spent by the transaction
+ * @param sorted Whether the provided "allInputs" are sorted canonically or not
+ * @returns Input indices of utxos as they appear in "indexInputs"
+ */
+declare function getInputIndices(indexInputs: UTxO[], allInputs: UTxO[], sorted?: Boolean): bigint[];
 declare const calculateMinLovelaceFromUTxO: (coinsPerUtxoByte: bigint, utxo: UTxO) => bigint;
 
 declare function valueToAssets(value: CML.Value): Assets;
@@ -157,4 +173,4 @@ declare function getUniqueTokenName(utxo: UTxO): Promise<string>;
 
 declare const stringify: (data: any) => string;
 
-export { type CMLNative, PROTOCOL_PARAMETERS_DEFAULT, type SortOrder, addAssets, addressFromHexOrBech32, applyDoubleCborEncoding, applyParamsToScript, assetsToValue, calculateMinLovelaceFromUTxO, coreToOutRef, coreToTxOutput, coreToUtxo, coresToOutRefs, coresToTxOutputs, coresToUtxos, createCostModels, credentialToAddress, credentialToRewardAddress, datumToHash, fromLabel, fromScriptRef, fromUnit, generatePrivateKey, generateSeedPhrase, getAddressDetails, getUniqueTokenName, isEqualUTxO, keyHashToCredential, mintingPolicyToId, networkToId, parseCMLNative, paymentCredentialOf, scriptFromCMLNative, scriptFromNative, scriptHashToCredential, selectUTxOs, slotToUnixTime, sortUTxOs, stakeCredentialOf, stringify, toCMLNativeScript, toLabel, toPublicKey, toScriptRef, toUnit, unixTimeToSlot, utxoToCore, utxoToTransactionInput, utxoToTransactionOutput, utxosToCores, validatorToAddress, validatorToRewardAddress, validatorToScriptHash, valueToAssets };
+export { type CMLNative, PROTOCOL_PARAMETERS_DEFAULT, type SortOrder, addAssets, addressFromHexOrBech32, applyDoubleCborEncoding, applyParamsToScript, assetsToValue, calculateMinLovelaceFromUTxO, coreToOutRef, coreToTxOutput, coreToUtxo, coresToOutRefs, coresToTxOutputs, coresToUtxos, createCostModels, credentialToAddress, credentialToRewardAddress, datumToHash, fromLabel, fromScriptRef, fromUnit, generatePrivateKey, generateSeedPhrase, getAddressDetails, getInputIndices, getUniqueTokenName, isEqualUTxO, keyHashToCredential, mintingPolicyToId, networkToId, parseCMLNative, paymentCredentialOf, scriptFromCMLNative, scriptFromNative, scriptHashToCredential, selectUTxOs, slotToUnixTime, sortUTxOs, stakeCredentialOf, stringify, toCMLNativeScript, toLabel, toPublicKey, toScriptRef, toUnit, unixTimeToSlot, utxoToCore, utxoToTransactionInput, utxoToTransactionOutput, utxosToCores, validatorToAddress, validatorToRewardAddress, validatorToScriptHash, valueToAssets };

package/dist/index.js

@@ -1069,6 +1069,8 @@ var sortUTxOs = (utxos, order = "LargestFirst") => {
       return [...utxos].sort(largestFirst);
     case "SmallestFirst":
       return [...utxos].sort(smallestFirst);
+    case "Canonical":
+      return [...utxos].sort(canonical);
   }
 };
 var largestFirst = (a, b) => {
@@ -1087,7 +1089,28 @@ var smallestFirst = (a, b) => {
   }
   return lovelaceA - lovelaceB;
 };
+var canonical = (a, b) => {
+  if (a.txHash < b.txHash) {
+    return -1;
+  } else if (a.txHash > b.txHash) {
+    return 1;
+  } else {
+    return a.outputIndex - b.outputIndex;
+  }
+};
 var isEqualUTxO = (self, that) => self.txHash === that.txHash && self.outputIndex === that.outputIndex;
+function getInputIndices(indexInputs, allInputs, sorted = false) {
+  const sortedInputs = sorted ? allInputs : sortUTxOs(allInputs, "Canonical");
+  const indicesMap = /* @__PURE__ */ new Map();
+  sortedInputs.forEach((value, index) => {
+    indicesMap.set(value.txHash + value.outputIndex, BigInt(index));
+  });
+  return indexInputs.flatMap((value) => {
+    const index = indicesMap.get(value.txHash + value.outputIndex);
+    if (index !== void 0) return index;
+    else return [];
+  });
+}
 var calculateMinLovelaceFromUTxO = (coinsPerUtxoByte, utxo) => buildOutput(utxo).with_asset_and_min_required_coin(
   assetsToValue(utxo.assets).multi_asset(),
   coinsPerUtxoByte
@@ -1140,6 +1163,7 @@ export {
   generatePrivateKey,
   generateSeedPhrase,
   getAddressDetails,
+  getInputIndices,
   getUniqueTokenName,
   isEqualUTxO,
   keyHashToCredential,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucid-evolution/utils",
-  "version": "0.1.25",
+  "version": "0.1.27",
   "description": "",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -33,12 +33,12 @@
     "@emurgo/cardano-serialization-lib-nodejs": "^11.5.0",
     "cborg": "^4.2.0",
     "effect": "^3.1.2",
-    "@lucid-evolution/bip39": "0.2.9",
-    "@lucid-evolution/core-types": "0.1.9",
-    "@lucid-evolution/core-utils": "0.1.7",
-    "@lucid-evolution/crc8": "0.1.7",
-    "@lucid-evolution/plutus": "0.1.12",
-    "@lucid-evolution/uplc": "0.2.8"
+    "@lucid-evolution/bip39": "0.2.10",
+    "@lucid-evolution/core-types": "0.1.11",
+    "@lucid-evolution/core-utils": "0.1.8",
+    "@lucid-evolution/crc8": "0.1.8",
+    "@lucid-evolution/plutus": "0.1.14",
+    "@lucid-evolution/uplc": "0.2.9"
   },
   "devDependencies": {
     "@types/node": "^20.12.8",
@@ -48,6 +48,7 @@
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",
+    "lint": "tsc --noEmit",
     "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist",
     "test": "vitest run"
   }