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

package/dist/BoostCore.d.ts

@@ -1,31 +1,52 @@
 import { boostCoreAbi, type iAuthAbi } from '@boostxyz/evm';
+import { type GetTransactionReceiptParameters } from '@wagmi/core';
 import { type Address, type ContractEventName, type Hex } from 'viem';
 import { type Action } from './Actions/Action';
-import { EventAction } from './Actions/EventAction';
+import { EventAction, type EventActionPayload } from './Actions/EventAction';
 import { type AllowList } from './AllowLists/AllowList';
+import { OpenAllowList } from './AllowLists/OpenAllowList';
 import { SimpleAllowList, type SimpleAllowListPayload } from './AllowLists/SimpleAllowList';
 import { SimpleDenyList, type SimpleDenyListPayload } from './AllowLists/SimpleDenyList';
 import { type Auth, PassthroughAuth } from './Auth/Auth';
-import { Boost } from './Boost';
+import { Boost, type RawBoost } from './Boost';
 import { type Budget } from './Budgets/Budget';
 import { ManagedBudget, type ManagedBudgetPayload } from './Budgets/ManagedBudget';
 import { Deployable, type DeployableOptions, type DeployablePayloadOrAddress, type GenericDeployableParams } from './Deployable/Deployable';
 import { AllowListIncentive, type AllowListIncentivePayload } from './Incentives/AllowListIncentive';
 import { CGDAIncentive, type CGDAIncentivePayload } from './Incentives/CGDAIncentive';
 import { ERC20Incentive, type ERC20IncentivePayload } from './Incentives/ERC20Incentive';
+import { ERC20VariableCriteriaIncentive, type ERC20VariableCriteriaIncentivePayload } from './Incentives/ERC20VariableCriteriaIncentive';
+import type { ERC20VariableIncentivePayload } from './Incentives/ERC20VariableIncentive';
 import { ERC20VariableIncentive, type Incentive } from './Incentives/Incentive';
 import { PointsIncentive, type PointsIncentivePayload } from './Incentives/PointsIncentive';
 import { SignerValidator, type SignerValidatorPayload } from './Validators/SignerValidator';
 import { type Validator } from './Validators/Validator';
-import { type ERC20VariableIncentivePayload, type EventActionPayload, type GenericLog, type ReadParams, type WriteParams } from './utils';
+import { type GenericLog, type ReadParams, type WriteParams } from './utils';
+/**
+ * The ABI of the BoostCore contract, if needed for low level operations
+ *
+ * @type {typeof boostCoreAbi}
+ */
 export { boostCoreAbi };
 /**
- * The fixed address for the deployed Boost Core.
- * By default, `new BoostCore` will use this address if not otherwise provided.
+ * The fee (in wei) required to claim each incentive, must be provided for the `claimIncentive` transaction
+ *
+ * @type {bigint}
+ */
+export declare const BOOST_CORE_CLAIM_FEE: bigint;
+/**
+ * The address of the deployed BoostCore instance. In prerelease mode, this will be its sepolia address
  *
  * @type {Address}
  */
-export declare const BOOST_CORE_ADDRESS: Address;
+export declare const BOOST_CORE_ADDRESS: `0x${string}`;
+/**
+ * The fixed addresses for the deployed Boost Core.
+ * By default, `new BoostCore` will use the address deployed to the currently connected chain, or `BOOST_CORE_ADDRESS` if not provided.
+ *
+ * @type {Record<number, Address>}
+ */
+export declare const BOOST_CORE_ADDRESSES: Record<number, Address>;
 /**
  * A generic `viem.Log` event with support for `BoostCore` event types.
  *
@@ -90,11 +111,10 @@ export type BoostCoreConfig = BoostCoreDeployedOptions | BoostCoreOptionsWithPay
 export type CreateBoostPayload = {
     budget: Budget;
     action: Action;
-    validator: Validator;
+    validator?: Validator;
     allowList: AllowList;
     incentives: Array<Incentive>;
     protocolFee?: bigint;
-    referralFee?: bigint;
     maxParticipants?: bigint;
     owner?: Address;
 };
@@ -110,6 +130,22 @@ export declare class BoostCore extends Deployable<[
     Address,
     Address
 ], typeof boostCoreAbi> {
+    /**
+     * A static property representing a map of stringified chain ID's to the address of the deployed implementation on chain
+     *
+     * @static
+     * @readonly
+     * @type {Record<string, Address>}
+     */
+    static readonly addresses: Record<number, Address>;
+    /**
+     * A getter that will return Boost core's static addresses by numerical chain ID
+     *
+     * @public
+     * @readonly
+     * @type {Record<number, Address>}
+     */
+    get addresses(): Record<number, Address>;
     /**
      * Creates an instance of BoostCore.
      *
@@ -119,16 +155,644 @@ export declare class BoostCore extends Deployable<[
      * @param {?Account} [param0.account]
      * @param {({ address?: Address; } | { registryAddress: Address; protocolFeeReceiver: Address; })} param0....options
      */
