@boostxyz/sdk 0.0.0-alpha.2 → 0.0.0-alpha.21

package/dist/deployments-oykLv3_Z.js

@@ -0,0 +1,43 @@
+const c = {
+  11155111: "0x504F4710d6C4A4cf610F17782C9205E0e583e85f"
+}, e = {
+  11155111: "0x7BB0f4D1EC236B6F7EDb5AB41Cff0956755Fc202"
+}, a = {
+  11155111: "0xD32f03C033383E0B62Ff900038C1CA9788f76369"
+}, s = {
+  11155111: "0x88DCc7Fc9dDA2081fF2Fa15E240D3B81dfCbbaF0"
+}, t = {
+  11155111: "0xFc81D4702F836C68E47184f31878af192949658A"
+}, n = {
+  11155111: "0x588C5f424A1a1BE2dC0991906DDe323754B918Ad"
+}, C = {
+  11155111: "0xDb79d3803fC80E62c7E5A64f00DAD14721f2801c"
+}, f = {
+  11155111: "0x59A4B235950e7BdfD185F447271CE045691d5156"
+}, o = {
+  11155111: "0x22e48036b74d125da60246b8Fb677D6194a95291"
+}, i = {
+  11155111: "0xc37d353c13F75F48bEDB1CaDAACa77F3594FB2B9"
+}, E = {
+  11155111: "0x9e1ff146C96195c74a746756AEd748c92Ff81d6A"
+}, d = {
+  11155111: "0x7b27cc50e96Fc2f714b9a11825702d33f44cCB49"
+}, A = {
+  11155111: "0x5Be370C82769dfa3738041D672047E2048EE5e73"
+};
+export {
+  c as A,
+  a as B,
+  s as C,
+  t as E,
+  o as M,
+  i as P,
+  d as S,
+  A as a,
+  E as b,
+  C as c,
+  f as d,
+  n as e,
+  e as f
+};
+//# sourceMappingURL=deployments-oykLv3_Z.js.map

package/dist/deployments-oykLv3_Z.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deployments-oykLv3_Z.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/dist/deployments.json

@@ -0,0 +1,44 @@
+{
+  "AllowListIncentive": {
+    "11155111": "0x504F4710d6C4A4cf610F17782C9205E0e583e85f"
+  },
+  "BoostCore": {
+    "11155111": "0x7BB0f4D1EC236B6F7EDb5AB41Cff0956755Fc202"
+  },
+  "BoostRegistry": {
+    "11155111": "0xD32f03C033383E0B62Ff900038C1CA9788f76369"
+  },
+  "CGDAIncentive": {
+    "11155111": "0x88DCc7Fc9dDA2081fF2Fa15E240D3B81dfCbbaF0"
+  },
+  "ERC20Incentive": {
+    "11155111": "0xFc81D4702F836C68E47184f31878af192949658A"
+  },
+  "ERC20VariableCriteriaIncentive": {
+    "11155111": "0x588C5f424A1a1BE2dC0991906DDe323754B918Ad"
+  },
+  "ERC20VariableIncentive": {
+    "11155111": "0xDb79d3803fC80E62c7E5A64f00DAD14721f2801c"
+  },
+  "EventAction": {
+    "11155111": "0x59A4B235950e7BdfD185F447271CE045691d5156"
+  },
+  "ManagedBudget": {
+    "11155111": "0x22e48036b74d125da60246b8Fb677D6194a95291"
+  },
+  "OpenAllowList": {
+    "11155111": "0x192F4a185c76306C6F4fF22a8c412De414452330"
+  },
+  "PointsIncentive": {
+    "11155111": "0xc37d353c13F75F48bEDB1CaDAACa77F3594FB2B9"
+  },
+  "SignerValidator": {
+    "11155111": "0x9e1ff146C96195c74a746756AEd748c92Ff81d6A"
+  },
+  "SimpleAllowList": {
+    "11155111": "0x7b27cc50e96Fc2f714b9a11825702d33f44cCB49"
+  },
+  "SimpleDenyList": {
+    "11155111": "0x5Be370C82769dfa3738041D672047E2048EE5e73"
+  }
+}

package/dist/errors.cjs

