@lucid-evolution/provider 0.1.19 → 0.1.21

package/dist/index.cjs

@@ -31,6 +31,7 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   Blockfrost: () => Blockfrost,
+  Koios: () => Koios,
   Kupmios: () => Kupmios,
   Maestro: () => Maestro,
   datumJsonToCbor: () => datumJsonToCbor
@@ -47,7 +48,7 @@ var import_utils = require("@lucid-evolution/utils");
 // package.json
 var package_default = {
   name: "@lucid-evolution/provider",
-  version: "0.1.19",
+  version: "0.1.21",
   description: "",
   main: "./dist/index.js",
   types: "./dist/index.d.ts",
@@ -67,7 +68,8 @@ var package_default = {
   },
   scripts: {
     build: "tsup src/index.ts --format esm,cjs --dts --clean",
-    clean: "rm -rf .turbo && rm -rf node_modules && rm -rf dist"
+    clean: "rm -rf .turbo && rm -rf node_modules && rm -rf dist",
+    test: "vitest run"
   },
   keywords: [],
   author: "",
@@ -76,8 +78,9 @@ var package_default = {
     "@dcspark/cardano-multiplatform-lib-nodejs": "@dcspark/cardano-multiplatform-lib-browser"
   },
   dependencies: {
-    "@dcspark/cardano-multiplatform-lib-nodejs": "^5.3.0",
     "@dcspark/cardano-multiplatform-lib-browser": "^5.3.0",
+    "@dcspark/cardano-multiplatform-lib-nodejs": "^5.3.0",
+    "@effect/schema": "^0.67.16",
     "@lucid-evolution/core-types": "workspace:*",
     "@lucid-evolution/core-utils": "workspace:*",
     "@lucid-evolution/utils": "workspace:*"
@@ -85,7 +88,8 @@ var package_default = {
   devDependencies: {
     "@types/node": "^20.12.8",
     tsup: "^8.0.2",
-    typescript: "^5.4.5"
+    typescript: "^5.4.5",
+    vitest: "^1.6.0"
   }
 };
 
@@ -843,9 +847,444 @@ var Maestro = class {
   }
 };
 var lucid2 = package_default.version;
+
+// src/koios/koios.ts
+var S2 = __toESM(require("@effect/schema/Schema"), 1);
+var import_core_utils3 = require("@lucid-evolution/core-utils");
+var import_utils4 = require("@lucid-evolution/utils");
+
+// src/koios/schema.ts
+var S = __toESM(require("@effect/schema/Schema"), 1);
+var ProtocolParametersSchema = S.Struct({
+  epoch_no: S.Number,
+  min_fee_a: S.Number,
+  min_fee_b: S.Number,
+  max_block_size: S.Number,
+  max_tx_size: S.Number,
+  max_bh_size: S.Number,
+  key_deposit: S.BigInt,
+  pool_deposit: S.BigInt,
+  max_epoch: S.Number,
+  optimal_pool_count: S.Number,
+  influence: S.Number,
+  monetary_expand_rate: S.Number,
+  treasury_growth_rate: S.Number,
+  decentralisation: S.Number,
+  extra_entropy: S.NullOr(S.String),
+  protocol_major: S.Number,
+  protocol_minor: S.Number,
+  min_utxo_value: S.String,
+  min_pool_cost: S.String,
+  nonce: S.String,
+  block_hash: S.NullOr(S.String),
+  cost_models: S.Struct({
+    PlutusV1: S.Array(S.Number),
+    PlutusV2: S.Array(S.Number)
+  }),
+  price_mem: S.Number,
+  price_step: S.Number,
+  max_tx_ex_mem: S.BigIntFromNumber,
+  max_tx_ex_steps: S.BigIntFromNumber,
+  max_block_ex_mem: S.Number,
+  max_block_ex_steps: S.Number,
+  max_val_size: S.Number,
+  collateral_percent: S.Number,
+  max_collateral_inputs: S.Number,
+  coins_per_utxo_size: S.BigInt
+});
+var KoiosAssetSchema = S.Struct({
+  policy_id: S.String,
+  asset_name: S.NullOr(S.String),
+  fingerprint: S.String,
+  decimals: S.Number,
+  quantity: S.String
+});
+var KoiosUTxOSchema = S.Struct({
+  tx_hash: S.String,
+  tx_index: S.Number,
+  block_height: S.NullOr(S.Number),
+  value: S.String,
+  datum_hash: S.NullOr(S.String),
+  inline_datum: S.NullOr(
+    S.Struct({
+      bytes: S.String,
+      value: S.Object
+    })
+  ),
+  reference_script: S.NullOr(
+    S.Struct({
+      hash: S.String,
+      size: S.Number,
+      type: S.String,
+      bytes: S.String,
+      value: S.NullOr(S.Object)
+    })
+  ),
+  asset_list: S.Array(KoiosAssetSchema)
+});
+var KoiosAddressInfoSchema = S.Array(
+  S.NullishOr(
+    S.Struct({
+      address: S.String,
+      balance: S.String,
+      stake_address: S.NullOr(S.String),
+      script_address: S.Boolean,
+      utxo_set: S.Array(KoiosUTxOSchema)
+    })
+  )
+);
+var KoiosInputOutputSchema = S.Struct({
+  payment_addr: S.Struct({
+    bech32: S.String,
+    cred: S.String
+  }),
+  stake_addr: S.NullOr(S.String),
+  tx_hash: S.String,
+  tx_index: S.Number,
+  value: S.String,
+  datum_hash: S.NullOr(S.String),
+  inline_datum: S.NullOr(
+    S.Struct({
+      bytes: S.String,
+      value: S.Object
+    })
+  ),
+  reference_script: S.NullOr(
+    S.Struct({
+      hash: S.String,
+      size: S.Number,
+      type: S.String,
+      bytes: S.String,
+      value: S.NullOr(S.Object)
+    })
+  ),
+  asset_list: S.Array(KoiosAssetSchema)
+});
+var KoiosTxInfoSchema = S.Struct({
+  tx_hash: S.String,
+  block_hash: S.String,
+  block_height: S.Number,
+  epoch_no: S.Number,
+  epoch_slot: S.Number,
+  absolute_slot: S.Number,
+  tx_timestamp: S.Number,
+  tx_block_index: S.Number,
+  tx_size: S.Number,
+  total_output: S.String,
+  fee: S.String,
+  deposit: S.String,
+  invalid_before: S.NullOr(S.String),
+  invalid_after: S.NullOr(S.String),
+  collateral_inputs: S.NullOr(S.Array(KoiosInputOutputSchema)),
+  collateral_output: S.NullOr(KoiosInputOutputSchema),
+  reference_inputs: S.NullOr(S.Array(KoiosInputOutputSchema)),
+  inputs: S.Array(KoiosInputOutputSchema),
+  outputs: S.Array(KoiosInputOutputSchema),
+  withdrawals: S.NullOr(
+    S.Array(
+      S.Struct({
+        amount: S.String,
+        stake_addr: S.String
+      })
+    )
+  ),
+  assets_minted: S.NullOr(S.Array(KoiosAssetSchema)),
+  metadata: S.NullOr(S.Object),
+  certificates: S.NullOr(
+    S.Array(
+      S.Struct({
+        index: S.Number,
+        type: S.String,
+        info: S.NullOr(S.Object)
+      })
+    )
+  ),
+  native_scripts: S.NullOr(
+    S.Array(
+      S.Struct({
+        script_hash: S.String,
+        script_json: S.Object
+      })
+    )
+  ),
+  plutus_contracts: S.NullOr(
+    S.Array(
+      S.Struct({
+        address: S.String,
+        spends_inputs: S.NullOr(
+          S.Struct({
+            tx_hash: S.String,
+            tx_index: S.Number
+          })
+        ),
+        script_hash: S.String,
+        bytecode: S.String,
+        size: S.Number,
+        valid_contract: S.Boolean,
+        input: S.Struct({
+          redeemer: S.Struct({
+            purpose: S.Literal("spend", "mint", "cert", "reward")
+          })
+        }),
+        fee: S.String,
+        unit: S.Struct({
+          steps: S.String,
+          mem: S.String
+        }),
+        datum: S.Struct({
+          hash: S.NullOr(S.String),
+          value: S.NullOr(S.Object)
+        })
+      })
+    )
+  )
+});
+
+// src/koios/koios.ts
+var Koios = class {
+  baseUrl;
+  constructor(baseUrl) {
+    this.baseUrl = baseUrl;
+  }
+  async getProtocolParameters() {
+    const result = await fetch(`${this.baseUrl}/epoch_params?limit=1`).then(
+      (res) => res.json()
+    );
+    const param = S2.decodeUnknownSync(ProtocolParametersSchema)(result[0]);
+    return {
+      minFeeA: param.min_fee_a,
+      minFeeB: param.min_fee_b,
+      maxTxSize: param.max_tx_size,
+      maxValSize: param.max_val_size,
+      keyDeposit: param.key_deposit,
+      poolDeposit: param.pool_deposit,
+      priceMem: param.price_mem,
+      priceStep: param.price_step,
+      maxTxExMem: param.max_tx_ex_mem,
+      maxTxExSteps: param.max_tx_ex_steps,
+      coinsPerUtxoByte: param.coins_per_utxo_size,
+      collateralPercentage: param.collateral_percent,
+      maxCollateralInputs: param.max_collateral_inputs,
+      costModels: {
+        PlutusV1: Object.fromEntries(
+          param.cost_models.PlutusV1.map((value, index) => [
+            index.toString(),
+            value
+          ])
+        ),
+        PlutusV2: Object.fromEntries(
+          param.cost_models.PlutusV2.map((value, index) => [
+            index.toString(),
+            value
+          ])
+        )
+      }
+    };
+  }
+  async getUtxos(addressOrCredential) {
+    if (typeof addressOrCredential === "string") {
+      const body = {
+        _addresses: [addressOrCredential]
+      };
+      const result = await fetch(`${this.baseUrl}/address_info`, {
+        headers: {
+          Accept: "application/json",
+          "Content-Type": "application/json"
+        },
+        method: "POST",
+        body: JSON.stringify(body)
+      }).then((res) => res.json());
+      const parsedResult = S2.decodeUnknownSync(KoiosAddressInfoSchema)(
+        result
+      )[0];
+      return parsedResult ? parsedResult.utxo_set.map(
+        (koiosUTXO) => toUTxO(koiosUTXO, parsedResult.address)
+      ) : [];
+    } else {
+      throw Error("getUtxos by Credential Type is not supported in Koios yet.");
+    }
+  }
+  async getUtxosWithUnit(addressOrCredential, unit) {
+    if (typeof addressOrCredential === "string") {
+      const utxos = await this.getUtxos(addressOrCredential);
+      if (utxos && utxos.length > 0) {
+        return utxos.filter((utxo) => {
+          const keys = Object.keys(utxo.assets);
+          return keys.length > 0 && keys.includes(unit);
+        });
+      } else {
+        return [];
+      }
+    } else {
+      throw Error(
+        "getUtxosWithUnit by Credential Type is not supported in Koios yet."
+      );
+    }
+  }
+  async getUtxoByUnit(unit) {
+    let { policyId, assetName } = (0, import_utils4.fromUnit)(unit);
+    assetName = String(assetName);
+    const assetAddresses = await fetch(
+      `${this.baseUrl}/asset_addresses?_asset_policy=${policyId}&_asset_name=${assetName}`
+    ).then((res) => res.json());
+    if (Array.isArray(assetAddresses) && assetAddresses.length > 0) {
+      if (assetAddresses.length > 1) {
+        throw new Error("Unit needs to be an NFT or only held by one address.");
+      }
+      const utxos = await this.getUtxos(
+        assetAddresses[0].payment_address
+      );
+      const result = utxos.find((utxo) => {
+        const keys = Object.keys(utxo.assets);
+        return keys.length > 0 && keys.includes(unit);
+      });
+      if (result) {
+        return result;
+      }
+    }
+    throw new Error("Unit not found.");
+  }
+  async getUtxosByOutRef(outRefs) {
+    const utxos = [];
+    const body = {
+      _tx_hashes: [...new Set(outRefs.map((outRef) => outRef.txHash))]
+    };
+    const result = await fetch(`${this.baseUrl}/tx_info`, {
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      body: JSON.stringify(body)
+    }).then((res) => res.json());
+    const parsedResult = S2.decodeUnknownSync(S2.Array(KoiosTxInfoSchema))(
+      result
+    )[0];
+    if (parsedResult) {
+      return parsedResult.outputs.map(
+        (koiosInputOutput) => toUTxO(
+          {
+            tx_hash: koiosInputOutput.tx_hash,
+            tx_index: koiosInputOutput.tx_index,
+            block_height: null,
+            value: koiosInputOutput.value,
+            datum_hash: koiosInputOutput.datum_hash,
+            inline_datum: koiosInputOutput.inline_datum,
+            reference_script: koiosInputOutput.reference_script,
+            asset_list: koiosInputOutput.asset_list
+          },
+          koiosInputOutput.payment_addr.bech32
+        )
+      );
+    } else {
+      return [];
+    }
+  }
+  async getDelegation(rewardAddress) {
+    const body = {
+      _stake_addresses: [rewardAddress]
+    };
+    const result = await fetch(`${this.baseUrl}/account_info`, {
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      body: JSON.stringify(body)
+    }).then((res) => res.json());
+    if (Array.isArray(result) && result.length > 0) {
+      return {
+        poolId: result[0].delegated_pool || null,
+        rewards: BigInt(result[0].rewards_available)
+      };
+    } else {
+      throw new Error("No Delegation Found by Reward Address");
+    }
+  }
+  async getDatum(datumHash) {
+    const body = {
+      _datum_hashes: [datumHash]
+    };
+    const datum = await fetch(`${this.baseUrl}/datum_info`, {
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      body: JSON.stringify(body)
+    }).then((res) => res.json());
+    if (Array.isArray(datum) && datum.length > 0) {
+      return datum[0].bytes;
+    } else {
+      throw new Error("No Datum Found by Datum Hash");
+    }
+  }
+  awaitTx(txHash, checkInterval = 3e3) {
+    return new Promise((res) => {
+      const confirmation = setInterval(async () => {
+        const body = {
+          _tx_hashes: [txHash]
+        };
+        const result = await fetch(`${this.baseUrl}/tx_info`, {
+          headers: {
+            Accept: "application/json",
+            "Content-Type": "application/json"
+          },
+          method: "POST",
+          body: JSON.stringify(body)
+        }).then((res2) => res2.json());
+        if (Array.isArray(result) && result.length > 0) {
+          clearInterval(confirmation);
+          await new Promise((res2) => setTimeout(() => res2(1), 1e3));
+          return res(true);
+        }
+      }, checkInterval);
+    });
+  }
+  async submitTx(tx) {
+    const result = await fetch(`${this.baseUrl}/submittx`, {
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/cbor"
+      },
+      method: "POST",
+      body: (0, import_core_utils3.fromHex)(tx)
+    }).then((res) => res.json());
+    if (!result || result.error) {
+      if (result?.status_code === 400)
+        throw new Error(result.message);
+      else
+        throw new Error("Could not submit transaction.");
+    }
+    return result;
+  }
+};
+var toUTxO = (koiosUTxO, address) => ({
+  txHash: koiosUTxO.tx_hash,
+  outputIndex: koiosUTxO.tx_index,
+  assets: (() => {
+    const a = {};
+    koiosUTxO.asset_list.forEach((am) => {
+      a[am.policy_id + am.asset_name] = BigInt(am.quantity);
+    });
+    a["lovelace"] = BigInt(koiosUTxO.value);
+    return a;
+  })(),
+  address,
+  datumHash: koiosUTxO.inline_datum ? void 0 : koiosUTxO.datum_hash,
+  datum: koiosUTxO.inline_datum ? koiosUTxO.inline_datum.bytes : void 0,
+  scriptRef: koiosUTxO.reference_script ? koiosUTxO.reference_script.type == "plutusV1" ? {
+    type: "PlutusV1",
+    script: (0, import_utils4.applyDoubleCborEncoding)(koiosUTxO.reference_script.bytes)
+  } : {
+    type: "PlutusV2",
+    script: (0, import_utils4.applyDoubleCborEncoding)(koiosUTxO.reference_script.bytes)
+  } : void 0
+});
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   Blockfrost,
+  Koios,
   Kupmios,
   Maestro,
   datumJsonToCbor

