@aztec/aztec.js 0.0.0-test.1 → 0.0.1-commit.5476d83

package/dest/contract/deploy_method.d.ts

@@ -1,113 +1,159 @@
-import type { Fr } from '@aztec/foundation/fields';
+import { Fr } from '@aztec/foundation/fields';
 import { type ContractArtifact, type FunctionArtifact } from '@aztec/stdlib/abi';
+import type { AuthWitness } from '@aztec/stdlib/auth-witness';
 import { AztecAddress } from '@aztec/stdlib/aztec-address';
 import { type ContractInstanceWithAddress } from '@aztec/stdlib/contract';
-import type { GasSettings } from '@aztec/stdlib/gas';
 import type { PublicKeys } from '@aztec/stdlib/keys';
-import type { TxExecutionRequest } from '@aztec/stdlib/tx';
-import type { Wallet } from '../account/index.js';
-import type { ExecutionRequestInit } from '../entrypoint/entrypoint.js';
-import { BaseContractInteraction, type SendMethodOptions } from './base_contract_interaction.js';
-import type { Contract } from './contract.js';
+import { type Capsule, type TxProfileResult } from '@aztec/stdlib/tx';
+import { ExecutionPayload } from '@aztec/stdlib/tx';
+import type { Wallet } from '../wallet/wallet.js';
+import { BaseContractInteraction } from './base_contract_interaction.js';
 import type { ContractBase } from './contract_base.js';
-import { DeployProvenTx } from './deploy_proven_tx.js';
 import { DeploySentTx } from './deploy_sent_tx.js';
+import { type ProfileInteractionOptions, type RequestInteractionOptions, type SendInteractionOptions, type SimulationInteractionFeeOptions, type SimulationReturn } from './interaction_options.js';
 /**
  * Options for deploying a contract on the Aztec network.
- * Allows specifying a contract address salt, and additional send method options.
+ * Allows specifying a contract address salt and different options to tweak contract publication
+ * and initialization
  */
-export type DeployOptions = {
+export type RequestDeployOptions = RequestInteractionOptions & {
     /** An optional salt value used to deterministically calculate the contract address. */
     contractAddressSalt?: Fr;
-    /** Set to true to *not* include the sender in the address computation. */
-    universalDeploy?: boolean;
-    /** Skip contract class registration. */
-    skipClassRegistration?: boolean;
-    /** Skip public deployment, instead just privately initialize the contract. */
-    skipPublicDeployment?: boolean;
+    /**
+     * Deployer address that will be used for the deployed contract's address computation.
+     * If set to 0, the sender's address won't be mixed in
+     */
+    deployer?: AztecAddress;
+    /** Skip contract class publication. */
+    skipClassPublication?: boolean;
+    /** Skip publication, instead just privately initialize the contract. */
+    skipInstancePublication?: boolean;
     /** Skip contract initialization. */
     skipInitialization?: boolean;
-} & SendMethodOptions;
+    /** Skip contract registration in the wallet */
+    skipRegistration?: boolean;
+};
+/**
+ * Extends the deployment options with the required parameters to send the transaction
+ */
+export type DeployOptions = Omit<RequestDeployOptions, 'deployer'> & {
+    /**
+     * Set to true to *not* include the sender in the address computation. This option
+     * is mutually exclusive with "deployer"
+     */
+    universalDeploy?: boolean;
+} & Pick<SendInteractionOptions, 'from' | 'fee'>;
+/**
+ * Options for simulating the deployment of a contract
+ * Allows skipping certain validations and computing gas estimations
+ */
+export type SimulateDeployOptions = Omit<DeployOptions, 'fee'> & {
+    /** The fee options for the transaction. */
+    fee?: SimulationInteractionFeeOptions;
+    /** Simulate without checking for the validity of the resulting transaction,
+     * e.g. whether it emits any existing nullifiers. */
+    skipTxValidation?: boolean;
+    /** Whether to ensure the fee payer is not empty and has enough balance to pay for the fee. */
+    skipFeeEnforcement?: boolean;
+    /** Whether to include metadata such as offchain effects and performance statistics
+     * (e.g. timing information of the different circuits and oracles) in
+     * the simulation result, instead of just the return value of the function */
+    includeMetadata?: boolean;
+};
 /**
- * Contract interaction for deployment. Handles class registration, public instance deployment,
- * and initialization of the contract. Extends the BaseContractInteraction class.
+ * Contract interaction for deployment.
+ * Handles class publication, instance publication, and initialization of the contract.
+ *
+ * Note that for some contracts, a tx is not required as part of its "creation":
+ * If there are no public functions, and if there are no initialization functions,
+ * then technically the contract has already been "created", and all of the contract's
+ * functions (private and utility) can be interacted-with immediately, without any
+ * "deployment tx".
+ *
+ * Extends the BaseContractInteraction class.
  */