@@ -1 +1,2 @@
-"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const t=require("viem");class s extends Error{constructor(){super('No "BoostCreated" log was emitted from which to extract boostId')}}class a extends Error{constructor(){super("Attempted to call contract method without providing an address")}}class n extends Error{constructor(e){super("Attempted to deploy a contract that already has an address configured"),this.address=e}}class d extends Error{constructor(){super("Implementing class did not properly override the `buildParameters` method")}}class i extends Error{constructor(){super("Expected an an owner to be provided in configuration or an account to exist on Wagmi config.")}}class c extends Error{constructor(){super("Expected a valid Wagmi configuration to be available either on Deployable, or as argument to deploy.")}}class l extends Error{constructor(){super("Expected a valid payload to be available either on Deployable or as argument to deploy.")}}class p extends Error{constructor(e){super("Expected a contract address to exist on receipt.",{cause:e}),this.receipt=e}}class u extends Error{constructor(e,o){super("Address provided does not match any expected protocol interface",{cause:{expected:e,received:o}}),this.expected=[],this.received=t.zeroHash,this.expected=e,this.received=o}}class E extends Error{constructor(e){super("Did not provide a valid FungibleTransferPayload or ERC1155 transfer payload.",{cause:e}),this.received=e}}class y extends Error{constructor(e){super(`Budget needs to explicitly authorize ${e}. You can retrieve this value from BoostCore.address`)}}class m extends Error{constructor(e){super(`Incentive not cloneable: ${e.constructor.name}`)}}exports.BoostCoreNoIdentifierEmitted=s;exports.BudgetMustAuthorizeBoostCore=y;exports.ContractAddressRequiredError=a;exports.DeployableAlreadyDeployedError=n;exports.DeployableBuildParametersUnspecifiedError=d;exports.DeployableMissingPayloadError=l;exports.DeployableUnknownOwnerProvidedError=i;exports.DeployableWagmiConfigurationRequiredError=c;exports.IncentiveNotCloneableError=m;exports.InvalidComponentInterfaceError=u;exports.NoContractAddressUponReceiptError=p;exports.UnknownTransferPayloadSupplied=E;
+"use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const a=require("viem");class i extends Error{constructor(){super('No "BoostCreated" log was emitted from which to extract boostId')}}class d extends Error{constructor(){super("Attempted to call contract method without providing an address")}}class c extends Error{constructor(r){super("Attempted to deploy a contract that already has an address configured"),this.address=r}}class l extends Error{constructor(){super("Implementing class did not properly override the `buildParameters` method")}}class u extends Error{constructor(){super("Expected an an owner to be provided in configuration or an account to exist on Wagmi config.")}}class p extends Error{constructor(){super("Expected a valid Wagmi configuration to be available either on Deployable, or as argument to deploy.")}}class E extends Error{constructor(){super("Expected a valid payload to be available either on Deployable or as argument to deploy.")}}class h extends Error{constructor(r){super("Expected a contract address to exist on receipt.",{cause:r}),this.receipt=r}}class g extends Error{constructor(r,o){super("Address provided does not match any expected protocol interface",{cause:{expected:r,received:o}}),this.expected=[],this.received=a.zeroHash,this.expected=r,this.received=o}}class m extends Error{constructor(r,o){super(`Parameter is not transparently stored onchain. Parameter ${r} in event ${o.name} cannot be used in an action`,{cause:o}),this.event=o,this.input_param_idx=r}}class v extends Error{constructor(r){super("Did not provide a valid FungibleTransferPayload or ERC1155 transfer payload.",{cause:r}),this.received=r}}class y extends Error{constructor(r){super(`Budget needs to explicitly authorize ${r}. You can retrieve this value from BoostCore.address`)}}class b extends Error{constructor(){super("Budgets must be preinitialized before being used with a new Boost")}}class x extends Error{constructor(r){super(`Incentive not cloneable: ${r.constructor.name}`)}}class f extends Error{constructor(){super("Must supply at least one action step")}}class C extends Error{constructor(){super("Cannot supply more than 4 action steps with current protocol version")}}class I extends Error{constructor(r){super(`No known ABI for given signature: ${r}`)}}class t extends Error{constructor(r,{fieldValue:o,criteria:n,...s}){switch(super(r),this.fieldValue=o,this.criteria=n,!0){case"log"in s:this.log=s.log;break;case"decodedArgs"in s:this.decodedArgs=s.decodedArgs}}}class A extends t{constructor(r){super("Decoded Args are malformed; Check which params are indexed",r)}}class D extends t{constructor(r){super("Field value is undefined",r)}}class N extends t{constructor(r){super("Numerical comparisons cannot be used with non-numerical criteria",r)}}class w extends Error{constructor(r,o){super(`Failed to decode function data: ${o.message}`),this.name="FunctionDataDecodeError",this.abi=r,this.originalError=o}}class P extends t{constructor(r){super("Filter can only be used with bytes or string field type",r)}}class F extends t{constructor(r){super("Invalid FilterType provided",r)}}class B extends Error{constructor(){super("Provided Wagmi configuration does not define `chainId` property with which to target protocol contracts"),this.name="NoConnectedChainIdError"}}class M extends Error{constructor(r,o){super(`Provided Wagmi configuration supplied a "chainId" where protocol is not deployed, provided: ${r}, but valid chains are: ${o}`),this.name="InvalidProtocolChainIdError"}}class U extends Error{constructor(r,o="Unable to fetch Incentive Criteria from contract"){super(o+(r?`: ${r.message}`:"")),this.name="IncentiveCriteriaNotFoundError"}}class T extends Error{constructor(r,o=`No logs found for event signature ${r}`){super(o),this.name="NoMatchingLogsError"}}class $ extends Error{constructor(r="unknown",o=`Invalid criteria type ${r}`){super(o),this.name="InvalidCriteriaTypeError"}}class z extends Error{constructor(r="Issue decoding args"){super(r),this.name="DecodedArgsError"}}class V extends Error{constructor(r){super(`Boost with not found with id: ${r}`),this.id=r}}exports.BoostCoreNoIdentifierEmitted=i;exports.BoostNotFoundError=V;exports.BudgetMustAuthorizeBoostCore=y;exports.ContractAddressRequiredError=d;exports.DecodedArgsError=z;exports.DecodedArgsMalformedError=A;exports.DeployableAlreadyDeployedError=c;exports.DeployableBuildParametersUnspecifiedError=l;exports.DeployableMissingPayloadError=E;exports.DeployableUnknownOwnerProvidedError=u;exports.DeployableWagmiConfigurationRequiredError=p;exports.FieldActionValidationError=t;exports.FieldValueNotComparableError=P;exports.FieldValueUndefinedError=D;exports.FunctionDataDecodeError=w;exports.IncentiveCriteriaNotFoundError=U;exports.IncentiveNotCloneableError=x;exports.InvalidComponentInterfaceError=g;exports.InvalidCriteriaTypeError=$;exports.InvalidNumericalCriteriaError=N;exports.InvalidProtocolChainIdError=M;exports.MustInitializeBudgetError=b;exports.NoConnectedChainIdError=B;exports.NoContractAddressUponReceiptError=h;exports.NoEventActionStepsProvidedError=f;exports.NoMatchingLogsError=T;exports.TooManyEventActionStepsProvidedError=C;exports.UnknownTransferPayloadSupplied=v;exports.UnparseableAbiParamError=m;exports.UnrecognizedFilterTypeError=F;exports.ValidationAbiMissingError=I;
+//# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.cjs","sources":["../src/errors.ts"],"sourcesContent":["import {\n  type AbiEvent,\n  type AbiFunction,\n  type Hex,\n  type Log,\n  type WaitForTransactionReceiptReturnType,\n  zeroHash,\n} from 'viem';\nimport type { Criteria } from './Actions/EventAction';\nimport type { EventLogs } from './Actions/EventAction';\nimport type { BoostRegistry } from './BoostRegistry';\nimport type { Incentive } from './Incentives/Incentive';\n\n/**\n * This error is thrown during Boost creation if no `BoostCreated` event was emitted.\n *\n * @export\n * @class BoostCoreNoIdentifierEmitted\n * @typedef {BoostCoreNoIdentifierEmitted}\n * @extends {Error}\n * @example\n * ```ts\n * try {\n *   await boostCore.createBoost(...)\n * } catch(e) {\n *   if(e instanceof BoostCoreNoIdentifierEmitted) {}\n * }\n * ```\n */\nexport class BoostCoreNoIdentifierEmitted extends Error {\n  /**\n   * Creates an instance of BoostCoreNoIdentifierEmitted.\n   *\n   * @constructor\n   */\n  constructor() {\n    super(`No \"BoostCreated\" log was emitted from which to extract boostId`);\n  }\n}\n\n/**\n * This error is thrown when `assertValidAddress` is called, usually because a contract call expects the class to have a valid address attached.\n *\n * @export\n * @class ContractAddressRequiredError\n * @typedef {ContractAddressRequiredError}\n * @extends {Error}\n * @example\n * ```ts\n * try {\n *   target.assertValidAddress()\n * } catch(e) {\n *   if(e instanceof ContractAddressRequiredError) {}\n * }\n */\nexport class ContractAddressRequiredError extends Error {\n  /**\n   * Creates an instance of ContractAddressRequiredError.\n   *\n   * @constructor\n   */\n  constructor() {\n    super('Attempted to call contract method without providing an address');\n  }\n}\n\n/**\n * This error is thrown when attempting to deploy a contract that has already been deployed, or has an address attached.\n *\n * @export\n * @class DeployableAlreadyDeployedError\n * @typedef {DeployableAlreadyDeployedError}\n * @extends {Error}\n */\nexport class DeployableAlreadyDeployedError extends Error {\n  /**\n   * The address already attached to the target.\n   *\n   * @type {string}\n   */\n  address: string;\n  /**\n   * Creates an instance of DeployableAlreadyDeployedError.\n   *\n   * @constructor\n   * @param {string} address\n   */\n  constructor(address: string) {\n    super(\n      'Attempted to deploy a contract that already has an address configured',\n    );\n    this.address = address;\n  }\n}\n\n/**\n * You should never see this error if we did our jobs and every target overrides the `buildParameters` method.\n *\n * @export\n * @class DeployableBuildParametersUnspecifiedError\n * @typedef {DeployableBuildParametersUnspecifiedError}\n * @extends {Error}\n */\nexport class DeployableBuildParametersUnspecifiedError extends Error {\n  /**\n   * Creates an instance of DeployableBuildParametersUnspecifiedError.\n   *\n   * @constructor\n   */\n  constructor() {\n    super(\n      'Implementing class did not properly override the `buildParameters` method',\n    );\n  }\n}\n\n/**\n * This error is thrown when attempting to deploy an `ownable` contract and the owner cannot be ascertained from the initialization payload or configured account.\n *\n * @export\n * @class DeployableUnknownOwnerProvidedError\n * @typedef {DeployableUnknownOwnerProvidedError}\n * @extends {Error}\n */\nexport class DeployableUnknownOwnerProvidedError extends Error {\n  /**\n   * Creates an instance of DeployableUnknownOwnerProvidedError.\n   *\n   * @constructor\n   */\n  constructor() {\n    super(\n      'Expected an an owner to be provided in configuration or an account to exist on Wagmi config.',\n    );\n  }\n}\n\n/**\n * This error is thrown when deploying a contract with no valid Wagmi configuration on the instance.\n *\n * @export\n * @class DeployableWagmiConfigurationRequiredError\n * @typedef {DeployableWagmiConfigurationRequiredError}\n * @extends {Error}\n */\nexport class DeployableWagmiConfigurationRequiredError extends Error {\n  /**\n   * Creates an instance of DeployableWagmiConfigurationRequiredError.\n   *\n   * @constructor\n   */\n  constructor() {\n    super(\n      'Expected a valid Wagmi configuration to be available either on Deployable, or as argument to deploy.',\n    );\n  }\n}\n\n/**\n * This error is thrown when deploying a contract with no valid initialization payload.\n *\n * @export\n * @class DeployableMissingPayloadError\n * @typedef {DeployableMissingPayloadError}\n * @extends {Error}\n */\nexport class DeployableMissingPayloadError extends Error {\n  /**\n   * Creates an instance of DeployableMissingPayloadError.\n   *\n   * @constructor\n   */\n  constructor() {\n    super(\n      'Expected a valid payload to be available either on Deployable or as argument to deploy.',\n    );\n  }\n}\n\n/**\n * This error is thrown when we receive a transaction receipt for a contract deployment without a contract address on it.\n *\n * @export\n * @class NoContractAddressUponReceiptError\n * @typedef {NoContractAddressUponReceiptError}\n * @extends {Error}\n */\nexport class NoContractAddressUponReceiptError extends Error {\n  /**\n   * The raw receipt we receive from [waitForTransactionReceipt](https://v1.viem.sh/docs/actions/public/waitForTransactionReceipt.html#waitfortransactionreceipt)\n   *\n   * @public\n   * @readonly\n   * @type {WaitForTransactionReceiptReturnType}\n   */\n  public readonly receipt: WaitForTransactionReceiptReturnType;\n  /**\n   * Creates an instance of NoContractAddressUponReceiptError.\n   *\n   * @constructor\n   * @param {WaitForTransactionReceiptReturnType} receipt\n   */\n  constructor(receipt: WaitForTransactionReceiptReturnType) {\n    super(`Expected a contract address to exist on receipt.`, {\n      cause: receipt,\n    });\n    this.receipt = receipt;\n  }\n}\n\n/**\n * This error is thrown when a target address was provided that doesn't match any supported interface for the given registry type.\n * For example, if you try to do `incentiveFromAddress()` with the address of a deployed `SimpleBudget`\n *\n * @export\n * @class InvalidComponentInterfaceError\n * @typedef {InvalidComponentInterfaceError}\n * @extends {Error}\n */\nexport class InvalidComponentInterfaceError extends Error {\n  /**\n   * Expected interface hashes.\n   *\n   * @public\n   * @readonly\n   * @type {Hex[]}\n   */\n  public readonly expected: Hex[] = [];\n  /**\n   * The actual interface hash.\n   *\n   * @public\n   * @readonly\n   * @type {Hex}\n   */\n  public readonly received: Hex = zeroHash;\n\n  /**\n   * Creates an instance of InvalidComponentInterfaceError.\n   *\n   * @constructor\n   * @param {Hex[]} expected\n   * @param {Hex} received\n   */\n  constructor(expected: Hex[], received: Hex) {\n    super(`Address provided does not match any expected protocol interface`, {\n      cause: { expected, received },\n    });\n    this.expected = expected;\n    this.received = received;\n  }\n}\n\n/**\n * This error is thrown when a param is not transparently stored onchain\n *\n * @export\n * @class UnparseableAbiParamError\n * @typedef {UnparseableAbiParamError}\n * @extends {Error}\n */\nexport class UnparseableAbiParamError extends Error {\n  /**\n   * the param index that is unparseable\n   *\n   * @type {number}\n   */\n  input_param_idx: number;\n  /**\n   * The given event that contains the unparseable param\n   *\n   * @type {AbiEvent}\n   */\n  event: AbiEvent;\n  /**\n   * Creates an instance of UnknownTransferPayloadSupplied.\n   *\n   * @constructor\n   * @param {number} input_param_idx\n   * @param {AbiEvent} event\n   */\n  constructor(input_param_idx: number, event: AbiEvent) {\n    super(\n      `Parameter is not transparently stored onchain. Parameter ${input_param_idx} in event ${event.name} cannot be used in an action`,\n      { cause: event },\n    );\n    this.event = event;\n    this.input_param_idx = input_param_idx;\n  }\n}\n\n/**\n * This error is thrown when attempting a Budget transfer and arguments aren't of the type `FungibleTransferPayload` or `ERC1155TransferPayload`\n *\n * @see {@link FungibleTransferPayload}\n * @see {@link ERC1155TransferPayload}\n * @export\n * @class UnknownTransferPayloadSupplied\n * @typedef {UnknownTransferPayloadSupplied}\n * @extends {Error}\n */\nexport class UnknownTransferPayloadSupplied extends Error {\n  /**\n   * The given payload that does not conform to the correct payload shape.\n   *\n   * @type {unknown}\n   */\n  received: unknown;\n  /**\n   * Creates an instance of UnknownTransferPayloadSupplied.\n   *\n   * @constructor\n   * @param {unknown} received\n   */\n  constructor(received: unknown) {\n    super(\n      `Did not provide a valid FungibleTransferPayload or ERC1155 transfer payload.`,\n      { cause: received },\n    );\n    this.received = received;\n  }\n}\n\n/**\n * This error is thrown during Boost creation when the budget doesn't authorize the Boost Core address.\n *\n * @export\n * @class BudgetMustAuthorizeBoostCore\n * @typedef {BudgetMustAuthorizeBoostCore}\n * @extends {Error}\n */\nexport class BudgetMustAuthorizeBoostCore extends Error {\n  /**\n   * Creates an instance of BudgetMustAuthorizeBoostCore.\n   *\n   * @constructor\n   * @param {string} boostCoreAddress\n   */\n  constructor(boostCoreAddress: string) {\n    super(\n      `Budget needs to explicitly authorize ${boostCoreAddress}. You can retrieve this value from BoostCore.address`,\n    );\n  }\n}\n\n/**\n * Because this contract is a base implementation, it should not be initialized through the constructor. Instead, it should be cloned and initialized using the {@link BoostRegistry}\n *\n * @export\n * @class MustInitializeBudgetError\n * @typedef {MustInitializeBudgetError}\n * @extends {Error}\n */\nexport class MustInitializeBudgetError extends Error {\n  /**\n   * Creates an instance of MustInitializeBudgetError.\n   */\n  constructor() {\n    super(`Budgets must be preinitialized before being used with a new Boost`);\n  }\n}\n\n/**\n * The error is thrown when trying to reuse an existing deployed Incentive that isn't a base implementation.\n * The protocol doesn't allow this.\n *\n * @export\n * @class IncentiveNotCloneableError\n * @typedef {IncentiveNotCloneableError}\n * @extends {Error}\n */\nexport class IncentiveNotCloneableError extends Error {\n  /**\n   * Creates an instance of IncentiveNotCloneableError.\n   *\n   * @constructor\n   * @param {Incentive} incentive\n   */\n  constructor(incentive: Incentive) {\n    super(`Incentive not cloneable: ${incentive.constructor.name}`);\n  }\n}\n\n/**\n * Thrown when encoding an EventAction payload and no action steps are provided\n *\n * @export\n * @class NoEventActionStepsProvidedError\n * @typedef {NoEventActionStepsProvidedError}\n * @extends {Error}\n */\nexport class NoEventActionStepsProvidedError extends Error {\n  /**\n   * Creates an instance of NoEventActionStepsProvidedError.\n   *\n   * @constructor\n   */\n  constructor() {\n    super('Must supply at least one action step');\n  }\n}\n\n/**\n * Thrown when encoding an EventAction payload and > 4 steps are provided\n *\n * @export\n * @class TooManyEventActionStepsProvidedError\n * @typedef {TooManyEventActionStepsProvidedError}\n * @extends {Error}\n */\nexport class TooManyEventActionStepsProvidedError extends Error {\n  /**\n   * Creates an instance of TooManyEventActionStepsProvidedError.\n   *\n   * @constructor\n   */\n  constructor() {\n    super(\n      'Cannot supply more than 4 action steps with current protocol version',\n    );\n  }\n}\n\n/**\n * The error is thrown when trying to reuse an existing deployed Incentive that isn't a base implementation.\n *\n * @export\n * @class ValidationAbiMissingError\n * @typedef {ValidationAbiMissingError}\n * @extends {Error}\n */\nexport class ValidationAbiMissingError extends Error {\n  /**\n   * Creates an instance of ValidationAbiMissingError.\n   *\n   * @constructor\n   * @param {Hex} signature\n   */\n  constructor(signature: Hex) {\n    super(`No known ABI for given signature: ${signature}`);\n  }\n}\n\n/**\n * Function action validation context to help debug other validation errors\n *\n * @interface FunctionActionValidationMeta\n * @typedef {FunctionActionValidationMeta}\n */\ninterface FunctionActionValidationMeta {\n  decodedArgs: readonly (string | bigint)[];\n  /**\n   * The value pulled off the log being validated against\n   *\n   * @type {*}\n   * biome-ignore lint/suspicious/noExplicitAny: this can be a few different types based on what the log emits\n   */\n  fieldValue: any;\n  /**\n   * The criteria being used to compare during validation\n   *\n   * @type {Criteria}\n   */\n  criteria: Criteria;\n}\n/**\n * Event action validation context to help debug other validation errors\n *\n * @interface EventActionValidationMeta\n * @typedef {EventActionValidationMeta}\n */\ninterface EventActionValidationMeta {\n  /**\n   * The viem log being validated against\n   *\n   * @type {Log}\n   */\n  log?: EventLogs[0];\n  /**\n   * The value pulled off the log being validated against\n   *\n   * @type {*}\n   * biome-ignore lint/suspicious/noExplicitAny: this can be a few different types based on what the log emits\n   */\n  fieldValue: any;\n  /**\n   * The criteria being used to compare during validation\n   *\n   * @type {Criteria}\n   */\n  criteria: Criteria;\n}\n\n/**\n * The base error thrown during event action validation extended by more specific validation errors.\n * Instantiated with relevent context data for more in depth debugging.\n *\n * @export\n * @class FieldActionValidationError\n * @typedef {FieldActionValidationError}\n * @extends {Error}\n */\nexport class FieldActionValidationError extends Error {\n  /**\n   * The function input arguments being validated against\n   *\n   * @type {decodedArgs}\n   */\n  decodedArgs?: readonly (string | bigint)[];\n  /**\n   * The viem log being validated against\n   *\n   * @type {Log}\n   */\n  log?: EventLogs[0];\n  /**\n   * The value pulled off the log being validated against\n   *\n   * @type {*}\n   * biome-ignore lint/suspicious/noExplicitAny: this can be a few different types based on what the log emits\n   */\n  fieldValue: any;\n  /**\n   * The criteria being used to compare during validation\n   *\n   * @type {Criteria}\n   */\n  criteria: Criteria;\n  /**\n   * Creates an instance of FieldActionValidationError.\n   *\n   * @constructor\n   * @param {string} message\n   * @param {EventActionValidationMeta} param0\n   * @param {*} param0.fieldValue\n   * @param {Criteria} param0.criteria\n   * @param {Log} param0.log\n   */\n  constructor(\n    message: string,\n    {\n      fieldValue,\n      criteria,\n      ...args\n    }: EventActionValidationMeta | FunctionActionValidationMeta,\n  ) {\n    super(message);\n    this.fieldValue = fieldValue;\n    this.criteria = criteria;\n\n    switch (true) {\n      case 'log' in args:\n        this.log = args.log;\n        break;\n      case 'decodedArgs' in args:\n        this.decodedArgs = args.decodedArgs;\n    }\n  }\n}\n\n/**\n * Thrown when abi-decoded args on log is undefined\n *\n * @export\n * @class FieldValueUndefinedError\n * @typedef {FieldValueUndefinedError}\n * @extends {FieldActionValidationError}\n */\nexport class DecodedArgsMalformedError extends FieldActionValidationError {\n  /**\n   * Creates an instance of DecodedArgsUndefinedError.\n   *\n   * @constructor\n   * @param {DecodedArgsMalformedError} metadata\n   */\n  constructor(\n    metadata: EventActionValidationMeta | FunctionActionValidationMeta,\n  ) {\n    super(\n      'Decoded Args are malformed; Check which params are indexed',\n      metadata,\n    );\n  }\n}\n\n/**\n * Thrown when field value on log is undefined\n *\n * @export\n * @class FieldValueUndefinedError\n * @typedef {FieldValueUndefinedError}\n * @extends {FieldActionValidationError}\n */\nexport class FieldValueUndefinedError extends FieldActionValidationError {\n  /**\n   * Creates an instance of FieldValueUndefinedError.\n   *\n   * @constructor\n   * @param {EventActionValidationMeta} metadata\n   */\n  constructor(\n    metadata: EventActionValidationMeta | FunctionActionValidationMeta,\n  ) {\n    super('Field value is undefined', metadata);\n  }\n}\n\n/**\n * Thrown when a filter type is using a numerical operator but field type is not numerical\n *\n * @export\n * @class InvalidNumericalCriteriaError\n * @typedef {InvalidNumericalCriteriaError}\n * @extends {FieldActionValidationError}\n */\nexport class InvalidNumericalCriteriaError extends FieldActionValidationError {\n  /**\n   * Creates an instance of InvalidNumericalCriteria.\n   *\n   * @constructor\n   * @param {EventActionValidationMeta} metadata\n   */\n  constructor(\n    metadata: EventActionValidationMeta | FunctionActionValidationMeta,\n  ) {\n    super(\n      'Numerical comparisons cannot be used with non-numerical criteria',\n      metadata,\n    );\n  }\n}\n\n/**\n * Thrown when decoding function data fails.\n *\n * @export\n * @class FunctionDataDecodeError\n * @typedef {FunctionDataDecodeError}\n * @extends {Error}\n */\nexport class FunctionDataDecodeError extends Error {\n  public abi: AbiFunction[];\n  public originalError: Error;\n\n  /**\n   * Creates an instance of FunctionDataDecodeError.\n   *\n   * @constructor\n   * @param {AbiFunction[]} abi - The ABI of the function.\n   * @param {Error} originalError - The original error that was thrown.\n   */\n  constructor(abi: AbiFunction[], originalError: Error) {\n    super(`Failed to decode function data: ${originalError.message}`);\n    this.name = 'FunctionDataDecodeError';\n    this.abi = abi;\n    this.originalError = originalError;\n  }\n}\n\n/**\n * Thrown when an the log's field value is being compared a field type that isn't bytes or string during event action validation\n *\n * @export\n * @class FieldValueNotComparableError\n * @typedef {FieldValueNotComparableError}\n * @extends {FieldActionValidationError}\n */\nexport class FieldValueNotComparableError extends FieldActionValidationError {\n  /**\n   * Creates an instance of FieldValueNotComparableError.\n   *\n   * @constructor\n   * @param {EventActionValidationMeta} metadata\n   */\n  constructor(\n    metadata: EventActionValidationMeta | FunctionActionValidationMeta,\n  ) {\n    super('Filter can only be used with bytes or string field type', metadata);\n  }\n}\n\n/**\n * Thrown when an invalid filter type enum was provided event action validation.\n *\n * @export\n * @class UnrecognizedFilterTypeError\n * @typedef {UnrecognizedFilterTypeError}\n * @extends {FieldActionValidationError}\n */\nexport class UnrecognizedFilterTypeError extends FieldActionValidationError {\n  /**\n   * Creates an instance of UnrecognizedFilterTypeError.\n   *\n   * @constructor\n   * @param {EventActionValidationMeta} metadata\n   */\n  constructor(\n    metadata: EventActionValidationMeta | FunctionActionValidationMeta,\n  ) {\n    super('Invalid FilterType provided', metadata);\n  }\n}\n\n/**\n * Thrown when no chain ID is provided in the Wagmi configuration.\n *\n * @export\n * @class NoConnectedChainIdError\n * @typedef {NoConnectedChainIdError}\n * @extends {Error}\n */\nexport class NoConnectedChainIdError extends Error {\n  /**\n   * Creates an instance of NoConnectedChainIdError.\n   *\n   * @constructor\n   */\n  constructor() {\n    super(\n      'Provided Wagmi configuration does not define `chainId` property with which to target protocol contracts',\n    );\n    this.name = 'NoConnectedChainIdError';\n  }\n}\n\n/**\n * Thrown when an invalid chain ID is provided that doesn't match any deployed protocol.\n *\n * @export\n * @class InvalidProtocolChainIdError\n * @typedef {InvalidProtocolChainIdError}\n * @extends {Error}\n */\nexport class InvalidProtocolChainIdError extends Error {\n  /**\n   * Creates an instance of InvalidProtocolChainIdError.\n   *\n   * @constructor\n   * @param {number} chainId - The chain ID provided in the configuration.\n   * @param {number[]} validChainIds - A list of valid chain IDs where the protocol is deployed.\n   */\n  constructor(chainId: number, validChainIds: number[]) {\n    super(\n      `Provided Wagmi configuration supplied a \"chainId\" where protocol is not deployed, provided: ${chainId}, but valid chains are: ${validChainIds}`,\n    );\n    this.name = 'InvalidProtocolChainIdError';\n  }\n}\n\n/**\n * Thrown when the incentive criteria cannot be fetched from the contract.\n *\n * @export\n * @class IncentiveCriteriaNotFoundError\n * @typedef {IncentiveCriteriaNotFoundError}\n * @extends {Error}\n */\nexport class IncentiveCriteriaNotFoundError extends Error {\n  /**\n   * Creates an instance of IncentiveCriteriaNotFoundError.\n   *\n   * @constructor\n   * @param {Error} [e] - Optional error object for further context.\n   * @param {string} [message='Unable to fetch Incentive Criteria from contract'] - Custom error message.\n   */\n  constructor(\n    e?: Error,\n    message = 'Unable to fetch Incentive Criteria from contract',\n  ) {\n    super(message + (e ? `: ${e.message}` : ''));\n    this.name = 'IncentiveCriteriaNotFoundError';\n  }\n}\n\n/**\n * Thrown when no matching logs are found for a given event signature.\n *\n * @export\n * @class NoMatchingLogsError\n * @typedef {NoMatchingLogsError}\n * @extends {Error}\n */\nexport class NoMatchingLogsError extends Error {\n  /**\n   * Creates an instance of NoMatchingLogsError.\n   *\n   * @constructor\n   * @param {string} signature - The event signature for which logs are being searched.\n   * @param {string} [message] - Optional custom error message.\n   */\n  constructor(\n    signature: string,\n    message = `No logs found for event signature ${signature}`,\n  ) {\n    super(message);\n    this.name = 'NoMatchingLogsError';\n  }\n}\n\n/**\n * Thrown when an invalid criteria type is provided.\n *\n * @export\n * @class InvalidCriteriaTypeError\n * @typedef {InvalidCriteriaTypeError}\n * @extends {Error}\n */\nexport class InvalidCriteriaTypeError extends Error {\n  /**\n   * Creates an instance of InvalidCriteriaTypeError.\n   *\n   * @constructor\n   * @param {string} [criteriaType='unknown'] - The invalid criteria type that was provided.\n   * @param {string} [message] - Optional custom error message.\n   */\n  constructor(\n    criteriaType = 'unknown',\n    message = `Invalid criteria type ${criteriaType}`,\n  ) {\n    super(message);\n    this.name = 'InvalidCriteriaTypeError';\n  }\n}\n\n/**\n * Thrown when decoding function arguments fails.\n *\n * @export\n * @class DecodedArgsError\n * @typedef {DecodedArgsError}\n * @extends {Error}\n */\nexport class DecodedArgsError extends Error {\n  /**\n   * Creates an instance of DecodedArgsError.\n   *\n   * @constructor\n   * @param {string} [message='Issue decoding args'] - Custom error message.\n   */\n  constructor(message = 'Issue decoding args') {\n    super(message);\n    this.name = 'DecodedArgsError';\n  }\n}\n\n/**\n * Thrown when reading a Boost that does not exist\n *\n * @export\n * @class BoostNotFoundError\n * @typedef {BoostNotFoundError}\n * @extends {Error}\n */\nexport class BoostNotFoundError extends Error {\n  public readonly id: string;\n  /**\n   * Creates an instance of BoostNotFoundError.\n   *\n   * @constructor\n   * @param {string} [id] - stringified boost id that does not exist\n   */\n  constructor(id: string) {\n    super(`Boost with not found with id: ${id}`);\n    this.id = id;\n  }\n}\n"],"names":["BoostCoreNoIdentifierEmitted","ContractAddressRequiredError","DeployableAlreadyDeployedError","address","DeployableBuildParametersUnspecifiedError","DeployableUnknownOwnerProvidedError","DeployableWagmiConfigurationRequiredError","DeployableMissingPayloadError","NoContractAddressUponReceiptError","receipt","InvalidComponentInterfaceError","expected","received","zeroHash","UnparseableAbiParamError","input_param_idx","event","UnknownTransferPayloadSupplied","BudgetMustAuthorizeBoostCore","boostCoreAddress","MustInitializeBudgetError","IncentiveNotCloneableError","incentive","NoEventActionStepsProvidedError","TooManyEventActionStepsProvidedError","ValidationAbiMissingError","signature","FieldActionValidationError","message","fieldValue","criteria","args","DecodedArgsMalformedError","metadata","FieldValueUndefinedError","InvalidNumericalCriteriaError","FunctionDataDecodeError","abi","originalError","FieldValueNotComparableError","UnrecognizedFilterTypeError","NoConnectedChainIdError","InvalidProtocolChainIdError","chainId","validChainIds","IncentiveCriteriaNotFoundError","e","NoMatchingLogsError","InvalidCriteriaTypeError","criteriaType","DecodedArgsError","BoostNotFoundError","id"],"mappings":"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"}

