@lucid-evolution/provider 0.1.93 → 0.1.95

package/dist/index.cjs

@@ -52,7 +52,7 @@ var import_utils2 = require("@lucid-evolution/utils");
 // package.json
 var package_default = {
   name: "@lucid-evolution/provider",
-  version: "0.1.93",
+  version: "0.1.95",
   description: "",
   main: "./dist/index.js",
   types: "./dist/index.d.ts",
@@ -82,8 +82,8 @@ var package_default = {
     "@anastasia-labs/cardano-multiplatform-lib-nodejs": "@anastasia-labs/cardano-multiplatform-lib-browser"
   },
   dependencies: {
-    "@anastasia-labs/cardano-multiplatform-lib-browser": "6.0.2-3",
-    "@anastasia-labs/cardano-multiplatform-lib-nodejs": "6.0.2-3",
+    "@anastasia-labs/cardano-multiplatform-lib-browser": "6.2.0-1",
+    "@anastasia-labs/cardano-multiplatform-lib-nodejs": "6.2.0-1",
     "@effect/platform": "^0.71.3",
     "@effect/schema": "^0.68.26",
     "@lucid-evolution/core-types": "workspace:*",
@@ -153,6 +153,15 @@ var fromLegacyRedeemerTag = (redeemerTag) => {
 };
 
 // src/blockfrost.ts
+var toBlockfrostQueryPredicate = (addressOrCredential) => {
+  if (typeof addressOrCredential === "string") return addressOrCredential;
+  if (addressOrCredential.type === "Key") {
+    return CML.Ed25519KeyHash.from_hex(addressOrCredential.hash).to_bech32(
+      "addr_vkh"
+    );
+  }
+  return CML.ScriptHash.from_hex(addressOrCredential.hash).to_bech32("script");
+};
 var Blockfrost = class {
   url;
   projectId;
@@ -186,16 +195,17 @@ var Blockfrost = class {
       costModels: result.cost_models_raw
     };
   }
+  async getTreasury() {
+    const result = await fetch(`${this.url}/network`, {
+      headers: { project_id: this.projectId, lucid }
+    }).then((res) => res.json());
+    if (!result || result.error || result.supply?.treasury === void 0) {
+      throw new Error("Could not fetch treasury amount from Blockfrost.");
+    }
+    return BigInt(result.supply.treasury);
+  }
   async getUtxos(addressOrCredential) {
-    const queryPredicate = (() => {
-      if (typeof addressOrCredential === "string") return addressOrCredential;
-      const credentialBech32 = addressOrCredential.type === "Key" ? CML.Ed25519KeyHash.from_hex(addressOrCredential.hash).to_bech32(
-        "addr_vkh"
-      ) : CML.ScriptHash.from_hex(addressOrCredential.hash).to_bech32(
-        "addr_vkh"
-      );
-      return credentialBech32;
-    })();
+    const queryPredicate = toBlockfrostQueryPredicate(addressOrCredential);
     let result = [];
     let page = 1;
     while (true) {
@@ -217,15 +227,7 @@ var Blockfrost = class {
     return this.blockfrostUtxosToUtxos(result);
   }
   async getUtxosWithUnit(addressOrCredential, unit) {
-    const queryPredicate = (() => {
-      if (typeof addressOrCredential === "string") return addressOrCredential;
-      const credentialBech32 = addressOrCredential.type === "Key" ? CML.Ed25519KeyHash.from_hex(addressOrCredential.hash).to_bech32(
-        "addr_vkh"
-      ) : CML.ScriptHash.from_hex(addressOrCredential.hash).to_bech32(
-        "addr_vkh"
-      );
-      return credentialBech32;
-    })();
+    const queryPredicate = toBlockfrostQueryPredicate(addressOrCredential);
     let result = [];
     let page = 1;
     while (true) {
@@ -490,6 +492,29 @@ var getJSONRPCResult = (response) => {
 var LovelaceAsset = import_effect2.Schema.Struct({
   lovelace: import_effect2.Schema.Number
 });
+var LovelaceAmount = import_effect2.Schema.Union(import_effect2.Schema.Number, import_effect2.Schema.String, import_effect2.Schema.BigInt);
+var TreasuryAndReservesSchema = import_effect2.Schema.Struct({
+  treasury: import_effect2.Schema.Struct({
+    ada: import_effect2.Schema.Struct({
+      lovelace: LovelaceAmount
+    })
+  }),
+  reserves: import_effect2.Schema.Struct({
+    ada: import_effect2.Schema.Struct({
+      lovelace: LovelaceAmount
+    })
+  })
+});
+var lovelaceAmountToBigInt = (lovelace) => {
+  if (typeof lovelace === "bigint") return lovelace;
+  if (typeof lovelace === "string") return BigInt(lovelace);
+  if (!Number.isSafeInteger(lovelace)) {
+    throw new Error(
+      `Cannot decode Ogmios lovelace amount ${lovelace}; number is outside the safe integer range.`
+    );
+  }
+  return BigInt(lovelace);
+};
 var TupleNumberFromString = import_effect2.Schema.compose(
   import_effect2.Schema.split("/"),
   import_effect2.Schema.Array(import_effect2.Schema.NumberFromString)
@@ -834,6 +859,31 @@ var Kupmios = class {
     const result = getJSONRPCResult(response);
     return toProtocolParameters(result);
   }
+  async getTreasury() {
+    const data = {
+      jsonrpc: "2.0",
+      method: "queryLedgerState/treasuryAndReserves",
+      params: {},
+      id: null
+    };
+    const schema = JSONRPCResponseSchema(
+      TreasuryAndReservesSchema
+    );
+    const response = await (0, import_effect6.pipe)(
+      makePostAsJson(
+        this.ogmiosUrl,
+        data,
+        schema,
+        this.headers?.ogmiosHeader
+      ),
+      import_effect6.Effect.timeout(1e4),
+      import_effect6.Effect.catchAll((cause) => new KupmiosError({ cause })),
+      import_effect6.Effect.provide(import_platform2.FetchHttpClient.layer),
+      import_effect6.Effect.runPromise
+    );
+    const result = getJSONRPCResult(response);
+    return lovelaceAmountToBigInt(result.treasury.ada.lovelace);
+  }
   async getUtxos(addressOrCredential) {
     const isAddress = typeof addressOrCredential === "string";
     const queryPredicate = isAddress ? addressOrCredential : addressOrCredential.hash;
@@ -1211,7 +1261,8 @@ var Emulator = class {
   time;
   protocolParameters;
   datumTable = {};
-  constructor(accounts, protocolParameters = import_utils5.PROTOCOL_PARAMETERS_DEFAULT) {
+  treasury;
+  constructor(accounts, protocolParameters = import_utils5.PROTOCOL_PARAMETERS_DEFAULT, treasury = 0n) {
     const GENESIS_HASH = "00".repeat(32);
     this.blockHeight = 0;
     this.slot = 0;
@@ -1241,6 +1292,7 @@ var Emulator = class {
       };
     });
     this.protocolParameters = protocolParameters;
+    this.treasury = treasury;
   }
   now() {
     return this.time;
@@ -1286,6 +1338,9 @@ var Emulator = class {
   getProtocolParameters() {
     return Promise.resolve(this.protocolParameters);
   }
+  getTreasury() {
+    return Promise.resolve(this.treasury);
+  }
   getDatum(datumHash) {
     return Promise.resolve(this.datumTable[datumHash]);
   }
@@ -1368,6 +1423,23 @@ var Emulator = class {
         `Upper bound (${upperBound}) not in slot range (${this.slot}).`
       );
     }
+    const currentTreasuryValue = body.current_treasury_value();
+    const treasuryDonation = body.donation();
+    if (currentTreasuryValue === void 0 && treasuryDonation !== void 0 || currentTreasuryValue !== void 0 && treasuryDonation === void 0) {
+      throw new Error(
+        "Treasury donation transactions must include both current treasury value and donation."
+      );
+    }
+    if (treasuryDonation !== void 0) {
+      if (treasuryDonation <= 0n) {
+        throw new Error("Treasury donation must be greater than 0 lovelace.");
+      }
+      if (currentTreasuryValue !== this.treasury) {
+        throw new Error(
+          `Current treasury value (${currentTreasuryValue}) does not match emulator treasury (${this.treasury}).`
+        );
+      }
+    }
     const datumTable = (() => {
       const table = {};
       for (let i = 0; i < (datums?.len() || 0); i++) {
@@ -1660,6 +1732,12 @@ It does not exist or was already spent.`
       withdrawalRequests.push({ rewardAddress, withdrawal });
     }
     const certRequests = [];
+    const credentialToCore = (credential) => credential.kind() === 0 ? { type: "Key", hash: credential.as_pub_key().to_hex() } : { type: "Script", hash: credential.as_script().to_hex() };
+    const checkCertCredential = (credential, index) => {
+      if (!credential) return;
+      checkAndConsumeHash(credentialToCore(credential), "Cert", index);
+    };
+    const rewardAddressFromCredential = (credential) => CML.RewardAddress.new(CML.NetworkInfo.testnet().network_id(), credential).to_address().to_bech32(void 0);
     for (let index = 0; index < (body.certs()?.len() || 0); index++) {
       const cert = body.certs().get(index);
       switch (cert.kind()) {
@@ -1677,6 +1755,22 @@ It does not exist or was already spent.`
           certRequests.push({ type: "Registration", rewardAddress });
           break;
         }
+        case CML.CertificateKind.RegCert: {
+          const registration = cert.as_reg_cert();
+          const rewardAddress = CML.RewardAddress.new(
+            CML.NetworkInfo.testnet().network_id(),
+            registration.stake_credential()
+          ).to_address().to_bech32(void 0);
+          const { stakeCredential } = (0, import_utils6.getAddressDetails)(rewardAddress);
+          checkAndConsumeHash(stakeCredential, "Cert", index);
+          if (this.chain[rewardAddress]?.registeredStake) {
+            throw new Error(
+              `Stake key is already registered. Reward address: ${rewardAddress}`
+            );
+          }
+          certRequests.push({ type: "Registration", rewardAddress });
+          break;
+        }
         case 1: {
           const deregistration = cert.as_stake_deregistration();
           const rewardAddress = CML.RewardAddress.new(
@@ -1712,6 +1806,166 @@ It does not exist or was already spent.`
           certRequests.push({ type: "Delegation", rewardAddress, poolId });
           break;
         }
+        case CML.CertificateKind.PoolRegistration: {
+          const poolParams = cert.as_pool_registration()?.pool_params();
+          if (!poolParams) break;
+          checkAndConsumeHash(
+            { type: "Key", hash: poolParams.operator().to_hex() },
+            "Cert",
+            index
+          );
+          const owners = poolParams.pool_owners();
+          for (let ownerIndex = 0; ownerIndex < owners.len(); ownerIndex++) {
+            checkAndConsumeHash(
+              { type: "Key", hash: owners.get(ownerIndex).to_hex() },
+              "Cert",
+              index
+            );
+          }
+          break;
+        }
+        case CML.CertificateKind.PoolRetirement: {
+          const pool = cert.as_pool_retirement()?.pool();
+          if (pool) {
+            checkAndConsumeHash(
+              { type: "Key", hash: pool.to_hex() },
+              "Cert",
+              index
+            );
+          }
+          break;
+        }
+        case CML.CertificateKind.UnregCert: {
+          const deregistration = cert.as_unreg_cert()?.stake_credential();
+          checkCertCredential(deregistration, index);
+          if (deregistration) {
+            const rewardAddress = rewardAddressFromCredential(deregistration);
+            if (!this.chain[rewardAddress]?.registeredStake) {
+              throw new Error(
+                `Stake key is already deregistered. Reward address: ${rewardAddress}`
+              );
+            }
+            certRequests.push({ type: "Deregistration", rewardAddress });
+          }
+          break;
+        }
+        case CML.CertificateKind.VoteDelegCert: {
+          const credential = cert.as_vote_deleg_cert()?.stake_credential();
+          checkCertCredential(credential, index);
+          if (credential) {
+            const rewardAddress = rewardAddressFromCredential(credential);
+            if (!this.chain[rewardAddress]?.registeredStake && !certRequests.find(
+              (request) => request.type === "Registration" && request.rewardAddress === rewardAddress
+            )) {
+              throw new Error(
+                `Stake key is not registered. Reward address: ${rewardAddress}`
+              );
+            }
+          }
+          break;
+        }
+        case CML.CertificateKind.StakeVoteDelegCert: {
+          const delegation = cert.as_stake_vote_deleg_cert();
+          const credential = delegation?.stake_credential();
+          checkCertCredential(credential, index);
+          if (delegation && credential) {
+            const rewardAddress = rewardAddressFromCredential(credential);
+            const poolId = delegation.pool().to_bech32("pool");
+            if (!this.chain[rewardAddress]?.registeredStake && !certRequests.find(
+              (request) => request.type === "Registration" && request.rewardAddress === rewardAddress
+            )) {
+              throw new Error(
+                `Stake key is not registered. Reward address: ${rewardAddress}`
+              );
+            }
+            certRequests.push({ type: "Delegation", rewardAddress, poolId });
+          }
+          break;
+        }
+        case CML.CertificateKind.StakeRegDelegCert: {
+          const registration = cert.as_stake_reg_deleg_cert();
+          const credential = registration?.stake_credential();
+          checkCertCredential(credential, index);
+          if (registration && credential) {
+            const rewardAddress = rewardAddressFromCredential(credential);
+            const poolId = registration.pool().to_bech32("pool");
+            if (this.chain[rewardAddress]?.registeredStake) {
+              throw new Error(
+                `Stake key is already registered. Reward address: ${rewardAddress}`
+              );
+            }
+            certRequests.push({ type: "Registration", rewardAddress });
+            certRequests.push({ type: "Delegation", rewardAddress, poolId });
+          }
+          break;
+        }
+        case CML.CertificateKind.VoteRegDelegCert: {
+          const registration = cert.as_vote_reg_deleg_cert();
+          const credential = registration?.stake_credential();
+          checkCertCredential(credential, index);
+          if (credential) {
+            const rewardAddress = rewardAddressFromCredential(credential);
+            if (this.chain[rewardAddress]?.registeredStake) {
+              throw new Error(
+                `Stake key is already registered. Reward address: ${rewardAddress}`
+              );
+            }
+            certRequests.push({ type: "Registration", rewardAddress });
+          }
+          break;
+        }
+        case CML.CertificateKind.StakeVoteRegDelegCert: {
+          const registration = cert.as_stake_vote_reg_deleg_cert();
+          const credential = registration?.stake_credential();
+          checkCertCredential(credential, index);
+          if (registration && credential) {
+            const rewardAddress = rewardAddressFromCredential(credential);
+            const poolId = registration.pool().to_bech32("pool");
+            if (this.chain[rewardAddress]?.registeredStake) {
+              throw new Error(
+                `Stake key is already registered. Reward address: ${rewardAddress}`
+              );
+            }
+            certRequests.push({ type: "Registration", rewardAddress });
+            certRequests.push({ type: "Delegation", rewardAddress, poolId });
+          }
+          break;
+        }
+        case CML.CertificateKind.AuthCommitteeHotCert: {
+          checkCertCredential(
+            cert.as_auth_committee_hot_cert()?.committee_cold_credential(),
+            index
+          );
+          break;
+        }
+        case CML.CertificateKind.ResignCommitteeColdCert: {
+          checkCertCredential(
+            cert.as_resign_committee_cold_cert()?.committee_cold_credential(),
+            index
+          );
+          break;
+        }
+        case CML.CertificateKind.RegDrepCert: {
+          checkCertCredential(
+            cert.as_reg_drep_cert()?.drep_credential(),
+            index
+          );
+          break;
+        }
+        case CML.CertificateKind.UnregDrepCert: {
+          checkCertCredential(
+            cert.as_unreg_drep_cert()?.drep_credential(),
+            index
+          );
+          break;
+        }
+        case CML.CertificateKind.UpdateDrepCert: {
+          checkCertCredential(
+            cert.as_update_drep_cert()?.drep_credential(),
+            index
+          );
+          break;
+        }
       }
     }
     resolvedInputs.forEach(({ entry: { utxo } }, index) => {
@@ -1775,6 +2029,9 @@ It does not exist or was already spent.`
     withdrawalRequests.forEach(({ rewardAddress, withdrawal }) => {
       this.chain[rewardAddress].delegation.rewards -= withdrawal;
     });
+    if (treasuryDonation !== void 0) {
+      this.treasury += treasuryDonation;
+    }
     certRequests.forEach(({ type, rewardAddress, poolId }) => {
       switch (type) {
         case "Registration": {
@@ -1968,6 +2225,11 @@ var Maestro = class {
       }
     };
   }
+  async getTreasury() {
+    throw new Error(
+      "Maestro does not expose a current treasury query. Pass currentTreasuryValue explicitly to donateToTreasury."
+    );
+  }
   async getUtxosInternal(addressOrCredential, unit) {
     const queryPredicate = (() => {
       if (typeof addressOrCredential === "string") {
@@ -2294,6 +2556,9 @@ var ProtocolParametersSchema2 = import_effect7.Schema.Struct({
   max_collateral_inputs: import_effect7.Schema.Number,
   coins_per_utxo_size: import_effect7.Schema.BigInt
 });
+var TotalsSchema = import_effect7.Schema.Struct({
+  treasury: import_effect7.Schema.String
+});
 var AssetSchema = import_effect7.Schema.Struct({
   policy_id: import_effect7.Schema.String,
   asset_name: import_effect7.Schema.NullOr(import_effect7.Schema.String),
@@ -2568,6 +2833,22 @@ var Koios = class {
       }
     };
   }
+  async getTreasury() {
+    const url = `${this.baseUrl}/totals?order=epoch_no.desc&limit=1`;
+    const schema = import_effect8.Schema.Array(TotalsSchema);
+    const bearerToken = this.token ? { Authorization: `Bearer ${this.token}` } : void 0;
+    const [result] = await (0, import_effect8.pipe)(
+      makeGet(url, schema, bearerToken),
+      import_effect8.Effect.provide(import_platform4.FetchHttpClient.layer),
+      import_effect8.Effect.flatMap(
+        (result2) => result2.length === 0 ? import_effect8.Effect.fail("No totals found") : import_effect8.Effect.succeed(result2)
+      ),
+      import_effect8.Effect.timeout(1e4),
+      import_effect8.Effect.catchAllCause((cause) => new KoiosError({ cause })),
+      import_effect8.Effect.runPromise
+    );
+    return BigInt(result.treasury);
+  }
   async getUtxos(addressOrCredential) {
     const bearerToken = this.token ? { Authorization: `Bearer ${this.token}` } : void 0;
     const result = await (0, import_effect8.pipe)(

package/dist/index.d.cts

@@ -1,4 +1,4 @@
-import { Provider, ProtocolParameters, Address, Credential, UTxO, Unit, OutRef, RewardAddress, Delegation, DatumHash, Datum, TxHash, Transaction, EvalRedeemer, UnixTime, Assets, OutputData, Lovelace } from '@lucid-evolution/core-types';
+import { Provider, ProtocolParameters, Address, Credential, UTxO, Unit, OutRef, RewardAddress, Delegation, DatumHash, Datum, TxHash, Transaction, EvalRedeemer, UnixTime, Lovelace, Assets, OutputData } from '@lucid-evolution/core-types';
 import * as effect_Cause from 'effect/Cause';
 import * as effect_Types from 'effect/Types';
 
@@ -7,6 +7,7 @@ declare class Blockfrost implements Provider {
     projectId: string;
     constructor(url: string, projectId?: string);
     getProtocolParameters(): Promise<ProtocolParameters>;
+    getTreasury(): Promise<bigint>;
     getUtxos(addressOrCredential: Address | Credential): Promise<UTxO[]>;
     getUtxosWithUnit(addressOrCredential: Address | Credential, unit: Unit): Promise<UTxO[]>;
     getUtxoByUnit(unit: Unit): Promise<UTxO>;
@@ -66,6 +67,7 @@ declare class Kupmios implements Provider {
         kupoHeader?: Record<string, string>;
     });
     getProtocolParameters(): Promise<ProtocolParameters>;
+    getTreasury(): Promise<bigint>;
     getUtxos(addressOrCredential: Address | Credential): Promise<UTxO[]>;
     getUtxosWithUnit(addressOrCredential: Address | Credential, unit: Unit): Promise<UTxO[]>;
     getUtxoByUnit(unit: Unit): Promise<UTxO>;
@@ -110,12 +112,14 @@ declare class Emulator implements Provider {
     time: UnixTime;
     protocolParameters: ProtocolParameters;
     datumTable: Record<DatumHash, Datum>;
-    constructor(accounts: EmulatorAccount[], protocolParameters?: ProtocolParameters);
+    treasury: Lovelace;
+    constructor(accounts: EmulatorAccount[], protocolParameters?: ProtocolParameters, treasury?: Lovelace);
     now(): UnixTime;
     awaitSlot(length?: number): void;
     awaitBlock(height?: number): void;
     getUtxos(addressOrCredential: Address | Credential): Promise<UTxO[]>;
     getProtocolParameters(): Promise<ProtocolParameters>;
+    getTreasury(): Promise<bigint>;
     getDatum(datumHash: DatumHash): Promise<Datum>;
     getUtxosWithUnit(addressOrCredential: Address | Credential, unit: Unit): Promise<UTxO[]>;
     getUtxosByOutRef(outRefs: OutRef[]): Promise<UTxO[]>;
@@ -144,6 +148,7 @@ declare class Maestro implements Provider {
     turboSubmit: boolean;
     constructor({ network, apiKey, turboSubmit }: MaestroConfig);
     getProtocolParameters(): Promise<ProtocolParameters>;
+    getTreasury(): Promise<bigint>;
     private getUtxosInternal;
     getUtxos(addressOrCredential: Address | Credential): Promise<UTxO[]>;
     getUtxosWithUnit(addressOrCredential: Address | Credential, unit: Unit): Promise<UTxO[]>;
@@ -201,6 +206,7 @@ declare class Koios implements Provider {
     private readonly token?;
     constructor(baseUrl: string, token?: string);
     getProtocolParameters(): Promise<ProtocolParameters>;
+    getTreasury(): Promise<bigint>;
     getUtxos(addressOrCredential: Address | Credential): Promise<UTxO[]>;
     getUtxosWithUnit(addressOrCredential: Address | Credential, unit: Unit): Promise<UTxO[]>;
     getUtxoByUnit(unit: Unit): Promise<UTxO>;

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Provider, ProtocolParameters, Address, Credential, UTxO, Unit, OutRef, RewardAddress, Delegation, DatumHash, Datum, TxHash, Transaction, EvalRedeemer, UnixTime, Assets, OutputData, Lovelace } from '@lucid-evolution/core-types';
+import { Provider, ProtocolParameters, Address, Credential, UTxO, Unit, OutRef, RewardAddress, Delegation, DatumHash, Datum, TxHash, Transaction, EvalRedeemer, UnixTime, Lovelace, Assets, OutputData } from '@lucid-evolution/core-types';
 import * as effect_Cause from 'effect/Cause';
 import * as effect_Types from 'effect/Types';
 
@@ -7,6 +7,7 @@ declare class Blockfrost implements Provider {
     projectId: string;
     constructor(url: string, projectId?: string);
     getProtocolParameters(): Promise<ProtocolParameters>;
+    getTreasury(): Promise<bigint>;
     getUtxos(addressOrCredential: Address | Credential): Promise<UTxO[]>;
     getUtxosWithUnit(addressOrCredential: Address | Credential, unit: Unit): Promise<UTxO[]>;
     getUtxoByUnit(unit: Unit): Promise<UTxO>;
@@ -66,6 +67,7 @@ declare class Kupmios implements Provider {
         kupoHeader?: Record<string, string>;
     });
     getProtocolParameters(): Promise<ProtocolParameters>;
+    getTreasury(): Promise<bigint>;
     getUtxos(addressOrCredential: Address | Credential): Promise<UTxO[]>;
     getUtxosWithUnit(addressOrCredential: Address | Credential, unit: Unit): Promise<UTxO[]>;
     getUtxoByUnit(unit: Unit): Promise<UTxO>;
@@ -110,12 +112,14 @@ declare class Emulator implements Provider {
     time: UnixTime;
     protocolParameters: ProtocolParameters;
     datumTable: Record<DatumHash, Datum>;
-    constructor(accounts: EmulatorAccount[], protocolParameters?: ProtocolParameters);
+    treasury: Lovelace;
+    constructor(accounts: EmulatorAccount[], protocolParameters?: ProtocolParameters, treasury?: Lovelace);
     now(): UnixTime;
     awaitSlot(length?: number): void;
     awaitBlock(height?: number): void;
     getUtxos(addressOrCredential: Address | Credential): Promise<UTxO[]>;
     getProtocolParameters(): Promise<ProtocolParameters>;
+    getTreasury(): Promise<bigint>;
     getDatum(datumHash: DatumHash): Promise<Datum>;
     getUtxosWithUnit(addressOrCredential: Address | Credential, unit: Unit): Promise<UTxO[]>;
     getUtxosByOutRef(outRefs: OutRef[]): Promise<UTxO[]>;
@@ -144,6 +148,7 @@ declare class Maestro implements Provider {
     turboSubmit: boolean;
     constructor({ network, apiKey, turboSubmit }: MaestroConfig);
     getProtocolParameters(): Promise<ProtocolParameters>;
+    getTreasury(): Promise<bigint>;
     private getUtxosInternal;
     getUtxos(addressOrCredential: Address | Credential): Promise<UTxO[]>;
     getUtxosWithUnit(addressOrCredential: Address | Credential, unit: Unit): Promise<UTxO[]>;
@@ -201,6 +206,7 @@ declare class Koios implements Provider {
     private readonly token?;
     constructor(baseUrl: string, token?: string);
     getProtocolParameters(): Promise<ProtocolParameters>;
+    getTreasury(): Promise<bigint>;
     getUtxos(addressOrCredential: Address | Credential): Promise<UTxO[]>;
     getUtxosWithUnit(addressOrCredential: Address | Credential, unit: Unit): Promise<UTxO[]>;
     getUtxoByUnit(unit: Unit): Promise<UTxO>;

package/dist/index.js

@@ -11,7 +11,7 @@ import {
 // package.json
 var package_default = {
   name: "@lucid-evolution/provider",
-  version: "0.1.93",
+  version: "0.1.95",
   description: "",
   main: "./dist/index.js",
   types: "./dist/index.d.ts",
@@ -41,8 +41,8 @@ var package_default = {
     "@anastasia-labs/cardano-multiplatform-lib-nodejs": "@anastasia-labs/cardano-multiplatform-lib-browser"
   },
   dependencies: {
-    "@anastasia-labs/cardano-multiplatform-lib-browser": "6.0.2-3",
-    "@anastasia-labs/cardano-multiplatform-lib-nodejs": "6.0.2-3",
+    "@anastasia-labs/cardano-multiplatform-lib-browser": "6.2.0-1",
+    "@anastasia-labs/cardano-multiplatform-lib-nodejs": "6.2.0-1",
     "@effect/platform": "^0.71.3",
     "@effect/schema": "^0.68.26",
     "@lucid-evolution/core-types": "workspace:*",
@@ -112,6 +112,15 @@ var fromLegacyRedeemerTag = (redeemerTag) => {
 };
 
 // src/blockfrost.ts
+var toBlockfrostQueryPredicate = (addressOrCredential) => {
+  if (typeof addressOrCredential === "string") return addressOrCredential;
+  if (addressOrCredential.type === "Key") {
+    return CML.Ed25519KeyHash.from_hex(addressOrCredential.hash).to_bech32(
+      "addr_vkh"
+    );
+  }
+  return CML.ScriptHash.from_hex(addressOrCredential.hash).to_bech32("script");
+};
 var Blockfrost = class {
   url;
   projectId;
@@ -145,16 +154,17 @@ var Blockfrost = class {
       costModels: result.cost_models_raw
     };
   }
+  async getTreasury() {
+    const result = await fetch(`${this.url}/network`, {
+      headers: { project_id: this.projectId, lucid }
+    }).then((res) => res.json());
+    if (!result || result.error || result.supply?.treasury === void 0) {
+      throw new Error("Could not fetch treasury amount from Blockfrost.");
+    }
+    return BigInt(result.supply.treasury);
+  }
   async getUtxos(addressOrCredential) {
-    const queryPredicate = (() => {
-      if (typeof addressOrCredential === "string") return addressOrCredential;
-      const credentialBech32 = addressOrCredential.type === "Key" ? CML.Ed25519KeyHash.from_hex(addressOrCredential.hash).to_bech32(
-        "addr_vkh"
-      ) : CML.ScriptHash.from_hex(addressOrCredential.hash).to_bech32(
-        "addr_vkh"
-      );
-      return credentialBech32;
-    })();
+    const queryPredicate = toBlockfrostQueryPredicate(addressOrCredential);
     let result = [];
     let page = 1;
     while (true) {
@@ -176,15 +186,7 @@ var Blockfrost = class {
     return this.blockfrostUtxosToUtxos(result);
   }
   async getUtxosWithUnit(addressOrCredential, unit) {
-    const queryPredicate = (() => {
-      if (typeof addressOrCredential === "string") return addressOrCredential;
-      const credentialBech32 = addressOrCredential.type === "Key" ? CML.Ed25519KeyHash.from_hex(addressOrCredential.hash).to_bech32(
-        "addr_vkh"
-      ) : CML.ScriptHash.from_hex(addressOrCredential.hash).to_bech32(
-        "addr_vkh"
-      );
-      return credentialBech32;
-    })();
+    const queryPredicate = toBlockfrostQueryPredicate(addressOrCredential);
     let result = [];
     let page = 1;
     while (true) {
@@ -449,6 +451,29 @@ var getJSONRPCResult = (response) => {
 var LovelaceAsset = S.Struct({
   lovelace: S.Number
 });
+var LovelaceAmount = S.Union(S.Number, S.String, S.BigInt);
+var TreasuryAndReservesSchema = S.Struct({
+  treasury: S.Struct({
+    ada: S.Struct({
+      lovelace: LovelaceAmount
+    })
+  }),
+  reserves: S.Struct({
+    ada: S.Struct({
+      lovelace: LovelaceAmount
+    })
+  })
+});
+var lovelaceAmountToBigInt = (lovelace) => {
+  if (typeof lovelace === "bigint") return lovelace;
+  if (typeof lovelace === "string") return BigInt(lovelace);
+  if (!Number.isSafeInteger(lovelace)) {
+    throw new Error(
+      `Cannot decode Ogmios lovelace amount ${lovelace}; number is outside the safe integer range.`
+    );
+  }
+  return BigInt(lovelace);
+};
 var TupleNumberFromString = S.compose(
   S.split("/"),
   S.Array(S.NumberFromString)
@@ -798,6 +823,31 @@ var Kupmios = class {
     const result = getJSONRPCResult(response);
     return toProtocolParameters(result);
   }
+  async getTreasury() {
+    const data = {
+      jsonrpc: "2.0",
+      method: "queryLedgerState/treasuryAndReserves",
+      params: {},
+      id: null
+    };
+    const schema = JSONRPCResponseSchema(
+      TreasuryAndReservesSchema
+    );
+    const response = await pipe3(
+      makePostAsJson(
+        this.ogmiosUrl,
+        data,
+        schema,
+        this.headers?.ogmiosHeader
+      ),
+      Effect2.timeout(1e4),
+      Effect2.catchAll((cause) => new KupmiosError({ cause })),
+      Effect2.provide(FetchHttpClient.layer),
+      Effect2.runPromise
+    );
+    const result = getJSONRPCResult(response);
+    return lovelaceAmountToBigInt(result.treasury.ada.lovelace);
+  }
   async getUtxos(addressOrCredential) {
     const isAddress = typeof addressOrCredential === "string";
     const queryPredicate = isAddress ? addressOrCredential : addressOrCredential.hash;
@@ -1179,7 +1229,8 @@ var Emulator = class {
   time;
   protocolParameters;
   datumTable = {};
-  constructor(accounts, protocolParameters = PROTOCOL_PARAMETERS_DEFAULT) {
+  treasury;
+  constructor(accounts, protocolParameters = PROTOCOL_PARAMETERS_DEFAULT, treasury = 0n) {
     const GENESIS_HASH = "00".repeat(32);
     this.blockHeight = 0;
     this.slot = 0;
@@ -1209,6 +1260,7 @@ var Emulator = class {
       };
     });
     this.protocolParameters = protocolParameters;
+    this.treasury = treasury;
   }
   now() {
     return this.time;
@@ -1254,6 +1306,9 @@ var Emulator = class {
   getProtocolParameters() {
     return Promise.resolve(this.protocolParameters);
   }
+  getTreasury() {
+    return Promise.resolve(this.treasury);
+  }
   getDatum(datumHash) {
     return Promise.resolve(this.datumTable[datumHash]);
   }
@@ -1336,6 +1391,23 @@ var Emulator = class {
         `Upper bound (${upperBound}) not in slot range (${this.slot}).`
       );
     }
+    const currentTreasuryValue = body.current_treasury_value();
+    const treasuryDonation = body.donation();
+    if (currentTreasuryValue === void 0 && treasuryDonation !== void 0 || currentTreasuryValue !== void 0 && treasuryDonation === void 0) {
+      throw new Error(
+        "Treasury donation transactions must include both current treasury value and donation."
+      );
+    }
+    if (treasuryDonation !== void 0) {
+      if (treasuryDonation <= 0n) {
+        throw new Error("Treasury donation must be greater than 0 lovelace.");
+      }
+      if (currentTreasuryValue !== this.treasury) {
+        throw new Error(
+          `Current treasury value (${currentTreasuryValue}) does not match emulator treasury (${this.treasury}).`
+        );
+      }
+    }
     const datumTable = (() => {
       const table = {};
       for (let i = 0; i < (datums?.len() || 0); i++) {
@@ -1628,6 +1700,12 @@ It does not exist or was already spent.`
       withdrawalRequests.push({ rewardAddress, withdrawal });
     }
     const certRequests = [];
+    const credentialToCore = (credential) => credential.kind() === 0 ? { type: "Key", hash: credential.as_pub_key().to_hex() } : { type: "Script", hash: credential.as_script().to_hex() };
+    const checkCertCredential = (credential, index) => {
+      if (!credential) return;
+      checkAndConsumeHash(credentialToCore(credential), "Cert", index);
+    };
+    const rewardAddressFromCredential = (credential) => CML.RewardAddress.new(CML.NetworkInfo.testnet().network_id(), credential).to_address().to_bech32(void 0);
     for (let index = 0; index < (body.certs()?.len() || 0); index++) {
       const cert = body.certs().get(index);
       switch (cert.kind()) {
@@ -1645,6 +1723,22 @@ It does not exist or was already spent.`
           certRequests.push({ type: "Registration", rewardAddress });
           break;
         }
+        case CML.CertificateKind.RegCert: {
+          const registration = cert.as_reg_cert();
+          const rewardAddress = CML.RewardAddress.new(
+            CML.NetworkInfo.testnet().network_id(),
+            registration.stake_credential()
+          ).to_address().to_bech32(void 0);
+          const { stakeCredential } = getAddressDetails(rewardAddress);
+          checkAndConsumeHash(stakeCredential, "Cert", index);
+          if (this.chain[rewardAddress]?.registeredStake) {
+            throw new Error(
+              `Stake key is already registered. Reward address: ${rewardAddress}`
+            );
+          }
+          certRequests.push({ type: "Registration", rewardAddress });
+          break;
+        }
         case 1: {
           const deregistration = cert.as_stake_deregistration();
           const rewardAddress = CML.RewardAddress.new(
@@ -1680,6 +1774,166 @@ It does not exist or was already spent.`
           certRequests.push({ type: "Delegation", rewardAddress, poolId });
           break;
         }
+        case CML.CertificateKind.PoolRegistration: {
+          const poolParams = cert.as_pool_registration()?.pool_params();
+          if (!poolParams) break;
+          checkAndConsumeHash(
+            { type: "Key", hash: poolParams.operator().to_hex() },
+            "Cert",
+            index
+          );
+          const owners = poolParams.pool_owners();
+          for (let ownerIndex = 0; ownerIndex < owners.len(); ownerIndex++) {
+            checkAndConsumeHash(
+              { type: "Key", hash: owners.get(ownerIndex).to_hex() },
+              "Cert",
+              index
+            );
+          }
+          break;
+        }
+        case CML.CertificateKind.PoolRetirement: {
+          const pool = cert.as_pool_retirement()?.pool();
+          if (pool) {
+            checkAndConsumeHash(
+              { type: "Key", hash: pool.to_hex() },
+              "Cert",
+              index
+            );
+          }
+          break;
+        }
+        case CML.CertificateKind.UnregCert: {
+          const deregistration = cert.as_unreg_cert()?.stake_credential();
+          checkCertCredential(deregistration, index);
+          if (deregistration) {
+            const rewardAddress = rewardAddressFromCredential(deregistration);
+            if (!this.chain[rewardAddress]?.registeredStake) {
+              throw new Error(
+                `Stake key is already deregistered. Reward address: ${rewardAddress}`
+              );
+            }
+            certRequests.push({ type: "Deregistration", rewardAddress });
+          }
+          break;
+        }
+        case CML.CertificateKind.VoteDelegCert: {
+          const credential = cert.as_vote_deleg_cert()?.stake_credential();
+          checkCertCredential(credential, index);
+          if (credential) {
+            const rewardAddress = rewardAddressFromCredential(credential);
+            if (!this.chain[rewardAddress]?.registeredStake && !certRequests.find(
+              (request) => request.type === "Registration" && request.rewardAddress === rewardAddress
+            )) {
+              throw new Error(
+                `Stake key is not registered. Reward address: ${rewardAddress}`
+              );
+            }
+          }
+          break;
+        }
+        case CML.CertificateKind.StakeVoteDelegCert: {
+          const delegation = cert.as_stake_vote_deleg_cert();
+          const credential = delegation?.stake_credential();
+          checkCertCredential(credential, index);
+          if (delegation && credential) {
+            const rewardAddress = rewardAddressFromCredential(credential);
+            const poolId = delegation.pool().to_bech32("pool");
+            if (!this.chain[rewardAddress]?.registeredStake && !certRequests.find(
+              (request) => request.type === "Registration" && request.rewardAddress === rewardAddress
+            )) {
+              throw new Error(
+                `Stake key is not registered. Reward address: ${rewardAddress}`
+              );
+            }
+            certRequests.push({ type: "Delegation", rewardAddress, poolId });
+          }
+          break;
+        }
+        case CML.CertificateKind.StakeRegDelegCert: {
+          const registration = cert.as_stake_reg_deleg_cert();
+          const credential = registration?.stake_credential();
+          checkCertCredential(credential, index);
+          if (registration && credential) {
+            const rewardAddress = rewardAddressFromCredential(credential);
+            const poolId = registration.pool().to_bech32("pool");
+            if (this.chain[rewardAddress]?.registeredStake) {
+              throw new Error(
+                `Stake key is already registered. Reward address: ${rewardAddress}`
+              );
+            }
+            certRequests.push({ type: "Registration", rewardAddress });
+            certRequests.push({ type: "Delegation", rewardAddress, poolId });
+          }
+          break;
+        }
+        case CML.CertificateKind.VoteRegDelegCert: {
+          const registration = cert.as_vote_reg_deleg_cert();
+          const credential = registration?.stake_credential();
+          checkCertCredential(credential, index);
+          if (credential) {
+            const rewardAddress = rewardAddressFromCredential(credential);
+            if (this.chain[rewardAddress]?.registeredStake) {
+              throw new Error(
+                `Stake key is already registered. Reward address: ${rewardAddress}`
+              );
+            }
+            certRequests.push({ type: "Registration", rewardAddress });
+          }
+          break;
+        }
+        case CML.CertificateKind.StakeVoteRegDelegCert: {
+          const registration = cert.as_stake_vote_reg_deleg_cert();
+          const credential = registration?.stake_credential();
+          checkCertCredential(credential, index);
+          if (registration && credential) {
+            const rewardAddress = rewardAddressFromCredential(credential);
+            const poolId = registration.pool().to_bech32("pool");
+            if (this.chain[rewardAddress]?.registeredStake) {
+              throw new Error(
+                `Stake key is already registered. Reward address: ${rewardAddress}`
+              );
+            }
+            certRequests.push({ type: "Registration", rewardAddress });
+            certRequests.push({ type: "Delegation", rewardAddress, poolId });
+          }
+          break;
+        }
+        case CML.CertificateKind.AuthCommitteeHotCert: {
+          checkCertCredential(
+            cert.as_auth_committee_hot_cert()?.committee_cold_credential(),
+            index
+          );
+          break;
+        }
+        case CML.CertificateKind.ResignCommitteeColdCert: {
+          checkCertCredential(
+            cert.as_resign_committee_cold_cert()?.committee_cold_credential(),
+            index
+          );
+          break;
+        }
+        case CML.CertificateKind.RegDrepCert: {
+          checkCertCredential(
+            cert.as_reg_drep_cert()?.drep_credential(),
+            index
+          );
+          break;
+        }
+        case CML.CertificateKind.UnregDrepCert: {
+          checkCertCredential(
+            cert.as_unreg_drep_cert()?.drep_credential(),
+            index
+          );
+          break;
+        }
+        case CML.CertificateKind.UpdateDrepCert: {
+          checkCertCredential(
+            cert.as_update_drep_cert()?.drep_credential(),
+            index
+          );
+          break;
+        }
       }
     }
     resolvedInputs.forEach(({ entry: { utxo } }, index) => {
@@ -1743,6 +1997,9 @@ It does not exist or was already spent.`
     withdrawalRequests.forEach(({ rewardAddress, withdrawal }) => {
       this.chain[rewardAddress].delegation.rewards -= withdrawal;
     });
+    if (treasuryDonation !== void 0) {
+      this.treasury += treasuryDonation;
+    }
     certRequests.forEach(({ type, rewardAddress, poolId }) => {
       switch (type) {
         case "Registration": {
@@ -1940,6 +2197,11 @@ var Maestro = class {
       }
     };
   }
+  async getTreasury() {
+    throw new Error(
+      "Maestro does not expose a current treasury query. Pass currentTreasuryValue explicitly to donateToTreasury."
+    );
+  }
   async getUtxosInternal(addressOrCredential, unit) {
     const queryPredicate = (() => {
       if (typeof addressOrCredential === "string") {
@@ -2266,6 +2528,9 @@ var ProtocolParametersSchema2 = S4.Struct({
   max_collateral_inputs: S4.Number,
   coins_per_utxo_size: S4.BigInt
 });
+var TotalsSchema = S4.Struct({
+  treasury: S4.String
+});
 var AssetSchema = S4.Struct({
   policy_id: S4.String,
   asset_name: S4.NullOr(S4.String),
@@ -2540,6 +2805,22 @@ var Koios = class {
       }
     };
   }
+  async getTreasury() {
+    const url = `${this.baseUrl}/totals?order=epoch_no.desc&limit=1`;
+    const schema = S5.Array(TotalsSchema);
+    const bearerToken = this.token ? { Authorization: `Bearer ${this.token}` } : void 0;
+    const [result] = await pipe5(
+      makeGet(url, schema, bearerToken),
+      Effect4.provide(FetchHttpClient3.layer),
+      Effect4.flatMap(
+        (result2) => result2.length === 0 ? Effect4.fail("No totals found") : Effect4.succeed(result2)
+      ),
+      Effect4.timeout(1e4),
+      Effect4.catchAllCause((cause) => new KoiosError({ cause })),
+      Effect4.runPromise
+    );
+    return BigInt(result.treasury);
+  }
   async getUtxos(addressOrCredential) {
     const bearerToken = this.token ? { Authorization: `Bearer ${this.token}` } : void 0;
     const result = await pipe5(

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lucid-evolution/provider",
-  "version": "0.1.93",
+  "version": "0.1.95",
   "description": "",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -25,15 +25,15 @@
     "@anastasia-labs/cardano-multiplatform-lib-nodejs": "@anastasia-labs/cardano-multiplatform-lib-browser"
   },
   "dependencies": {
-    "@anastasia-labs/cardano-multiplatform-lib-browser": "6.0.2-3",
-    "@anastasia-labs/cardano-multiplatform-lib-nodejs": "6.0.2-3",
+    "@anastasia-labs/cardano-multiplatform-lib-browser": "6.2.0-1",
+    "@anastasia-labs/cardano-multiplatform-lib-nodejs": "6.2.0-1",
     "@effect/platform": "^0.71.3",
     "@effect/schema": "^0.68.26",
     "effect": "^3.11.7",
-    "@lucid-evolution/core-types": "0.1.24",
-    "@lucid-evolution/utils": "0.1.68",
+    "@lucid-evolution/core-types": "0.2.0",
     "@lucid-evolution/core-utils": "0.1.16",
-    "@lucid-evolution/wallet": "0.1.74"
+    "@lucid-evolution/utils": "0.1.69",
+    "@lucid-evolution/wallet": "0.1.75"
   },
   "devDependencies": {
     "@types/node": "^20.12.8",