package/dist/index.d.cts

@@ -80,4 +80,21 @@ declare class Maestro implements Provider {
     private getAllPagesData;
 }
 
-export { Blockfrost, Kupmios, Maestro, type MaestroConfig, type MaestroSupportedNetworks, datumJsonToCbor };
+/**
+ * @description This class supports Koios API v1.1.2.
+ */
+declare class Koios implements Provider {
+    private readonly baseUrl;
+    constructor(baseUrl: string);
+    getProtocolParameters(): Promise<ProtocolParameters>;
+    getUtxos(addressOrCredential: Address | Credential): Promise<UTxO[]>;
+    getUtxosWithUnit(addressOrCredential: Address | Credential, unit: Unit): Promise<UTxO[]>;
+    getUtxoByUnit(unit: Unit): Promise<UTxO>;
+    getUtxosByOutRef(outRefs: OutRef[]): Promise<UTxO[]>;
+    getDelegation(rewardAddress: RewardAddress): Promise<Delegation>;
+    getDatum(datumHash: DatumHash): Promise<Datum>;
+    awaitTx(txHash: TxHash, checkInterval?: number): Promise<boolean>;
+    submitTx(tx: Transaction): Promise<TxHash>;
+}
+
+export { Blockfrost, Koios, Kupmios, Maestro, type MaestroConfig, type MaestroSupportedNetworks, datumJsonToCbor };

