@boostxyz/sdk 0.0.0-alpha.16 → 0.0.0-alpha.18

package/dist/errors.cjs

@@ -1,2 +1,2 @@
-"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 m 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 y 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 g extends Error{constructor(r){super("Did not provide a valid FungibleTransferPayload or ERC1155 transfer payload.",{cause:r}),this.received=r}}class v 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 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 I extends t{constructor(r){super("Numerical comparisons cannot be used with non-numerical criteria",r)}}class P extends Error{constructor(r,o){super(`Failed to decode function data: ${o.message}`),this.name="FunctionDataDecodeError",this.abi=r,this.originalError=o}}class w 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 N extends Error{constructor(){super("Provided Wagmi configuration does not define `chainId` property with which to target protocol contracts")}}class B extends Error{constructor(r,o){super(`Provided Wagmi configuration supplied a "chainId" where protocol is not deployed, provided: ${r}, but valid chains are: ${o}`)}}exports.BoostCoreNoIdentifierEmitted=i;exports.BudgetMustAuthorizeBoostCore=v;exports.ContractAddressRequiredError=d;exports.DecodedArgsMalformedError=A;exports.DeployableAlreadyDeployedError=c;exports.DeployableBuildParametersUnspecifiedError=l;exports.DeployableMissingPayloadError=E;exports.DeployableUnknownOwnerProvidedError=u;exports.DeployableWagmiConfigurationRequiredError=p;exports.FieldActionValidationError=t;exports.FieldValueNotComparableError=w;exports.FieldValueUndefinedError=D;exports.FunctionDataDecodeError=P;exports.IncentiveNotCloneableError=x;exports.InvalidComponentInterfaceError=m;exports.InvalidNumericalCriteriaError=I;exports.InvalidProtocolChainIdError=B;exports.MustInitializeBudgetError=b;exports.NoConnectedChainIdError=N;exports.NoContractAddressUponReceiptError=h;exports.NoEventActionStepsProvidedError=f;exports.TooManyEventActionStepsProvidedError=C;exports.UnknownTransferPayloadSupplied=g;exports.UnparseableAbiParamError=y;exports.UnrecognizedFilterTypeError=F;
+"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 g extends Error{constructor(r){super("Expected a contract address to exist on receipt.",{cause:r}),this.receipt=r}}class h 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 A extends Error{constructor(){super("Logs are required for validation")}}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 D extends t{constructor(r){super("Decoded Args are malformed; Check which params are indexed",r)}}class N extends t{constructor(r){super("Field value is undefined",r)}}class P 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 F extends t{constructor(r){super("Filter can only be used with bytes or string field type",r)}}class M 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 U 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 T extends Error{constructor(r,o="Unable to fetch Incentive Criteria from contract"){super(o+(r?`: ${r.message}`:"")),this.name="IncentiveCriteriaNotFoundError"}}class V 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"}}exports.BoostCoreNoIdentifierEmitted=i;exports.BudgetMustAuthorizeBoostCore=y;exports.ContractAddressRequiredError=d;exports.DecodedArgsError=z;exports.DecodedArgsMalformedError=D;exports.DeployableAlreadyDeployedError=c;exports.DeployableBuildParametersUnspecifiedError=l;exports.DeployableMissingPayloadError=E;exports.DeployableUnknownOwnerProvidedError=u;exports.DeployableWagmiConfigurationRequiredError=p;exports.FieldActionValidationError=t;exports.FieldValueNotComparableError=F;exports.FieldValueUndefinedError=N;exports.FunctionDataDecodeError=w;exports.IncentiveCriteriaNotFoundError=T;exports.IncentiveNotCloneableError=x;exports.InvalidComponentInterfaceError=h;exports.InvalidCriteriaTypeError=$;exports.InvalidNumericalCriteriaError=P;exports.InvalidProtocolChainIdError=U;exports.MustInitializeBudgetError=b;exports.NoConnectedChainIdError=B;exports.NoContractAddressUponReceiptError=g;exports.NoEventActionStepsProvidedError=f;exports.NoMatchingLogsError=V;exports.TooManyEventActionStepsProvidedError=C;exports.UnknownTransferPayloadSupplied=v;exports.UnparseableAbiParamError=m;exports.UnrecognizedFilterTypeError=M;exports.ValidationAbiMissingError=I;exports.ValidationLogsMissingError=A;
 //# sourceMappingURL=errors.cjs.map

package/dist/errors.cjs.map