-export declare class DeployMethod<TContract extends ContractBase = Contract> extends BaseContractInteraction {
+export declare class DeployMethod<TContract extends ContractBase = ContractBase> extends BaseContractInteraction {
     private publicKeys;
-    private artifact;
-    private postDeployCtor;
+    protected artifact: ContractArtifact;
+    protected postDeployCtor: (instance: ContractInstanceWithAddress, wallet: Wallet) => TContract;
     private args;
     /** The contract instance to be deployed. */
     private instance?;
     /** Constructor function to call. */
     private constructorArtifact;
-    constructor(publicKeys: PublicKeys, wallet: Wallet, artifact: ContractArtifact, postDeployCtor: (address: AztecAddress, wallet: Wallet) => Promise<TContract>, args?: any[], constructorNameOrArtifact?: string | FunctionArtifact);
+    constructor(publicKeys: PublicKeys, wallet: Wallet, artifact: ContractArtifact, postDeployCtor: (instance: ContractInstanceWithAddress, wallet: Wallet) => TContract, args?: any[], constructorNameOrArtifact?: string | FunctionArtifact, authWitnesses?: AuthWitness[], capsules?: Capsule[]);
     /**
-     * Create a contract deployment transaction, given the deployment options.
-     * This function internally calls `request()` and `sign()` methods to prepare
-     * the transaction for deployment. The resulting signed transaction can be
-     * later sent using the `send()` method.
-     *
-     * @param options - An object containing optional deployment settings, contractAddressSalt, and from.
-     * @returns A Promise resolving to an object containing the signed transaction data and other relevant information.
+     * Returns the execution payload that allows this operation to happen on chain.
+     * @param options - Configuration options.
+     * @returns The execution payload for this operation
      */
-    create(options?: DeployOptions): Promise<TxExecutionRequest>;
+    request(options?: RequestDeployOptions): Promise<ExecutionPayload>;
+    convertDeployOptionsToRequestOptions(options: DeployOptions): RequestDeployOptions;
     /**
-     * Returns an array of function calls that represent this operation. Useful as a building
-     * block for constructing batch requests.
+     * Adds this contract to the wallet and returns the Contract object.
      * @param options - Deployment options.
-     * @returns An array of function calls.
-     * @remarks This method does not have the same return type as the `request` in the ContractInteraction object,
-     * it returns a promise for an array instead of a function call directly.
      */
-    request(options?: DeployOptions): Promise<ExecutionRequestInit>;
+    register(options?: RequestDeployOptions): Promise<TContract>;
     /**
-     * Register this contract in the PXE and returns the Contract object.
-     * @param options - Deployment options.
-     */
-    register(options?: DeployOptions): Promise<TContract>;
-    /**
-     * Returns calls for registration of the class and deployment of the instance, depending on the provided options.
-     * @param options - Deployment options.
-     * @returns A function call array with potentially requests to the class registerer and instance deployer.
+     * Returns an execution payload for:
+     * - publication of the contract class and
+     * - publication of the contract instance to enable public execution
+     * depending on the provided options.
+     * @param options - Contract creation options.
+     * @returns An execution payload with potentially calls (and bytecode capsule) to the class registry and instance registry.
      */
-    protected getDeploymentFunctionCalls(options?: DeployOptions): Promise<Pick<ExecutionRequestInit, 'calls' | 'authWitnesses' | 'hashedArguments' | 'capsules'>>;
+    protected getPublicationExecutionPayload(options?: RequestDeployOptions): Promise<ExecutionPayload>;
     /**
      * Returns the calls necessary to initialize the contract.
      * @param options - Deployment options.
      * @returns - An array of function calls.
      */
-    protected getInitializeFunctionCalls(options: DeployOptions): Promise<Pick<ExecutionRequestInit, 'calls' | 'authWitnesses' | 'hashedArguments' | 'capsules'>>;
+    protected getInitializationExecutionPayload(options?: RequestDeployOptions): Promise<ExecutionPayload>;
     /**
-     * Send the contract deployment transaction using the provided options.
+     * Send a contract deployment transaction (initialize and/or publish) using the provided options.
      * This function extends the 'send' method from the ContractFunctionInteraction class,
      * allowing us to send a transaction specifically for contract deployment.
      *
      * @param options - An object containing various deployment options such as contractAddressSalt and from.
      * @returns A SentTx object that returns the receipt and the deployed contract instance.
      */
-    send(options?: DeployOptions): DeploySentTx<TContract>;
+    send(options: DeployOptions): DeploySentTx<TContract>;
     /**
-     * Builds the contract instance to be deployed and returns it.
+     * Builds the contract instance and returns it.
      *
-     * @param options - An object containing various deployment options.
+     * @param options - An object containing various initialization and publication options.
      * @returns An instance object.
      */
-    getInstance(options?: DeployOptions): Promise<ContractInstanceWithAddress>;
+    getInstance(options?: RequestDeployOptions): Promise<ContractInstanceWithAddress>;
     /**
-     * Prove the request.
-     * @param options - Deployment options.
-     * @returns The proven tx.
+     * Simulate the deployment
+     *
+     * @param options - An optional object containing additional configuration for the simulation.
+     * @returns A simulation result object containing metadata of the execution, including gas
+     * estimations (if requested via options), execution statistics and emitted offchain effects
      */
-    prove(options: DeployOptions): Promise<DeployProvenTx<TContract>>;
+    simulate(options: SimulateDeployOptions): Promise<SimulationReturn<true>>;
     /**
-     * Estimates gas cost for this deployment operation.
-     * @param options - Options.
+     * Simulate a deployment and profile the gate count for each function in the transaction.
+     * @param options - Same options as `send`, plus extra profiling options.
+     *
+     * @returns An object containing the function return value and profile result.
      */
-    estimateGas(options?: Omit<DeployOptions, 'estimateGas' | 'skipPublicSimulation'>): Promise<Pick<GasSettings, 'gasLimits' | 'teardownGasLimits'>>;
+    profile(options: DeployOptions & ProfileInteractionOptions): Promise<TxProfileResult>;
     /** Return this deployment address. */
     get address(): AztecAddress | undefined;
     /** Returns the partial address for this deployment. */
     get partialAddress(): Promise<Fr> | undefined;
+    /**
+     * Augments this DeployMethod with additional metadata, such as authWitnesses and capsules.
+     * @param options - An object containing the metadata to add to the interaction
+     * @returns A new DeployMethod with the added metadata, but calling the same original function in the same manner
+     */
+    with({ authWitnesses, capsules }: {
+        /** The authWitnesses to add to the deployment */
+        authWitnesses?: AuthWitness[];
+        /** The capsules to add to the deployment */
+        capsules?: Capsule[];
+    }): DeployMethod;
 }
-//# sourceMappingURL=deploy_method.d.ts.map
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGVwbG95X21ldGhvZC5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NvbnRyYWN0L2RlcGxveV9tZXRob2QudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLDBCQUEwQixDQUFDO0FBQzlDLE9BQU8sRUFBRSxLQUFLLGdCQUFnQixFQUFvQixLQUFLLGdCQUFnQixFQUFrQixNQUFNLG1CQUFtQixDQUFDO0FBQ25ILE9BQU8sS0FBSyxFQUFFLFdBQVcsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQzlELE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUMzRCxPQUFPLEVBQ0wsS0FBSywyQkFBMkIsRUFJakMsTUFBTSx3QkFBd0IsQ0FBQztBQUNoQyxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUNyRCxPQUFPLEVBQUUsS0FBSyxPQUFPLEVBQUUsS0FBSyxlQUFlLEVBQTBCLE1BQU0sa0JBQWtCLENBQUM7QUFDOUYsT0FBTyxFQUFFLGdCQUFnQixFQUEwQixNQUFNLGtCQUFrQixDQUFDO0FBSTVFLE9BQU8sS0FBSyxFQUFFLE1BQU0sRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBQ2xELE9BQU8sRUFBRSx1QkFBdUIsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ3pFLE9BQU8sS0FBSyxFQUFFLFlBQVksRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBRXZELE9BQU8sRUFBRSxZQUFZLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUVuRCxPQUFPLEVBQ0wsS0FBSyx5QkFBeUIsRUFDOUIsS0FBSyx5QkFBeUIsRUFDOUIsS0FBSyxzQkFBc0IsRUFDM0IsS0FBSywrQkFBK0IsRUFDcEMsS0FBSyxnQkFBZ0IsRUFJdEIsTUFBTSwwQkFBMEIsQ0FBQztBQUVsQzs7OztHQUlHO0FBQ0gsTUFBTSxNQUFNLG9CQUFvQixHQUFHLHlCQUF5QixHQUFH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

package/dest/contract/deploy_method.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"deploy_method.d.ts","sourceRoot":"","sources":["../../src/contract/deploy_method.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"deploy_method.d.ts","sourceRoot":"","sources":["../../src/contract/deploy_method.ts"],"names":[],"mappings":"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"}

package/dest/contract/deploy_method.js

@@ -1,17 +1,27 @@
+import { Fr } from '@aztec/foundation/fields';
 import { getInitializer } from '@aztec/stdlib/abi';
 import { AztecAddress } from '@aztec/stdlib/aztec-address';
-import { computePartialAddress, getContractClassFromArtifact, getContractInstanceFromDeployParams } from '@aztec/stdlib/contract';
-import { deployInstance } from '../deployment/deploy_instance.js';
-import { registerContractClass } from '../deployment/register_class.js';
+import { computePartialAddress, getContractClassFromArtifact, getContractInstanceFromInstantiationParams } from '@aztec/stdlib/contract';
+import { collectOffchainEffects } from '@aztec/stdlib/tx';
+import { mergeExecutionPayloads } from '@aztec/stdlib/tx';
+import { publishContractClass } from '../deployment/publish_class.js';
+import { publishInstance } from '../deployment/publish_instance.js';
 import { BaseContractInteraction } from './base_contract_interaction.js';
 import { ContractFunctionInteraction } from './contract_function_interaction.js';
-import { DeployProvenTx } from './deploy_proven_tx.js';
 import { DeploySentTx } from './deploy_sent_tx.js';
-// docs:end:deploy_options
-// TODO(@spalladino): Add unit tests for this class!
+import { getGasLimits } from './get_gas_limits.js';
+import { toProfileOptions, toSendOptions, toSimulateOptions } from './interaction_options.js';
 /**
- * Contract interaction for deployment. Handles class registration, public instance deployment,
- * and initialization of the contract. Extends the BaseContractInteraction class.
+ * Contract interaction for deployment.
+ * Handles class publication, instance publication, and initialization of the contract.
+ *
+ * Note that for some contracts, a tx is not required as part of its "creation":
+ * If there are no public functions, and if there are no initialization functions,
+ * then technically the contract has already been "created", and all of the contract's
+ * functions (private and utility) can be interacted-with immediately, without any
+ * "deployment tx".
+ *
+ * Extends the BaseContractInteraction class.
  */ export class DeployMethod extends BaseContractInteraction {
     publicKeys;
     artifact;
@@ -19,99 +29,57 @@ import { DeploySentTx } from './deploy_sent_tx.js';
     args;
     /** The contract instance to be deployed. */ instance;
     /** Constructor function to call. */ constructorArtifact;
-    constructor(publicKeys, wallet, artifact, postDeployCtor, args = [], constructorNameOrArtifact){
-        super(wallet), this.publicKeys = publicKeys, this.artifact = artifact, this.postDeployCtor = postDeployCtor, this.args = args, this.instance = undefined;
+    constructor(publicKeys, wallet, artifact, postDeployCtor, args = [], constructorNameOrArtifact, authWitnesses = [], capsules = []){
+        super(wallet, authWitnesses, capsules), this.publicKeys = publicKeys, this.artifact = artifact, this.postDeployCtor = postDeployCtor, this.args = args, this.instance = undefined;
         this.constructorArtifact = getInitializer(artifact, constructorNameOrArtifact);
     }
     /**
-   * Create a contract deployment transaction, given the deployment options.
-   * This function internally calls `request()` and `sign()` methods to prepare
-   * the transaction for deployment. The resulting signed transaction can be
-   * later sent using the `send()` method.
-   *
-   * @param options - An object containing optional deployment settings, contractAddressSalt, and from.
-   * @returns A Promise resolving to an object containing the signed transaction data and other relevant information.
-   */ async create(options = {}) {
-        return this.wallet.createTxExecutionRequest(await this.request(options));
-    }
-    // REFACTOR: Having a `request` method with different semantics than the ones in the other
-    // derived ContractInteractions is confusing. We should unify the flow of all ContractInteractions.
-    /**
-   * Returns an array of function calls that represent this operation. Useful as a building
-   * block for constructing batch requests.
-   * @param options - Deployment options.
-   * @returns An array of function calls.
-   * @remarks This method does not have the same return type as the `request` in the ContractInteraction object,
-   * it returns a promise for an array instead of a function call directly.
-   */ async request(options = {}) {
-        const deployment = await this.getDeploymentFunctionCalls(options);
-        // NOTE: MEGA HACK. Remove with #10007
-        // register the contract after generating deployment function calls in order to publicly register the class and (optioanlly) emit its bytecode
-        //
-        // TODO: Should we add the contracts to the DB here, or once the tx has been sent or mined?
-        // Note that we need to run this registerContract here so it's available when computeFeeOptionsFromEstimatedGas
-        // runs, since it needs the contract to have been registered in order to estimate gas for its initialization,
-        // in case the initializer is public. This hints at the need of having "transient" contracts scoped to a
-        // simulation, so we can run the simulation with a set of contracts, but only "commit" them to the wallet
-        // once this tx has gone through.
-        await this.wallet.registerContract({
-            artifact: this.artifact,
-            instance: await this.getInstance(options)
-        });
-        const bootstrap = await this.getInitializeFunctionCalls(options);
-        if (deployment.calls.length + bootstrap.calls.length === 0) {
-            throw new Error(`No function calls needed to deploy contract ${this.artifact.name}`);
+   * Returns the execution payload that allows this operation to happen on chain.
+   * @param options - Configuration options.
+   * @returns The execution payload for this operation
+   */ async request(options) {
+        const publication = await this.getPublicationExecutionPayload(options);
+        if (!options?.skipRegistration) {
+            await this.wallet.registerContract(await this.getInstance(options), this.artifact);
         }
-        const calls = [
-            ...deployment.calls,
-            ...bootstrap.calls
-        ];
-        const authWitnesses = [
-            ...deployment.authWitnesses ?? [],
-            ...bootstrap.authWitnesses ?? []
-        ];
-        const hashedArguments = [
-            ...deployment.hashedArguments ?? [],
-            ...bootstrap.hashedArguments ?? []
-        ];
-        const capsules = [
-            ...deployment.capsules ?? [],
-            ...bootstrap.capsules ?? []
-        ];
-        const { cancellable, nonce, fee: userFee } = options;
-        const request = {
-            calls,
-            authWitnesses,
-            hashedArguments,
-            capsules,
-            cancellable,
-            fee: userFee,
-            nonce
-        };
-        const fee = await this.getFeeOptions(request);
+        const initialization = await this.getInitializationExecutionPayload(options);
+        const feeExecutionPayload = options?.fee?.paymentMethod ? await options.fee.paymentMethod.getExecutionPayload() : undefined;
+        const finalExecutionPayload = feeExecutionPayload ? mergeExecutionPayloads([
+            feeExecutionPayload,
+            publication,
+            initialization
+        ]) : mergeExecutionPayloads([
+            publication,
+            initialization
+        ]);
+        if (!finalExecutionPayload.calls.length) {
+            throw new Error(`No transactions are needed to publish or initialize contract ${this.artifact.name}`);
+        }
+        return finalExecutionPayload;
+    }
+    convertDeployOptionsToRequestOptions(options) {
         return {
-            ...request,
-            fee
+            ...options,
+            deployer: !options?.universalDeploy ? options.from : undefined
         };
     }
     /**
-   * Register this contract in the PXE and returns the Contract object.
+   * Adds this contract to the wallet and returns the Contract object.
    * @param options - Deployment options.
-   */ async register(options = {}) {
+   */ async register(options) {
         const instance = await this.getInstance(options);
-        await this.wallet.registerContract({
-            artifact: this.artifact,
-            instance
-        });
-        return this.postDeployCtor(instance.address, this.wallet);
+        await this.wallet.registerContract(instance, this.artifact);
+        return this.postDeployCtor(instance, this.wallet);
     }
     /**
-   * Returns calls for registration of the class and deployment of the instance, depending on the provided options.
-   * @param options - Deployment options.
-   * @returns A function call array with potentially requests to the class registerer and instance deployer.
-   */ async getDeploymentFunctionCalls(options = {}) {
+   * Returns an execution payload for:
+   * - publication of the contract class and
+   * - publication of the contract instance to enable public execution
+   * depending on the provided options.
+   * @param options - Contract creation options.
+   * @returns An execution payload with potentially calls (and bytecode capsule) to the class registry and instance registry.
+   */ async getPublicationExecutionPayload(options) {
         const calls = [];
-        const capsules = [];
         // Set contract instance object so it's available for populating the DeploySendTx object
         const instance = await this.getInstance(options);
         // Obtain contract class from artifact and check it matches the reported one by the instance.
@@ -120,88 +88,105 @@ import { DeploySentTx } from './deploy_sent_tx.js';
         if (!instance.currentContractClassId.equals(contractClass.id)) {
             throw new Error(`Contract class mismatch when deploying contract: got ${instance.currentContractClassId.toString()} from instance and ${contractClass.id.toString()} from artifact`);
         }
-        // Register the contract class if it hasn't been published already.
-        if (!options.skipClassRegistration) {
+        // Publish the contract class if it hasn't been published already.
+        if (!options?.skipClassPublication) {
             if ((await this.wallet.getContractClassMetadata(contractClass.id)).isContractClassPubliclyRegistered) {
-                this.log.debug(`Skipping registration of already registered contract class ${contractClass.id.toString()} for ${instance.address.toString()}`);
+                this.log.debug(`Skipping publication of already-registered contract class ${contractClass.id.toString()} for ${instance.address.toString()}`);
             } else {
-                this.log.info(`Creating request for registering contract class ${contractClass.id.toString()} as part of deployment for ${instance.address.toString()}`);
-                const registerContractClassInteraction = await registerContractClass(this.wallet, this.artifact);
+                this.log.info(`Creating request for publishing contract class ${contractClass.id.toString()} as part of deployment for ${instance.address.toString()}`);
+                const registerContractClassInteraction = await publishContractClass(this.wallet, this.artifact);
                 calls.push(await registerContractClassInteraction.request());
-                capsules.push(...registerContractClassInteraction.getCapsules());
             }
         }
-        // Deploy the contract via the instance deployer.
-        if (!options.skipPublicDeployment) {
-            const deploymentInteraction = await deployInstance(this.wallet, instance);
+        // Publish the contract instance:
+        if (!options?.skipInstancePublication) {
+            // TODO(https://github.com/AztecProtocol/aztec-packages/issues/15596):
+            // Read the artifact, and if there are no public functions, warn the caller that publication of the
+            // contract instance is not necessary (until such time as they wish to update the instance (i.e. change its class_id)).
+            const deploymentInteraction = await publishInstance(this.wallet, instance);
             calls.push(await deploymentInteraction.request());
-            capsules.push(...deploymentInteraction.getCapsules());
         }
-        return {
-            calls,
-            capsules
-        };
+        return mergeExecutionPayloads(calls);
     }
     /**
    * Returns the calls necessary to initialize the contract.
    * @param options - Deployment options.
    * @returns - An array of function calls.
-   */ async getInitializeFunctionCalls(options) {
-        const { address } = await this.getInstance(options);
-        const calls = [];
-        const capsules = [];
-        if (this.constructorArtifact && !options.skipInitialization) {
+   */ async getInitializationExecutionPayload(options) {
+        const executionsPayloads = [];
+        if (this.constructorArtifact && !options?.skipInitialization) {
+            const { address } = await this.getInstance(options);
             const constructorCall = new ContractFunctionInteraction(this.wallet, address, this.constructorArtifact, this.args);
-            calls.push(await constructorCall.request());
-            capsules.push(...constructorCall.getCapsules());
+            executionsPayloads.push(await constructorCall.request());
         }
-        return {
-            calls,
-            capsules
-        };
+        return mergeExecutionPayloads(executionsPayloads);
     }
     /**
-   * Send the contract deployment transaction using the provided options.
+   * Send a contract deployment transaction (initialize and/or publish) using the provided options.
    * This function extends the 'send' method from the ContractFunctionInteraction class,
    * allowing us to send a transaction specifically for contract deployment.
    *
    * @param options - An object containing various deployment options such as contractAddressSalt and from.
    * @returns A SentTx object that returns the receipt and the deployed contract instance.
-   */ send(options = {}) {
-        const txHashPromise = super.send(options).getTxHash();
+   */ send(options) {
+        const sendTx = async ()=>{
+            const executionPayload = await this.request(this.convertDeployOptionsToRequestOptions(options));
+            const sendOptions = toSendOptions(options);
+            return this.wallet.sendTx(executionPayload, sendOptions);
+        };
         this.log.debug(`Sent deployment tx of ${this.artifact.name} contract`);
-        return new DeploySentTx(this.wallet, txHashPromise, this.postDeployCtor, ()=>this.getInstance(options));
+        return new DeploySentTx(this.wallet, sendTx, this.postDeployCtor, ()=>this.getInstance(options));
     }
     /**
-   * Builds the contract instance to be deployed and returns it.
+   * Builds the contract instance and returns it.
    *
-   * @param options - An object containing various deployment options.
+   * @param options - An object containing various initialization and publication options.
    * @returns An instance object.
-   */ async getInstance(options = {}) {
+   */ async getInstance(options) {
         if (!this.instance) {
-            this.instance = await getContractInstanceFromDeployParams(this.artifact, {
+            this.instance = await getContractInstanceFromInstantiationParams(this.artifact, {
                 constructorArgs: this.args,
-                salt: options.contractAddressSalt,
+                salt: options?.contractAddressSalt ?? Fr.random(),
                 publicKeys: this.publicKeys,
                 constructorArtifact: this.constructorArtifact,
-                deployer: options.universalDeploy ? AztecAddress.ZERO : this.wallet.getAddress()
+                deployer: options?.deployer ? options.deployer : AztecAddress.ZERO
             });
         }
         return this.instance;
     }
     /**
-   * Prove the request.
-   * @param options - Deployment options.
-   * @returns The proven tx.
-   */ async prove(options) {
-        const txProvingResult = await this.proveInternal(options);
-        return new DeployProvenTx(this.wallet, txProvingResult.toTx(), this.postDeployCtor, ()=>this.getInstance(options));
+   * Simulate the deployment
+   *
+   * @param options - An optional object containing additional configuration for the simulation.
+   * @returns A simulation result object containing metadata of the execution, including gas
+   * estimations (if requested via options), execution statistics and emitted offchain effects
+   */ async simulate(options) {
+        const executionPayload = await this.request(this.convertDeployOptionsToRequestOptions(options));
+        const simulatedTx = await this.wallet.simulateTx(executionPayload, toSimulateOptions(options));
+        const { gasLimits, teardownGasLimits } = getGasLimits(simulatedTx, options.fee?.estimatedGasPadding);
+        this.log.verbose(`Estimated gas limits for tx: DA=${gasLimits.daGas} L2=${gasLimits.l2Gas} teardownDA=${teardownGasLimits.daGas} teardownL2=${teardownGasLimits.l2Gas}`);
+        return {
+            stats: simulatedTx.stats,
+            offchainEffects: collectOffchainEffects(simulatedTx.privateExecutionResult),
+            result: undefined,
+            estimatedGas: {
+                gasLimits,
+                teardownGasLimits
+            }
+        };
     }
     /**
-   * Estimates gas cost for this deployment operation.
-   * @param options - Options.
-   */ estimateGas(options) {
-        return super.estimateGas(options);
+   * Simulate a deployment and profile the gate count for each function in the transaction.
+   * @param options - Same options as `send`, plus extra profiling options.
+   *
+   * @returns An object containing the function return value and profile result.
+   */ async profile(options) {
+        const executionPayload = await this.request(this.convertDeployOptionsToRequestOptions(options));
+        return await this.wallet.profileTx(executionPayload, {
+            ...toProfileOptions(options),
+            profileMode: options.profileMode,
+            skipProofGeneration: options.skipProofGeneration
+        });
     }
     /** Return this deployment address. */ get address() {
         return this.instance?.address;
@@ -209,4 +194,11 @@ import { DeploySentTx } from './deploy_sent_tx.js';
     /** Returns the partial address for this deployment. */ get partialAddress() {
         return this.instance && computePartialAddress(this.instance);
     }
+    /**
+   * Augments this DeployMethod with additional metadata, such as authWitnesses and capsules.
+   * @param options - An object containing the metadata to add to the interaction
+   * @returns A new DeployMethod with the added metadata, but calling the same original function in the same manner
+   */ with({ authWitnesses = [], capsules = [] }) {
+        return new DeployMethod(this.publicKeys, this.wallet, this.artifact, this.postDeployCtor, this.args, this.constructorArtifact?.name, this.authWitnesses.concat(authWitnesses), this.capsules.concat(capsules));
+    }
 }