-    constructor({ config, account, ...options }: BoostCoreConfig); /**
+    constructor({ config, account, ...options }: BoostCoreConfig);
+    /**
      * Create a new Boost.
      *
      * @public
      * @async
      * @param {CreateBoostPayload} _boostPayload
-     * @param {?DeployableOptions} [_options]
-     * @returns {Boost}
+     * @param {?DeployableOptions} [_params]
+     * @returns {Promise<Boost>}
+     */
+    createBoost(_boostPayload: CreateBoostPayload, _params?: DeployableOptions & WriteParams<typeof boostCoreAbi, 'createBoost'>): Promise<Boost>;
+    /**
+     * Returns a simulated Boost creation.
+     *
+     * @public
+     * @async
+     * @param {CreateBoostPayload} _boostPayload
+     * @param {?DeployableOptions} [_params]
+     * @returns {Promise<SimulateContractReturnType>}
      */
-    createBoost(_boostPayload: CreateBoostPayload, _options?: DeployableOptions): Promise<Boost>;
+    simulateCreateBoost(_boostPayload: CreateBoostPayload, _params?: DeployableOptions & WriteParams<typeof boostCoreAbi, 'createBoost'>): Promise<import("viem").SimulateContractReturnType<readonly [{
+        readonly type: "constructor";
+        readonly inputs: readonly [{
+            readonly name: "registry_";
+            readonly internalType: "contract BoostRegistry";
+            readonly type: "address";
+        }, {
+            readonly name: "protocolFeeReceiver_";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly stateMutability: "nonpayable";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "AlreadyInitialized";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [{
+            readonly name: "caller";
+            readonly internalType: "address";
+            readonly type: "address";
+        }, {
+            readonly name: "data";
+            readonly internalType: "bytes";
+            readonly type: "bytes";
+        }];
+        readonly name: "ClaimFailed";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [{
+            readonly name: "caller";
+            readonly internalType: "address";
+            readonly type: "address";
+        }, {
+            readonly name: "data";
+            readonly internalType: "bytes";
+            readonly type: "bytes";
+        }];
+        readonly name: "ClawbackFailed";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "InvalidInitialization";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [{
+            readonly name: "expectedInterface";
+            readonly internalType: "bytes4";
+            readonly type: "bytes4";
+        }, {
+            readonly name: "instance";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly name: "InvalidInstance";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "NewOwnerIsZeroAddress";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "NoHandoverRequest";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "NotImplemented";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "Reentrancy";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "Unauthorized";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "Unauthorized";
+    }, {
+        readonly type: "event";
+        readonly anonymous: false;
+        readonly inputs: readonly [{
+            readonly name: "boostId";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+            readonly indexed: true;
+        }, {
+            readonly name: "incentiveId";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+            readonly indexed: true;
+        }, {
+            readonly name: "claimant";
+            readonly internalType: "address";
+            readonly type: "address";
+            readonly indexed: true;
+        }, {
+            readonly name: "referrer";
+            readonly internalType: "address";
+            readonly type: "address";
+            readonly indexed: false;
+        }, {
+            readonly name: "data";
+            readonly internalType: "bytes";
+            readonly type: "bytes";
+            readonly indexed: false;
+        }];
+        readonly name: "BoostClaimed";
+    }, {
+        readonly type: "event";
+        readonly anonymous: false;
+        readonly inputs: readonly [{
+            readonly name: "boostId";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+            readonly indexed: true;
+        }, {
+            readonly name: "owner";
+            readonly internalType: "address";
+            readonly type: "address";
+            readonly indexed: true;
+        }, {
+            readonly name: "action";
+            readonly internalType: "address";
+            readonly type: "address";
+            readonly indexed: true;
+        }, {
+            readonly name: "incentiveCount";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+            readonly indexed: false;
+        }, {
+            readonly name: "validator";
+            readonly internalType: "address";
+            readonly type: "address";
+            readonly indexed: false;
+        }, {
+            readonly name: "allowList";
+            readonly internalType: "address";
+            readonly type: "address";
+            readonly indexed: false;
+        }, {
+            readonly name: "budget";
+            readonly internalType: "address";
+            readonly type: "address";
+            readonly indexed: false;
+        }];
+        readonly name: "BoostCreated";
+    }, {
+        readonly type: "event";
+        readonly anonymous: false;
+        readonly inputs: readonly [{
+            readonly name: "pendingOwner";
+            readonly internalType: "address";
+            readonly type: "address";
+            readonly indexed: true;
+        }];
+        readonly name: "OwnershipHandoverCanceled";
+    }, {
+        readonly type: "event";
+        readonly anonymous: false;
+        readonly inputs: readonly [{
+            readonly name: "pendingOwner";
+            readonly internalType: "address";
+            readonly type: "address";
+            readonly indexed: true;
+        }];
+        readonly name: "OwnershipHandoverRequested";
+    }, {
+        readonly type: "event";
+        readonly anonymous: false;
+        readonly inputs: readonly [{
+            readonly name: "oldOwner";
+            readonly internalType: "address";
+            readonly type: "address";
+            readonly indexed: true;
+        }, {
+            readonly name: "newOwner";
+            readonly internalType: "address";
+            readonly type: "address";
+            readonly indexed: true;
+        }];
+        readonly name: "OwnershipTransferred";
+    }, {
+        readonly type: "event";
+        readonly anonymous: false;
+        readonly inputs: readonly [{
+            readonly name: "boostId";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+            readonly indexed: true;
+        }, {
+            readonly name: "incentiveId";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+            readonly indexed: true;
+        }, {
+            readonly name: "amount";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+            readonly indexed: false;
+        }, {
+            readonly name: "recipient";
+            readonly internalType: "address";
+            readonly type: "address";
+            readonly indexed: true;
+        }];
+        readonly name: "ProtocolFeesCollected";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [];
+        readonly name: "FEE_DENOMINATOR";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "uint64";
+            readonly type: "uint64";
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [];
+        readonly name: "cancelOwnershipHandover";
+        readonly outputs: readonly [];
+        readonly stateMutability: "payable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "boostId_";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }, {
+            readonly name: "incentiveId_";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }, {
+            readonly name: "referrer_";
+            readonly internalType: "address";
+            readonly type: "address";
+        }, {
+            readonly name: "data_";
+            readonly internalType: "bytes";
+            readonly type: "bytes";
+        }];
+        readonly name: "claimIncentive";
+        readonly outputs: readonly [];
+        readonly stateMutability: "payable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "boostId_";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }, {
+            readonly name: "incentiveId_";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }, {
+            readonly name: "referrer_";
+            readonly internalType: "address";
+            readonly type: "address";
+        }, {
+            readonly name: "data_";
+            readonly internalType: "bytes";
+            readonly type: "bytes";
+        }, {
+            readonly name: "claimant";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly name: "claimIncentiveFor";
+        readonly outputs: readonly [];
+        readonly stateMutability: "payable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "data_";
+            readonly internalType: "bytes";
+            readonly type: "bytes";
+        }, {
+            readonly name: "boostId";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }, {
+            readonly name: "incentiveId";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }];
+        readonly name: "clawback";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }, {
+            readonly name: "";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly stateMutability: "nonpayable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "pendingOwner";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly name: "completeOwnershipHandover";
+        readonly outputs: readonly [];
+        readonly stateMutability: "payable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "data_";
+            readonly internalType: "bytes";
+            readonly type: "bytes";
+        }];
+        readonly name: "createBoost";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "struct BoostLib.Boost";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "action";
+                readonly internalType: "contract AAction";
+                readonly type: "address";
+            }, {
+                readonly name: "validator";
+                readonly internalType: "contract AValidator";
+                readonly type: "address";
+            }, {
+                readonly name: "allowList";
+                readonly internalType: "contract AAllowList";
+                readonly type: "address";
+            }, {
+                readonly name: "budget";
+                readonly internalType: "contract ABudget";
+                readonly type: "address";
+            }, {
+                readonly name: "incentives";
+                readonly internalType: "contract AIncentive[]";
+                readonly type: "address[]";
+            }, {
+                readonly name: "protocolFee";
+                readonly internalType: "uint64";
+                readonly type: "uint64";
+            }, {
+                readonly name: "maxParticipants";
+                readonly internalType: "uint256";
+                readonly type: "uint256";
+            }, {
+                readonly name: "owner";
+                readonly internalType: "address";
+                readonly type: "address";
+            }];
+        }];
+        readonly stateMutability: "nonpayable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [];
+        readonly name: "createBoostAuth";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "contract IAuth";
+            readonly type: "address";
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "index";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }];
+        readonly name: "getBoost";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "struct BoostLib.Boost";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "action";
+                readonly internalType: "contract AAction";
+                readonly type: "address";
+            }, {
+                readonly name: "validator";
+                readonly internalType: "contract AValidator";
+                readonly type: "address";
+            }, {
+                readonly name: "allowList";
+                readonly internalType: "contract AAllowList";
+                readonly type: "address";
+            }, {
+                readonly name: "budget";
+                readonly internalType: "contract ABudget";
+                readonly type: "address";
+            }, {
+                readonly name: "incentives";
+                readonly internalType: "contract AIncentive[]";
+                readonly type: "address[]";
+            }, {
+                readonly name: "protocolFee";
+                readonly internalType: "uint64";
+                readonly type: "uint64";
+            }, {
+                readonly name: "maxParticipants";
+                readonly internalType: "uint256";
+                readonly type: "uint256";
+            }, {
+                readonly name: "owner";
+                readonly internalType: "address";
+                readonly type: "address";
+            }];
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [];
+        readonly name: "getBoostCount";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "key";
+            readonly internalType: "bytes32";
+            readonly type: "bytes32";
+        }];
+        readonly name: "getIncentive";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "struct BoostCore.IncentiveDisbursalInfo";
+            readonly type: "tuple";
+            readonly components: readonly [{
+                readonly name: "assetType";
+                readonly internalType: "enum ABudget.AssetType";
+                readonly type: "uint8";
+            }, {
+                readonly name: "asset";
+                readonly internalType: "address";
+                readonly type: "address";
+            }, {
+                readonly name: "protocolFeesRemaining";
+                readonly internalType: "uint256";
+                readonly type: "uint256";
+            }, {
+                readonly name: "protocolFee";
+                readonly internalType: "uint256";
+                readonly type: "uint256";
+            }, {
+                readonly name: "tokenId";
+                readonly internalType: "uint256";
+                readonly type: "uint256";
+            }];
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "";
+            readonly internalType: "bytes32";
+            readonly type: "bytes32";
+        }];
+        readonly name: "incentives";
+        readonly outputs: readonly [{
+            readonly name: "assetType";
+            readonly internalType: "enum ABudget.AssetType";
+            readonly type: "uint8";
+        }, {
+            readonly name: "asset";
+            readonly internalType: "address";
+            readonly type: "address";
+        }, {
+            readonly name: "protocolFeesRemaining";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }, {
+            readonly name: "protocolFee";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }, {
+            readonly name: "tokenId";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [];
+        readonly name: "owner";
+        readonly outputs: readonly [{
+            readonly name: "result";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "pendingOwner";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly name: "ownershipHandoverExpiresAt";
+        readonly outputs: readonly [{
+            readonly name: "result";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [];
+        readonly name: "protocolFee";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "uint64";
+            readonly type: "uint64";
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [];
+        readonly name: "protocolFeeReceiver";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [];
+        readonly name: "registry";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "contract BoostRegistry";
+            readonly type: "address";
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [];
+        readonly name: "renounceOwnership";
+        readonly outputs: readonly [];
+        readonly stateMutability: "payable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [];
+        readonly name: "requestOwnershipHandover";
+        readonly outputs: readonly [];
+        readonly stateMutability: "payable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "auth_";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly name: "setCreateBoostAuth";
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "protocolFee_";
+            readonly internalType: "uint64";
+            readonly type: "uint64";
+        }];
+        readonly name: "setProtocolFee";
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "protocolFeeReceiver_";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly name: "setProtocolFeeReceiver";
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "boostId";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }, {
+            readonly name: "incentiveId";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }];
+        readonly name: "settleProtocolFees";
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "newOwner";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly name: "transferOwnership";
+        readonly outputs: readonly [];
+        readonly stateMutability: "payable";
+    }], "createBoost", readonly [`0x${string}`], import("viem").Chain, import("viem").Account, import("viem").Chain> & {
+        chainId: number;
+        request: {
+            chainId?: undefined;
+            __mode: "prepared";
+            chain: import("viem").Chain;
+        };
+    }>;
+    private prepareCreateBoostPayload;
     /**
      * Claims one incentive from a given `Boost` by `boostId` and `incentiveId`
      *
@@ -138,8 +802,8 @@ export declare class BoostCore extends Deployable<[
      * @param {bigint} incentiveId
      * @param {Address} address
      * @param {Hex} data
-     * @param {?WriteParams<typeof boostCoreAbi, 'claimIncentive'>} [params]
-     * @returns {unknown}
+     * @param {?WriteParams} [params]
+     * @returns {Promise<void>}
      */
     claimIncentive(boostId: bigint, incentiveId: bigint, address: Address, data: Hex, params?: WriteParams<typeof boostCoreAbi, 'claimIncentive'>): Promise<void>;
     /**
@@ -149,43 +813,66 @@ export declare class BoostCore extends Deployable<[
      * @async
      * @param {bigint} boostId - The ID of the Boost
      * @param {bigint} incentiveId - The ID of the Incentive
-     * @param {Address} address - The address of the referrer (if any)
+     * @param {Address} referrer - The address of the referrer (if any)
      * @param {Hex} data- The data for the claim
-     * @param {?WriteParams<typeof boostCoreAbi, 'claimIncentive'>} [params]
-     * @returns {unknown}
+     * @param {?WriteParams} [params]
+     * @returns {Promise<{ hash: `0x${string}`; result: void; }>}
      */