@@ -1 +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 * 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\nexport class NoConnectedChainIdError extends Error {\n  constructor() {\n    super(\n      'Provided Wagmi configuration does not define `chainId` property with which to target protocol contracts',\n    );\n  }\n}\n\nexport class InvalidProtocolChainIdError extends Error {\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  }\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","FieldActionValidationError","message","fieldValue","criteria","args","DecodedArgsMalformedError","metadata","FieldValueUndefinedError","InvalidNumericalCriteriaError","FunctionDataDecodeError","abi","originalError","FieldValueNotComparableError","UnrecognizedFilterTypeError","NoConnectedChainIdError","InvalidProtocolChainIdError","chainId","validChainIds"],"mappings":"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"}
+{"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 * Thrown when missing logs for validating action steps.\n *\n * @export\n * @class ValidationLogsMissingError\n * @typedef {ValidationLogsMissingError}\n * @extends {Error}\n */\nexport class ValidationLogsMissingError extends Error {\n  /**\n   * Creates an instance of ValidationLogsMissingError.\n   *\n   * @constructor\n   */\n  constructor() {\n    super('Logs are required for validation');\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"],"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","ValidationLogsMissingError","FieldActionValidationError","message","fieldValue","criteria","args","DecodedArgsMalformedError","metadata","FieldValueUndefinedError","InvalidNumericalCriteriaError","FunctionDataDecodeError","abi","originalError","FieldValueNotComparableError","UnrecognizedFilterTypeError","NoConnectedChainIdError","InvalidProtocolChainIdError","chainId","validChainIds","IncentiveCriteriaNotFoundError","e","NoMatchingLogsError","InvalidCriteriaTypeError","criteriaType","DecodedArgsError"],"mappings":"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"}

package/dist/errors.d.ts

@@ -332,6 +332,39 @@ export declare class TooManyEventActionStepsProvidedError extends Error {
      */
     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);
+}
+/**
+ * Thrown when missing logs for validating action steps.
+ *
+ * @export
+ * @class ValidationLogsMissingError
+ * @typedef {ValidationLogsMissingError}
+ * @extends {Error}
+ */
+export declare class ValidationLogsMissingError extends Error {
+    /**
+     * Creates an instance of ValidationLogsMissingError.
+     *
+     * @constructor
+     */
+    constructor();
+}
 /**
  * Function action validation context to help debug other validation errors
  *
@@ -533,11 +566,110 @@ export declare class UnrecognizedFilterTypeError extends FieldActionValidationEr
      */
     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);
+}
 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":"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"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/errors.js