package/dist/errors.d.ts

@@ -1,4 +1,6 @@
-import { type Hex, type WaitForTransactionReceiptReturnType } from 'viem';
+import { type AbiEvent, type AbiFunction, type Hex, type WaitForTransactionReceiptReturnType } from 'viem';
+import type { Criteria } from './Actions/EventAction';
+import type { EventLogs } from './Actions/EventAction';
 import type { Incentive } from './Incentives/Incentive';
 /**
  * This error is thrown during Boost creation if no `BoostCreated` event was emitted.
@@ -194,6 +196,36 @@ export declare class InvalidComponentInterfaceError extends Error {
      */
     constructor(expected: Hex[], received: Hex);
 }
+/**
+ * This error is thrown when a param is not transparently stored onchain
+ *
+ * @export
+ * @class UnparseableAbiParamError
+ * @typedef {UnparseableAbiParamError}
+ * @extends {Error}
+ */
+export declare class UnparseableAbiParamError extends Error {
+    /**
+     * the param index that is unparseable
+     *
+     * @type {number}
+     */
+    input_param_idx: number;
+    /**
+     * The given event that contains the unparseable param
+     *
+     * @type {AbiEvent}
+     */
+    event: AbiEvent;
+    /**
+     * Creates an instance of UnknownTransferPayloadSupplied.
+     *
+     * @constructor
+     * @param {number} input_param_idx
+     * @param {AbiEvent} event
+     */
+    constructor(input_param_idx: number, event: AbiEvent);
+}
 /**
  * This error is thrown when attempting a Budget transfer and arguments aren't of the type `FungibleTransferPayload` or `ERC1155TransferPayload`
  *
@@ -236,6 +268,20 @@ export declare class BudgetMustAuthorizeBoostCore extends Error {
      */
     constructor(boostCoreAddress: string);
 }
