@walletmesh/aztec-rpc-wallet 0.3.0 → 0.4.0

package/dist/client/aztec-dapp-wallet.js

@@ -0,0 +1,705 @@
+import { Contract, DeploySentTx, SentTx } from '@aztec/aztec.js';
+import { DefaultAccountEntrypoint } from '@aztec/entrypoints/account';
+import { createLogger } from '@aztec/foundation/log';
+const logger = createLogger('aztec-rpc-wallet:dapp-wallet');
+/**
+ * RPC-based AuthWitnessProvider that delegates auth witness creation to the wallet via RPC.
+ * This allows the DefaultAccountEntrypoint to create auth witnesses through the remote wallet.
+ * @internal
+ */
+class RPCAuthWitnessProvider {
+    constructor(wallet) {
+        this.wallet = wallet;
+    }
+    /**
+     * Creates an authorization witness for the given message hash.
+     * Delegates the call to the underlying AztecDappWallet instance.
+     * @param messageHash - The message hash to authorize.
+     * @returns A promise that resolves to the AuthWitness.
+     */
+    async createAuthWit(messageHash) {
+        return this.wallet.createAuthWit(messageHash);
+    }
+}
+/**
+ * Aztec DApp Wallet that implements the aztec.js {@link Wallet} interface.
+ * This class provides a client-side representation of an Aztec wallet,
+ * interacting with a remote wallet implementation (typically an {@link AccountWallet}
+ * managed by a {@link JSONRPCNode} created via `createAztecWalletNode`)
+ * through the WalletMesh router system.
+ *
+ * It requires an {@link AztecRouterProvider} instance to handle the
+ * serialization and deserialization of Aztec-specific types (e.g., `AztecAddress`, `Fr`)
+ * when communicating with the router.
+ *
+ * An instance of this wallet should typically be created using the
+ * {@link createAztecWallet} helper function, which also handles initialization.
+ *
+ * @example
+ * ```typescript
+ * // Assuming 'provider' is an initialized AztecRouterProvider
+ * const wallet = await createAztecWallet(provider, 'aztec:mainnet');
+ * const address = wallet.getAddress(); // Synchronous access after initialization
+ * const txHash = await wallet.sendTx(someTx);
+ * ```
+ */
+export class AztecDappWallet {
+    /**
+     * Creates an instance of AztecDappWallet.
+     * Note: Prefer using the {@link createAztecWallet} helper function for creating
+     * and initializing wallet instances.
+     *
+     * @param routerProvider - The AztecRouterProvider instance used for communication.
+     * @param chainId - The Aztec chain ID this wallet is associated with.
+     */
+    constructor(routerProvider, chainId) {
+        this.routerProvider = routerProvider;
+        this.chainId = chainId;
+    }
+    /**
+     * Gets the chain ID for this wallet.
+     * This value is cached during initialization.
+     * @returns The chain ID as an Fr.
+     * @throws If the wallet is not initialized (e.g., if not created via `createAztecWallet`).
+     */
+    getChainId() {
+        if (!this.cachedChainId) {
+            throw new Error('Chain ID not initialized. Call createAztecWallet() to properly initialize the wallet.');
+        }
+        return this.cachedChainId;
+    }
+    /**
+     * Asynchronously fetches the chain ID from the remote wallet via an RPC call.
+     * This method directly queries the connected wallet node.
+     *
+     * @returns A promise that resolves to the chain ID as an {@link Fr}.
+     * @see {@link AztecWalletMethodMap.aztec_getChainId}
+     */
+    async getChainIdAsync() {
+        const chainId = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getChainId',
+        });
+        return chainId;
+    }
+    /**
+     * Gets the version of the wallet (typically PXE version).
+     * This value is cached during initialization.
+     * @returns The wallet version as an Fr.
+     * @throws If the wallet is not initialized.
+     */
+    getVersion() {
+        if (!this.cachedVersion) {
+            throw new Error('Wallet version not initialized. Call createAztecWallet() to properly initialize the wallet.');
+        }
+        return this.cachedVersion;
+    }
+    /**
+     * Asynchronously fetches the wallet version (typically the PXE version) from the remote wallet via an RPC call.
+     * This method directly queries the connected wallet node.
+     *
+     * @returns A promise that resolves to the wallet version as an {@link Fr}.
+     * @see {@link AztecWalletMethodMap.aztec_getVersion}
+     */
+    async getVersionAsync() {
+        const version = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getVersion',
+        });
+        return version;
+    }
+    /**
+     * Gets the primary Aztec address for this wallet.
+     * This value is cached during initialization.
+     * Implements {@link Wallet.getAddress}.
+     * @returns The wallet's AztecAddress.
+     * @throws If the wallet is not initialized.
+     */
+    getAddress() {
+        if (!this.cachedAddress) {
+            throw new Error('Wallet not initialized. Call createAztecWallet() to properly initialize the wallet.');
+        }
+        return this.cachedAddress;
+    }
+    /**
+     * Asynchronously fetches the primary Aztec address from the remote wallet via an RPC call.
+     * This method directly queries the connected wallet node.
+     *
+     * @returns A promise that resolves to the wallet's {@link AztecAddress}.
+     * @see {@link AztecWalletMethodMap.aztec_getAddress}
+     */
+    async getAddressAsync() {
+        const address = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getAddress',
+        });
+        return address;
+    }
+    /**
+     * Gets the complete address (including public keys) for this wallet.
+     * This value is cached during initialization.
+     * Implements {@link Wallet.getCompleteAddress}.
+     * @returns The wallet's CompleteAddress.
+     * @throws If the wallet is not initialized.
+     */
+    getCompleteAddress() {
+        if (!this.cachedCompleteAddress) {
+            throw new Error('Wallet not initialized. Call createAztecWallet() to properly initialize the wallet.');
+        }
+        return this.cachedCompleteAddress;
+    }
+    /**
+     * Asynchronously fetches the complete address (including public keys) from the remote wallet via an RPC call.
+     * This method directly queries the connected wallet node.
+     *
+     * @returns A promise that resolves to the wallet's {@link CompleteAddress}.
+     * @see {@link AztecWalletMethodMap.aztec_getCompleteAddress}
+     */
+    async getCompleteAddressAsync() {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getCompleteAddress',
+        });
+        return result;
+    }
+    /**
+     * Fetches and caches values (address, chain ID, version) that are accessed synchronously.
+     * @internal
+     */
+    async fetchCachedValues() {
+        const completeAddress = await this.getCompleteAddressAsync();
+        this.cachedCompleteAddress = completeAddress;
+        this.cachedAddress = completeAddress.address;
+        this.cachedChainId = await this.getChainIdAsync();
+        this.cachedVersion = await this.getVersionAsync();
+    }
+    /**
+     * Initializes the wallet instance by fetching and caching necessary values.
+     * This method is called by {@link createAztecWallet}.
+     * @internal
+     */
+    async initialize() {
+        try {
+            await this.fetchCachedValues();
+            // Initialize the auth provider and entrypoint
+            if (!this.cachedAddress || !this.cachedChainId || !this.cachedVersion) {
+                throw new Error('Failed to initialize wallet: missing required cached values');
+            }
+            this.authProvider = new RPCAuthWitnessProvider(this);
+            this.entrypoint = new DefaultAccountEntrypoint(this.cachedAddress, this.authProvider, this.cachedChainId.toNumber(), this.cachedVersion.toNumber());
+            logger.debug(`AztecDappWallet initialized: ${this.cachedAddress?.toString()}`);
+        }
+        catch (error) {
+            logger.warn('AztecDappWallet.initialize: Failed to initialize wallet addresses:', error);
+            throw error;
+        }
+    }
+    /**
+     * Registers an authorized sender for this account by making an RPC call to the remote wallet.
+     * Implements {@link Wallet.registerSender}.
+     * @param address - The {@link AztecAddress} of the sender to register.
+     * @returns A promise that resolves to the registered sender's {@link AztecAddress}.
+     * @see {@link AztecWalletMethodMap.aztec_registerSender}
+     */
+    async registerSender(address) {
+        await this.routerProvider.call(this.chainId, {
+            method: 'aztec_registerSender',
+            params: { sender: address },
+        });
+        return address; // Return the registered address
+    }
+    /**
+     * Retrieves the list of registered senders for this account by making an RPC call to the remote wallet.
+     * Implements {@link Wallet.getSenders}.
+     * @returns A promise that resolves to an array of {@link AztecAddress} objects.
+     * @see {@link AztecWalletMethodMap.aztec_getSenders}
+     */
+    async getSenders() {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getSenders',
+        });
+        return result;
+    }
+    /**
+     * Removes an authorized sender from this account by making an RPC call to the remote wallet.
+     * Implements {@link Wallet.removeSender}.
+     * @param sender - The {@link AztecAddress} of the sender to remove.
+     * @returns A promise that resolves when the sender is removed by the remote wallet.
+     * @see {@link AztecWalletMethodMap.aztec_removeSender}
+     */
+    async removeSender(sender) {
+        await this.routerProvider.call(this.chainId, {
+            method: 'aztec_removeSender',
+            params: { sender },
+        });
+    }
+    /**
+     * Registers a deployed contract instance with the remote wallet via an RPC call.
+     * Implements {@link Wallet.registerContract}.
+     * @param contract - An object containing the contract's {@link ContractInstanceWithAddress} and optionally its {@link ContractArtifact}.
+     * @returns A promise that resolves when the contract is registered by the remote wallet.
+     * @see {@link AztecWalletMethodMap.aztec_registerContract}
+     */
+    async registerContract(contract) {
+        const params = {
+            instance: contract.instance,
+        };
+        if (contract.artifact !== undefined) {
+            params.artifact = contract.artifact;
+        }
+        await this.routerProvider.call(this.chainId, {
+            method: 'aztec_registerContract',
+            params,
+        });
+    }
+    /**
+     * Registers a contract class (artifact/bytecode) with the remote wallet via an RPC call.
+     * Implements {@link Wallet.registerContractClass}.
+     * @param artifact - The {@link ContractArtifact} to register.
+     * @returns A promise that resolves when the class is registered by the remote wallet.
+     * @see {@link AztecWalletMethodMap.aztec_registerContractClass}
+     */
+    async registerContractClass(artifact) {
+        await this.routerProvider.call(this.chainId, {
+            method: 'aztec_registerContractClass',
+            params: { artifact },
+        });
+    }
+    /**
+     * Retrieves information about the connected Aztec node via an RPC call.
+     * Implements {@link Wallet.getNodeInfo}.
+     * @returns A promise that resolves to the {@link NodeInfo}.
+     * @see {@link AztecWalletMethodMap.aztec_getNodeInfo}
+     */
+    async getNodeInfo() {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getNodeInfo',
+        });
+        return result;
+    }
+    /**
+     * Retrieves information about the PXE service via an RPC call.
+     * Implements {@link Wallet.getPXEInfo}.
+     * @returns A promise that resolves to the {@link PXEInfo}.
+     * @see {@link AztecWalletMethodMap.aztec_getPXEInfo}
+     */
+    async getPXEInfo() {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getPXEInfo',
+        });
+        return result;
+    }
+    /**
+     * Retrieves a specific L2 block by its number via an RPC call.
+     * Implements {@link Wallet.getBlock}.
+     * @param number - The block number to retrieve.
+     * @returns A promise that resolves to the {@link L2Block} or `undefined` if not found.
+     * @see {@link AztecWalletMethodMap.aztec_getBlock}
+     */
+    async getBlock(number) {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getBlock',
+            params: { number },
+        });
+        return result;
+    }
+    /**
+     * Retrieves the current L2 block number via an RPC call.
+     * Implements {@link Wallet.getBlockNumber}.
+     * @returns A promise that resolves to the current block number.
+     * @see {@link AztecWalletMethodMap.aztec_getBlockNumber}
+     */
+    async getBlockNumber() {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getBlockNumber',
+        });
+        return result;
+    }
+    /**
+     * Retrieves the current base gas fees on the network via an RPC call.
+     * Implements {@link Wallet.getCurrentBaseFees}.
+     * @returns A promise that resolves to the {@link GasFees}.
+     * @see {@link AztecWalletMethodMap.aztec_getCurrentBaseFees}
+     */
+    async getCurrentBaseFees() {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getCurrentBaseFees',
+        });
+        return result;
+    }
+    /**
+     * Creates a transaction execution request using the wallet's entrypoint.
+     * Implements {@link Wallet.createTxExecutionRequest}.
+     * @param exec - The execution payload.
+     * @param fee - Fee payment options.
+     * @param options - Transaction execution options.
+     * @returns A promise that resolves to the TxExecutionRequest.
+     * @throws If the wallet or its entrypoint is not initialized.
+     */
+    async createTxExecutionRequest(exec, fee, options) {
+        if (!this.entrypoint) {
+            throw new Error('Wallet not initialized. Call createAztecWallet() to properly initialize the wallet.');
+        }
+        // Use the local entrypoint to create the transaction execution request
+        // The entrypoint will use the RPCAuthWitnessProvider to create auth witnesses via RPC
+        return this.entrypoint.createTxExecutionRequest(exec, fee, options);
+    }
+    async createAuthWit(intent) {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_createAuthWit',
+            params: { intent },
+        });
+        return result;
+    }
+    /**
+     * Proves a transaction execution request by making an RPC call to the remote wallet.
+     * Implements {@link Wallet.proveTx}.
+     * @param txRequest - The {@link TxExecutionRequest} to prove.
+     * @param privateExecutionResult - Optional {@link PrivateExecutionResult} from a private execution phase.
+     * @returns A promise that resolves to the {@link TxProvingResult}.
+     * @see {@link AztecWalletMethodMap.aztec_proveTx}
+     */
+    async proveTx(txRequest, privateExecutionResult) {
+        logger.debug('AztecDappWallet.proveTx: Proving transaction with request:', txRequest);
+        if (privateExecutionResult) {
+            logger.debug('AztecDappWallet.proveTx: Proving transaction with privateExecutionResult:', privateExecutionResult);
+        }
+        else {
+            logger.debug('AztecDappWallet.proveTx: Proving transaction without privateExecutionResult.');
+        }
+        const params = {
+            txRequest,
+        };
+        if (privateExecutionResult) {
+            params.privateExecutionResult = privateExecutionResult;
+        }
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_proveTx',
+            params,
+        });
+        return result;
+    }
+    /**
+     * Sends a proven transaction to the network via an RPC call to the remote wallet.
+     * Implements {@link Wallet.sendTx}.
+     * @param tx - The proven {@link Tx} to send.
+     * @returns A promise that resolves to the {@link TxHash}.
+     * @see {@link AztecWalletMethodMap.aztec_sendTx}
+     */
+    async sendTx(tx) {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_sendTx',
+            params: { tx },
+        });
+        return result;
+    }
+    /**
+     * Retrieves the receipt for a given transaction hash via an RPC call to the remote wallet.
+     * Implements {@link Wallet.getTxReceipt}.
+     * @param txHash - The {@link TxHash} of the transaction.
+     * @returns A promise that resolves to the {@link TxReceipt}.
+     * @see {@link AztecWalletMethodMap.aztec_getTxReceipt}
+     */
+    async getTxReceipt(txHash) {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getTxReceipt',
+            params: { txHash },
+        });
+        return result;
+    }
+    /**
+     * Simulates a transaction by making an RPC call to the remote wallet.
+     * Implements {@link Wallet.simulateTx}.
+     * @param txRequest - The {@link TxExecutionRequest} to simulate.
+     * @param simulatePublic - Whether to simulate public parts of the transaction.
+     * @param msgSender - Optional {@link AztecAddress} of the message sender for simulation context.
+     * @param skipTxValidation - Optional flag to skip transaction validation during simulation.
+     * @param skipFeeEnforcement - Optional flag to skip fee enforcement during simulation.
+     * @param scopes - Optional array of {@link AztecAddress} scopes for the simulation.
+     * @returns A promise that resolves to the {@link TxSimulationResult}.
+     * @see {@link AztecWalletMethodMap.aztec_simulateTx}
+     */
+    async simulateTx(txRequest, simulatePublic, msgSender, skipTxValidation, skipFeeEnforcement, scopes) {
+        const params = {
+            txRequest,
+        };
+        if (simulatePublic !== undefined)
+            params.simulatePublic = simulatePublic;
+        if (msgSender !== undefined)
+            params.msgSender = msgSender;
+        if (skipTxValidation !== undefined)
+            params.skipTxValidation = skipTxValidation;
+        if (skipFeeEnforcement !== undefined)
+            params.skipFeeEnforcement = skipFeeEnforcement;
+        if (scopes !== undefined)
+            params.scopes = scopes;
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_simulateTx',
+            params,
+        });
+        return result;
+    }
+    /**
+     * Profiles a transaction for performance analysis by making an RPC call to the remote wallet.
+     * Implements {@link Wallet.profileTx}.
+     * @param txRequest - The {@link TxExecutionRequest} to profile.
+     * @param profileMode - The mode for profiling: 'gates', 'execution-steps', or 'full'.
+     * @param skipProofGeneration - Optional flag to skip proof generation during profiling.
+     * @param msgSender - Optional {@link AztecAddress} of the message sender for profiling context.
+     * @returns A promise that resolves to the {@link TxProfileResult}.
+     * @see {@link AztecWalletMethodMap.aztec_profileTx}
+     */
+    async profileTx(txRequest, profileMode, skipProofGeneration, msgSender) {
+        const params = {
+            txRequest,
+        };
+        if (profileMode !== undefined)
+            params.profileMode = profileMode;
+        if (skipProofGeneration !== undefined)
+            params.skipProofGeneration = skipProofGeneration;
+        if (msgSender !== undefined)
+            params.msgSender = msgSender;
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_profileTx',
+            params,
+        });
+        return result;
+    }
+    /**
+     * Simulates a utility function call (view function) by making an RPC call to the remote wallet.
+     * Implements {@link Wallet.simulateUtility}.
+     * @param functionName - The name of the utility function to call.
+     * @param args - Arguments for the function call.
+     * @param to - The {@link AztecAddress} of the contract or account to call.
+     * @param authWits - Optional array of {@link AuthWitness} for authorization.
+     * @param from - Optional {@link AztecAddress} of the sender.
+     * @returns A promise that resolves to the {@link UtilitySimulationResult}.
+     * @see {@link AztecWalletMethodMap.aztec_simulateUtility}
+     */
+    async simulateUtility(functionName, args, to, authWits, from) {
+        const params = {
+            functionName,
+            args,
+            to,
+        };
+        if (authWits !== undefined)
+            params.authWits = authWits;
+        if (from !== undefined)
+            params.from = from;
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_simulateUtility',
+            params,
+        });
+        return result;
+    }
+    /**
+     * Retrieves private events (encrypted logs) by making an RPC call to the remote wallet.
+     * Implements {@link Wallet.getPrivateEvents}.
+     * @template T - The expected type of the decoded event data.
+     * @param contractAddress - The {@link AztecAddress} of the contract emitting the events.
+     * @param eventMetadata - {@link EventMetadataDefinition} of the event to query.
+     * @param from - Starting block number (inclusive).
+     * @param numBlocks - Number of blocks to query from the `from` block.
+     * @param recipients - Array of {@link AztecAddress} recipients for the events.
+     * @returns A promise that resolves to an array of decoded event data of type `T`.
+     * @see {@link AztecWalletMethodMap.aztec_getPrivateEvents}
+     */
+    async getPrivateEvents(contractAddress, eventMetadata, from, numBlocks, recipients) {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getPrivateEvents',
+            params: { contractAddress, eventMetadata, from, numBlocks, recipients },
+        });
+        return result;
+    }
+    /**
+     * Retrieves public events (unencrypted logs) by making an RPC call to the remote wallet.
+     * Implements {@link Wallet.getPublicEvents}.
+     * @template T - The expected type of the decoded event data.
+     * @param eventMetadata - {@link EventMetadataDefinition} of the event to query.
+     * @param from - Starting block number (inclusive).
+     * @param limit - Maximum number of events to return.
+     * @returns A promise that resolves to an array of decoded event data of type `T`.
+     * @see {@link AztecWalletMethodMap.aztec_getPublicEvents}
+     */
+    async getPublicEvents(eventMetadata, from, limit) {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getPublicEvents',
+            params: { eventMetadata, from, limit },
+        });
+        return result;
+    }
+    /**
+     * Retrieves metadata for a specific contract by making an RPC call to the remote wallet.
+     * Implements {@link Wallet.getContractMetadata}.
+     * @param address - The {@link AztecAddress} of the contract.
+     * @returns A promise that resolves to the {@link ContractMetadata}.
+     * @see {@link AztecWalletMethodMap.aztec_getContractMetadata}
+     */
+    async getContractMetadata(address) {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getContractMetadata',
+            params: { address },
+        });
+        return result;
+    }
+    /**
+     * Retrieves metadata for a contract class by making an RPC call to the remote wallet.
+     * Implements {@link Wallet.getContractClassMetadata}.
+     * @param id - The {@link Fr} ID of the contract class.
+     * @param includeArtifact - Optional flag to include the {@link ContractArtifact} in the metadata.
+     * @returns A promise that resolves to the {@link ContractClassMetadata}.
+     * @see {@link AztecWalletMethodMap.aztec_getContractClassMetadata}
+     */
+    async getContractClassMetadata(id, includeArtifact) {
+        const params = { id };
+        if (includeArtifact !== undefined) {
+            params.includeArtifact = includeArtifact;
+        }
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getContractClassMetadata',
+            params,
+        });
+        return result;
+    }
+    /**
+     * Updates a contract's artifact by re-registering its class with the remote wallet via an RPC call.
+     * Implements {@link Wallet.updateContract}.
+     * @param _contractAddress - The {@link AztecAddress} of the contract to update (often unused if primarily updating the class).
+     * @param artifact - The new {@link ContractArtifact}.
+     * @returns A promise that resolves when the update is complete on the remote wallet.
+     * @see {@link AztecWalletMethodMap.aztec_registerContractClass} (as this is what it typically calls)
+     */
+    async updateContract(_contractAddress, artifact) {
+        await this.routerProvider.call(this.chainId, {
+            method: 'aztec_registerContractClass',
+            params: { artifact },
+        });
+    }
+    /**
+     * Retrieves a list of all contracts registered with the remote wallet via an RPC call.
+     * Implements {@link Wallet.getContracts}.
+     * @returns A promise that resolves to an array of {@link AztecAddress} objects for the contracts.
+     * @see {@link AztecWalletMethodMap.aztec_getContracts}
+     */
+    async getContracts() {
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_getContracts',
+        });
+        return result;
+    }
+    /**
+     * Executes a transaction based on a {@link ContractFunctionInteraction}.
+     * This WalletMesh-specific helper method simplifies sending a transaction by deriving
+     * the necessary {@link ExecutionPayload} from the interaction and making an RPC call
+     * to the `aztec_wmExecuteTx` method on the remote wallet.
+     * The remote wallet is expected to handle fee configuration, proof generation, and submission.
+     *
+     * @param interaction - The {@link ContractFunctionInteraction} representing the desired contract call.
+     * @returns A {@link SentTx} object that can be used to track the transaction.
+     * @see {@link AztecWalletMethodMap.aztec_wmExecuteTx}
+     */
+    async wmExecuteTx(interaction) {
+        // Extract the execution payload which contains the encoded function call
+        const executionPayload = await interaction.request();
+        // Send the high-level interaction details to the remote wallet
+        // Note: opts is not sent - the server-side wallet will handle fee configuration
+        const result = await this.routerProvider.call(this.chainId, {
+            method: 'aztec_wmExecuteTx',
+            params: {
+                executionPayload,
+            },
+        });
+        const txHashPromise = Promise.resolve(result);
+        return new SentTx(this, txHashPromise);
+    }
+    /**
+     * Simulates a transaction based on a {@link ContractFunctionInteraction}.
+     * This WalletMesh-specific helper method simplifies simulating a transaction by deriving
+     * the necessary {@link ExecutionPayload} from the interaction and making an RPC call
+     * to the `aztec_wmSimulateTx` method on the remote wallet.
+     *
+     * @param interaction - The {@link ContractFunctionInteraction} representing the desired contract call.
+     * @returns A promise that resolves to the {@link TxSimulationResult}.
+     * @remarks TODO(twt): This should return a more useful result, not the raw TxSimulationResult.
+     *   Copying the logic from `aztec.js/src/contract/contract_function_interaction.ts`
+     *   could work if we can get the Function ABI or maybe have `aztec_wmSimulateTx` return hints
+     *   about how to interpret the result.
+     * @see {@link AztecWalletMethodMap.aztec_wmSimulateTx}
+     */
+    async wmSimulateTx(interaction) {
+        // Extract the execution payload which contains the encoded function call
+        const executionPayload = await interaction.request();
+        // Send the high-level interaction details to the remote wallet for simulation
+        const result = (await this.routerProvider.call(this.chainId, {
+            method: 'aztec_wmSimulateTx',
+            params: {
+                executionPayload,
+            },
+        }));
+        // TODO(twt): This should return a more useful result, not the raw TxSimulationResult
+        // Copying the logic from https://github.com/AztecProtocol/aztec-packages/blob/next/yarn-project/aztec.js/src/contract/contract_function_interaction.ts
+        // could work if we can get the Function ABI or maybe have aztec_wmSimulateTx return hints about how to interpret the result.
+        return result;
+    }
+    /**
+     * Deploys a contract using its artifact and constructor arguments.
+     * This WalletMesh-specific helper method makes an RPC call to the `aztec_wmDeployContract`
+     * method on the remote wallet. The remote wallet handles the deployment process.
+     *
+     * @param artifact - The {@link ContractArtifact} of the contract to deploy.
+     * @param args - An array of arguments for the contract's constructor.
+     * @param constructorName - Optional name of the constructor function if the artifact has multiple.
+     * @returns A {@link DeploySentTx} object that can be used to track the deployment transaction
+     *          and get the deployed contract instance.
+     * @see {@link AztecWalletMethodMap.aztec_wmDeployContract}
+     */
+    async deployContract(artifact, args, constructorName) {
+        // Send the deployment request to the remote wallet
+        const result = (await this.routerProvider.call(this.chainId, {
+            method: 'aztec_wmDeployContract',
+            params: {
+                artifact,
+                args,
+                constructorName,
+            },
+        }));
+        // Create a promise that resolves with the transaction hash
+        const txHashPromise = Promise.resolve(result.txHash);
+        // Create the post-deploy constructor function
+        const postDeployCtor = async (address, wallet) => {
+            return Contract.at(address, artifact, wallet);
+        };
+        // Create the instance getter function
+        // This will compute the contract address from the artifact and deployment args
+        const instanceGetter = async () => {
+            // Use the deployed contract address returned by the server
+            // Only the address is used from this result by DeploySentTx
+            return {
+                address: result.contractAddress,
+            };
+        };
+        // Return a DeploySentTx instance
+        return new DeploySentTx(this, txHashPromise, postDeployCtor, instanceGetter);
+    }
+}
+/**
+ * Helper function to create and initialize an AztecDappWallet instance.
+ * This is the recommended way to instantiate an Aztec wallet for dApp use,
+ * as it ensures all necessary asynchronous setup (like fetching initial
+ * address and chain ID) is completed.
+ *
+ * @param provider - An {@link AztecRouterProvider} instance, which handles Aztec-specific type serialization.
+ * @param chainId - The Aztec chain ID (e.g., 'aztec:mainnet', 'aztec:31337') for the wallet. Defaults to 'aztec:mainnet'.
+ * @returns A promise that resolves to a fully initialized {@link AztecDappWallet} instance.
+ *
+ * @example
+ * ```typescript
+ * const dAppTransport = { send: ..., onMessage: ... }; // User-defined transport
+ * const provider = new AztecRouterProvider(dAppTransport);
+ * await provider.connect({ 'aztec:mainnet': ['aztec_getAddress'] }); // Connect first
+ * const wallet = await createAztecWallet(provider, 'aztec:mainnet');
+ * const address = wallet.getAddress(); // Now usable
+ * ```
+ */
+export async function createAztecWallet(provider, chainId = 'aztec:mainnet') {
+    const wallet = new AztecDappWallet(provider, chainId);
+    await wallet.initialize();
+    return wallet;
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYXp0ZWMtZGFwcC13YWxsZXQuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvY2xpZW50L2F6dGVjLWRhcHAtd2FsbGV0LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQWVBLE9BQU8sRUFBRSxRQUFRLEVBQUUsWUFBWSxFQUFFLE1BQU0sRUFBRSxNQUFNLGlCQUFpQixDQUFDO0FBbUJqRSxPQUFPLEVBQUUsd0JBQXdCLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUN0RSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFLckQsTUFBTSxNQUFNLEdBQUcsWUFBWSxDQUFDLDhCQUE4QixDQUFDLENBQUM7QUFFNUQ7Ozs7R0FJRztBQUNILE1BQU0sc0JBQXNCO0lBQzFCLFlBQW9CLE1BQXVCO1FBQXZCLFdBQU0sR0FBTixNQUFNLENBQWlCO0lBQUcsQ0FBQztJQUUvQzs7Ozs7T0FLRztJQUNILEtBQUssQ0FBQyxhQUFhLENBQUMsV0FBd0I7UUFDMUMsT0FBTyxJQUFJLENBQUMsTUFBTSxDQUFDLGFBQWEsQ0FBQyxXQUFXLENBQUMsQ0FBQztJQUNoRCxDQUFDO0NBQ0Y7QUFFRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBcUJHO0FBQ0gsTUFBTSxPQUFPLGVBQWU7SUFRMUI7Ozs7Ozs7T0FPRztJQUNILFlBQ1UsY0FBbUMsRUFDbkMsT0FBcUI7UUFEckIsbUJBQWMsR0FBZCxjQUFjLENBQXFCO1FBQ25DLFlBQU8sR0FBUCxPQUFPLENBQWM7SUFDNUIsQ0FBQztJQUVKOzs7OztPQUtHO0lBQ0gsVUFBVTtRQUNSLElBQUksQ0FBQyxJQUFJLENBQUMsYUFBYSxFQUFFLENBQUM7WUFDeEIsTUFBTSxJQUFJLEtBQUssQ0FDYix1RkFBdUYsQ0FDeEYsQ0FBQztRQUNKLENBQUM7UUFDRCxPQUFPLElBQUksQ0FBQyxhQUFhLENBQUM7SUFDNUIsQ0FBQztJQUVEOzs7Ozs7T0FNRztJQUNILEtBQUssQ0FBQyxlQUFlO1FBQ25CLE1B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