@lucid-evolution/utils 0.1.15 → 0.1.17

package/dist/index.cjs

@@ -65,6 +65,7 @@ __export(src_exports, {
   slotToUnixTime: () => slotToUnixTime,
   sortUTxOs: () => sortUTxOs,
   stakeCredentialOf: () => stakeCredentialOf,
+  stringify: () => stringify,
   toLabel: () => toLabel,
   toNativeScript: () => toNativeScript,
   toPublicKey: () => toPublicKey,
@@ -1114,18 +1115,38 @@ var selectUTxOs = (utxos, totalAssets) => {
     return [];
   return selectedUtxos;
 };
-var sortUTxOs = (utxos, order = "descending") => {
-  return [...utxos].sort((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 sortUTxOs = (utxos, order = "LargestFirst") => {
+  switch (order) {
+    case "LargestFirst":
+      return [...utxos].sort(largestFirst);
+    case "SmallestFirst":
+      return [...utxos].sort(smallestFirst);
+  }
+};
+var largestFirst = (a, b) => {
+  const lovelaceA = Number(a.assets["lovelace"]);
+  const lovelaceB = Number(b.assets["lovelace"]);
+  if (lovelaceA === lovelaceB) {
+    return Object.keys(a.assets).length - Object.keys(b.assets).length;
+  }
+  return -1 * (lovelaceA - lovelaceB);
+};
+var smallestFirst = (a, b) => {
+  const lovelaceA = Number(a.assets["lovelace"]);
+  const lovelaceB = Number(b.assets["lovelace"]);
+  if (lovelaceA == lovelaceB) {
+    return Object.keys(a.assets).length - Object.keys(b.assets).length;
+  }
+  return lovelaceA - lovelaceB;
 };
 var isEqualUTxO = (self, that) => self.txHash === that.txHash && self.outputIndex === that.outputIndex;
+
+// src/objects.ts
+var stringify = (data) => JSON.stringify(
+  data,
+  (key, value) => typeof value === "bigint" ? value.toString() + "n" : value,
+  2
+);
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   PROTOCOL_PARAMETERS_DEFAULT,
@@ -1163,6 +1184,7 @@ var isEqualUTxO = (self, that) => self.txHash === that.txHash && self.outputInde
   slotToUnixTime,
   sortUTxOs,
   stakeCredentialOf,
+  stringify,
   toLabel,
   toNativeScript,
   toPublicKey,

package/dist/index.d.cts

@@ -61,15 +61,26 @@ 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.
+ * Union type for specifying sorting order in function "sortUTxOs"
+ */
+type SortOrder = 
+/**
+ * Largest amount of "lovelace" with least number of unique assets first
+ */
+"LargestFirst"
+/**
+ * Smallest amount of "lovelace" with least number of unique assets first
+ */
+ | "SmallestFirst";
+/**
+ * Sorts an array of UTXOs according to specified sort order ("LargestFirst" by default).
  *
  * @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.
+ * @param {SortOrder} [order="LargestFirst"] - The order in which to sort the UTXOs.
  * @returns {UTxO[]} - The sorted array of UTXOs.
  *
  */
-declare const sortUTxOs: (utxos: UTxO[], order?: "ascending" | "descending") => UTxO[];
+declare const sortUTxOs: (utxos: UTxO[], order?: SortOrder) => UTxO[];
 declare const isEqualUTxO: (self: UTxO, that: UTxO) => boolean;
 
 declare function valueToAssets(value: CML.Value): Assets;
@@ -90,4 +101,6 @@ 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, 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 };
+declare const stringify: (data: any) => string;
+
+export { PROTOCOL_PARAMETERS_DEFAULT, type SortOrder, 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, stringify, toLabel, toNativeScript, toPublicKey, toScriptRef, toUnit, unixTimeToSlot, utxoToCore, utxoToTransactionInput, utxoToTransactionOutput, utxosToCores, validatorToAddress, validatorToRewardAddress, validatorToScriptHash, valueToAssets };

package/dist/index.d.ts

@@ -61,15 +61,26 @@ 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.
+ * Union type for specifying sorting order in function "sortUTxOs"
+ */
+type SortOrder = 
+/**
+ * Largest amount of "lovelace" with least number of unique assets first
+ */
+"LargestFirst"
+/**
+ * Smallest amount of "lovelace" with least number of unique assets first
+ */
+ | "SmallestFirst";
+/**
+ * Sorts an array of UTXOs according to specified sort order ("LargestFirst" by default).
  *
  * @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.
+ * @param {SortOrder} [order="LargestFirst"] - The order in which to sort the UTXOs.
  * @returns {UTxO[]} - The sorted array of UTXOs.
  *
  */
-declare const sortUTxOs: (utxos: UTxO[], order?: "ascending" | "descending") => UTxO[];
+declare const sortUTxOs: (utxos: UTxO[], order?: SortOrder) => UTxO[];
 declare const isEqualUTxO: (self: UTxO, that: UTxO) => boolean;
 
 declare function valueToAssets(value: CML.Value): Assets;
@@ -90,4 +101,6 @@ 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, 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 };
+declare const stringify: (data: any) => string;
+
+export { PROTOCOL_PARAMETERS_DEFAULT, type SortOrder, 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, stringify, toLabel, toNativeScript, toPublicKey, toScriptRef, toUnit, unixTimeToSlot, utxoToCore, utxoToTransactionInput, utxoToTransactionOutput, utxosToCores, validatorToAddress, validatorToRewardAddress, validatorToScriptHash, valueToAssets };

package/dist/index.js

@@ -1034,18 +1034,38 @@ var selectUTxOs = (utxos, totalAssets) => {
     return [];
   return selectedUtxos;
 };
-var sortUTxOs = (utxos, order = "descending") => {
-  return [...utxos].sort((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 sortUTxOs = (utxos, order = "LargestFirst") => {
+  switch (order) {
+    case "LargestFirst":
+      return [...utxos].sort(largestFirst);
+    case "SmallestFirst":
+      return [...utxos].sort(smallestFirst);
+  }
+};
+var largestFirst = (a, b) => {
+  const lovelaceA = Number(a.assets["lovelace"]);
+  const lovelaceB = Number(b.assets["lovelace"]);
+  if (lovelaceA === lovelaceB) {
+    return Object.keys(a.assets).length - Object.keys(b.assets).length;
+  }
+  return -1 * (lovelaceA - lovelaceB);
+};
+var smallestFirst = (a, b) => {
+  const lovelaceA = Number(a.assets["lovelace"]);
+  const lovelaceB = Number(b.assets["lovelace"]);
+  if (lovelaceA == lovelaceB) {
+    return Object.keys(a.assets).length - Object.keys(b.assets).length;
+  }
+  return lovelaceA - lovelaceB;
 };
 var isEqualUTxO = (self, that) => self.txHash === that.txHash && self.outputIndex === that.outputIndex;
+
+// src/objects.ts
+var stringify = (data) => JSON.stringify(
+  data,
+  (key, value) => typeof value === "bigint" ? value.toString() + "n" : value,
+  2
+);
 export {
   PROTOCOL_PARAMETERS_DEFAULT,
   addAssets,
@@ -1082,6 +1102,7 @@ export {
   slotToUnixTime,
   sortUTxOs,
   stakeCredentialOf,
+  stringify,
   toLabel,
   toNativeScript,
   toPublicKey,

package/package.json

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