@boostxyz/sdk 0.0.0-alpha.19 → 0.0.0-alpha.20

package/dist/index.js

@@ -1,12 +1,12 @@
 import { BOOST_REGISTRY_ADDRESS as o, BOOST_REGISTRY_ADDRESSES as a, BoostRegistry as t } from "./BoostRegistry.js";
-import { a as n, b as s, B as p, c as l, E as d, p as E } from "./BoostCore-kwoUw7YE.js";
+import { a as n, b as p, B as s, c as l, E as d, p as E } from "./BoostCore-DVGBUr2y.js";
 import { Boost as c, prepareBoostPayload as A } from "./Boost.js";
 import { ActionByComponentInterface as f, actionFromAddress as C } from "./Actions/Action.js";
-import { E as I, F as b, P as v, S, i as P, p as R } from "./EventAction-D5tnm00s.js";
+import { E as b, F as g, P as v, S, i as P, p as R } from "./EventAction-CIPqmAoP.js";
 import { AllowListByComponentInterface as x, OpenAllowList as D, allowListFromAddress as B } from "./AllowLists/AllowList.js";
-import { LIST_MANAGER_ROLE as F, SimpleAllowList as L, prepareSimpleAllowListPayload as O } from "./AllowLists/SimpleAllowList.js";
-import { S as w, p as M } from "./SimpleDenyList-Cn5WpNn0.js";
-import { BudgetByComponentInterface as h, budgetFromAddress as N } from "./Budgets/Budget.js";
+import { LIST_MANAGER_ROLE as F, SimpleAllowList as O, prepareSimpleAllowListPayload as L } from "./AllowLists/SimpleAllowList.js";
+import { S as w, p as _ } from "./SimpleDenyList-Cn5WpNn0.js";
+import { BudgetByComponentInterface as M, budgetFromAddress as N } from "./Budgets/Budget.js";
 import { ManagedBudget as G, ManagedBudgetRoles as z, isERC1155TransferPayload as k, isFungibleTransfer as q, prepareManagedBudgetPayload as W, prepareTransfer as Y } from "./Budgets/ManagedBudget.js";
 import { Deployable as H } from "./Deployable/Deployable.js";
 import { Contract as K } from "./Deployable/Contract.js";
@@ -14,54 +14,54 @@ import { DeployableTarget as X } from "./Deployable/DeployableTarget.js";
 import { DeployableTargetWithRBAC as $, Roles as ee } from "./Deployable/DeployableTargetWithRBAC.js";
 import { AllowListIncentive as oe, prepareAllowListIncentivePayload as ae } from "./Incentives/AllowListIncentive.js";
 import { CGDAIncentive as ie, prepareCGDAIncentivePayload as ne } from "./Incentives/CGDAIncentive.js";
-import { ERC20Incentive as pe, prepareERC20IncentivePayload as le } from "./Incentives/ERC20Incentive.js";
+import { ERC20Incentive as se, prepareERC20IncentivePayload as le } from "./Incentives/ERC20Incentive.js";
 import { E as Ee, I as me, i as ce, p as Ae } from "./Incentive-Bp8Sez7M.js";
 import { PointsIncentive as fe, preparePointsIncentivePayload as Ce } from "./Incentives/PointsIncentive.js";
-import { SignerValidator as Ie, prepareSignerValidatorClaimDataPayload as be, prepareSignerValidatorInputParams as ve, prepareSignerValidatorPayload as Se } from "./Validators/SignerValidator.js";
+import { SignerValidator as be, prepareSignerValidatorClaimDataPayload as ge, prepareSignerValidatorInputParams as ve, prepareSignerValidatorPayload as Se } from "./Validators/SignerValidator.js";
 import { ValidatorByComponentInterface as Re, validatorFromAddress as ue } from "./Validators/Validator.js";