package/dist/index.d.ts

@@ -80,4 +80,21 @@ declare class Maestro implements Provider {
     private getAllPagesData;
 }
 
-export { Blockfrost, Kupmios, Maestro, type MaestroConfig, type MaestroSupportedNetworks, datumJsonToCbor };
+/**
+ * @description This class supports Koios API v1.1.2.
+ */
+declare class Koios implements Provider {
+    private readonly baseUrl;
+    constructor(baseUrl: string);
+    getProtocolParameters(): Promise<ProtocolParameters>;
+    getUtxos(addressOrCredential: Address | Credential): Promise<UTxO[]>;
+    getUtxosWithUnit(addressOrCredential: Address | Credential, unit: Unit): Promise<UTxO[]>;
+    getUtxoByUnit(unit: Unit): Promise<UTxO>;
+    getUtxosByOutRef(outRefs: OutRef[]): Promise<UTxO[]>;
+    getDelegation(rewardAddress: RewardAddress): Promise<Delegation>;
+    getDatum(datumHash: DatumHash): Promise<Datum>;
+    awaitTx(txHash: TxHash, checkInterval?: number): Promise<boolean>;
+    submitTx(tx: Transaction): Promise<TxHash>;
+}
+
+export { Blockfrost, Koios, Kupmios, Maestro, type MaestroConfig, type MaestroSupportedNetworks, datumJsonToCbor };