-    claimIncentiveRaw(boostId: bigint, incentiveId: bigint, address: Address, data: Hex, params?: WriteParams<typeof boostCoreAbi, 'claimIncentive'>): Promise<{
+    claimIncentiveRaw(boostId: bigint, incentiveId: bigint, referrer: Address, data: Hex, params?: WriteParams<typeof boostCoreAbi, 'claimIncentive'>): Promise<{
         hash: `0x${string}`;
         result: void;
     }>;
     /**
-     * Get a Boost by index, will return the raw on chain representation of a Boost.
+     * Claims one incentive for a given `Boost` on behalf of another user by `boostId` and `incentiveId`
      *
      * @public
      * @async
-     * @param {bigint} id
-     * @param {?ReadParams<typeof boostCoreAbi, 'getBoost'>} [params]
-     * @returns {unknown}
+     * @param {bigint} boostId
+     * @param {bigint} incentiveId
+     * @param {Address} referrer
+     * @param {Hex} data
+     * @param {Address} claimant
+     * @param {?WriteParams} [params]
+     * @returns {Promise<void>}
+     */
+    claimIncentiveFor(boostId: bigint, incentiveId: bigint, referrer: Address, data: Hex, claimant: Address, params?: WriteParams<typeof boostCoreAbi, 'claimIncentiveFor'>): Promise<void>;
+    /**
+     * Claim an incentive for a Boost on behalf of another user
+     *
+     * @public
+     * @async
+     * @param {bigint} boostId - The ID of the Boost
+     * @param {bigint} incentiveId - The ID of the Incentive
+     * @param {Address} referrer - The address of the referrer (if any)
+     * @param {Hex} data - The data for the claim
+     * @param {Address} claimant - The address of the user eligible for the incentive payout
+     * @param {?WriteParams} [params]
+     * @returns {Promise<{ hash: Hex; result: void; }>}
      */
-    readBoost(id: bigint, params?: ReadParams<typeof boostCoreAbi, 'getBoost'>): Promise<{
-        action: `0x${string}`;
-        validator: `0x${string}`;
-        allowList: `0x${string}`;
-        budget: `0x${string}`;
-        incentives: readonly `0x${string}`[];
-        protocolFee: bigint;
-        referralFee: bigint;
-        maxParticipants: bigint;
-        owner: `0x${string}`;
+    claimIncentiveForRaw(boostId: bigint, incentiveId: bigint, referrer: Address, data: Hex, claimant: Address, params?: WriteParams<typeof boostCoreAbi, 'claimIncentiveFor'>): Promise<{
+        hash: `0x${string}`;
+        result: void;
     }>;
+    /**
+     * Get a Boost by index, will return the raw on chain representation of a Boost.
+     *
+     * @public
+     * @async
+     * @param {bigint | string} id
+     * @param {?ReadParams} [params]
+     * @returns {Promise<RawBoost>}
+     * @throws {@link BoostNotFoundError}
+     */
+    readBoost(_id: string | bigint, params?: ReadParams<typeof boostCoreAbi, 'getBoost'>): Promise<RawBoost>;
     /**
      * Get a Boost by index, will return a new {@link Boost} with correct target implementations instantiated, ie `(await core.getBoost(0n)).allowList instanceof SimpleAllowList` vs `SimpleDenyList`
      *
      * @public
      * @async
      * @param {(string | bigint)} _id
-     * @param {?ReadParams<typeof boostCoreAbi, 'getBoost'>} [params]
-     * @returns {unknown}
+     * @param {?ReadParams} [params]
+     * @returns {Promise<Boost>}
+     * @throws {@link BoostNotFoundError}
      */
     getBoost(_id: string | bigint, params?: ReadParams<typeof boostCoreAbi, 'getBoost'>): Promise<Boost>;
     /**
@@ -193,7 +880,7 @@ export declare class BoostCore extends Deployable<[
      *
      * @public
      * @async
-     * @param {?ReadParams<typeof boostCoreAbi, 'getBoostCount'>} [params]
+     * @param {?ReadParams} [params]
      * @returns {Promise<bigint>}
      */
     getBoostCount(params?: ReadParams<typeof boostCoreAbi, 'getBoostCount'>): Promise<bigint>;
@@ -203,7 +890,7 @@ export declare class BoostCore extends Deployable<[
      * @public
      * @async
      * @param {Address} address
-     * @param {?ReadParams<typeof boostCoreAbi, 'createBoostAuth'> &
+     * @param {?ReadParams &
      *       ReadParams<typeof iAuthAbi, 'isAuthorized'>} [params]
      * @returns {Promise<boolean>}
      */
@@ -213,8 +900,8 @@ export declare class BoostCore extends Deployable<[
      *
      * @public
      * @async
-     * @param {?ReadParams<typeof boostCoreAbi, 'createBoostAuth'>} [params]
-     * @returns {unknown}
+     * @param {?ReadParams} [params]
+     * @returns {Promise<Address>}
      */
     createBoostAuth(params?: ReadParams<typeof boostCoreAbi, 'createBoostAuth'>): Promise<`0x${string}`>;
     /**
@@ -223,8 +910,8 @@ export declare class BoostCore extends Deployable<[
      * @public
      * @async
      * @param {Auth} auth
-     * @param {?WriteParams<typeof boostCoreAbi, 'setCreateBoostAuth'>} [params]
-     * @returns {unknown}
+     * @param {?WriteParams} [params]
+     * @returns {Promise<void>}
      */
     setCreateBoostAuth(auth: Auth, params?: WriteParams<typeof boostCoreAbi, 'setCreateBoostAuth'>): Promise<void>;
     /**
@@ -233,8 +920,8 @@ export declare class BoostCore extends Deployable<[
      * @public
      * @async
      * @param {Address} address
-     * @param {?WriteParams<typeof boostCoreAbi, 'setCreateBoostAuth'>} [params]
-     * @returns {unknown}
+     * @param {?WriteParams} [params]
+     * @returns {Promise<{ hash: `0x${string}`; result: void; }>}
      */
     setCreateBoostAuthRaw(address: Address, params?: WriteParams<typeof boostCoreAbi, 'setCreateBoostAuth'>): Promise<{
         hash: `0x${string}`;
@@ -245,7 +932,7 @@ export declare class BoostCore extends Deployable<[
      *
      * @public
      * @async
-     * @param {?ReadParams<typeof boostCoreAbi, 'protocolFee'>} [params]
+     * @param {?ReadParams} [params]
      * @returns {unknown}
      */
     protocolFee(params?: ReadParams<typeof boostCoreAbi, 'protocolFee'>): Promise<bigint>;
@@ -254,8 +941,8 @@ export declare class BoostCore extends Deployable<[
      *
      * @public
      * @async
-     * @param {?ReadParams<typeof boostCoreAbi, 'protocolFeeReceiver'>} [params]
-     * @returns {unknown}
+     * @param {?ReadParams} [params]
+     * @returns {Promise<Address>}
      */
     protocolFeeReceiver(params?: ReadParams<typeof boostCoreAbi, 'protocolFeeReceiver'>): Promise<`0x${string}`>;
     /**
@@ -264,8 +951,8 @@ export declare class BoostCore extends Deployable<[
      * @public
      * @async
      * @param {Address} address
-     * @param {?WriteParams<typeof boostCoreAbi, 'setProtocolFeeReceiver'>} [params]
-     * @returns {unknown}
+     * @param {?WriteParams} [params]
+     * @returns {Promise<void>}
      */
     setProcolFeeReceiver(address: Address, params?: WriteParams<typeof boostCoreAbi, 'setProtocolFeeReceiver'>): Promise<void>;
     /**
@@ -274,45 +961,43 @@ export declare class BoostCore extends Deployable<[
      * @public
      * @async
      * @param {Address} address
-     * @param {?WriteParams<typeof boostCoreAbi, 'setProtocolFeeReceiver'>} [params]
-     * @returns {unknown}
+     * @param {?WriteParams} [params]
+     * @returns {Promise<{ hash: `0x${string}`; result: void; }>}
      */
     setProcolFeeReceiverRaw(address: Address, params?: WriteParams<typeof boostCoreAbi, 'setProtocolFeeReceiver'>): Promise<{
         hash: `0x${string}`;
         result: void;
     }>;
     /**
-     * Get the claim fee.
+     * Retrieves the claim information from a transaction receipt.
      *
-     * @public
-     * @async
-     * @param {?ReadParams<typeof boostCoreAbi, 'claimFee'>} [params]
-     * @returns {unknown}
-     */
-    claimFee(params?: ReadParams<typeof boostCoreAbi, 'claimFee'>): Promise<bigint>;
-    /**
-     * Sets the claim fee.
+     * @param {GetTransactionReceiptParameters} params - The parameters required to get the transaction receipt.
+     * @returns {Promise<{ boostId: bigint, incentiveId: bigint, claimer: Address, amount: bigint } | undefined>} The claim information if found, undefined otherwise.
      *
-     * @public
-     * @async
-     * @param {bigint} claimFee
-     * @param {?WriteParams<typeof boostCoreAbi, 'setClaimFee'>} [params]
-     * @returns {unknown}
-     */
-    setClaimFee(claimFee: bigint, params?: WriteParams<typeof boostCoreAbi, 'setClaimFee'>): Promise<void>;
-    /**
-     * Sets the claim fee.
+     * @description
+     * This method retrieves the transaction receipt using the provided parameters,
+     * then parses the logs to find the 'BoostClaimed' event.
+     * If found, it returns the arguments of the event, which include the boost ID,
+     * incentive ID, claimer address, and claimed amount.
      *
-     * @public
-     * @async
-     * @param {bigint} claimFee
-     * @param {?WriteParams<typeof boostCoreAbi, 'setClaimFee'>} [params]
-     * @returns {unknown}
+     * @example
+     * ```ts
+     * const claimInfo = await boostCore.getClaimFromTransaction({
+     *   hash: '0x...',
+     *   chainId: 1
+     * });
+     * if (claimInfo) {
+     *   console.log(`Boost ${claimInfo.boostId} claimed by ${claimInfo.claimer}`);
+     * }
+     * ```
      */
-    setClaimFeeRaw(claimFee: bigint, params?: WriteParams<typeof boostCoreAbi, 'setClaimFee'>): Promise<{
-        hash: `0x${string}`;
-        result: void;
-    }>;
+    getClaimFromTransaction(params: GetTransactionReceiptParameters): Promise<{
+        boostId: bigint;
+        incentiveId: bigint;
+        claimant: `0x${string}`;
+        referrer: `0x${string}`;
+        data: `0x${string}`;
+    } | undefined>;
     /**
      * Bound {@link PassthroughAuth} constructor that reuses the same configuration as the Boost Core instance.
      *
@@ -321,8 +1006,7 @@ export declare class BoostCore extends Deployable<[
      * const auth = core.PassthroughAuth('0x') // is roughly equivalent to
      * const auth = new PassthroughAuth({ config: core._config, account: core._account }, '0x')
      * ```
-     * @param {DeployablePayloadOrAddress<{}>} options
-     * @param {?boolean} [isBase]
+     * @param {Address} address
      * @returns {PassthroughAuth}
      */
     PassthroughAuth(address?: Address): PassthroughAuth;
@@ -335,6 +1019,18 @@ export declare class BoostCore extends Deployable<[
      * const action = new EventAction({ config: core._config, account: core._account }, '0x')
      */
     EventAction(options: DeployablePayloadOrAddress<EventActionPayload>, isBase?: boolean): EventAction;
+    /**
+     * Bound {@link OpenAllowList} constructor that reuses the same configuration as the Boost Core instance.
+     *
+     * @example
+     * ```ts
+     * const list = core.OpenAllowList('0x') // is roughly equivalent to
+     * const list = new OpenAllowList({ config: core._config, account: core._account }, '0x')
+     * ```
+     * @param {?boolean} [isBase]
+     * @returns {OpenAllowList}
+     */
+    OpenAllowList(isBase?: boolean): OpenAllowList;
     /**
      * Bound {@link SimpleAllowList} constructor that reuses the same configuration as the Boost Core instance.
      *
@@ -360,7 +1056,7 @@ export declare class BoostCore extends Deployable<[
      * @param {?boolean} [isBase]
      * @returns {SimpleDenyList}
      */
-    SimpleDenyList(options: DeployablePayloadOrAddress<SimpleDenyListPayload>, isBase?: boolean): SimpleDenyList;
+    SimpleDenyList(options: DeployablePayloadOrAddress<SimpleDenyListPayload>, isBase?: boolean): SimpleDenyList<SimpleDenyListPayload>;
     /**
      * Bound {@link ManagedBudget} constructor that reuses the same configuration as the Boost Core instance.
      *
@@ -434,6 +1130,19 @@ export declare class BoostCore extends Deployable<[
      * @returns {SignerValidator}
      */
     SignerValidator(options: DeployablePayloadOrAddress<SignerValidatorPayload>, isBase?: boolean): SignerValidator;
+    /**
+     * Bound {@link ERC20VariableCriteriaIncentive} constructor that reuses the same configuration as the Boost Core instance.
+     *
+     * @example
+     * ```ts
+     * const validator = core.ERC20VariableCrtieriaIncentive({ ... }) // is roughly equivalent to
+     * const validator = new ERC20VariableCrtieriaIncentive({ config: core._config, account: core._account }, { ... })
+     * ```
+     * @param {DeployablePayloadOrAddress<ERC20VariableCrtieriaIncentivePayload>} options
+     * @param {?boolean} [isBase]
+     * @returns {ERC20VariableCrtieriaIncentive}
+     * */
+    ERC20VariableCriteriaIncentive(options: DeployablePayloadOrAddress<ERC20VariableCriteriaIncentivePayload>, isBase?: boolean): ERC20VariableCriteriaIncentive;
     /**
      * Bound {@link ERC20VariableIncentive} constructor that reuses the same configuration as the Boost Core instance.
      *