-import { BoostCoreNoIdentifierEmitted as De, BudgetMustAuthorizeBoostCore as Be, ContractAddressRequiredError as Te, DecodedArgsError as Fe, DecodedArgsMalformedError as Le, DeployableAlreadyDeployedError as Oe, DeployableBuildParametersUnspecifiedError as Ve, DeployableMissingPayloadError as we, DeployableUnknownOwnerProvidedError as Me, DeployableWagmiConfigurationRequiredError as _e, FieldActionValidationError as he, FieldValueNotComparableError as Ne, FieldValueUndefinedError as Ue, FunctionDataDecodeError as Ge, IncentiveCriteriaNotFoundError as ze, IncentiveNotCloneableError as ke, InvalidComponentInterfaceError as qe, InvalidCriteriaTypeError as We, InvalidNumericalCriteriaError as Ye, InvalidProtocolChainIdError as je, MustInitializeBudgetError as He, NoConnectedChainIdError as Je, NoContractAddressUponReceiptError as Ke, NoEventActionStepsProvidedError as Qe, NoMatchingLogsError as Xe, TooManyEventActionStepsProvidedError as Ze, UnknownTransferPayloadSupplied as $e, UnparseableAbiParamError as er, UnrecognizedFilterTypeError as rr, ValidationAbiMissingError as or, ValidationLogsMissingError as ar } from "./errors.js";
-import { RegistryType as ir, assertValidAddressByChainId as nr, awaitResult as sr, bytes4 as pr, getDeployedContractAddress as lr } from "./utils.js";
-import { StrategyType as Er, prepareClaimPayload as mr } from "./claiming.js";
-import { AssetType as Ar, prepareERC1155Payload as yr, prepareERC1155Transfer as fr, prepareFungiblePayload as Cr, prepareFungibleTransfer as gr, prepareTransferPayload as Ir } from "./transfers.js";
-import { PassthroughAuth as vr } from "./Auth/PassthroughAuth.js";
-import { R as Pr, b as Rr, a as ur, g as xr, T as Dr, O as Br, l as Tr, d as Fr, c as Lr, z as Or, x as Vr, A as wr, I as Mr } from "./generated-B7VaSah4.js";
+import { BoostCoreNoIdentifierEmitted as De, BudgetMustAuthorizeBoostCore as Be, ContractAddressRequiredError as Te, DecodedArgsError as Fe, DecodedArgsMalformedError as Oe, DeployableAlreadyDeployedError as Le, DeployableBuildParametersUnspecifiedError as Ve, DeployableMissingPayloadError as we, DeployableUnknownOwnerProvidedError as _e, DeployableWagmiConfigurationRequiredError as he, FieldActionValidationError as Me, FieldValueNotComparableError as Ne, FieldValueUndefinedError as Ue, FunctionDataDecodeError as Ge, IncentiveCriteriaNotFoundError as ze, IncentiveNotCloneableError as ke, InvalidComponentInterfaceError as qe, InvalidCriteriaTypeError as We, InvalidNumericalCriteriaError as Ye, InvalidProtocolChainIdError as je, MustInitializeBudgetError as He, NoConnectedChainIdError as Je, NoContractAddressUponReceiptError as Ke, NoEventActionStepsProvidedError as Qe, NoMatchingLogsError as Xe, TooManyEventActionStepsProvidedError as Ze, UnknownTransferPayloadSupplied as $e, UnparseableAbiParamError as er, UnrecognizedFilterTypeError as rr, ValidationAbiMissingError as or } from "./errors.js";
+import { RegistryType as tr, assertValidAddressByChainId as ir, awaitResult as nr, bytes4 as pr, getDeployedContractAddress as sr } from "./utils.js";
+import { StrategyType as dr, prepareClaimPayload as Er } from "./claiming.js";
+import { AssetType as cr, prepareERC1155Payload as Ar, prepareERC1155Transfer as yr, prepareFungiblePayload as fr, prepareFungibleTransfer as Cr, prepareTransferPayload as Ir } from "./transfers.js";
+import { PassthroughAuth as gr } from "./Auth/PassthroughAuth.js";
+import { R as Sr, b as Pr, a as Rr, g as ur, T as xr, O as Dr, l as Br, d as Tr, c as Fr, z as Or, x as Lr, A as Vr, I as wr } from "./generated-B7VaSah4.js";
 export {
   f as ActionByComponentInterface,
   x as AllowListByComponentInterface,
   oe as AllowListIncentive,
-  Ar as AssetType,
+  cr as AssetType,
   n as BOOST_CORE_ADDRESS,
-  s as BOOST_CORE_ADDRESSES,
-  p as BOOST_CORE_CLAIM_FEE,
+  p as BOOST_CORE_ADDRESSES,
+  s as BOOST_CORE_CLAIM_FEE,
   o as BOOST_REGISTRY_ADDRESS,
   a as BOOST_REGISTRY_ADDRESSES,
   c as Boost,
   l as BoostCore,
   De as BoostCoreNoIdentifierEmitted,
   t as BoostRegistry,
-  h as BudgetByComponentInterface,
+  M as BudgetByComponentInterface,
   Be as BudgetMustAuthorizeBoostCore,
   ie as CGDAIncentive,
   K as Contract,
   Te as ContractAddressRequiredError,
   Fe as DecodedArgsError,
-  Le as DecodedArgsMalformedError,
+  Oe as DecodedArgsMalformedError,
   H as Deployable,
-  Oe as DeployableAlreadyDeployedError,
+  Le as DeployableAlreadyDeployedError,
   Ve as DeployableBuildParametersUnspecifiedError,
   we as DeployableMissingPayloadError,
   X as DeployableTarget,
   $ as DeployableTargetWithRBAC,
-  Me as DeployableUnknownOwnerProvidedError,
-  _e as DeployableWagmiConfigurationRequiredError,
-  pe as ERC20Incentive,
+  _e as DeployableUnknownOwnerProvidedError,
+  he as DeployableWagmiConfigurationRequiredError,
+  se as ERC20Incentive,
   d as ERC20VariableCriteriaIncentive,
   Ee as ERC20VariableIncentive,
-  I as EventAction,
-  he as FieldActionValidationError,
+  b as EventAction,
+  Me as FieldActionValidationError,
   Ne as FieldValueNotComparableError,
   Ue as FieldValueUndefinedError,
-  b as FilterType,
+  g as FilterType,
   Ge as FunctionDataDecodeError,
   me as IncentiveByComponentInterface,
   ze as IncentiveCriteriaNotFoundError,
@@ -79,68 +79,67 @@ export {
   Qe as NoEventActionStepsProvidedError,
   Xe as NoMatchingLogsError,
   D as OpenAllowList,
-  vr as PassthroughAuth,
+  gr as PassthroughAuth,
   fe as PointsIncentive,
   v as PrimitiveType,
-  ir as RegistryType,
+  tr as RegistryType,
   ee as Roles,
   S as SignatureType,
-  Ie as SignerValidator,
-  L as SimpleAllowList,
+  be as SignerValidator,
+  O as SimpleAllowList,
   w as SimpleDenyList,
-  Er as StrategyType,
+  dr as StrategyType,
   Ze as TooManyEventActionStepsProvidedError,
   $e as UnknownTransferPayloadSupplied,
   er as UnparseableAbiParamError,
   rr as UnrecognizedFilterTypeError,
   or as ValidationAbiMissingError,
-  ar as ValidationLogsMissingError,
   Re as ValidatorByComponentInterface,
   C as actionFromAddress,
   B as allowListFromAddress,
-  Pr as allowListIncentiveAbi,
-  nr as assertValidAddressByChainId,
-  sr as awaitResult,
-  Rr as boostCoreAbi,
-  ur as boostRegistryAbi,
+  Sr as allowListIncentiveAbi,
+  ir as assertValidAddressByChainId,
+  nr as awaitResult,
+  Pr as boostCoreAbi,
+  Rr as boostRegistryAbi,
   N as budgetFromAddress,
   pr as bytes4,
-  xr as cgdaIncentiveAbi,
-  Dr as erc20IncentiveAbi,
-  Br as erc20VariableIncentiveAbi,
-  lr as getDeployedContractAddress,
+  ur as cgdaIncentiveAbi,
+  xr as erc20IncentiveAbi,
+  Dr as erc20VariableIncentiveAbi,
+  sr as getDeployedContractAddress,
   ce as incentiveFromAddress,
   k as isERC1155TransferPayload,
   P as isEventActionPayloadSimple,
   q as isFungibleTransfer,
-  Tr as managedBudgetAbi,
-  Fr as passthroughAuthAbi,
-  Lr as pointsIncentiveAbi,
+  Br as managedBudgetAbi,
+  Tr as passthroughAuthAbi,
+  Fr as pointsIncentiveAbi,
   ae as prepareAllowListIncentivePayload,
   A as prepareBoostPayload,
   ne as prepareCGDAIncentivePayload,
-  mr as prepareClaimPayload,
-  yr as prepareERC1155Payload,
-  fr as prepareERC1155Transfer,
+  Er as prepareClaimPayload,
+  Ar as prepareERC1155Payload,
+  yr as prepareERC1155Transfer,
   le as prepareERC20IncentivePayload,
   E as prepareERC20VariableCriteriaIncentivePayload,
   Ae as prepareERC20VariableIncentivePayload,
   R as prepareEventActionPayload,
-  Cr as prepareFungiblePayload,
-  gr as prepareFungibleTransfer,
+  fr as prepareFungiblePayload,
+  Cr as prepareFungibleTransfer,
   W as prepareManagedBudgetPayload,
   Ce as preparePointsIncentivePayload,
-  be as prepareSignerValidatorClaimDataPayload,
+  ge as prepareSignerValidatorClaimDataPayload,
   ve as prepareSignerValidatorInputParams,
   Se as prepareSignerValidatorPayload,
-  O as prepareSimpleAllowListPayload,
-  M as prepareSimpleDenyListPayload,
+  L as prepareSimpleAllowListPayload,
+  _ as prepareSimpleDenyListPayload,
   Y as prepareTransfer,
   Ir as prepareTransferPayload,
   Or as rbacAbi,
-  Vr as signerValidatorAbi,
-  wr as simpleAllowListAbi,
-  Mr as simpleDenyListAbi,
+  Lr as signerValidatorAbi,
+  Vr as simpleAllowListAbi,
+  wr as simpleDenyListAbi,
   ue as validatorFromAddress
 };
 //# sourceMappingURL=index.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@boostxyz/sdk",
-  "version": "0.0.0-alpha.19",
+  "version": "0.0.0-alpha.20",
   "license": "GPL-3.0-or-later",
   "type": "module",
   "files": [

package/src/Actions/EventAction.test.ts

@@ -482,6 +482,34 @@ describe("EventAction Event Selector", () => {
         expect(await action.validateActionSteps({ hash, chainId })).toBe(true);
       });
     });