package/dist/index.js

@@ -8,7 +8,7 @@ import { applyDoubleCborEncoding } from "@lucid-evolution/utils";
 // package.json
 var package_default = {
   name: "@lucid-evolution/provider",
-  version: "0.1.19",
+  version: "0.1.21",
   description: "",
   main: "./dist/index.js",
   types: "./dist/index.d.ts",
@@ -28,7 +28,8 @@ var package_default = {
   },
   scripts: {
     build: "tsup src/index.ts --format esm,cjs --dts --clean",
-    clean: "rm -rf .turbo && rm -rf node_modules && rm -rf dist"
+    clean: "rm -rf .turbo && rm -rf node_modules && rm -rf dist",
+    test: "vitest run"
   },
   keywords: [],
   author: "",
@@ -37,8 +38,9 @@ var package_default = {
     "@dcspark/cardano-multiplatform-lib-nodejs": "@dcspark/cardano-multiplatform-lib-browser"
   },
   dependencies: {
-    "@dcspark/cardano-multiplatform-lib-nodejs": "^5.3.0",
     "@dcspark/cardano-multiplatform-lib-browser": "^5.3.0",
+    "@dcspark/cardano-multiplatform-lib-nodejs": "^5.3.0",
+    "@effect/schema": "^0.67.16",
     "@lucid-evolution/core-types": "workspace:*",
     "@lucid-evolution/core-utils": "workspace:*",
     "@lucid-evolution/utils": "workspace:*"
@@ -46,7 +48,8 @@ var package_default = {
   devDependencies: {
     "@types/node": "^20.12.8",
     tsup: "^8.0.2",
-    typescript: "^5.4.5"
+    typescript: "^5.4.5",
+    vitest: "^1.6.0"
   }
 };
 
@@ -804,8 +807,443 @@ var Maestro = class {
   }
 };
 var lucid2 = package_default.version;
+
+// src/koios/koios.ts
+import * as S2 from "@effect/schema/Schema";
+import { fromHex as fromHex3 } from "@lucid-evolution/core-utils";
+import { applyDoubleCborEncoding as applyDoubleCborEncoding3, fromUnit as fromUnit2 } from "@lucid-evolution/utils";
+
+// src/koios/schema.ts
+import * as S from "@effect/schema/Schema";
+var ProtocolParametersSchema = S.Struct({
+  epoch_no: S.Number,
+  min_fee_a: S.Number,
+  min_fee_b: S.Number,
+  max_block_size: S.Number,
+  max_tx_size: S.Number,
+  max_bh_size: S.Number,
+  key_deposit: S.BigInt,
+  pool_deposit: S.BigInt,
+  max_epoch: S.Number,
+  optimal_pool_count: S.Number,
+  influence: S.Number,
+  monetary_expand_rate: S.Number,
+  treasury_growth_rate: S.Number,
+  decentralisation: S.Number,
+  extra_entropy: S.NullOr(S.String),
+  protocol_major: S.Number,
+  protocol_minor: S.Number,
+  min_utxo_value: S.String,
+  min_pool_cost: S.String,
+  nonce: S.String,
+  block_hash: S.NullOr(S.String),
+  cost_models: S.Struct({
+    PlutusV1: S.Array(S.Number),
+    PlutusV2: S.Array(S.Number)
+  }),
+  price_mem: S.Number,
+  price_step: S.Number,
+  max_tx_ex_mem: S.BigIntFromNumber,
+  max_tx_ex_steps: S.BigIntFromNumber,
+  max_block_ex_mem: S.Number,
+  max_block_ex_steps: S.Number,
+  max_val_size: S.Number,
+  collateral_percent: S.Number,
+  max_collateral_inputs: S.Number,
+  coins_per_utxo_size: S.BigInt
+});
+var KoiosAssetSchema = S.Struct({
+  policy_id: S.String,
+  asset_name: S.NullOr(S.String),
+  fingerprint: S.String,
+  decimals: S.Number,
+  quantity: S.String
+});
+var KoiosUTxOSchema = S.Struct({
+  tx_hash: S.String,
+  tx_index: S.Number,
+  block_height: S.NullOr(S.Number),
+  value: S.String,
+  datum_hash: S.NullOr(S.String),
+  inline_datum: S.NullOr(
+    S.Struct({
+      bytes: S.String,
+      value: S.Object
+    })
+  ),
+  reference_script: S.NullOr(
+    S.Struct({
+      hash: S.String,
+      size: S.Number,
+      type: S.String,
+      bytes: S.String,
+      value: S.NullOr(S.Object)
+    })
+  ),
+  asset_list: S.Array(KoiosAssetSchema)
+});
+var KoiosAddressInfoSchema = S.Array(
+  S.NullishOr(
+    S.Struct({
+      address: S.String,
+      balance: S.String,
+      stake_address: S.NullOr(S.String),
+      script_address: S.Boolean,
+      utxo_set: S.Array(KoiosUTxOSchema)
+    })
+  )
+);
+var KoiosInputOutputSchema = S.Struct({
+  payment_addr: S.Struct({
+    bech32: S.String,
+    cred: S.String
+  }),
+  stake_addr: S.NullOr(S.String),
+  tx_hash: S.String,
+  tx_index: S.Number,
+  value: S.String,
+  datum_hash: S.NullOr(S.String),
+  inline_datum: S.NullOr(
+    S.Struct({
+      bytes: S.String,
+      value: S.Object
+    })
+  ),
+  reference_script: S.NullOr(
+    S.Struct({
+      hash: S.String,
+      size: S.Number,
+      type: S.String,
+      bytes: S.String,
+      value: S.NullOr(S.Object)
+    })
+  ),
+  asset_list: S.Array(KoiosAssetSchema)
+});
+var KoiosTxInfoSchema = S.Struct({
+  tx_hash: S.String,
+  block_hash: S.String,
+  block_height: S.Number,
+  epoch_no: S.Number,
+  epoch_slot: S.Number,
+  absolute_slot: S.Number,
+  tx_timestamp: S.Number,
+  tx_block_index: S.Number,
+  tx_size: S.Number,
+  total_output: S.String,
+  fee: S.String,
+  deposit: S.String,
+  invalid_before: S.NullOr(S.String),
+  invalid_after: S.NullOr(S.String),
+  collateral_inputs: S.NullOr(S.Array(KoiosInputOutputSchema)),
+  collateral_output: S.NullOr(KoiosInputOutputSchema),
+  reference_inputs: S.NullOr(S.Array(KoiosInputOutputSchema)),
+  inputs: S.Array(KoiosInputOutputSchema),
+  outputs: S.Array(KoiosInputOutputSchema),
+  withdrawals: S.NullOr(
+    S.Array(
+      S.Struct({
+        amount: S.String,
+        stake_addr: S.String
+      })
+    )
+  ),
+  assets_minted: S.NullOr(S.Array(KoiosAssetSchema)),
+  metadata: S.NullOr(S.Object),
+  certificates: S.NullOr(
+    S.Array(
+      S.Struct({
+        index: S.Number,
+        type: S.String,
+        info: S.NullOr(S.Object)
+      })
+    )
+  ),
+  native_scripts: S.NullOr(
+    S.Array(
+      S.Struct({
+        script_hash: S.String,
+        script_json: S.Object
+      })
+    )
+  ),
+  plutus_contracts: S.NullOr(
+    S.Array(
+      S.Struct({
+        address: S.String,
+        spends_inputs: S.NullOr(
+          S.Struct({
+            tx_hash: S.String,
+            tx_index: S.Number
+          })
+        ),
+        script_hash: S.String,
+        bytecode: S.String,
+        size: S.Number,
+        valid_contract: S.Boolean,
+        input: S.Struct({
+          redeemer: S.Struct({
+            purpose: S.Literal("spend", "mint", "cert", "reward")
+          })
+        }),
+        fee: S.String,
+        unit: S.Struct({
+          steps: S.String,
+          mem: S.String
+        }),
+        datum: S.Struct({
+          hash: S.NullOr(S.String),
+          value: S.NullOr(S.Object)
+        })
+      })
+    )
+  )
+});
+
+// src/koios/koios.ts
+var Koios = class {
+  baseUrl;
+  constructor(baseUrl) {
+    this.baseUrl = baseUrl;
+  }
+  async getProtocolParameters() {
+    const result = await fetch(`${this.baseUrl}/epoch_params?limit=1`).then(
+      (res) => res.json()
+    );
+    const param = S2.decodeUnknownSync(ProtocolParametersSchema)(result[0]);
+    return {
+      minFeeA: param.min_fee_a,
+      minFeeB: param.min_fee_b,
+      maxTxSize: param.max_tx_size,
+      maxValSize: param.max_val_size,
+      keyDeposit: param.key_deposit,
+      poolDeposit: param.pool_deposit,
+      priceMem: param.price_mem,
+      priceStep: param.price_step,
+      maxTxExMem: param.max_tx_ex_mem,
+      maxTxExSteps: param.max_tx_ex_steps,
+      coinsPerUtxoByte: param.coins_per_utxo_size,
+      collateralPercentage: param.collateral_percent,
+      maxCollateralInputs: param.max_collateral_inputs,
+      costModels: {
+        PlutusV1: Object.fromEntries(
+          param.cost_models.PlutusV1.map((value, index) => [
+            index.toString(),
+            value
+          ])
+        ),
+        PlutusV2: Object.fromEntries(
+          param.cost_models.PlutusV2.map((value, index) => [
+            index.toString(),
+            value
+          ])
+        )
+      }
+    };
+  }
+  async getUtxos(addressOrCredential) {
+    if (typeof addressOrCredential === "string") {
+      const body = {
+        _addresses: [addressOrCredential]
+      };
+      const result = await fetch(`${this.baseUrl}/address_info`, {
+        headers: {
+          Accept: "application/json",
+          "Content-Type": "application/json"
+        },
+        method: "POST",
+        body: JSON.stringify(body)
+      }).then((res) => res.json());
+      const parsedResult = S2.decodeUnknownSync(KoiosAddressInfoSchema)(
+        result
+      )[0];
+      return parsedResult ? parsedResult.utxo_set.map(
+        (koiosUTXO) => toUTxO(koiosUTXO, parsedResult.address)
+      ) : [];
+    } else {
+      throw Error("getUtxos by Credential Type is not supported in Koios yet.");
+    }
+  }
+  async getUtxosWithUnit(addressOrCredential, unit) {
+    if (typeof addressOrCredential === "string") {
+      const utxos = await this.getUtxos(addressOrCredential);
+      if (utxos && utxos.length > 0) {
+        return utxos.filter((utxo) => {
+          const keys = Object.keys(utxo.assets);
+          return keys.length > 0 && keys.includes(unit);
+        });
+      } else {
+        return [];
+      }
+    } else {
+      throw Error(
+        "getUtxosWithUnit by Credential Type is not supported in Koios yet."
+      );
+    }
+  }
+  async getUtxoByUnit(unit) {
+    let { policyId, assetName } = fromUnit2(unit);
+    assetName = String(assetName);
+    const assetAddresses = await fetch(
+      `${this.baseUrl}/asset_addresses?_asset_policy=${policyId}&_asset_name=${assetName}`
+    ).then((res) => res.json());
+    if (Array.isArray(assetAddresses) && assetAddresses.length > 0) {
+      if (assetAddresses.length > 1) {
+        throw new Error("Unit needs to be an NFT or only held by one address.");
+      }
+      const utxos = await this.getUtxos(
+        assetAddresses[0].payment_address
+      );
+      const result = utxos.find((utxo) => {
+        const keys = Object.keys(utxo.assets);
+        return keys.length > 0 && keys.includes(unit);
+      });
+      if (result) {
+        return result;
+      }
+    }
+    throw new Error("Unit not found.");
+  }
+  async getUtxosByOutRef(outRefs) {
+    const utxos = [];
+    const body = {
+      _tx_hashes: [...new Set(outRefs.map((outRef) => outRef.txHash))]
+    };
+    const result = await fetch(`${this.baseUrl}/tx_info`, {
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      body: JSON.stringify(body)
+    }).then((res) => res.json());
+    const parsedResult = S2.decodeUnknownSync(S2.Array(KoiosTxInfoSchema))(
+      result
+    )[0];
+    if (parsedResult) {
+      return parsedResult.outputs.map(
+        (koiosInputOutput) => toUTxO(
+          {
+            tx_hash: koiosInputOutput.tx_hash,
+            tx_index: koiosInputOutput.tx_index,
+            block_height: null,
+            value: koiosInputOutput.value,
+            datum_hash: koiosInputOutput.datum_hash,
+            inline_datum: koiosInputOutput.inline_datum,
+            reference_script: koiosInputOutput.reference_script,
+            asset_list: koiosInputOutput.asset_list
+          },
+          koiosInputOutput.payment_addr.bech32
+        )
+      );
+    } else {
+      return [];
+    }
+  }
+  async getDelegation(rewardAddress) {
+    const body = {
+      _stake_addresses: [rewardAddress]
+    };
+    const result = await fetch(`${this.baseUrl}/account_info`, {
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      body: JSON.stringify(body)
+    }).then((res) => res.json());
+    if (Array.isArray(result) && result.length > 0) {
+      return {
+        poolId: result[0].delegated_pool || null,
+        rewards: BigInt(result[0].rewards_available)
+      };
+    } else {
+      throw new Error("No Delegation Found by Reward Address");
+    }
+  }
+  async getDatum(datumHash) {
+    const body = {
+      _datum_hashes: [datumHash]
+    };
+    const datum = await fetch(`${this.baseUrl}/datum_info`, {
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/json"
+      },
+      method: "POST",
+      body: JSON.stringify(body)
+    }).then((res) => res.json());
+    if (Array.isArray(datum) && datum.length > 0) {
+      return datum[0].bytes;
+    } else {
+      throw new Error("No Datum Found by Datum Hash");
+    }
+  }
+  awaitTx(txHash, checkInterval = 3e3) {
+    return new Promise((res) => {
+      const confirmation = setInterval(async () => {
+        const body = {
+          _tx_hashes: [txHash]
+        };
+        const result = await fetch(`${this.baseUrl}/tx_info`, {
+          headers: {
+            Accept: "application/json",
+            "Content-Type": "application/json"
+          },
+          method: "POST",
+          body: JSON.stringify(body)
+        }).then((res2) => res2.json());
+        if (Array.isArray(result) && result.length > 0) {
+          clearInterval(confirmation);
+          await new Promise((res2) => setTimeout(() => res2(1), 1e3));
+          return res(true);
+        }
+      }, checkInterval);
+    });
+  }
+  async submitTx(tx) {
+    const result = await fetch(`${this.baseUrl}/submittx`, {
+      headers: {
+        Accept: "application/json",
+        "Content-Type": "application/cbor"
+      },
+      method: "POST",
+      body: fromHex3(tx)
+    }).then((res) => res.json());
+    if (!result || result.error) {
+      if (result?.status_code === 400)
+        throw new Error(result.message);
+      else
+        throw new Error("Could not submit transaction.");
+    }
+    return result;
+  }
+};
+var toUTxO = (koiosUTxO, address) => ({
+  txHash: koiosUTxO.tx_hash,
+  outputIndex: koiosUTxO.tx_index,
+  assets: (() => {
+    const a = {};
+    koiosUTxO.asset_list.forEach((am) => {
+      a[am.policy_id + am.asset_name] = BigInt(am.quantity);
+    });
+    a["lovelace"] = BigInt(koiosUTxO.value);
+    return a;
+  })(),
+  address,
+  datumHash: koiosUTxO.inline_datum ? void 0 : koiosUTxO.datum_hash,
+  datum: koiosUTxO.inline_datum ? koiosUTxO.inline_datum.bytes : void 0,
+  scriptRef: koiosUTxO.reference_script ? koiosUTxO.reference_script.type == "plutusV1" ? {
+    type: "PlutusV1",
+    script: applyDoubleCborEncoding3(koiosUTxO.reference_script.bytes)
+  } : {
+    type: "PlutusV2",
+    script: applyDoubleCborEncoding3(koiosUTxO.reference_script.bytes)
+  } : void 0
+});
 export {
   Blockfrost,
+  Koios,
   Kupmios,
   Maestro,
   datumJsonToCbor

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucid-evolution/provider",
-  "version": "0.1.19",
+  "version": "0.1.21",
   "description": "",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -25,19 +25,22 @@
     "@dcspark/cardano-multiplatform-lib-nodejs": "@dcspark/cardano-multiplatform-lib-browser"
   },
   "dependencies": {
-    "@dcspark/cardano-multiplatform-lib-nodejs": "^5.3.0",
     "@dcspark/cardano-multiplatform-lib-browser": "^5.3.0",
-    "@lucid-evolution/core-types": "0.1.6",
+    "@dcspark/cardano-multiplatform-lib-nodejs": "^5.3.0",
+    "@effect/schema": "^0.67.16",
     "@lucid-evolution/core-utils": "0.1.6",
+    "@lucid-evolution/core-types": "0.1.6",
     "@lucid-evolution/utils": "0.1.15"
   },
   "devDependencies": {
     "@types/node": "^20.12.8",
     "tsup": "^8.0.2",
-    "typescript": "^5.4.5"
+    "typescript": "^5.4.5",
+    "vitest": "^1.6.0"
   },
   "scripts": {
     "build": "tsup src/index.ts --format esm,cjs --dts --clean",
-    "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist"
+    "clean": "rm -rf .turbo && rm -rf node_modules && rm -rf dist",
+    "test": "vitest run"
   }
 }