+/**
+ * Because this contract is a base implementation, it should not be initialized through the constructor. Instead, it should be cloned and initialized using the {@link BoostRegistry}
+ *
+ * @export
+ * @class MustInitializeBudgetError
+ * @typedef {MustInitializeBudgetError}
+ * @extends {Error}
+ */
+export declare class MustInitializeBudgetError extends Error {
+    /**
+     * Creates an instance of MustInitializeBudgetError.
+     */
+    constructor();
+}
 /**
  * The error is thrown when trying to reuse an existing deployed Incentive that isn't a base implementation.
  * The protocol doesn't allow this.
@@ -254,4 +300,378 @@ export declare class IncentiveNotCloneableError extends Error {
      */
     constructor(incentive: Incentive);
 }
+/**
+ * Thrown when encoding an EventAction payload and no action steps are provided
+ *
+ * @export
+ * @class NoEventActionStepsProvidedError
+ * @typedef {NoEventActionStepsProvidedError}
+ * @extends {Error}
+ */
+export declare class NoEventActionStepsProvidedError extends Error {
+    /**
+     * Creates an instance of NoEventActionStepsProvidedError.
+     *
+     * @constructor
+     */
+    constructor();
+}
+/**
+ * Thrown when encoding an EventAction payload and > 4 steps are provided
+ *
+ * @export
+ * @class TooManyEventActionStepsProvidedError
+ * @typedef {TooManyEventActionStepsProvidedError}
+ * @extends {Error}
+ */
+export declare class TooManyEventActionStepsProvidedError extends Error {
+    /**
+     * Creates an instance of TooManyEventActionStepsProvidedError.
+     *
+     * @constructor
+     */
+    constructor();
+}
+/**
+ * The error is thrown when trying to reuse an existing deployed Incentive that isn't a base implementation.
+ *
+ * @export
+ * @class ValidationAbiMissingError
+ * @typedef {ValidationAbiMissingError}
+ * @extends {Error}
+ */
+export declare class ValidationAbiMissingError extends Error {
+    /**
+     * Creates an instance of ValidationAbiMissingError.
+     *
+     * @constructor
+     * @param {Hex} signature
+     */
+    constructor(signature: Hex);
+}
+/**
+ * Function action validation context to help debug other validation errors
+ *
+ * @interface FunctionActionValidationMeta
+ * @typedef {FunctionActionValidationMeta}
+ */
+interface FunctionActionValidationMeta {
+    decodedArgs: readonly (string | bigint)[];
+    /**
+     * The value pulled off the log being validated against
+     *
+     * @type {*}
+     * biome-ignore lint/suspicious/noExplicitAny: this can be a few different types based on what the log emits
+     */
+    fieldValue: any;
+    /**
+     * The criteria being used to compare during validation
+     *
+     * @type {Criteria}
+     */
+    criteria: Criteria;
+}
+/**
+ * Event action validation context to help debug other validation errors
+ *
+ * @interface EventActionValidationMeta
+ * @typedef {EventActionValidationMeta}
+ */
+interface EventActionValidationMeta {
+    /**
+     * The viem log being validated against
+     *
+     * @type {Log}
+     */
+    log?: EventLogs[0];
+    /**
+     * The value pulled off the log being validated against
+     *
+     * @type {*}
+     * biome-ignore lint/suspicious/noExplicitAny: this can be a few different types based on what the log emits
+     */
+    fieldValue: any;
+    /**
+     * The criteria being used to compare during validation
+     *
+     * @type {Criteria}
+     */
+    criteria: Criteria;
+}
+/**
+ * The base error thrown during event action validation extended by more specific validation errors.
+ * Instantiated with relevent context data for more in depth debugging.
+ *
+ * @export
+ * @class FieldActionValidationError
+ * @typedef {FieldActionValidationError}
+ * @extends {Error}
+ */
+export declare class FieldActionValidationError extends Error {
+    /**
+     * The function input arguments being validated against
+     *
+     * @type {decodedArgs}
+     */
+    decodedArgs?: readonly (string | bigint)[];
+    /**
+     * The viem log being validated against
+     *
+     * @type {Log}
+     */
+    log?: EventLogs[0];
+    /**
+     * The value pulled off the log being validated against
+     *
+     * @type {*}
+     * biome-ignore lint/suspicious/noExplicitAny: this can be a few different types based on what the log emits
+     */
+    fieldValue: any;
+    /**
+     * The criteria being used to compare during validation
+     *
+     * @type {Criteria}
+     */
+    criteria: Criteria;
+    /**
+     * Creates an instance of FieldActionValidationError.
+     *
+     * @constructor
+     * @param {string} message
+     * @param {EventActionValidationMeta} param0
+     * @param {*} param0.fieldValue
+     * @param {Criteria} param0.criteria
+     * @param {Log} param0.log
+     */
+    constructor(message: string, { fieldValue, criteria, ...args }: EventActionValidationMeta | FunctionActionValidationMeta);
+}
+/**
+ * Thrown when abi-decoded args on log is undefined
+ *
+ * @export
+ * @class FieldValueUndefinedError
+ * @typedef {FieldValueUndefinedError}
+ * @extends {FieldActionValidationError}
+ */
+export declare class DecodedArgsMalformedError extends FieldActionValidationError {
+    /**
+     * Creates an instance of DecodedArgsUndefinedError.
+     *
+     * @constructor
+     * @param {DecodedArgsMalformedError} metadata
+     */
+    constructor(metadata: EventActionValidationMeta | FunctionActionValidationMeta);
+}
+/**
+ * Thrown when field value on log is undefined
+ *
+ * @export
+ * @class FieldValueUndefinedError
+ * @typedef {FieldValueUndefinedError}
+ * @extends {FieldActionValidationError}
+ */
+export declare class FieldValueUndefinedError extends FieldActionValidationError {
+    /**
+     * Creates an instance of FieldValueUndefinedError.
+     *
+     * @constructor
+     * @param {EventActionValidationMeta} metadata
+     */
+    constructor(metadata: EventActionValidationMeta | FunctionActionValidationMeta);
+}
+/**
+ * Thrown when a filter type is using a numerical operator but field type is not numerical
+ *
+ * @export
+ * @class InvalidNumericalCriteriaError
+ * @typedef {InvalidNumericalCriteriaError}
+ * @extends {FieldActionValidationError}
+ */
+export declare class InvalidNumericalCriteriaError extends FieldActionValidationError {
+    /**
+     * Creates an instance of InvalidNumericalCriteria.
+     *
+     * @constructor
+     * @param {EventActionValidationMeta} metadata
+     */
+    constructor(metadata: EventActionValidationMeta | FunctionActionValidationMeta);
+}
+/**
+ * Thrown when decoding function data fails.
+ *
+ * @export
+ * @class FunctionDataDecodeError
+ * @typedef {FunctionDataDecodeError}
+ * @extends {Error}
+ */
+export declare class FunctionDataDecodeError extends Error {
+    abi: AbiFunction[];
+    originalError: Error;
+    /**
+     * Creates an instance of FunctionDataDecodeError.
+     *
+     * @constructor
+     * @param {AbiFunction[]} abi - The ABI of the function.
+     * @param {Error} originalError - The original error that was thrown.
+     */
+    constructor(abi: AbiFunction[], originalError: Error);
+}
+/**
+ * Thrown when an the log's field value is being compared a field type that isn't bytes or string during event action validation
+ *
+ * @export
+ * @class FieldValueNotComparableError
+ * @typedef {FieldValueNotComparableError}
+ * @extends {FieldActionValidationError}
+ */
+export declare class FieldValueNotComparableError extends FieldActionValidationError {
+    /**
+     * Creates an instance of FieldValueNotComparableError.
+     *
+     * @constructor
+     * @param {EventActionValidationMeta} metadata
+     */
+    constructor(metadata: EventActionValidationMeta | FunctionActionValidationMeta);
+}
+/**
+ * Thrown when an invalid filter type enum was provided event action validation.
+ *
+ * @export
+ * @class UnrecognizedFilterTypeError
+ * @typedef {UnrecognizedFilterTypeError}
+ * @extends {FieldActionValidationError}
+ */
+export declare class UnrecognizedFilterTypeError extends FieldActionValidationError {
+    /**
+     * Creates an instance of UnrecognizedFilterTypeError.
+     *
+     * @constructor
+     * @param {EventActionValidationMeta} metadata
+     */
+    constructor(metadata: EventActionValidationMeta | FunctionActionValidationMeta);
+}
+/**
+ * Thrown when no chain ID is provided in the Wagmi configuration.
+ *
+ * @export
+ * @class NoConnectedChainIdError
+ * @typedef {NoConnectedChainIdError}
+ * @extends {Error}
+ */
+export declare class NoConnectedChainIdError extends Error {
+    /**
+     * Creates an instance of NoConnectedChainIdError.
+     *
+     * @constructor
+     */
+    constructor();
+}
+/**
+ * Thrown when an invalid chain ID is provided that doesn't match any deployed protocol.
+ *
+ * @export
+ * @class InvalidProtocolChainIdError
+ * @typedef {InvalidProtocolChainIdError}
+ * @extends {Error}
+ */
+export declare class InvalidProtocolChainIdError extends Error {
+    /**
+     * Creates an instance of InvalidProtocolChainIdError.
+     *
+     * @constructor
+     * @param {number} chainId - The chain ID provided in the configuration.
+     * @param {number[]} validChainIds - A list of valid chain IDs where the protocol is deployed.
+     */
+    constructor(chainId: number, validChainIds: number[]);
+}
+/**
+ * Thrown when the incentive criteria cannot be fetched from the contract.
+ *
+ * @export
+ * @class IncentiveCriteriaNotFoundError
+ * @typedef {IncentiveCriteriaNotFoundError}
+ * @extends {Error}
+ */
+export declare class IncentiveCriteriaNotFoundError extends Error {
+    /**
+     * Creates an instance of IncentiveCriteriaNotFoundError.
+     *
+     * @constructor
+     * @param {Error} [e] - Optional error object for further context.
+     * @param {string} [message='Unable to fetch Incentive Criteria from contract'] - Custom error message.
+     */
+    constructor(e?: Error, message?: string);
+}
+/**
+ * Thrown when no matching logs are found for a given event signature.
+ *
+ * @export
+ * @class NoMatchingLogsError
+ * @typedef {NoMatchingLogsError}
+ * @extends {Error}
+ */
+export declare class NoMatchingLogsError extends Error {
+    /**
+     * Creates an instance of NoMatchingLogsError.
+     *
+     * @constructor
+     * @param {string} signature - The event signature for which logs are being searched.
+     * @param {string} [message] - Optional custom error message.
+     */
+    constructor(signature: string, message?: string);
+}
+/**
+ * Thrown when an invalid criteria type is provided.
+ *
+ * @export
+ * @class InvalidCriteriaTypeError
+ * @typedef {InvalidCriteriaTypeError}
+ * @extends {Error}
+ */
+export declare class InvalidCriteriaTypeError extends Error {
+    /**
+     * Creates an instance of InvalidCriteriaTypeError.
+     *
+     * @constructor
+     * @param {string} [criteriaType='unknown'] - The invalid criteria type that was provided.
+     * @param {string} [message] - Optional custom error message.
+     */
+    constructor(criteriaType?: string, message?: string);
+}
+/**
+ * Thrown when decoding function arguments fails.
+ *
+ * @export
+ * @class DecodedArgsError
+ * @typedef {DecodedArgsError}
+ * @extends {Error}
+ */
+export declare class DecodedArgsError extends Error {
+    /**
+     * Creates an instance of DecodedArgsError.
+     *
+     * @constructor
+     * @param {string} [message='Issue decoding args'] - Custom error message.
+     */
+    constructor(message?: string);
+}
+/**
+ * Thrown when reading a Boost that does not exist
+ *
+ * @export
+ * @class BoostNotFoundError
+ * @typedef {BoostNotFoundError}
+ * @extends {Error}
+ */
+export declare class BoostNotFoundError extends Error {
+    readonly id: string;
+    /**
+     * Creates an instance of BoostNotFoundError.
+     *
+     * @constructor
+     * @param {string} [id] - stringified boost id that does not exist
+     */
+    constructor(id: string);
+}
+export {};
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,GAAG,EACR,KAAK,mCAAmC,EAEzC,MAAM,MAAM,CAAC;AACd,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD;;;;;;;;;;;;;;;GAeG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD;;;;OAIG;;CAIJ;AAED;;;;;;;;;;;;;;GAcG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD;;;;OAIG;;CAIJ;AAED;;;;;;;GAOG;AACH,qBAAa,8BAA+B,SAAQ,KAAK;IACvD;;;;OAIG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB;;;;;OAKG;gBACS,OAAO,EAAE,MAAM;CAM5B;AAED;;;;;;;GAOG;AACH,qBAAa,yCAA0C,SAAQ,KAAK;IAClE;;;;OAIG;;CAMJ;AAED;;;;;;;GAOG;AACH,qBAAa,mCAAoC,SAAQ,KAAK;IAC5D;;;;OAIG;;CAMJ;AAED;;;;;;;GAOG;AACH,qBAAa,yCAA0C,SAAQ,KAAK;IAClE;;;;OAIG;;CAMJ;AAED;;;;;;;GAOG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;IACtD;;;;OAIG;;CAMJ;AAED;;;;;;;GAOG;AACH,qBAAa,iCAAkC,SAAQ,KAAK;IAC1D;;;;;;OAMG;IACH,SAAgB,OAAO,EAAE,mCAAmC,CAAC;IAC7D;;;;;OAKG;gBACS,OAAO,EAAE,mCAAmC;CAMzD;AAED;;;;;;;;GAQG;AACH,qBAAa,8BAA+B,SAAQ,KAAK;IACvD;;;;;;OAMG;IACH,SAAgB,QAAQ,EAAE,GAAG,EAAE,CAAM;IACrC;;;;;;OAMG;IACH,SAAgB,QAAQ,EAAE,GAAG,CAAY;IAEzC;;;;;;OAMG;gBACS,QAAQ,EAAE,GAAG,EAAE,EAAE,QAAQ,EAAE,GAAG;CAO3C;AAED;;;;;;;;;GASG;AACH,qBAAa,8BAA+B,SAAQ,KAAK;IACvD;;;;OAIG;IACH,QAAQ,EAAE,OAAO,CAAC;IAClB;;;;;OAKG;gBACS,QAAQ,EAAE,OAAO;CAO9B;AAED;;;;;;;GAOG;AACH,qBAAa,4BAA6B,SAAQ,KAAK;IACrD;;;;;OAKG;gBACS,gBAAgB,EAAE,MAAM;CAKrC;AAED;;;;;;;;GAQG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;IACnD;;;;;OAKG;gBACS,SAAS,EAAE,SAAS;CAGjC"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}