@boostxyz/sdk 8.0.0-canary.2 → 8.0.0-canary.4

package/dist/Validators/SignerValidatorV2.d.ts

@@ -0,0 +1,728 @@
+import { signerValidatorV2Abi } from '@boostxyz/evm';
+import { type Address, type ContractEventName, type Hex, type PrivateKeyAccount } from 'viem';
+import type { DeployableOptions, GenericDeployableParams } from '../Deployable/Deployable';
+import { DeployableTarget } from '../Deployable/DeployableTarget';
+import { type GenericLog, type ReadParams, RegistryType, type WriteParams } from '../utils';
+export { signerValidatorV2Abi };
+/**
+ * Object reprentation of a {@link SignerValidatorV2} initialization payload
+ *
+ * @export
+ * @interface SignerValidatorV2Payload
+ * @typedef {SignerValidatorV2Payload}
+ */
+export interface SignerValidatorV2Payload {
+    /**
+     * The list of authorized signers. The first address in the list will be the initial owner of the contract.
+     *
+     * @type {Address[]}
+     */
+    signers: Address[];
+    /**
+     * The authorized caller of the {@link prepareSignerValidatorV2} function
+     * @type {Address}
+     */
+    validatorCaller: Address;
+}
+/**
+ * Description placeholder
+ *
+ * @export
+ * @interface SignerValidatorV2ValidatePayload
+ * @typedef {SignerValidatorV2ValidatePayload}
+ */
+export interface SignerValidatorV2ValidatePayload {
+    /**
+     * The ID of the boost.
+     *
+     * @type {bigint}
+     */
+    boostId: bigint;
+    /**
+     * The ID of the incentive.
+     *
+     * @type {bigint}
+     */
+    incentiveId: bigint;
+    /**
+     * The address of the claimant.
+     *
+     * @type {Address}
+     */
+    claimant: Address;
+    /**
+     * The claim data.
+     *
+     * @type {Hex}
+     */
+    claimData: Hex;
+}
+/**
+ * Signer Validator Claim Data Payload
+ *
+ * @export
+ * @interface SignerValidatorV2ClaimDataParams
+ * @typedef {SignerValidatorV2ClaimDataParams}
+ */
+export interface SignerValidatorV2ClaimDataParams {
+    /**
+     * The signer with which to sign the input
+     *
+     * @type {{
+     *     account: Address;
+     *     key: Hex;
+     *     privateKey: PrivateKeyAccount;
+     *   }}
+     */
+    signer: {
+        account: Address;
+        key: Hex;
+        privateKey: PrivateKeyAccount;
+    };
+    /**
+     * The encoded data to provide the underlying incentive. You can use {@link prepareAllowListIncentivePayload}, {@link prepareCGDAIncentivePayload}, {@link prepareERC20IncentivePayload}, {@link prepareERC1155IncentivePayload}, or {@link preparePointsIncentivePayload}
+     *
+     * @type {Hex}
+     */
+    incentiveData: Hex;
+    /**
+     * The chain id to target
+     *
+     * @type {number}
+     */
+    chainId: number;
+    /**
+     * The address of the validator
+     *
+     * @type {Address}
+     */
+    validator: Address;
+    /**
+     * The total number of incentives on the Boost
+     *
+     * @type {number}
+     */
+    incentiveQuantity: number;
+    /**
+     * The address of the claimant
+     *
+     * @type {Address}
+     */
+    claimant: Address;
+    /**
+     * The ID of the boost
+     *
+     * @type {bigint}
+     */
+    boostId: bigint;
+    /**
+     * The address of the referrer
+     *
+     * @type {?Address}
+     */
+    referrer?: Address;
+}
+/**
+ * Object representation of a {@link SignerValidatorV2InputParams} initialization payload
+ *
+ * @export
+ * @interface SignerValidatorV2InputParams
+ * @typedef {SignerValidatorV2InputParams}
+ */
+export interface SignerValidatorV2InputParams {
+    /**
+     * The signer address.
+     *
+     * @type {Address}
+     */
+    signer: Address;
+    /**
+     * The signature data.
+     *
+     * @type {Hex}
+     */
+    signature: Hex;
+    /**
+     * The total number of incentives on the Boost
+     *
+     * @type {number}
+     */
+    incentiveQuantity: number;
+}
+/**
+ * Object representing the payload for signing before validaton.
+ *
+ * @export
+ * @interface SignerValidatorV2SignaturePayload
+ * @typedef {SignerValidatorV2SignaturePayload}
+ */
+export interface SignerValidatorV2SignaturePayload {
+    /**
+     * The ID of the boost.
+     *
+     * @type {bigint}
+     */
+    boostId: bigint;
+    /**
+     * The ID of the incentive.
+     *
+     * @type {number}
+     */
+    incentiveQuantity: number;
+    /**
+     * The address of the claimant.
+     *
+     * @type {Address}
+     */
+    claimant: Address;
+    /**
+     * The claim data.
+     *
+     * @type {Hex}
+     */
+    incentiveData: Hex;
+    /**
+     * The address of the referrer (defaults to claimant if omitted)
+     *
+     * @type {?Address}
+     */
+    referrer?: Address;
+}
+/**
+ * A generic `viem.Log` event with support for `BoostCore` event types.
+ *
+ * @export
+ * @typedef {SignerValidatorV2Log}
+ * @template {ContractEventName<
+ *     typeof signerValidatorV2Abi
+ *   >} [event=ContractEventName<typeof signerValidatorV2Abi>]
+ */
+export type SignerValidatorV2Log<event extends ContractEventName<typeof signerValidatorV2Abi> = ContractEventName<typeof signerValidatorV2Abi>> = GenericLog<typeof signerValidatorV2Abi, event>;
+/**
+ *  A simple implementation of a Validator that verifies a given signature and checks the recovered address against a set of authorized signers
+ *
+ * @export
+ * @class SignerValidatorV2
+ * @typedef {SignerValidatorV2}
+ * @extends {DeployableTarget<SignerValidatorV2Payload>}
+ */
+export declare class SignerValidatorV2 extends DeployableTarget<SignerValidatorV2Payload, typeof signerValidatorV2Abi> {
+    /**
+     * @inheritdoc
+     *
+     * @public
+     * @readonly
+     * @type {*}
+     */
+    readonly abi: readonly [{
+        readonly type: "constructor";
+        readonly inputs: readonly [];
+        readonly stateMutability: "nonpayable";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "AlreadyInitialized";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "CloneAlreadyInitialized";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "InitializerNotImplemented";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [{
+            readonly name: "available";
+            readonly internalType: "uint8";
+            readonly type: "uint8";
+        }, {
+            readonly name: "id";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }];
+        readonly name: "InvalidIncentive";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "InvalidInitialization";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "InvalidInitializationData";
+    }, {
+        readonly type: "error";
+        readonly inputs: readonly [];
+        readonly name: "LengthMismatch";
+    }, {
+        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: "NotInitializing";
+    }, {
+        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: "version";
+            readonly internalType: "uint64";
+            readonly type: "uint64";
+            readonly indexed: false;
+        }];
+        readonly name: "Initialized";
+    }, {
+        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: "validatorCaller";
+            readonly internalType: "address";
+            readonly type: "address";
+            readonly indexed: false;
+        }];
+        readonly name: "SignerValidatorV2Initialized";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [];
+        readonly name: "cancelOwnershipHandover";
+        readonly outputs: readonly [];
+        readonly stateMutability: "payable";
+    }, {
+        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: "eip712Domain";
+        readonly outputs: readonly [{
+            readonly name: "fields";
+            readonly internalType: "bytes1";
+            readonly type: "bytes1";
+        }, {
+            readonly name: "name";
+            readonly internalType: "string";
+            readonly type: "string";
+        }, {
+            readonly name: "version";
+            readonly internalType: "string";
+            readonly type: "string";
+        }, {
+            readonly name: "chainId";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }, {
+            readonly name: "verifyingContract";
+            readonly internalType: "address";
+            readonly type: "address";
+        }, {
+            readonly name: "salt";
+            readonly internalType: "bytes32";
+            readonly type: "bytes32";
+        }, {
+            readonly name: "extensions";
+            readonly internalType: "uint256[]";
+            readonly type: "uint256[]";
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [];
+        readonly name: "getComponentInterface";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "bytes4";
+            readonly type: "bytes4";
+        }];
+        readonly stateMutability: "pure";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "boostId";
+            readonly internalType: "uint256";
+            readonly type: "uint256";
+        }, {
+            readonly name: "incentiveQuantity";
+            readonly internalType: "uint8";
+            readonly type: "uint8";
+        }, {
+            readonly name: "claimant";
+            readonly internalType: "address";
+            readonly type: "address";
+        }, {
+            readonly name: "incentiveData";
+            readonly internalType: "bytes";
+            readonly type: "bytes";
+        }, {
+            readonly name: "referrer";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly name: "hashSignerData";
+        readonly outputs: readonly [{
+            readonly name: "hashedSignerData";
+            readonly internalType: "bytes32";
+            readonly type: "bytes32";
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "data_";
+            readonly internalType: "bytes";
+            readonly type: "bytes";
+        }];
+        readonly name: "initialize";
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+    }, {
+        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: "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: "signers_";
+            readonly internalType: "address[]";
+            readonly type: "address[]";
+        }, {
+            readonly name: "authorized_";
+            readonly internalType: "bool[]";
+            readonly type: "bool[]";
+        }];
+        readonly name: "setAuthorized";
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "newCaller";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly name: "setValidatorCaller";
+        readonly outputs: readonly [];
+        readonly stateMutability: "nonpayable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly name: "signers";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "bool";
+            readonly type: "bool";
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "interfaceId";
+            readonly internalType: "bytes4";
+            readonly type: "bytes4";
+        }];
+        readonly name: "supportsInterface";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "bool";
+            readonly type: "bool";
+        }];
+        readonly stateMutability: "view";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [{
+            readonly name: "newOwner";
+            readonly internalType: "address";
+            readonly type: "address";
+        }];
+        readonly name: "transferOwnership";
+        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: "claimant";
+            readonly internalType: "address";
+            readonly type: "address";
+        }, {
+            readonly name: "claimData";
+            readonly internalType: "bytes";
+            readonly type: "bytes";
+        }];
+        readonly name: "validate";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "bool";
+            readonly type: "bool";
+        }];
+        readonly stateMutability: "payable";
+    }, {
+        readonly type: "function";
+        readonly inputs: readonly [];
+        readonly name: "validatorName";
+        readonly outputs: readonly [{
+            readonly name: "";
+            readonly internalType: "string";
+            readonly type: "string";
+        }];
+        readonly stateMutability: "pure";
+    }];
+    /**
+     * @inheritdoc
+     *
+     * @public
+     * @static
+     * @type {Record<number, Address>}
+     */
+    static bases: Record<number, Address>;
+    /**
+     * @inheritdoc
+     *
+     * @public
+     * @static
+     * @type {RegistryType}
+     */
+    static registryType: RegistryType;
+    /**
+     * The set of authorized signers
+     *
+     * @public
+     * @async
+     * @param {Address} address
+     * @param {?ReadParams} [params]
+     * @returns {Promise<boolean>}
+     */
+    signers(address: Address, params?: ReadParams): Promise<boolean>;
+    /**
+     * Retrieve the hash and signer data for a given hash
+     *
+     * @public
+     * @async
+     * @param {SignerValidatorV2SignaturePayload} payload
+     * @param {?ReadParams} [params]
+     * @returns {Promise<Hex>}
+     */
+    hashSignerData(payload: SignerValidatorV2SignaturePayload, params?: ReadParams): Promise<`0x${string}`>;
+    /**
+     * Validate that the action has been completed successfully. The data payload is expected to be a tuple of (address signer, bytes32 hash, bytes signature). The signature is expected to be a valid ECDSA or EIP-1271 signature of a unique hash by an authorized signer.
+     *
+     * @public
+     * @async
+     * @param {SignerValidatorV2ValidatePayload} payload
+     * @param {?WriteParams} [params]
+     * @returns {Promise<boolean>} - True if the action has been validated based on the data payload
+     */
+    validate(payload: SignerValidatorV2ValidatePayload, params?: WriteParams): Promise<boolean>;
+    /**
+     * Validate that the action has been completed successfully. The data payload is expected to be a tuple of (address signer, bytes32 hash, bytes signature). The signature is expected to be a valid ECDSA or EIP-1271 signature of a unique hash by an authorized signer.
+     *
+     * @public
+     * @async
+     * @param {SignerValidatorV2ValidatePayload} payload
+     * @param {?WriteParams} [params]
+     * @returns {Promise<boolean>} - True if the action has been validated based on the data payload
+     */
+    validateRaw(payload: SignerValidatorV2ValidatePayload, params?: WriteParams): Promise<{
+        hash: `0x${string}`;
+        result: boolean;
+    }>;
+    /**
+     * Set the authorized status of a signer
+     *
+     * @public
+     * @async
+     * @param {Address[]} addresses - The list of signers to update
+     * @param {boolean[]} allowed - The authorized status of each signer
+     * @param {?WriteParams} [params]
+     * @returns {Promise<void>}
+     */
+    setAuthorized(addresses: Address[], allowed: boolean[], params?: WriteParams): Promise<void>;
+    /**
+     * Set the authorized status of a signer
+     *
+     * @public
+     * @async
+     * @param {Address[]} addresses - The list of signers to update
+     * @param {boolean[]} allowed - The authorized status of each signer
+     * @param {?WriteParams} [params]
+     * @returns {Promise<{ hash: `0x${string}`; result: void; }>}
+     */
+    setAuthorizedRaw(addresses: Address[], allowed: boolean[], params?: WriteParams): Promise<{
+        hash: `0x${string}`;
+        result: void;
+    }>;
+    /**
+     * Update the authorized caller of the validator function
+     *
+     * @public
+     * @async
+     * @param {Address} address
+     * @param {?WriteParams} [params]
+     * @returns {Promise<{ hash: `0x${string}`; result: void; }>}
+     */
+    setValidatorCallerRaw(address: Address, params?: WriteParams): Promise<{
+        hash: `0x${string}`;
+        result: void;
+    }>;
+    /**
+     * Update the authorized caller of the validator function
+     *
+     * @public
+     * @async
+     * @param {Address} address
+     * @param {?WriteParams} [params]
+     * @returns {Promise<void>}
+     */
+    setValidatorCaller(address: Address, params?: WriteParams): Promise<void>;
+    /**
+     * Properly encodes the data needed to claim
+     *
+     * @public
+     * @async
+     * @param {SignerValidatorV2ClaimDataParams} params
+     * @returns {Promise<Hex>}
+     */
+    encodeClaimData(params: Omit<SignerValidatorV2ClaimDataParams, 'validator'>): Promise<Hex>;
+    /**
+     * @inheritdoc
+     *
+     * @public
+     * @param {?SignerValidatorV2Payload} [_payload]
+     * @param {?DeployableOptions} [_options]
+     * @returns {GenericDeployableParams}
+     */
+    buildParameters(_payload?: SignerValidatorV2Payload, _options?: DeployableOptions): GenericDeployableParams;
+}
+/**
+ * Signer Validator Claim Data Payload Preparation
+ *
+ * @export
+ * @async
+ * @param {SignerValidatorV2ClaimDataParams} param0
+ * @param {{ account: Address; key: Hex; privateKey: PrivateKeyAccount; }} param0.signer
+ * @param {Hex} param0.incentiveData
+ * @param {number} param0.chainId
+ * @param {Address} param0.validator
+ * @param {number} param0.incentiveQuantity
+ * @param {Address} param0.claimant
+ * @param {bigint} param0.boostId
+ * @returns {Promise<Hex>}
+ */
+export declare function prepareSignerValidatorV2ClaimDataPayload({ signer, incentiveData, chainId, validator, incentiveQuantity, claimant, boostId, referrer, }: SignerValidatorV2ClaimDataParams): Promise<Hex>;
+/**
+ * Given a {@link SignerValidatorV2InputParams}, properly encode the initialization payload.
+ *
+ * @param {SignerValidatorV2InputParams} param0
+ * @param {Address} param0.signer
+ * @param {Hex} param0.signature
+ * @param {number} param0.incentiveQuantity
+ * @returns {Hex}
+ */
+export declare function prepareSignerValidatorV2InputParams({ signer, signature, incentiveQuantity, }: SignerValidatorV2InputParams): `0x${string}`;
+/**
+ * Given a {@link SignerValidatorV2Payload}, properly encode the initialization payload.
+ *
+ * @param {SignerValidatorV2Payload} param0
+ * @param {Address[]} param0.signers
+ * @param {Address} param0.validatorCaller
+ * @returns {Hex}
+ */
+export declare function prepareSignerValidatorV2Payload({ signers, validatorCaller, }: SignerValidatorV2Payload): `0x${string}`;
+//# sourceMappingURL=SignerValidatorV2.d.ts.map