@lucid-evolution/utils 0.1.11 → 0.1.12

package/dist/index.cjs

@@ -52,6 +52,7 @@ __export(src_exports, {
   generatePrivateKey: () => generatePrivateKey,
   generateSeedPhrase: () => generateSeedPhrase,
   getAddressDetails: () => getAddressDetails,
+  isEqualUTxO: () => isEqualUTxO,
   keyHashToCredential: () => keyHashToCredential,
   mintingPolicyToId: () => mintingPolicyToId,
   nativeFromJson: () => nativeFromJson,
@@ -60,7 +61,9 @@ __export(src_exports, {
   networkToId: () => networkToId,
   paymentCredentialOf: () => paymentCredentialOf,
   scriptHashToCredential: () => scriptHashToCredential,
+  selectUTxOs: () => selectUTxOs,
   slotToUnixTime: () => slotToUnixTime,
+  sortUTxOs: () => sortUTxOs,
   stakeCredentialOf: () => stakeCredentialOf,
   toLabel: () => toLabel,
   toNativeScript: () => toNativeScript,
@@ -926,8 +929,8 @@ var import_core_utils4 = require("@lucid-evolution/core-utils");
 function valueToAssets(value) {
   const assets = {};
   assets["lovelace"] = value.coin();
-  const ma = value.multi_asset();
-  if (ma) {
+  if (value.has_multiassets()) {
+    const ma = value.multi_asset();
     const multiAssets = ma.keys();
     for (let j = 0; j < multiAssets.len(); j++) {
       const policy = multiAssets.get(j);
@@ -936,7 +939,7 @@ function valueToAssets(value) {
       for (let k = 0; k < assetNames.len(); k++) {
         const policyAsset = assetNames.get(k);
         const quantity = policyAssets.get(policyAsset);
-        const unit = policy.to_hex() + policyAsset.to_cbor_hex();
+        const unit = policy.to_hex() + (0, import_core_utils4.fromText)(policyAsset.to_str());
         assets[unit] = quantity;
       }
     }
@@ -1045,7 +1048,6 @@ function coreToUtxo(coreUtxo) {
     ...coreToOutRef(CML.TransactionInput.from_cbor_hex(coreUtxo.to_cbor_hex())),
     ...coreToTxOutput(out)
   };
-  out.free();
   return utxo;
 }
 function coresToUtxos(utxos) {
@@ -1084,6 +1086,47 @@ function coresToTxOutputs(outputs) {
   }
   return result;
 }
+var selectUTxOs = (utxos, totalAssets) => {
+  const selectedUtxos = [];
+  let isSelected = false;
+  const assetsRequired = new Map(Object.entries(totalAssets));
+  const sortedUtxos = sortUTxOs(utxos);
+  for (const utxo of sortedUtxos) {
+    isSelected = false;
+    for (const [unit, amount] of assetsRequired) {
+      if (Object.hasOwn(utxo.assets, unit)) {
+        const utxoAmount = utxo.assets[unit];
+        if (utxoAmount >= amount) {
+          assetsRequired.delete(unit);
+        } else {
+          assetsRequired.set(unit, amount - utxoAmount);
+        }
+        isSelected = true;
+      }
+    }
+    if (isSelected) {
+      selectedUtxos.push(utxo);
+    }
+    if (assetsRequired.size == 0) {
+      break;
+    }
+  }
+  if (assetsRequired.size > 0)
+    return [];
+  return selectedUtxos;
+};
+var sortUTxOs = (utxos, order = "descending") => {
+  return utxos.toSorted((a, b) => {
+    if (a.assets["lovelace"] > b.assets["lovelace"]) {
+      return order === "ascending" ? 1 : -1;
+    }
+    if (a.assets["lovelace"] < b.assets["lovelace"]) {
+      return order === "ascending" ? -1 : 1;
+    }
+    return 0;
+  });
+};
+var isEqualUTxO = (self, that) => self.txHash === that.txHash && self.outputIndex === that.outputIndex;
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PROTOCOL_PARAMETERS_DEFAULT,
@@ -1108,6 +1151,7 @@ function coresToTxOutputs(outputs) {
   generatePrivateKey,
   generateSeedPhrase,
   getAddressDetails,
+  isEqualUTxO,
   keyHashToCredential,
   mintingPolicyToId,
   nativeFromJson,
@@ -1116,7 +1160,9 @@ function coresToTxOutputs(outputs) {
   networkToId,
   paymentCredentialOf,
   scriptHashToCredential,
+  selectUTxOs,
   slotToUnixTime,
+  sortUTxOs,
   stakeCredentialOf,
   toLabel,
   toNativeScript,

package/dist/index.d.cts

@@ -56,9 +56,21 @@ declare function utxosToCores(utxos: UTxO[]): CML.TransactionUnspentOutput[];
 declare function coreToUtxo(coreUtxo: CML.TransactionUnspentOutput): UTxO;
 declare function coresToUtxos(utxos: CML.TransactionUnspentOutput[]): UTxO[];
 declare function coreToOutRef(input: CML.TransactionInput): OutRef;
-declare function coresToOutRefs(inputs: Array<CML.TransactionInput>): OutRef[];
+declare function coresToOutRefs(inputs: CML.TransactionInput[]): OutRef[];
 declare function coreToTxOutput(output: CML.TransactionOutput): TxOutput;
 declare function coresToTxOutputs(outputs: CML.TransactionOutput[]): TxOutput[];
+declare const selectUTxOs: (utxos: UTxO[], totalAssets: Assets) => UTxO[];
+/**
+ * Sorts an array of UTXOs by the amount of "lovelace" in ascending or descending order.
+ *
+ * @param {UTxO[]} utxos - The array of UTXO objects to be sorted.
+ * @param {"ascending" | "descending"} [order="descending"] - The order in which to sort the UTXOs.
+ *      Use "ascending" for ascending order and "descending" for descending order.
+ * @returns {UTxO[]} - The sorted array of UTXOs.
+ *
+ */
+declare const sortUTxOs: (utxos: UTxO[], order?: "ascending" | "descending") => UTxO[];
+declare const isEqualUTxO: (self: UTxO, that: UTxO) => boolean;
 
 declare function valueToAssets(value: CML.Value): Assets;
 declare function assetsToValue(assets: Assets): CML.Value;
@@ -78,4 +90,4 @@ declare function fromUnit(unit: Unit): {
 declare function toUnit(policyId: PolicyId, name?: string | null, label?: number | null): Unit;
 declare function addAssets(...assets: Assets[]): Assets;
 
-export { PROTOCOL_PARAMETERS_DEFAULT, addAssets, addressFromHexOrBech32, applyDoubleCborEncoding, applyParamsToScript, assetsToValue, coreToOutRef, coreToTxOutput, coreToUtxo, coresToOutRefs, coresToTxOutputs, coresToUtxos, createCostModels, credentialToAddress, credentialToRewardAddress, datumToHash, fromLabel, fromScriptRef, fromUnit, generatePrivateKey, generateSeedPhrase, getAddressDetails, keyHashToCredential, mintingPolicyToId, nativeFromJson, nativeJSFromJson, nativeScriptFromJson, networkToId, paymentCredentialOf, scriptHashToCredential, slotToUnixTime, stakeCredentialOf, toLabel, toNativeScript, toPublicKey, toScriptRef, toUnit, unixTimeToSlot, utxoToCore, utxoToTransactionInput, utxoToTransactionOutput, utxosToCores, validatorToAddress, validatorToRewardAddress, validatorToScriptHash, valueToAssets };
+export { PROTOCOL_PARAMETERS_DEFAULT, addAssets, addressFromHexOrBech32, applyDoubleCborEncoding, applyParamsToScript, assetsToValue, coreToOutRef, coreToTxOutput, coreToUtxo, coresToOutRefs, coresToTxOutputs, coresToUtxos, createCostModels, credentialToAddress, credentialToRewardAddress, datumToHash, fromLabel, fromScriptRef, fromUnit, generatePrivateKey, generateSeedPhrase, getAddressDetails, isEqualUTxO, keyHashToCredential, mintingPolicyToId, nativeFromJson, nativeJSFromJson, nativeScriptFromJson, networkToId, paymentCredentialOf, scriptHashToCredential, selectUTxOs, slotToUnixTime, sortUTxOs, stakeCredentialOf, toLabel, toNativeScript, toPublicKey, toScriptRef, toUnit, unixTimeToSlot, utxoToCore, utxoToTransactionInput, utxoToTransactionOutput, utxosToCores, validatorToAddress, validatorToRewardAddress, validatorToScriptHash, valueToAssets };

package/dist/index.d.ts

@@ -56,9 +56,21 @@ declare function utxosToCores(utxos: UTxO[]): CML.TransactionUnspentOutput[];
 declare function coreToUtxo(coreUtxo: CML.TransactionUnspentOutput): UTxO;
 declare function coresToUtxos(utxos: CML.TransactionUnspentOutput[]): UTxO[];
 declare function coreToOutRef(input: CML.TransactionInput): OutRef;
-declare function coresToOutRefs(inputs: Array<CML.TransactionInput>): OutRef[];
+declare function coresToOutRefs(inputs: CML.TransactionInput[]): OutRef[];
 declare function coreToTxOutput(output: CML.TransactionOutput): TxOutput;
 declare function coresToTxOutputs(outputs: CML.TransactionOutput[]): TxOutput[];
+declare const selectUTxOs: (utxos: UTxO[], totalAssets: Assets) => UTxO[];
+/**
+ * Sorts an array of UTXOs by the amount of "lovelace" in ascending or descending order.
+ *
+ * @param {UTxO[]} utxos - The array of UTXO objects to be sorted.
+ * @param {"ascending" | "descending"} [order="descending"] - The order in which to sort the UTXOs.
+ *      Use "ascending" for ascending order and "descending" for descending order.
+ * @returns {UTxO[]} - The sorted array of UTXOs.
+ *
+ */
+declare const sortUTxOs: (utxos: UTxO[], order?: "ascending" | "descending") => UTxO[];
+declare const isEqualUTxO: (self: UTxO, that: UTxO) => boolean;
 
 declare function valueToAssets(value: CML.Value): Assets;
 declare function assetsToValue(assets: Assets): CML.Value;
@@ -78,4 +90,4 @@ declare function fromUnit(unit: Unit): {
 declare function toUnit(policyId: PolicyId, name?: string | null, label?: number | null): Unit;
 declare function addAssets(...assets: Assets[]): Assets;
 
-export { PROTOCOL_PARAMETERS_DEFAULT, addAssets, addressFromHexOrBech32, applyDoubleCborEncoding, applyParamsToScript, assetsToValue, coreToOutRef, coreToTxOutput, coreToUtxo, coresToOutRefs, coresToTxOutputs, coresToUtxos, createCostModels, credentialToAddress, credentialToRewardAddress, datumToHash, fromLabel, fromScriptRef, fromUnit, generatePrivateKey, generateSeedPhrase, getAddressDetails, keyHashToCredential, mintingPolicyToId, nativeFromJson, nativeJSFromJson, nativeScriptFromJson, networkToId, paymentCredentialOf, scriptHashToCredential, slotToUnixTime, stakeCredentialOf, toLabel, toNativeScript, toPublicKey, toScriptRef, toUnit, unixTimeToSlot, utxoToCore, utxoToTransactionInput, utxoToTransactionOutput, utxosToCores, validatorToAddress, validatorToRewardAddress, validatorToScriptHash, valueToAssets };
+export { PROTOCOL_PARAMETERS_DEFAULT, addAssets, addressFromHexOrBech32, applyDoubleCborEncoding, applyParamsToScript, assetsToValue, coreToOutRef, coreToTxOutput, coreToUtxo, coresToOutRefs, coresToTxOutputs, coresToUtxos, createCostModels, credentialToAddress, credentialToRewardAddress, datumToHash, fromLabel, fromScriptRef, fromUnit, generatePrivateKey, generateSeedPhrase, getAddressDetails, isEqualUTxO, keyHashToCredential, mintingPolicyToId, nativeFromJson, nativeJSFromJson, nativeScriptFromJson, networkToId, paymentCredentialOf, scriptHashToCredential, selectUTxOs, slotToUnixTime, sortUTxOs, stakeCredentialOf, toLabel, toNativeScript, toPublicKey, toScriptRef, toUnit, unixTimeToSlot, utxoToCore, utxoToTransactionInput, utxoToTransactionOutput, utxosToCores, validatorToAddress, validatorToRewardAddress, validatorToScriptHash, valueToAssets };

package/dist/index.js

@@ -845,12 +845,12 @@ function slotToUnixTime(network, slot) {
 }
 
 // src/value.ts
-import { toText } from "@lucid-evolution/core-utils";
+import { fromText, toText } from "@lucid-evolution/core-utils";
 function valueToAssets(value) {
   const assets = {};
   assets["lovelace"] = value.coin();
-  const ma = value.multi_asset();
-  if (ma) {
+  if (value.has_multiassets()) {
+    const ma = value.multi_asset();
     const multiAssets = ma.keys();
     for (let j = 0; j < multiAssets.len(); j++) {
       const policy = multiAssets.get(j);
@@ -859,7 +859,7 @@ function valueToAssets(value) {
       for (let k = 0; k < assetNames.len(); k++) {
         const policyAsset = assetNames.get(k);
         const quantity = policyAssets.get(policyAsset);
-        const unit = policy.to_hex() + policyAsset.to_cbor_hex();
+        const unit = policy.to_hex() + fromText(policyAsset.to_str());
         assets[unit] = quantity;
       }
     }
@@ -968,7 +968,6 @@ function coreToUtxo(coreUtxo) {
     ...coreToOutRef(CML.TransactionInput.from_cbor_hex(coreUtxo.to_cbor_hex())),
     ...coreToTxOutput(out)
   };
-  out.free();
   return utxo;
 }
 function coresToUtxos(utxos) {
@@ -1007,6 +1006,47 @@ function coresToTxOutputs(outputs) {
   }
   return result;
 }
+var selectUTxOs = (utxos, totalAssets) => {
+  const selectedUtxos = [];
+  let isSelected = false;
+  const assetsRequired = new Map(Object.entries(totalAssets));
+  const sortedUtxos = sortUTxOs(utxos);
+  for (const utxo of sortedUtxos) {
+    isSelected = false;
+    for (const [unit, amount] of assetsRequired) {
+      if (Object.hasOwn(utxo.assets, unit)) {
+        const utxoAmount = utxo.assets[unit];
+        if (utxoAmount >= amount) {
+          assetsRequired.delete(unit);
+        } else {
+          assetsRequired.set(unit, amount - utxoAmount);
+        }
+        isSelected = true;
+      }
+    }
+    if (isSelected) {
+      selectedUtxos.push(utxo);
+    }
+    if (assetsRequired.size == 0) {
+      break;
+    }
+  }
+  if (assetsRequired.size > 0)
+    return [];
+  return selectedUtxos;
+};
+var sortUTxOs = (utxos, order = "descending") => {
+  return utxos.toSorted((a, b) => {
+    if (a.assets["lovelace"] > b.assets["lovelace"]) {
+      return order === "ascending" ? 1 : -1;
+    }
+    if (a.assets["lovelace"] < b.assets["lovelace"]) {
+      return order === "ascending" ? -1 : 1;
+    }
+    return 0;
+  });
+};
+var isEqualUTxO = (self, that) => self.txHash === that.txHash && self.outputIndex === that.outputIndex;
 export {
   PROTOCOL_PARAMETERS_DEFAULT,
   addAssets,
@@ -1030,6 +1070,7 @@ export {
   generatePrivateKey,
   generateSeedPhrase,
   getAddressDetails,
+  isEqualUTxO,
   keyHashToCredential,
   mintingPolicyToId,
   nativeFromJson,
@@ -1038,7 +1079,9 @@ export {
   networkToId,
   paymentCredentialOf,
   scriptHashToCredential,
+  selectUTxOs,
   slotToUnixTime,
+  sortUTxOs,
   stakeCredentialOf,
   toLabel,
   toNativeScript,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucid-evolution/utils",
-  "version": "0.1.11",
+  "version": "0.1.12",
   "description": "",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",