+
+    test("can derive the claimant from an event action", async () => {
+      const action = await loadFixture(cloneEventAction(fixtures, erc721));
+      const recipient = accounts[1].account;
+      await erc721.approve(recipient, 1n);
+      const { hash } = await erc721.transferFromRaw(defaultOptions.account.address, recipient, 1n);
+      expect(
+        await action.deriveActionClaimantFromTransaction(await action.getActionClaimant(), {
+          hash,
+          chainId,
+        }),
+      ).toBe(recipient);
+    });
+
+    test("can derive the claimant from a function action", async () => {
+      const action = await loadFixture(cloneFunctionAction(fixtures, erc721));
+      const recipient = accounts[1].account;
+      const { hash } = await erc721.mintRaw(recipient, {
+        value: parseEther(".1"),
+      });
+
+      expect(
+        await action.deriveActionClaimantFromTransaction(await action.getActionClaimant(), {
+          hash,
+          chainId,
+        }),
+      ).toBe(recipient);
+    });
   });
 });
 

package/src/Actions/EventAction.ts

@@ -8,11 +8,17 @@ import {
 import { bytecode } from '@boostxyz/evm/artifacts/contracts/actions/EventAction.sol/EventAction.json';
 import events from '@boostxyz/signatures/events';
 import functions from '@boostxyz/signatures/functions';
+import {
+  GetTransactionReceiptParameters,
+  getTransaction,
+  getTransactionReceipt,
+} from '@wagmi/core';
 import { match } from 'ts-pattern';
 import {
   type Abi,
   type AbiEvent,
   type AbiFunction,
+  AbiItem,
   type Address,
   type ContractEventName,
   type ContractFunctionName,
@@ -26,6 +32,7 @@ import {
   decodeFunctionData,
   encodeAbiParameters,
   fromHex,
+  isAddress,
   isAddressEqual,
 } from 'viem';
 import { EventAction as EventActionBases } from '../../dist/deployments.json';
@@ -45,7 +52,6 @@ import {
   UnparseableAbiParamError,
   UnrecognizedFilterTypeError,
   ValidationAbiMissingError,
-  ValidationLogsMissingError,
 } from '../errors';
 import {
   type GetLogsParams,
@@ -220,15 +226,15 @@ export interface ActionStep {
  * Parameters for validating an action step.
  *
  * @typedef {Object} ValidateActionStepParams
- * @property {Record<Hex, AbiEvent>} [knownEvents] - Optional record of known events, keyed by their hex signature.
- * @property {AbiEvent} [event] - Optional ABI event definition.
+ * @property {Record<Hex, AbiEvent | AbiFunction>} [knownSignatures] - Optional record of known events, keyed by 32 byte selectors.
+ * @property {AbiEvent | AbiFunction} [abiItem] - Optional ABI item definition.
  * @property {EventLogs} [logs] - Event logs to validate against. Required if 'hash' is not provided.
  * @property {Hex} [hash] - Transaction hash to validate against. Required if 'logs' is not provided.
  * @property {number} [chainId] - Chain ID for the transaction. Required if 'hash' is provided.
  */
 export type ValidateActionStepParams = {
-  knownEvents?: Record<Hex, AbiEvent>;
-  event?: AbiEvent;
+  knownSignatures?: Record<Hex, AbiEvent | AbiFunction>;
+  abiItem?: AbiEvent | AbiFunction;
 } & ({ logs: EventLogs } | { hash: Hex; chainId: number });
 
 /**
@@ -432,7 +438,7 @@ export class EventAction extends DeployableTarget<
    */
   public async getActionClaimant(
     params?: ReadEventActionParams<'getActionClaimant'>,
-  ) {
+  ): Promise<ActionClaimant> {
     const result = (await readEventActionGetActionClaimant(this._config, {
       address: this.assertValidAddress(),
       ...this.optionallyAttachAccount(),
@@ -481,6 +487,141 @@ export class EventAction extends DeployableTarget<
     return { hash, result };
   }
 
+  /**
+   * Derives the action claimant address from a transaction based on the provided ActionClaimant configuration.
+   * This method supports both event-based and function-based claimant derivation.
+   *
+   ** @example
+   * // Example usage
+   * const eventAction = boost.action as EventAction
+   * const claimant = await eventAction.getActionClaimant() // {
+   *   signatureType: SignatureType.EVENT,
+   *   signature: '0x1234...',
+   *   fieldIndex: 2,
+   *   targetContract: '0xabcd...',
+   *   chainid: 1
+   * };
+   * const params: ValidateActionStepParams = {
+   *   hash: '0x5678...',
+   *   chainId: 1,
+   *   knownSignatures?: {
+   *     '0x1234...': {}
+   *   }
+   * };
+   * const claimantAddress = await eventAction.deriveActionClaimantFromTransaction(claimant, params);
+   *
+   * @param {ActionClaimant} claimant - The configuration specifying how to derive the claimant.
+   * @param {ValidateActionStepParams} params - Parameters for validation, including transaction hash, known signatures, logs, and chain ID.
+   * @returns {Promise<Address | undefined>} The derived claimant address if found, undefined otherwise.
+   * @throws {ValidationAbiMissingError} If the ABI for the specified signature is not found.
+   * @throws {FunctionDataDecodeError} If there's an error decoding function data (for function-based derivation).
+   */
+  public async deriveActionClaimantFromTransaction(
+    claimant: ActionClaimant,
+    params: ValidateActionStepParams,
+  ): Promise<Address | undefined> {
+    const signature = claimant.signature;
+    if (claimant.signatureType === SignatureType.EVENT) {
+      let event: AbiEvent;
+      if (params.abiItem) event = params.abiItem as AbiEvent;
+      if (params.knownSignatures) {
+        event = params.knownSignatures?.[signature] as AbiEvent;
+      } else {
+        event = (events.abi as Record<Hex, AbiEvent>)[signature] as AbiEvent;
+      }
+
+      if (!event) {
+        throw new ValidationAbiMissingError(signature);
+      }
+
+      let address: Address | undefined;
+      if ('logs' in params) {
+        for (let log of params.logs) {
+          if (!isAddressEqual(log.address, claimant.targetContract)) continue;
+          let addressCandidate = this.validateClaimantAgainstArgs(
+            claimant,
+            log,
+          );
+          if (addressCandidate) address = addressCandidate;
+        }
+        return address;
+      }
+      const receipt = await getTransactionReceipt(this._config, params);
+      const decodedLogs = receipt.logs.map((log) => {
+        const { eventName, args } = decodeEventLog({
+          abi: [event],
+          data: log.data,
+          topics: log.topics,
+        });
+        return { ...log, eventName, args };
+      });
+
+      for (let log of decodedLogs) {
+        if (!isAddressEqual(log.address, claimant.targetContract)) continue;
+        let addressCandidate = this.validateClaimantAgainstArgs(claimant, log);
+        if (addressCandidate) address = addressCandidate;
+      }
+      return address;
+    }
+    if (
+      claimant.signatureType === SignatureType.FUNC &&
+      'hash' in params &&
+      'chainId' in params
+    ) {
+      const transaction = await getTransaction(this._config, {
+        hash: params.hash,
+      });
+      if (!isAddressEqual(transaction.to!, claimant.targetContract)) return;
+      let func: AbiFunction;
+      if (params.abiItem) func = params.abiItem as AbiFunction;
+      if (params.knownSignatures) {
+        func = params.knownSignatures?.[signature] as AbiFunction;
+      } else {
+        func = (functions.abi as Record<Hex, AbiFunction>)[
+          signature
+        ] as AbiFunction;
+      }
+      if (!func) {
+        throw new ValidationAbiMissingError(claimant.signature);
+      }
+      let decodedData;
+      try {
+        decodedData = decodeFunctionData({
+          abi: [func],
+          data: transaction.input,
+        });
+      } catch (e) {
+        throw new FunctionDataDecodeError([func], e as Error);
+      }
+      return this.validateClaimantAgainstArgs(claimant, decodedData);
+    }
+  }
+
+  /**
+   * Validates the action claimant against the arguments of a log or function data.
+   *
+   * @param {ActionClaimant} claimant - The action claimant to validate.
+   * @param {Object} [logOrFnData] - Optional object containing the arguments to validate against.
+   * @param {Array<any> | readonly unknown[] | Record<string, unknown>} [logOrFnData.args] - The arguments from the log or function data.
+   * @returns {Address | undefined} The validated address if found and valid, otherwise undefined.
+   */
+  public validateClaimantAgainstArgs(
+    claimant: ActionClaimant,
+    logOrFnData?: {
+      args: Array<unknown> | readonly unknown[] | Record<string, unknown>;
+    },
+  ): Address | undefined {
+    if (
+      !logOrFnData ||
+      !Array.isArray(logOrFnData?.args) ||
+      logOrFnData?.args.length <= claimant.fieldIndex
+    ) {
+      return;
+    }
+    const maybeAddress = logOrFnData.args.at(claimant.fieldIndex);
+    if (isAddress(maybeAddress)) return maybeAddress;
+  }
+
   /**
    * Retrieves action steps, and uses them to validate against, and optionally fetch logs that match the step's signature.
    * If logs are provided in the optional `params` argument, then those logs will be used instead of fetched with the configured client.
@@ -518,9 +659,9 @@ export class EventAction extends DeployableTarget<
     if (actionStep.signatureType === SignatureType.EVENT) {
       const signature = actionStep.signature;
       let event: AbiEvent;
-      // Lookup ABI based on event signature
-      if (params.knownEvents) {
-        event = params.knownEvents?.[signature] as AbiEvent;
+      if (params.abiItem) event = params.abiItem as AbiEvent;
+      if (params.knownSignatures) {
+        event = params.knownSignatures?.[signature] as AbiEvent;
       } else {
         event = (events.abi as Record<Hex, AbiEvent>)[signature] as AbiEvent;
       }
@@ -537,13 +678,9 @@ export class EventAction extends DeployableTarget<
         );
       }
 
-      params.event = event;
-
       // Use the provided logs, no need to fetch receipt
       if ('logs' in params) {
-        return this.isActionEventValid(actionStep, {
-          ...params,
-        });
+        return this.isActionEventValid(actionStep, params.logs);
       }
 
       const client = this._config.getClient({
@@ -562,10 +699,7 @@ export class EventAction extends DeployableTarget<
         return { ...log, eventName, args };
       });
 
-      return this.isActionEventValid(actionStep, {
-        logs: decodedLogs,
-        ...params,
-      });
+      return this.isActionEventValid(actionStep, decodedLogs);
     }
     if (actionStep.signatureType === SignatureType.FUNC) {
       if ('hash' in params && 'chainId' in params) {
@@ -575,7 +709,7 @@ export class EventAction extends DeployableTarget<
         const transaction = await client.getTransaction({
           hash: params.hash,
         });
-        return this.isActionFunctionValid(actionStep, transaction);
+        return this.isActionFunctionValid(actionStep, transaction, params);
       }
     }
     return false;
@@ -588,18 +722,11 @@ export class EventAction extends DeployableTarget<
    * @public
    * @async
    * @param {ActionStep} actionStep - The action step containing the event to validate.
-   * @param {ValidateActionStepParams} params - Additional parameters for validation, including known events and logs
+   * @param {EventLogs} logs - Event logs to validate the given step against
    * @returns {Promise<boolean>} Resolves to true if the action event is valid, throws if input is invalid, otherwise false.
    */
-  public isActionEventValid(
-    actionStep: ActionStep,
-    params: ValidateActionStepParams,
-  ) {
-    if (!('logs' in params)) {
-      throw new ValidationLogsMissingError();
-    }
+  public isActionEventValid(actionStep: ActionStep, logs: EventLogs) {
     const criteria = actionStep.actionParameter;
-    const logs = params.logs;
     if (!logs.length) return false;
     for (let log of logs) {
       if (this.validateLogAgainstCriteria(criteria, log)) {
@@ -608,25 +735,37 @@ export class EventAction extends DeployableTarget<
     }
     return false;
   }
+
   /**
    * Validates a single action function with a given criteria against the transaction input.
    *
    * @public
-   * @async
    * @param {ActionStep} actionStep - The action step containing the function to validate.
    * @param {Transaction} transaction - The transaction that will be validated against.
-   * @returns {Promise<boolean>} Resolves to true if the action function is valid, throws if the inputs are invalid, otherwise false.
+   * @param {Object} [params] - Optional parameters for validation.
+   * @param {AbiItem} [params.abiItem] - The ABI item for the function, if known.
+   * @param {Record<Hex, AbiEvent | AbiFunction>} [params.knownSignatures] - A record of known signatures.
+   * @returns {boolean} Returns true if the action function is valid, false otherwise.
+   * @throws {ValidationAbiMissingError} Throws if the ABI for the function signature is not found.
+   * @throws {FunctionDataDecodeError} Throws if there's an error decoding the function data.
    */
   public isActionFunctionValid(
     actionStep: ActionStep,
     transaction: Transaction,
+    params?: Pick<ValidateActionStepParams, 'abiItem' | 'knownSignatures'>,
   ) {
     const criteria = actionStep.actionParameter;
     let signature = actionStep.signature;
 
-    const func = (functions.abi as Record<Hex, AbiFunction>)[
-      signature
-    ] as AbiFunction;
+    let func: AbiFunction;
+    if (params?.abiItem) func = params?.abiItem as AbiFunction;
+    if (params?.knownSignatures) {
+      func = params?.knownSignatures?.[signature] as AbiFunction;
+    } else {
+      func = (functions.abi as Record<Hex, AbiFunction>)[
+        signature
+      ] as AbiFunction;
+    }
     if (!func) {
       throw new ValidationAbiMissingError(signature);
     }
@@ -776,7 +915,7 @@ export class EventAction extends DeployableTarget<
    *
    * @param {Criteria} criteria - The criteria to validate against.
    * @param {Log} log - The Viem event log.
-   * @returns {Promise<boolean>} - Returns true if the log passes the criteria, false otherwise.
+   * @returns {boolean} - Returns true if the log passes the criteria, false otherwise.
    */
   public validateLogAgainstCriteria(
     criteria: Criteria,

package/src/errors.ts

@@ -441,25 +441,6 @@ export class ValidationAbiMissingError extends Error {
   }
 }
 
-/**
- * Thrown when missing logs for validating action steps.
- *
- * @export
- * @class ValidationLogsMissingError
- * @typedef {ValidationLogsMissingError}
- * @extends {Error}
- */
-export class ValidationLogsMissingError extends Error {
-  /**
-   * Creates an instance of ValidationLogsMissingError.
-   *
-   * @constructor
-   */
-  constructor() {
-    super('Logs are required for validation');
-  }
-}
-
 /**
  * Function action validation context to help debug other validation errors
  *

package/src/index.test.ts

@@ -40,7 +40,6 @@ const allExports = [
   "NoEventActionStepsProvidedError",
   "TooManyEventActionStepsProvidedError",
   "ValidationAbiMissingError",
-  "ValidationLogsMissingError",
   "FieldActionValidationError",
   "DecodedArgsMalformedError",
   "FieldValueUndefinedError",