@boostxyz/sdk 0.0.0-alpha.7 → 0.0.0-alpha.9

package/src/BoostCore.ts

@@ -9,10 +9,12 @@ import {
   readBoostCoreProtocolFeeReceiver,
   readIAuthIsAuthorized,
   simulateBoostCoreClaimIncentive,
+  simulateBoostCoreClaimIncentiveFor,
   simulateBoostCoreSetClaimFee,
   simulateBoostCoreSetCreateBoostAuth,
   simulateBoostCoreSetProtocolFeeReceiver,
   writeBoostCoreClaimIncentive,
+  writeBoostCoreClaimIncentiveFor,
   writeBoostCoreSetClaimFee,
   writeBoostCoreSetCreateBoostAuth,
   writeBoostCoreSetProtocolFeeReceiver,
@@ -24,12 +26,13 @@ import {
   type Address,
   type ContractEventName,
   type Hex,
+  parseEther,
   parseEventLogs,
   zeroAddress,
   zeroHash,
 } from 'viem';
 import { type Action, actionFromAddress } from './Actions/Action';
-import { EventAction } from './Actions/EventAction';
+import { EventAction, type EventActionPayload } from './Actions/EventAction';
 import { type AllowList, allowListFromAddress } from './AllowLists/AllowList';
 import {
   SimpleAllowList,
@@ -40,7 +43,12 @@ import {
   type SimpleDenyListPayload,
 } from './AllowLists/SimpleDenyList';
 import { type Auth, PassthroughAuth } from './Auth/Auth';
-import { Boost } from './Boost';
+import {
+  Boost,
+  type BoostPayload,
+  type Target,
+  prepareBoostPayload,
+} from './Boost';
 import { type Budget, budgetFromAddress } from './Budgets/Budget';
 import {
   ManagedBudget,
@@ -64,6 +72,7 @@ import {
   ERC20Incentive,
   type ERC20IncentivePayload,
 } from './Incentives/ERC20Incentive';
+import type { ERC20VariableIncentivePayload } from './Incentives/ERC20VariableIncentive';
 import {
   ERC20VariableIncentive,
   type Incentive,
@@ -82,21 +91,20 @@ import {
   BoostCoreNoIdentifierEmitted,
   BudgetMustAuthorizeBoostCore,
   DeployableUnknownOwnerProvidedError,
-  NoContractAddressUponReceiptError,
+  IncentiveNotCloneableError,
+  MustInitializeBudgetError,
 } from './errors';
-import {
-  type ERC20VariableIncentivePayload,
-  type EventActionPayload,
-  type GenericLog,
-  type BoostPayload as OnChainBoostPayload,
-  type ReadParams,
-  type Target,
-  type WriteParams,
-  prepareBoostPayload,
-} from './utils';
+import type { GenericLog, ReadParams, WriteParams } from './utils';
 
 export { boostCoreAbi };
 
+/**
+ * The fee (in wei) required to claim each incentive, must be provided for the `claimIncentive` transaction
+ *
+ * @type {bigint}
+ */
+export const BOOST_CORE_CLAIM_FEE = parseEther('0.000075');
+
 /**
  * The fixed address for the deployed Boost Core.
  * By default, `new BoostCore` will use this address if not otherwise provided.
@@ -245,7 +253,8 @@ export class BoostCore extends Deployable<
     }
     //@ts-expect-error I can't set this property on the class because for some reason it takes super out of constructor scope?
     this.abi = boostCoreAbi;
-  } /**
+  }
+  /**
    * Create a new Boost.
    *
    * @public
@@ -293,30 +302,19 @@ export class BoostCore extends Deployable<
       }
     }
 
-    let budgetPayload: OnChainBoostPayload['budget'] = zeroAddress;
+    let budgetPayload: BoostPayload['budget'] = zeroAddress;
     if (budget.address) {
       budgetPayload = budget.address;
       if (!(await budget.isAuthorized(coreAddress))) {
         throw new BudgetMustAuthorizeBoostCore(coreAddress);
       }
     } else {
-      // budgets are either instantiated with an address or payload, so in this branch payload will exist
-      const authorized = budget.payload?.authorized || [];
-      if (!authorized.includes(coreAddress)) {
-        throw new BudgetMustAuthorizeBoostCore(coreAddress);
-      }
-      const budgetHash = await budget.deployRaw(undefined, options);
-      const receipt = await waitForTransactionReceipt(options.config, {
-        hash: budgetHash,
-      });
-      if (!receipt.contractAddress)
-        throw new NoContractAddressUponReceiptError(receipt);
-      budgetPayload = receipt.contractAddress;
+      throw new MustInitializeBudgetError();
     }
 
     // if we're supplying an address, it could be a pre-initialized target
     // if base is explicitly set to false, then it will not be initialized, and it will be referenced as is if it implements interface correctly
-    let actionPayload: OnChainBoostPayload['action'] = {
+    let actionPayload: BoostPayload['action'] = {
       instance: zeroAddress,
       isBase: true,
       parameters: zeroHash,
@@ -336,7 +334,7 @@ export class BoostCore extends Deployable<
       actionPayload.instance = action.base;
     }
 
-    let validatorPayload: OnChainBoostPayload['validator'] = {
+    let validatorPayload: BoostPayload['validator'] = {
       instance: zeroAddress,
       isBase: true,
       parameters: zeroHash,
@@ -372,7 +370,7 @@ export class BoostCore extends Deployable<
       validatorPayload.instance = validator.base;
     }
 
-    let allowListPayload: OnChainBoostPayload['allowList'] = {
+    let allowListPayload: BoostPayload['allowList'] = {
       instance: zeroAddress,
       isBase: true,
       parameters: zeroHash,
@@ -402,6 +400,7 @@ export class BoostCore extends Deployable<
       const incentive = incentives.at(i)!;
       if (incentive.address) {
         const isBase = incentive.address === incentive.base || incentive.isBase;
+        if (!isBase) throw new IncentiveNotCloneableError(incentive);
         incentivesPayloads[i] = {
           isBase: isBase,
           instance: incentive.address,
@@ -411,8 +410,10 @@ export class BoostCore extends Deployable<
             : zeroHash,
         };
       } else {
+        // biome-ignore lint/style/noNonNullAssertion: this will never be undefined
         incentivesPayloads[i]!.parameters =
           incentive.buildParameters(undefined, options).args.at(0) || zeroHash;
+        // biome-ignore lint/style/noNonNullAssertion: this will never be undefined
         incentivesPayloads[i]!.instance = incentive.base;
       }
     }
@@ -452,6 +453,7 @@ export class BoostCore extends Deployable<
       validator: validator.at(boost.validator),
       allowList: allowList.at(boost.allowList),
       incentives: incentives.map((incentive, i) =>
+        // biome-ignore lint/style/noNonNullAssertion: this will never be undefined
         incentive.at(boost.incentives.at(i)!),
       ),
       protocolFee: boost.protocolFee,
@@ -480,7 +482,7 @@ export class BoostCore extends Deployable<
     data: Hex,
     params?: WriteParams<typeof boostCoreAbi, 'claimIncentive'>,
   ) {
-    return this.awaitResult(
+    return await this.awaitResult(
       this.claimIncentiveRaw(boostId, incentiveId, address, data, params),
     );
   }
@@ -492,7 +494,7 @@ export 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}
@@ -500,7 +502,7 @@ export class BoostCore extends Deployable<
   public async claimIncentiveRaw(
     boostId: bigint,
     incentiveId: bigint,
-    address: Address,
+    referrer: Address,
     data: Hex,
     params?: WriteParams<typeof boostCoreAbi, 'claimIncentive'>,
   ) {
@@ -508,7 +510,7 @@ export class BoostCore extends Deployable<
       this._config,
       {
         address: this.assertValidAddress(),
-        args: [boostId, incentiveId, address, data],
+        args: [boostId, incentiveId, referrer, data],
         ...this.optionallyAttachAccount(),
         // biome-ignore lint/suspicious/noExplicitAny: Accept any shape of valid wagmi/viem parameters, wagmi does the same thing internally
         ...(params as any),
@@ -518,6 +520,74 @@ export class BoostCore extends Deployable<
     return { hash, result };
   }
 
+  /**
+   * Claims one incentive for a given `Boost` on behalf of another user by `boostId` and `incentiveId`
+   *
+   * @public
+   * @async
+   * @param {bigint} boostId
+   * @param {bigint} incentiveId
+   * @param {Address} referrer
+   * @param {Hex} data
+   * @param {Address} claimant
+   * @param {?WriteParams<typeof boostCoreAbi, 'claimIncentiveFor'>} [params]
+   * @returns {unknown}
+   */
+  public async claimIncentiveFor(
+    boostId: bigint,
+    incentiveId: bigint,
+    referrer: Address,
+    data: Hex,
+    claimant: Address,
+    params?: WriteParams<typeof boostCoreAbi, 'claimIncentiveFor'>,
+  ) {
+    return await this.awaitResult(
+      this.claimIncentiveForRaw(
+        boostId,
+        incentiveId,
+        referrer,
+        data,
+        claimant,
+        params,
+      ),
+    );
+  }
+
+  /**
+   * 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<typeof boostCoreAbi, 'claimIncentiveFor'>} [params]
+   * @returns {unknown}
+   */
+  public async claimIncentiveForRaw(
+    boostId: bigint,
+    incentiveId: bigint,
+    referrer: Address,
+    data: Hex,
+    claimant: Address,
+    params?: WriteParams<typeof boostCoreAbi, 'claimIncentiveFor'>,
+  ) {
+    const { request, result } = await simulateBoostCoreClaimIncentiveFor(
+      this._config,
+      {
+        address: this.assertValidAddress(),
+        args: [boostId, incentiveId, referrer, data, claimant],
+        ...this.optionallyAttachAccount(),
+        // biome-ignore lint/suspicious/noExplicitAny: Accept any shape of valid wagmi/viem parameters, wagmi does the same thing internally
+        ...(params as any),
+      },
+    );
+    const hash = await writeBoostCoreClaimIncentiveFor(this._config, request);
+    return { hash, result };
+  }
+
   /**
    * Get a Boost by index, will return the raw on chain representation of a Boost.
    *
@@ -531,7 +601,7 @@ export class BoostCore extends Deployable<
     id: bigint,
     params?: ReadParams<typeof boostCoreAbi, 'getBoost'>,
   ) {
-    return readBoostCoreGetBoost(this._config, {
+    return await readBoostCoreGetBoost(this._config, {
       address: this.assertValidAddress(),
       args: [id],
       ...this.optionallyAttachAccount(),
@@ -605,7 +675,7 @@ export class BoostCore extends Deployable<
   public async getBoostCount(
     params?: ReadParams<typeof boostCoreAbi, 'getBoostCount'>,
   ) {
-    return readBoostCoreGetBoostCount(this._config, {
+    return await readBoostCoreGetBoostCount(this._config, {
       address: this.assertValidAddress(),
       args: [],
       ...this.optionallyAttachAccount(),
@@ -650,7 +720,7 @@ export class BoostCore extends Deployable<
   public async createBoostAuth(
     params?: ReadParams<typeof boostCoreAbi, 'createBoostAuth'>,
   ) {
-    return readBoostCoreCreateBoostAuth(this._config, {
+    return await readBoostCoreCreateBoostAuth(this._config, {
       address: this.assertValidAddress(),
       args: [],
       ...this.optionallyAttachAccount(),
@@ -672,7 +742,7 @@ export class BoostCore extends Deployable<
     auth: Auth,
     params?: WriteParams<typeof boostCoreAbi, 'setCreateBoostAuth'>,
   ) {
-    return this.awaitResult(
+    return await this.awaitResult(
       this.setCreateBoostAuthRaw(auth.assertValidAddress(), {
         ...params,
       }),
@@ -717,7 +787,7 @@ export class BoostCore extends Deployable<
   public async protocolFee(
     params?: ReadParams<typeof boostCoreAbi, 'protocolFee'>,
   ) {
-    return readBoostCoreProtocolFee(this._config, {
+    return await readBoostCoreProtocolFee(this._config, {
       address: this.assertValidAddress(),
       args: [],
       ...this.optionallyAttachAccount(),
@@ -737,7 +807,7 @@ export class BoostCore extends Deployable<
   public async protocolFeeReceiver(
     params?: ReadParams<typeof boostCoreAbi, 'protocolFeeReceiver'>,
   ) {
-    return readBoostCoreProtocolFeeReceiver(this._config, {
+    return await readBoostCoreProtocolFeeReceiver(this._config, {
       address: this.assertValidAddress(),
       args: [],
       ...this.optionallyAttachAccount(),
@@ -759,7 +829,7 @@ export class BoostCore extends Deployable<
     address: Address,
     params?: WriteParams<typeof boostCoreAbi, 'setProtocolFeeReceiver'>,
   ) {
-    return this.awaitResult(
+    return await this.awaitResult(
       this.setProcolFeeReceiverRaw(address, {
         ...params,
       }),
@@ -805,7 +875,7 @@ export class BoostCore extends Deployable<
    * @returns {unknown}
    */
   public async claimFee(params?: ReadParams<typeof boostCoreAbi, 'claimFee'>) {
-    return readBoostCoreClaimFee(this._config, {
+    return await readBoostCoreClaimFee(this._config, {
       address: this.assertValidAddress(),
       args: [],
       ...this.optionallyAttachAccount(),
@@ -827,7 +897,7 @@ export class BoostCore extends Deployable<
     claimFee: bigint,
     params?: WriteParams<typeof boostCoreAbi, 'setClaimFee'>,
   ) {
-    return this.awaitResult(this.setClaimFeeRaw(claimFee, params));
+    return await this.awaitResult(this.setClaimFeeRaw(claimFee, params));
   }
 
   /**
@@ -865,8 +935,7 @@ export 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) {

package/src/BoostRegistry.ts

@@ -21,15 +21,15 @@ import {
   type GenericDeployableParams,
 } from './Deployable/Deployable';
 import type { DeployableTarget } from './Deployable/DeployableTarget';
-import {
-  type GenericLog,
-  type HashAndSimulatedResult,
-  type ReadParams,
+import type {
+  GenericLog,
+  HashAndSimulatedResult,
+  ReadParams,
   RegistryType,
-  type WriteParams,
+  WriteParams,
 } from './utils';
 
-export { RegistryType, boostRegistryAbi };
+export { boostRegistryAbi };
 
 /**
  * The fixed address for the Boost Registry.
@@ -192,7 +192,7 @@ export class BoostRegistry extends Deployable<
     implementation: Address,
     params?: WriteParams<typeof boostRegistryAbi, 'register'>,
   ) {
-    return this.awaitResult(
+    return await this.awaitResult(
       this.registerRaw(registryType, name, implementation, params),
     );
   }
@@ -227,6 +227,27 @@ export class BoostRegistry extends Deployable<
     return { hash, result };
   }
 
+  /**
+   * Initialize a new instance of a registered base implementation, returning the provided target with a new address set on it.
+   * This method is the same as `clone`, but serves to make its function more obvious as to why you'd need to use it.
+   *
+   * @public
+   * @async
+   * @template {DeployableTarget} Target
+   * @param {string} displayName - The display name for the clone
+   * @param {Target} target - An instance of a target contract to clone and initialize
+   * @param {?WriteParams<typeof boostRegistryAbi, 'deployClone'>} [params]
+   * @returns {Target} - The provided instance, but with a new address attached.
+   * biome-ignore lint/suspicious/noExplicitAny: any deployable target will suffice
+   */
+  public initialize<Target extends DeployableTarget<any, any>>(
+    displayName: string,
+    target: Target,
+    params?: WriteParams<typeof boostRegistryAbi, 'deployClone'>,
+  ): Promise<Target> {
+    return this.clone(displayName, target, params);
+  }
+
   /**
    * Deploy a new instance of a registered base implementation, returning the provided target with a new address set on it.
    *
@@ -265,7 +286,9 @@ export class BoostRegistry extends Deployable<
     target: Target,
     params?: WriteParams<typeof boostRegistryAbi, 'deployClone'>,
   ): Promise<Address> {
-    return this.awaitResult(this.deployCloneRaw(displayName, target, params));
+    return await this.awaitResult(
+      this.deployCloneRaw(displayName, target, params),
+    );
   }
 
   /**
@@ -291,12 +314,7 @@ export class BoostRegistry extends Deployable<
       this._config,
       {
         address: this.assertValidAddress(),
-        args: [
-          target.registryType,
-          target.base,
-          displayName,
-          payload.args.at(0)!,
-        ],
+        args: [target.registryType, target.base, displayName, payload.args[0]],
         ...this.optionallyAttachAccount(),
         // biome-ignore lint/suspicious/noExplicitAny: Accept any shape of valid wagmi/viem parameters, wagmi does the same thing internally
         ...(params as any),
@@ -320,7 +338,7 @@ export class BoostRegistry extends Deployable<
     identifier: Hex,
     params?: ReadParams<typeof boostRegistryAbi, 'getBaseImplementation'>,
   ) {
-    return readBoostRegistryGetBaseImplementation(this._config, {
+    return await readBoostRegistryGetBaseImplementation(this._config, {
       address: this.assertValidAddress(),
       args: [identifier],
       ...this.optionallyAttachAccount(),
@@ -330,7 +348,7 @@ export class BoostRegistry extends Deployable<
   }
 
   /**
-   * Get the address of a deployed clone by its identifier (index in incentives array)
+   * Get the address of a deployed clone by its identifier
    *
    * @public
    * @async
@@ -342,7 +360,7 @@ export class BoostRegistry extends Deployable<
     identifier: Hex,
     params?: ReadParams<typeof boostRegistryAbi, 'getClone'>,
   ) {
-    return readBoostRegistryGetBaseImplementation(this._config, {
+    return await readBoostRegistryGetBaseImplementation(this._config, {
       address: this.assertValidAddress(),
       args: [identifier],
       ...this.optionallyAttachAccount(),
@@ -358,13 +376,13 @@ export class BoostRegistry extends Deployable<
    * @async
    * @param {Address} deployer - The address of the deployer
    * @param {?ReadParams<typeof boostRegistryAbi, 'getClones'>} [params]
-   * @returns {Promise<Address[]>} - The list of deployed clones for the given deployer
+   * @returns {Promise<Hex[]>} - The list of deployed clones for the given deployer
    */
   public async getClones(
     deployer: Address,
     params?: ReadParams<typeof boostRegistryAbi, 'getClones'>,
   ) {
-    return readBoostRegistryGetClones(this._config, {
+    return await readBoostRegistryGetClones(this._config, {
       address: this.assertValidAddress(),
       args: [deployer],
       ...this.optionallyAttachAccount(),
@@ -392,7 +410,7 @@ export class BoostRegistry extends Deployable<
     displayName: string,
     params?: ReadParams<typeof boostRegistryAbi, 'getCloneIdentifier'>,
   ) {
-    return readBoostRegistryGetCloneIdentifier(this._config, {
+    return await readBoostRegistryGetCloneIdentifier(this._config, {
       address: this.assertValidAddress(),
       args: [registryType, base, deployer, displayName],
       ...this.optionallyAttachAccount(),
@@ -416,7 +434,7 @@ export class BoostRegistry extends Deployable<
     displayName: string,
     params?: ReadParams<typeof boostRegistryAbi, 'getIdentifier'>,
   ) {
-    return readBoostRegistryGetCloneIdentifier(this._config, {
+    return await readBoostRegistryGetCloneIdentifier(this._config, {
       address: this.assertValidAddress(),
       args: [registryType, displayName],
       ...this.optionallyAttachAccount(),

package/src/Budgets/ManagedBudget.ts

@@ -29,6 +29,8 @@ import {
   type Address,
   type ContractEventName,
   type Hex,
+  encodeAbiParameters,
+  parseAbiParameters,
   zeroAddress,
 } from 'viem';
 import type {
@@ -43,22 +45,46 @@ import {
 import {
   type ERC1155TransferPayload,
   type FungibleTransferPayload,
+  prepareERC1155Transfer,
+  prepareFungibleTransfer,
+} from '../transfers';
+import {
   type GenericLog,
-  type ManagedBudgetPayload,
   type ReadParams,
   RegistryType,
   type WriteParams,
-  prepareERC1155Transfer,
-  prepareFungibleTransfer,
-  prepareManagedBudgetPayload,
 } from '../utils';
 
 export { managedBudgetAbi };
-export type {
-  ERC1155TransferPayload,
-  FungibleTransferPayload,
-  ManagedBudgetPayload,
-};
+export type { ERC1155TransferPayload, FungibleTransferPayload };
+
+/**
+ * The object representation of a `ManagedBudgetPayload.InitPayload`
+ *
+ * @export
+ * @interface ManagedBudgetPayload
+ * @typedef {ManagedBudgetPayload}
+ */
+export interface ManagedBudgetPayload {
+  /**
+   * The budget's owner
+   *
+   * @type {Address}
+   */
+  owner: Address;
+  /**
+   * List of accounts authorized to use the budget. This list should include a Boost core address to interact with the protocol.
+   *
+   * @type {Address[]}
+   */
+  authorized: Address[];
+  /**
+   * List of roles to assign to the corresponding account by index.
+   *
+   * @type {bigint[]}
+   */
+  roles: bigint[];
+}
 
 /**
  * Enum representing available roles for use in the `ManagedBudget`.
@@ -185,7 +211,7 @@ export class ManagedBudget extends DeployableTarget<
     transfer: FungibleTransferPayload | ERC1155TransferPayload,
     params?: WriteParams<typeof managedBudgetAbi, 'allocate'>,
   ) {
-    return this.awaitResult(this.allocateRaw(transfer, params));
+    return await this.awaitResult(this.allocateRaw(transfer, params));
   }
 
   /**
@@ -233,7 +259,7 @@ export class ManagedBudget extends DeployableTarget<
     transfer: FungibleTransferPayload | ERC1155TransferPayload,
     params?: WriteParams<typeof managedBudgetAbi, 'clawback'>,
   ) {
-    return this.awaitResult(this.clawbackRaw(transfer, params));
+    return await this.awaitResult(this.clawbackRaw(transfer, params));
   }
 
   /**
@@ -280,7 +306,7 @@ export class ManagedBudget extends DeployableTarget<
     transfer: FungibleTransferPayload | ERC1155TransferPayload,
     params?: WriteParams<typeof managedBudgetAbi, 'disburse'>,
   ) {
-    return this.awaitResult(this.disburseRaw(transfer, params));
+    return await this.awaitResult(this.disburseRaw(transfer, params));
   }
 
   /**
@@ -324,7 +350,7 @@ export class ManagedBudget extends DeployableTarget<
     transfers: Array<FungibleTransferPayload | ERC1155TransferPayload>,
     params?: WriteParams<typeof managedBudgetAbi, 'disburseBatch'>,
   ) {
-    return this.awaitResult(this.disburseBatchRaw(transfers, params));
+    return await this.awaitResult(this.disburseBatchRaw(transfers, params));
   }
 
   /**
@@ -370,7 +396,9 @@ export class ManagedBudget extends DeployableTarget<
     allowed: boolean[],
     params?: WriteParams<typeof managedBudgetAbi, 'setAuthorized'>,
   ) {
-    return this.awaitResult(this.setAuthorizedRaw(addresses, allowed, params));
+    return await this.awaitResult(
+      this.setAuthorizedRaw(addresses, allowed, params),
+    );
   }
 
   /**
@@ -422,7 +450,7 @@ export class ManagedBudget extends DeployableTarget<
     roles: bigint[],
     params?: WriteParams<typeof managedBudgetAbi, 'grantRoles'>,
   ) {
-    return this.awaitResult(this.grantRolesRaw(addresses, roles, params));
+    return await this.awaitResult(this.grantRolesRaw(addresses, roles, params));
   }
 
   /**
@@ -481,7 +509,9 @@ export class ManagedBudget extends DeployableTarget<
     roles: bigint[],
     params?: WriteParams<typeof managedBudgetAbi, 'revokeRoles'>,
   ) {
-    return this.awaitResult(this.revokeRolesRaw(addresses, roles, params));
+    return await this.awaitResult(
+      this.revokeRolesRaw(addresses, roles, params),
+    );
   }
 
   /**
@@ -741,3 +771,26 @@ export class ManagedBudget extends DeployableTarget<
     };
   }
 }
+
+/**
+ * Given a {@link ManagedBudgetPayload}, properly encode a `ManagedBudget.InitPayload` for use with {@link ManagedBudget} initialization.
+ *
+ * @param {ManagedBudgetPayload} param0
+ * @param {Address} param0.owner - The budget's owner
+ * @param {{}} param0.authorized - List of accounts authorized to use the budget. This list should include a Boost core address to interact with the protocol.
+ * @param {{}} param0.roles - List of roles to assign to the corresponding account by index.
+ * @returns {*}
+ */
+export const prepareManagedBudgetPayload = ({
+  owner,
+  authorized,
+  roles,
+}: ManagedBudgetPayload) => {
+  return encodeAbiParameters(
+    parseAbiParameters([
+      'ManagedBudgetPayload payload',
+      'struct ManagedBudgetPayload { address owner; address[] authorized; uint256[] roles; }',
+    ]),
+    [{ owner, authorized, roles }],
+  );
+};