@@ -1,5 +1,5 @@
-import { zeroHash as n } from "viem";
-class d extends Error {
+import { zeroHash as a } from "viem";
+class c extends Error {
   /**
    * Creates an instance of BoostCoreNoIdentifierEmitted.
    *
@@ -9,7 +9,7 @@ class d extends Error {
     super('No "BoostCreated" log was emitted from which to extract boostId');
   }
 }
-class i extends Error {
+class d extends Error {
   /**
    * Creates an instance of ContractAddressRequiredError.
    *
@@ -80,7 +80,7 @@ class h extends Error {
     );
   }
 }
-class m extends Error {
+class g extends Error {
   /**
    * Creates an instance of NoContractAddressUponReceiptError.
    *
@@ -93,7 +93,7 @@ class m extends Error {
     }), this.receipt = r;
   }
 }
-class x extends Error {
+class m extends Error {
   /**
    * Creates an instance of InvalidComponentInterfaceError.
    *
@@ -104,10 +104,10 @@ class x extends Error {
   constructor(r, o) {
     super("Address provided does not match any expected protocol interface", {
       cause: { expected: r, received: o }
-    }), this.expected = [], this.received = n, this.expected = r, this.received = o;
+    }), this.expected = [], this.received = a, this.expected = r, this.received = o;
   }
 }
-class g extends Error {
+class x extends Error {
   /**
    * Creates an instance of UnknownTransferPayloadSupplied.
    *
@@ -122,7 +122,7 @@ class g extends Error {
     ), this.event = o, this.input_param_idx = r;
   }
 }
-class y extends Error {
+class v extends Error {
   /**
    * Creates an instance of UnknownTransferPayloadSupplied.
    *
@@ -136,7 +136,7 @@ class y extends Error {
     ), this.received = r;
   }
 }
-class v extends Error {
+class y extends Error {
   /**
    * Creates an instance of BudgetMustAuthorizeBoostCore.
    *
@@ -168,7 +168,7 @@ class f extends Error {
     super(`Incentive not cloneable: ${r.constructor.name}`);
   }
 }
-class w extends Error {
+class I extends Error {
   /**
    * Creates an instance of NoEventActionStepsProvidedError.
    *
@@ -190,6 +190,27 @@ class C extends Error {
     );
   }
 }
+class A extends Error {
+  /**
+   * Creates an instance of ValidationAbiMissingError.
+   *
+   * @constructor
+   * @param {Hex} signature
+   */
+  constructor(r) {
+    super(`No known ABI for given signature: ${r}`);
+  }
+}
+class w extends Error {
+  /**
+   * Creates an instance of ValidationLogsMissingError.
+   *
+   * @constructor
+   */
+  constructor() {
+    super("Logs are required for validation");
+  }
+}
 class t extends Error {
   /**
    * Creates an instance of FieldActionValidationError.
@@ -203,10 +224,10 @@ class t extends Error {
    */
   constructor(r, {
     fieldValue: o,
-    criteria: a,
+    criteria: n,
     ...s
   }) {
-    switch (super(r), this.fieldValue = o, this.criteria = a, !0) {
+    switch (super(r), this.fieldValue = o, this.criteria = n, !0) {
       case "log" in s:
         this.log = s.log;
         break;
@@ -215,7 +236,7 @@ class t extends Error {
     }
   }
 }
-class A extends t {
+class D extends t {
   /**
    * Creates an instance of DecodedArgsUndefinedError.
    *
@@ -229,7 +250,7 @@ class A extends t {
     );
   }
 }
-class D extends t {
+class N extends t {
   /**
    * Creates an instance of FieldValueUndefinedError.
    *
@@ -240,7 +261,7 @@ class D extends t {
     super("Field value is undefined", r);
   }
 }
-class I extends t {
+class P extends t {
   /**
    * Creates an instance of InvalidNumericalCriteria.
    *
@@ -254,7 +275,7 @@ class I extends t {
     );
   }
 }
-class P extends Error {
+class F extends Error {
   /**
    * Creates an instance of FunctionDataDecodeError.
    *
@@ -266,7 +287,7 @@ class P extends Error {
     super(`Failed to decode function data: ${o.message}`), this.name = "FunctionDataDecodeError", this.abi = r, this.originalError = o;
   }
 }
-class F extends t {
+class B extends t {
   /**
    * Creates an instance of FieldValueNotComparableError.
    *
@@ -277,7 +298,7 @@ class F extends t {
     super("Filter can only be used with bytes or string field type", r);
   }
 }
-class B extends t {
+class $ extends t {
   /**
    * Creates an instance of UnrecognizedFilterTypeError.
    *
@@ -288,45 +309,110 @@ class B extends t {
     super("Invalid FilterType provided", r);
   }
 }
-class N extends Error {
+class M extends Error {
+  /**
+   * Creates an instance of NoConnectedChainIdError.
+   *
+   * @constructor
+   */
   constructor() {
     super(
       "Provided Wagmi configuration does not define `chainId` property with which to target protocol contracts"
-    );
+    ), this.name = "NoConnectedChainIdError";
   }
 }
 class U 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(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 T 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(r, o = "Unable to fetch Incentive Criteria from contract") {
+    super(o + (r ? `: ${r.message}` : "")), this.name = "IncentiveCriteriaNotFoundError";
+  }
+}
+class k 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(r, o = `No logs found for event signature ${r}`) {
+    super(o), this.name = "NoMatchingLogsError";
+  }
+}
+class z 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(r = "unknown", o = `Invalid criteria type ${r}`) {
+    super(o), this.name = "InvalidCriteriaTypeError";
+  }
+}
+class V extends Error {
+  /**
+   * Creates an instance of DecodedArgsError.
+   *
+   * @constructor
+   * @param {string} [message='Issue decoding args'] - Custom error message.
+   */
+  constructor(r = "Issue decoding args") {
+    super(r), this.name = "DecodedArgsError";
   }
 }
 export {
-  d as BoostCoreNoIdentifierEmitted,
-  v as BudgetMustAuthorizeBoostCore,
-  i as ContractAddressRequiredError,
-  A as DecodedArgsMalformedError,
+  c as BoostCoreNoIdentifierEmitted,
+  y as BudgetMustAuthorizeBoostCore,
+  d as ContractAddressRequiredError,
+  V as DecodedArgsError,
+  D as DecodedArgsMalformedError,
   l as DeployableAlreadyDeployedError,
   u as DeployableBuildParametersUnspecifiedError,
   h as DeployableMissingPayloadError,
   p as DeployableUnknownOwnerProvidedError,
   E as DeployableWagmiConfigurationRequiredError,
   t as FieldActionValidationError,
-  F as FieldValueNotComparableError,
-  D as FieldValueUndefinedError,
-  P as FunctionDataDecodeError,
+  B as FieldValueNotComparableError,
+  N as FieldValueUndefinedError,
+  F as FunctionDataDecodeError,
+  T as IncentiveCriteriaNotFoundError,
   f as IncentiveNotCloneableError,
-  x as InvalidComponentInterfaceError,
-  I as InvalidNumericalCriteriaError,
+  m as InvalidComponentInterfaceError,
+  z as InvalidCriteriaTypeError,
+  P as InvalidNumericalCriteriaError,
   U as InvalidProtocolChainIdError,
   b as MustInitializeBudgetError,
-  N as NoConnectedChainIdError,
-  m as NoContractAddressUponReceiptError,
-  w as NoEventActionStepsProvidedError,
+  M as NoConnectedChainIdError,
+  g as NoContractAddressUponReceiptError,
+  I as NoEventActionStepsProvidedError,
+  k as NoMatchingLogsError,
   C as TooManyEventActionStepsProvidedError,
-  y as UnknownTransferPayloadSupplied,
-  g as UnparseableAbiParamError,
-  B as UnrecognizedFilterTypeError
+  v as UnknownTransferPayloadSupplied,
+  x as UnparseableAbiParamError,
+  $ as UnrecognizedFilterTypeError,
+  A as ValidationAbiMissingError,
+  w as ValidationLogsMissingError
 };
 //# sourceMappingURL=errors.js.map