@walletmesh/aztec-rpc-wallet 0.3.0 → 0.4.0

package/dist/wallet/handlers/index.d.ts

@@ -0,0 +1,88 @@
+import type { AccountWallet, PXE } from '@aztec/aztec.js';
+import type { JSONRPCContext } from '@walletmesh/jsonrpc';
+import type { ContractArtifactCache } from '../../contractArtifactCache.js';
+import type { AztecWalletMethodMap } from '../../types.js';
+/**
+ * Defines the context object that is passed to all Aztec wallet JSON-RPC method handlers.
+ * This context provides handlers with the necessary dependencies to perform their operations.
+ * It extends the base {@link JSONRPCContext} with Aztec-specific instances.
+ *
+ * @property wallet - An instance of {@link AccountWallet} from `aztec.js`,
+ *                    representing the user's account and signing capabilities.
+ * @property pxe - An instance of {@link PXE} (Private Execution Environment) client
+ *                 from `aztec.js`, used for interacting with the Aztec network.
+ * @property cache - An instance of {@link ContractArtifactCache} used for caching
+ *                   contract artifacts to optimize performance.
+ */
+export interface AztecHandlerContext extends JSONRPCContext {
+    wallet: AccountWallet;
+    pxe: PXE;
+    cache: ContractArtifactCache;
+}
+/**
+ * Defines the generic signature for an Aztec wallet JSON-RPC method handler function.
+ *
+ * @template M - A key from {@link AztecWalletMethodMap}, representing the specific Aztec method being handled.
+ * @param context - The {@link AztecHandlerContext} providing access to wallet, PXE, and cache.
+ * @param params - The parameters for the RPC method, typed as {@link JSONRPCParams} (typically an array or object).
+ *                 The specific structure of `params` is defined by `AztecWalletMethodMap[M]['params']`.
+ * @returns A promise that resolves to the result of the RPC method, typed according to `AztecWalletMethodMap[M]['result']`.
+ */
+export type AztecHandler<M extends keyof AztecWalletMethodMap> = (context: AztecHandlerContext, params: AztecWalletMethodMap[M]['params']) => Promise<AztecWalletMethodMap[M]['result']>;
+/**
+ * Creates and aggregates all Aztec JSON-RPC method handlers.
+ *
+ * This factory function consolidates handlers from various specialized modules
+ * (account, transaction, contract, etc.) into a single object. This object
+ * maps method names (as defined in {@link AztecWalletMethodMap}) to their
+ * respective handler functions.
+ *
+ * The resulting map of handlers is typically registered with a {@link JSONRPCNode}
+ * instance on the wallet-side.
+ *
+ * @returns An object where keys are Aztec method names (e.g., "aztec_getAddress")
+ *          and values are the corresponding handler functions. Each handler
+ *          conforms to the {@link AztecHandler} type.
+ *
+ * @see {@link createAccountHandlers}
+ * @see {@link createTransactionHandlers}
+ * @see {@link createContractHandlers}
+ * @see {@link createContractInteractionHandlers}
+ * @see {@link createSenderHandlers}
+ * @see {@link createEventHandlers}
+ * @see {@link createNodeHandlers}
+ * @see {@link createAztecWalletNode} where these handlers are typically used.
+ */
+export declare function createAztecHandlers(): {
+    wm_getSupportedMethods: (_ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["wm_getSupportedMethods"]["params"]) => Promise<AztecWalletMethodMap["wm_getSupportedMethods"]["result"]>;
+    aztec_getChainId: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getChainId"]["params"]) => Promise<AztecWalletMethodMap["aztec_getChainId"]["result"]>;
+    aztec_getVersion: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getVersion"]["params"]) => Promise<AztecWalletMethodMap["aztec_getVersion"]["result"]>;
+    aztec_getNodeInfo: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getNodeInfo"]["params"]) => Promise<AztecWalletMethodMap["aztec_getNodeInfo"]["result"]>;
+    aztec_getCurrentBaseFees: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getCurrentBaseFees"]["params"]) => Promise<AztecWalletMethodMap["aztec_getCurrentBaseFees"]["result"]>;
+    aztec_getPXEInfo: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getPXEInfo"]["params"]) => Promise<AztecWalletMethodMap["aztec_getPXEInfo"]["result"]>;
+    aztec_getBlock: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_getBlock"]["params"]) => Promise<AztecWalletMethodMap["aztec_getBlock"]["result"]>;
+    aztec_getBlockNumber: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getBlockNumber"]["params"]) => Promise<AztecWalletMethodMap["aztec_getBlockNumber"]["result"]>;
+    aztec_getPrivateEvents: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_getPrivateEvents"]["params"]) => Promise<AztecWalletMethodMap["aztec_getPrivateEvents"]["result"]>;
+    aztec_getPublicEvents: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_getPublicEvents"]["params"]) => Promise<AztecWalletMethodMap["aztec_getPublicEvents"]["result"]>;
+    aztec_registerSender: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_registerSender"]["params"]) => Promise<AztecWalletMethodMap["aztec_registerSender"]["result"]>;
+    aztec_getSenders: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getSenders"]["params"]) => Promise<AztecWalletMethodMap["aztec_getSenders"]["result"]>;
+    aztec_removeSender: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_removeSender"]["params"]) => Promise<AztecWalletMethodMap["aztec_removeSender"]["result"]>;
+    aztec_wmExecuteTx: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_wmExecuteTx"]["params"]) => Promise<AztecWalletMethodMap["aztec_wmExecuteTx"]["result"]>;
+    aztec_wmSimulateTx: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_wmSimulateTx"]["params"]) => Promise<AztecWalletMethodMap["aztec_wmSimulateTx"]["result"]>;
+    aztec_wmDeployContract: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_wmDeployContract"]["params"]) => Promise<AztecWalletMethodMap["aztec_wmDeployContract"]["result"]>;
+    aztec_registerContract: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_registerContract"]["params"]) => Promise<AztecWalletMethodMap["aztec_registerContract"]["result"]>;
+    aztec_registerContractClass: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_registerContractClass"]["params"]) => Promise<AztecWalletMethodMap["aztec_registerContractClass"]["result"]>;
+    aztec_getContractMetadata: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_getContractMetadata"]["params"]) => Promise<AztecWalletMethodMap["aztec_getContractMetadata"]["result"]>;
+    aztec_getContracts: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getContracts"]["params"]) => Promise<AztecWalletMethodMap["aztec_getContracts"]["result"]>;
+    aztec_getContractClassMetadata: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_getContractClassMetadata"]["params"]) => Promise<AztecWalletMethodMap["aztec_getContractClassMetadata"]["result"]>;
+    aztec_proveTx: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_proveTx"]["params"]) => Promise<AztecWalletMethodMap["aztec_proveTx"]["result"]>;
+    aztec_sendTx: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_sendTx"]["params"]) => Promise<AztecWalletMethodMap["aztec_sendTx"]["result"]>;
+    aztec_getTxReceipt: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_getTxReceipt"]["params"]) => Promise<AztecWalletMethodMap["aztec_getTxReceipt"]["result"]>;
+    aztec_simulateTx: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_simulateTx"]["params"]) => Promise<AztecWalletMethodMap["aztec_simulateTx"]["result"]>;
+    aztec_profileTx: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_profileTx"]["params"]) => Promise<AztecWalletMethodMap["aztec_profileTx"]["result"]>;
+    aztec_simulateUtility: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_simulateUtility"]["params"]) => Promise<AztecWalletMethodMap["aztec_simulateUtility"]["result"]>;
+    aztec_getAddress: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getAddress"]["params"]) => Promise<AztecWalletMethodMap["aztec_getAddress"]["result"]>;
+    aztec_getCompleteAddress: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getCompleteAddress"]["params"]) => Promise<AztecWalletMethodMap["aztec_getCompleteAddress"]["result"]>;
+    aztec_createAuthWit: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_createAuthWit"]["params"]) => Promise<AztecWalletMethodMap["aztec_createAuthWit"]["result"]>;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/wallet/handlers/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/wallet/handlers/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,KAAK,EAAE,cAAc,EAAiB,MAAM,qBAAqB,CAAC;AACzE,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gCAAgC,CAAC;AAC5E,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAU3D;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,mBAAoB,SAAQ,cAAc;IACzD,MAAM,EAAE,aAAa,CAAC;IACtB,GAAG,EAAE,GAAG,CAAC;IACT,KAAK,EAAE,qBAAqB,CAAC;CAC9B;AAED;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,MAAM,oBAAoB,IAAI,CAC/D,OAAO,EAAE,mBAAmB,EAC5B,MAAM,EAAE,oBAAoB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KACtC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;AAEhD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,mBAAmB;sEAFV,8CAA+C,uBAExC,8CAEL;+DAagR,wCAAyC,uBAA2C,wCAAwC;+DAA03B,wCAAyC,uBAA2C,wCAAwC;gEAA61B,yCAA0C,uBAA2C,yCAAyC;uEAAm3B,gDAAiD,uBAA2C,gDAAgD;+DAAy3B,wCAAyC,uBAA2C,wCAAwC;4DAA6gC,sCAAuC,uBAA2B,sCAAsC;mEAA8mC,4CAA6C,uBAA2C,4CAA4C;oEApC1rN,8CAA+C,uBACrD,8CAA8C;mEAmCktB,6CAA8C,uBAA2B,6CAA6C;kEAzCv3B,4CAGT,uBAA2B,4CAErB;+DAyBsC,wCACvC,uBAA2C,wCACtD;gEASy/B,0CAA2C,uBAA2B,0CAA0C;+DAA4oF,yCAA0C,uBAA2B,yCAAyC;gEAAs4B,0CAA2C,uBAA2B,0CAA0C;oEAAyhD,8CAA+C,uBAA2B,8CAA8C;oEA3Ch+M,8CACe,uBAA2B,8CACnC;yEAyCyL,mDAAoD,uBAA2B,mDAAmD;uEAA2vC,iDAAkD,uBAA2B,iDAAiD;iEAA+9C,0CAA2C,uBAA2C,0CAA0C;4EAAuyC,sDAAuD,uBAA2B,sDAAsD;2DA5ClrJ,qCAC7B,uBACL,qCAAqC;0DA0C+kB,oCAAqC,uBAA2B,oCAAoC;gEAAmzC,0CAA2C,uBAA2B,0CAA0C;8DAAoqD,wCAAyC,uBAA2B,wCAAwC;6DAAqnE,uCAAwC,uBAA2B,uCAAuC;mEAA21D,6CAA8C,uBAA2B,6CAA6C;+DAlD1hQ,wCAAyC,uBACrE,wCAAwC;uEAqBzB,gDAAgD,uBACvC,gDAC9B;iEA0ByW,2CAA4C,uBAA2B,2CAA2C;EAD3d"}

package/dist/wallet/handlers/index.js

@@ -0,0 +1,47 @@
+import { createAccountHandlers } from './account.js';
+import { createTransactionHandlers } from './transaction.js';
+import { createContractHandlers } from './contract.js';
+import { createContractInteractionHandlers } from './contract-interaction.js';
+import { createEventHandlers } from './event.js';
+import { createNodeHandlers } from './node.js';
+import { createSenderHandlers } from './senders.js';
+/**
+ * Creates and aggregates all Aztec JSON-RPC method handlers.
+ *
+ * This factory function consolidates handlers from various specialized modules
+ * (account, transaction, contract, etc.) into a single object. This object
+ * maps method names (as defined in {@link AztecWalletMethodMap}) to their
+ * respective handler functions.
+ *
+ * The resulting map of handlers is typically registered with a {@link JSONRPCNode}
+ * instance on the wallet-side.
+ *
+ * @returns An object where keys are Aztec method names (e.g., "aztec_getAddress")
+ *          and values are the corresponding handler functions. Each handler
+ *          conforms to the {@link AztecHandler} type.
+ *
+ * @see {@link createAccountHandlers}
+ * @see {@link createTransactionHandlers}
+ * @see {@link createContractHandlers}
+ * @see {@link createContractInteractionHandlers}
+ * @see {@link createSenderHandlers}
+ * @see {@link createEventHandlers}
+ * @see {@link createNodeHandlers}
+ * @see {@link createAztecWalletNode} where these handlers are typically used.
+ */
+export function createAztecHandlers() {
+    return {
+        // Note: The individual createXYZHandlers() functions return objects whose methods
+        // might have params typed as general JSONRPCParams or a more specific tuple.
+        // The createAztecWalletNode function correctly casts these to the specific
+        // handler signatures expected by JSONRPCNode.registerMethod, using AztecWalletMethodMap.
+        ...createAccountHandlers(),
+        ...createTransactionHandlers(),
+        ...createContractHandlers(),
+        ...createContractInteractionHandlers(),
+        ...createSenderHandlers(),
+        ...createEventHandlers(),
+        ...createNodeHandlers(),
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvd2FsbGV0L2hhbmRsZXJzL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUtBLE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLGNBQWMsQ0FBQztBQUNyRCxPQUFPLEVBQUUseUJBQXlCLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUM3RCxPQUFPLEVBQUUsc0JBQXNCLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFDdkQsT0FBTyxFQUFFLGlDQUFpQyxFQUFFLE1BQU0sMkJBQTJCLENBQUM7QUFDOUUsT0FBTyxFQUFFLG1CQUFtQixFQUFFLE1BQU0sWUFBWSxDQUFDO0FBQ2pELE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLFdBQVcsQ0FBQztBQUMvQyxPQUFPLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxjQUFjLENBQUM7QUFrQ3BEOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7OztHQXVCRztBQUNILE1BQU0sVUFBVSxtQkFBbUI7SUFDakMsT0FBTztRQUNMLGtGQUFrRjtRQUNsRiw2RUFBNkU7UUFDN0UsMkVBQTJFO1FBQzNFLHlGQUF5RjtRQUN6RixHQUFHLHFCQUFxQixFQUFFO1FBQzFCLEdBQUcseUJBQXlCLEVBQUU7UUFDOUIsR0FBRyxzQkFBc0IsRUFBRTtRQUMzQixHQUFHLGlDQUFpQyxFQUFFO1FBQ3RDLEdBQUcsb0JBQW9CLEVBQUU7UUFDekIsR0FBRyxtQkFBbUIsRUFBRTtRQUN4QixHQUFHLGtCQUFrQixFQUFFO0tBQ3hCLENBQUM7QUFDSixDQUFDIn0=

package/dist/wallet/handlers/node.d.ts

@@ -0,0 +1,117 @@
+import type { AztecHandlerContext } from './index.js';
+import type { AztecWalletMethodMap } from '../../types.js';
+/**
+ * Creates handlers for node and network information-related Aztec wallet JSON-RPC methods.
+ * These handlers provide dApps with insights into the connected Aztec node's state,
+ * network parameters (like chain ID, version, fees), and block information.
+ *
+ * Each handler function receives an {@link AztecHandlerContext} which provides access
+ * to the {@link AccountWallet} and {@link PXE} client.
+ *
+ * @returns An object where keys are node-related method names
+ *          (e.g., "aztec_getNodeInfo", "aztec_getBlockNumber") and values are their
+ *          corresponding handler functions.
+ * @see {@link AztecWalletMethodMap} for method definitions.
+ */
+export declare function createNodeHandlers(): {
+    /**
+     * Handles the "wm_getSupportedMethods" JSON-RPC method.
+     * Returns a list of all JSON-RPC methods supported by this wallet implementation.
+     * This allows clients to discover the capabilities of the wallet.
+     *
+     * @param _ctx - The {@link AztecHandlerContext} (unused for this method).
+     * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+     *                       Defined by {@link AztecWalletMethodMap.wm_getSupportedMethods.params}.
+     * @returns A promise that resolves to an array of strings, where each string is a
+     *          supported method name.
+     *          Type defined by {@link AztecWalletMethodMap.wm_getSupportedMethods.result}.
+     * @see {@link SUPPORTED_AZTEC_METHODS}
+     */
+    wm_getSupportedMethods: (_ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["wm_getSupportedMethods"]["params"]) => Promise<AztecWalletMethodMap["wm_getSupportedMethods"]["result"]>;
+    /**
+     * Handles the "aztec_getChainId" JSON-RPC method.
+     * Retrieves the chain ID of the Aztec network to which the {@link AccountWallet}
+     * in the context is connected.
+     *
+     * @param ctx - The {@link AztecHandlerContext} containing the `wallet` instance.
+     * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+     *                       Defined by {@link AztecWalletMethodMap.aztec_getChainId.params}.
+     * @returns A promise that resolves to the chain ID as an {@link Fr} (Field element).
+     *          Type defined by {@link AztecWalletMethodMap.aztec_getChainId.result}.
+     */
+    aztec_getChainId: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getChainId"]["params"]) => Promise<AztecWalletMethodMap["aztec_getChainId"]["result"]>;
+    /**
+     * Handles the "aztec_getVersion" JSON-RPC method.
+     * Retrieves the version of the Aztec software stack, typically the version of the
+     * PXE (Private Execution Environment) or the node the wallet is interacting with.
+     *
+     * @param ctx - The {@link AztecHandlerContext} containing the `wallet` instance.
+     * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+     *                       Defined by {@link AztecWalletMethodMap.aztec_getVersion.params}.
+     * @returns A promise that resolves to the version as an {@link Fr} (Field element).
+     *          Type defined by {@link AztecWalletMethodMap.aztec_getVersion.result}.
+     */
+    aztec_getVersion: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getVersion"]["params"]) => Promise<AztecWalletMethodMap["aztec_getVersion"]["result"]>;
+    /**
+     * Handles the "aztec_getNodeInfo" JSON-RPC method.
+     * Retrieves comprehensive information about the connected Aztec node, such as
+     * protocol version, chain ID, and addresses of core protocol contracts.
+     *
+     * @param ctx - The {@link AztecHandlerContext} containing the `wallet` instance.
+     * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+     *                       Defined by {@link AztecWalletMethodMap.aztec_getNodeInfo.params}.
+     * @returns A promise that resolves to a {@link NodeInfo} object.
+     *          Type defined by {@link AztecWalletMethodMap.aztec_getNodeInfo.result}.
+     */
+    aztec_getNodeInfo: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getNodeInfo"]["params"]) => Promise<AztecWalletMethodMap["aztec_getNodeInfo"]["result"]>;
+    /**
+     * Handles the "aztec_getCurrentBaseFees" JSON-RPC method.
+     * Retrieves the current base gas fees applicable on the Aztec network.
+     * This information is essential for estimating transaction costs.
+     *
+     * @param ctx - The {@link AztecHandlerContext} containing the `wallet` instance.
+     * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+     *                       Defined by {@link AztecWalletMethodMap.aztec_getCurrentBaseFees.params}.
+     * @returns A promise that resolves to a {@link GasFees} object.
+     *          Type defined by {@link AztecWalletMethodMap.aztec_getCurrentBaseFees.result}.
+     */
+    aztec_getCurrentBaseFees: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getCurrentBaseFees"]["params"]) => Promise<AztecWalletMethodMap["aztec_getCurrentBaseFees"]["result"]>;
+    /**
+     * Handles the "aztec_getPXEInfo" JSON-RPC method.
+     * Retrieves information about the Private Execution Environment (PXE) service
+     * that the wallet is connected to, including its version and core contract addresses.
+     *
+     * @param ctx - The {@link AztecHandlerContext} containing the `pxe` instance.
+     * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+     *                       Defined by {@link AztecWalletMethodMap.aztec_getPXEInfo.params}.
+     * @returns A promise that resolves to a {@link PXEInfo} object.
+     *          Type defined by {@link AztecWalletMethodMap.aztec_getPXEInfo.result}.
+     */
+    aztec_getPXEInfo: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getPXEInfo"]["params"]) => Promise<AztecWalletMethodMap["aztec_getPXEInfo"]["result"]>;
+    /**
+     * Handles the "aztec_getBlock" JSON-RPC method.
+     * Retrieves a specific L2 block by its number from the connected PXE.
+     *
+     * @param ctx - The {@link AztecHandlerContext} containing the `pxe` instance.
+     * @param paramsTuple - A tuple containing the block number.
+     *                      Defined by {@link AztecWalletMethodMap.aztec_getBlock.params}.
+     * @param paramsTuple.0 - The number of the block to retrieve.
+     * @returns A promise that resolves to the {@link L2Block} data, or `null` / `undefined`
+     *          if the block is not found (behavior depends on PXE implementation, typically throws).
+     *          Type defined by {@link AztecWalletMethodMap.aztec_getBlock.result}.
+     * @throws {Error} If the `blockNumber` parameter is missing or invalid, or if the block is not found.
+     */
+    aztec_getBlock: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_getBlock"]["params"]) => Promise<AztecWalletMethodMap["aztec_getBlock"]["result"]>;
+    /**
+     * Handles the "aztec_getBlockNumber" JSON-RPC method.
+     * Retrieves the current (latest) L2 block number from the connected PXE.
+     *
+     * @param ctx - The {@link AztecHandlerContext} containing the `pxe` instance.
+     * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+     *                       Defined by {@link AztecWalletMethodMap.aztec_getBlockNumber.params}.
+     * @returns A promise that resolves to the current block number (a `number`).
+     *          Type defined by {@link AztecWalletMethodMap.aztec_getBlockNumber.result}.
+     */
+    aztec_getBlockNumber: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getBlockNumber"]["params"]) => Promise<AztecWalletMethodMap["aztec_getBlockNumber"]["result"]>;
+};
+//# sourceMappingURL=node.d.ts.map

package/dist/wallet/handlers/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../../src/wallet/handlers/node.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAmD3D;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB;IAE9B;;;;;;;;;;;;OAYG;mCAEK,mBAAmB,gBACX,oBAAoB,CAAC,wBAAwB,CAAC,CAAC,QAAQ,CAAC,KACrE,OAAO,CAAC,oBAAoB,CAAC,wBAAwB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAKpE;;;;;;;;;;OAUG;4BAEI,mBAAmB,gBACV,oBAAoB,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,KAC/D,OAAO,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAK9D;;;;;;;;;;OAUG;4BAEI,mBAAmB,gBACV,oBAAoB,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,KAC/D,OAAO,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAK9D;;;;;;;;;;OAUG;6BAEI,mBAAmB,gBACV,oBAAoB,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,KAChE,OAAO,CAAC,oBAAoB,CAAC,mBAAmB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAK/D;;;;;;;;;;OAUG;oCAEI,mBAAmB,gBACV,oBAAoB,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,KACvE,OAAO,CAAC,oBAAoB,CAAC,0BAA0B,CAAC,CAAC,QAAQ,CAAC,CAAC;IAKtE;;;;;;;;;;OAUG;4BAEI,mBAAmB,gBACV,oBAAoB,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,KAC/D,OAAO,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAK9D;;;;;;;;;;;;OAYG;0BAEI,mBAAmB,eACX,oBAAoB,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,KAC5D,OAAO,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAY5D;;;;;;;;;OASG;gCAEI,mBAAmB,gBACV,oBAAoB,CAAC,sBAAsB,CAAC,CAAC,QAAQ,CAAC,KACnE,OAAO,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC,QAAQ,CAAC,CAAC;EAKrE"}

package/dist/wallet/handlers/node.js

@@ -0,0 +1,196 @@
+import { createLogger } from '@aztec/foundation/log';
+const logger = createLogger('aztec-rpc-wallet:node');
+/**
+ * A constant array listing all JSON-RPC methods supported by this Aztec wallet implementation.
+ * This list is returned by the `wm_getSupportedMethods` RPC call, allowing clients (dApps)
+ * to discover the capabilities of the connected wallet node.
+ * It should be kept in sync with the methods defined in {@link AztecWalletMethodMap}
+ * and implemented by the various handler creation functions.
+ *
+ * Note: `aztec_createTxExecutionRequest` is intentionally omitted as it's a client-side
+ * convenience method in `AztecDappWallet` rather than a direct RPC method handled here.
+ * The actual RPC methods for transactions are `aztec_proveTx`, `aztec_sendTx`, etc.,
+ * or the higher-level `aztec_wmExecuteTx`.
+ */
+const SUPPORTED_AZTEC_METHODS = [
+    'wm_getSupportedMethods',
+    'aztec_getChainId',
+    'aztec_getVersion',
+    'aztec_getNodeInfo',
+    'aztec_getCurrentBaseFees',
+    'aztec_getPXEInfo',
+    'aztec_getBlock',
+    'aztec_getBlockNumber',
+    'aztec_getAddress',
+    'aztec_getCompleteAddress',
+    'aztec_createAuthWit',
+    'aztec_registerSender',
+    'aztec_getSenders',
+    'aztec_removeSender',
+    'aztec_getContracts',
+    'aztec_getContractMetadata',
+    'aztec_getContractClassMetadata',
+    'aztec_registerContract',
+    'aztec_registerContractClass',
+    // 'aztec_createTxExecutionRequest', // This is a client-side method, not an RPC method.
+    'aztec_proveTx',
+    'aztec_sendTx',
+    'aztec_getTxReceipt',
+    'aztec_simulateTx',
+    'aztec_profileTx',
+    'aztec_simulateUtility',
+    'aztec_getPrivateEvents',
+    'aztec_getPublicEvents',
+    'aztec_wmExecuteTx',
+    'aztec_wmSimulateTx',
+    'aztec_wmDeployContract',
+];
+/**
+ * Creates handlers for node and network information-related Aztec wallet JSON-RPC methods.
+ * These handlers provide dApps with insights into the connected Aztec node's state,
+ * network parameters (like chain ID, version, fees), and block information.
+ *
+ * Each handler function receives an {@link AztecHandlerContext} which provides access
+ * to the {@link AccountWallet} and {@link PXE} client.
+ *
+ * @returns An object where keys are node-related method names
+ *          (e.g., "aztec_getNodeInfo", "aztec_getBlockNumber") and values are their
+ *          corresponding handler functions.
+ * @see {@link AztecWalletMethodMap} for method definitions.
+ */
+export function createNodeHandlers() {
+    return {
+        /**
+         * Handles the "wm_getSupportedMethods" JSON-RPC method.
+         * Returns a list of all JSON-RPC methods supported by this wallet implementation.
+         * This allows clients to discover the capabilities of the wallet.
+         *
+         * @param _ctx - The {@link AztecHandlerContext} (unused for this method).
+         * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+         *                       Defined by {@link AztecWalletMethodMap.wm_getSupportedMethods.params}.
+         * @returns A promise that resolves to an array of strings, where each string is a
+         *          supported method name.
+         *          Type defined by {@link AztecWalletMethodMap.wm_getSupportedMethods.result}.
+         * @see {@link SUPPORTED_AZTEC_METHODS}
+         */
+        wm_getSupportedMethods: async (_ctx, _paramsTuple) => {
+            logger.debug('[HANDLER] wm_getSupportedMethods');
+            return Array.from(SUPPORTED_AZTEC_METHODS);
+        },
+        /**
+         * Handles the "aztec_getChainId" JSON-RPC method.
+         * Retrieves the chain ID of the Aztec network to which the {@link AccountWallet}
+         * in the context is connected.
+         *
+         * @param ctx - The {@link AztecHandlerContext} containing the `wallet` instance.
+         * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+         *                       Defined by {@link AztecWalletMethodMap.aztec_getChainId.params}.
+         * @returns A promise that resolves to the chain ID as an {@link Fr} (Field element).
+         *          Type defined by {@link AztecWalletMethodMap.aztec_getChainId.result}.
+         */
+        aztec_getChainId: async (ctx, _paramsTuple) => {
+            logger.debug('[HANDLER] aztec_getChainId');
+            return ctx.wallet.getChainId();
+        },
+        /**
+         * Handles the "aztec_getVersion" JSON-RPC method.
+         * Retrieves the version of the Aztec software stack, typically the version of the
+         * PXE (Private Execution Environment) or the node the wallet is interacting with.
+         *
+         * @param ctx - The {@link AztecHandlerContext} containing the `wallet` instance.
+         * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+         *                       Defined by {@link AztecWalletMethodMap.aztec_getVersion.params}.
+         * @returns A promise that resolves to the version as an {@link Fr} (Field element).
+         *          Type defined by {@link AztecWalletMethodMap.aztec_getVersion.result}.
+         */
+        aztec_getVersion: async (ctx, _paramsTuple) => {
+            logger.debug('[HANDLER] aztec_getVersion');
+            return ctx.wallet.getVersion();
+        },
+        /**
+         * Handles the "aztec_getNodeInfo" JSON-RPC method.
+         * Retrieves comprehensive information about the connected Aztec node, such as
+         * protocol version, chain ID, and addresses of core protocol contracts.
+         *
+         * @param ctx - The {@link AztecHandlerContext} containing the `wallet` instance.
+         * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+         *                       Defined by {@link AztecWalletMethodMap.aztec_getNodeInfo.params}.
+         * @returns A promise that resolves to a {@link NodeInfo} object.
+         *          Type defined by {@link AztecWalletMethodMap.aztec_getNodeInfo.result}.
+         */
+        aztec_getNodeInfo: async (ctx, _paramsTuple) => {
+            logger.debug('[HANDLER] aztec_getNodeInfo');
+            return await ctx.wallet.getNodeInfo();
+        },
+        /**
+         * Handles the "aztec_getCurrentBaseFees" JSON-RPC method.
+         * Retrieves the current base gas fees applicable on the Aztec network.
+         * This information is essential for estimating transaction costs.
+         *
+         * @param ctx - The {@link AztecHandlerContext} containing the `wallet` instance.
+         * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+         *                       Defined by {@link AztecWalletMethodMap.aztec_getCurrentBaseFees.params}.
+         * @returns A promise that resolves to a {@link GasFees} object.
+         *          Type defined by {@link AztecWalletMethodMap.aztec_getCurrentBaseFees.result}.
+         */
+        aztec_getCurrentBaseFees: async (ctx, _paramsTuple) => {
+            logger.debug('[HANDLER] aztec_getCurrentBaseFees');
+            return await ctx.wallet.getCurrentBaseFees();
+        },
+        /**
+         * Handles the "aztec_getPXEInfo" JSON-RPC method.
+         * Retrieves information about the Private Execution Environment (PXE) service
+         * that the wallet is connected to, including its version and core contract addresses.
+         *
+         * @param ctx - The {@link AztecHandlerContext} containing the `pxe` instance.
+         * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+         *                       Defined by {@link AztecWalletMethodMap.aztec_getPXEInfo.params}.
+         * @returns A promise that resolves to a {@link PXEInfo} object.
+         *          Type defined by {@link AztecWalletMethodMap.aztec_getPXEInfo.result}.
+         */
+        aztec_getPXEInfo: async (ctx, _paramsTuple) => {
+            logger.debug('[HANDLER] aztec_getPXEInfo');
+            return await ctx.pxe.getPXEInfo();
+        },
+        /**
+         * Handles the "aztec_getBlock" JSON-RPC method.
+         * Retrieves a specific L2 block by its number from the connected PXE.
+         *
+         * @param ctx - The {@link AztecHandlerContext} containing the `pxe` instance.
+         * @param paramsTuple - A tuple containing the block number.
+         *                      Defined by {@link AztecWalletMethodMap.aztec_getBlock.params}.
+         * @param paramsTuple.0 - The number of the block to retrieve.
+         * @returns A promise that resolves to the {@link L2Block} data, or `null` / `undefined`
+         *          if the block is not found (behavior depends on PXE implementation, typically throws).
+         *          Type defined by {@link AztecWalletMethodMap.aztec_getBlock.result}.
+         * @throws {Error} If the `blockNumber` parameter is missing or invalid, or if the block is not found.
+         */
+        aztec_getBlock: async (ctx, paramsTuple) => {
+            const [blockNumber] = paramsTuple;
+            logger.debug(`[HANDLER] aztec_getBlock: blockNumber = ${blockNumber}`);
+            if (blockNumber === undefined) {
+                // Should be caught by TS if tuple type is `[number]`
+                throw new Error('Missing required parameter: number');
+            }
+            const block = await ctx.pxe.getBlock(blockNumber);
+            if (!block)
+                throw new Error('Block not found');
+            return block;
+        },
+        /**
+         * Handles the "aztec_getBlockNumber" JSON-RPC method.
+         * Retrieves the current (latest) L2 block number from the connected PXE.
+         *
+         * @param ctx - The {@link AztecHandlerContext} containing the `pxe` instance.
+         * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+         *                       Defined by {@link AztecWalletMethodMap.aztec_getBlockNumber.params}.
+         * @returns A promise that resolves to the current block number (a `number`).
+         *          Type defined by {@link AztecWalletMethodMap.aztec_getBlockNumber.result}.
+         */
+        aztec_getBlockNumber: async (ctx, _paramsTuple) => {
+            logger.debug('[HANDLER] aztec_getBlockNumber');
+            return await ctx.pxe.getBlockNumber();
+        },
+    };
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoibm9kZS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uLy4uL3NyYy93YWxsZXQvaGFuZGxlcnMvbm9kZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFFQSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sdUJBQXVCLENBQUM7QUFFckQsTUFBTSxNQUFNLEdBQUcsWUFBWSxDQUFDLHVCQUF1QixDQUFDLENBQUM7QUFFckQ7Ozs7Ozs7Ozs7O0dBV0c7QUFDSCxNQUFNLHVCQUF1QixHQUFHO0lBQzlCLHdCQUF3QjtJQUN4QixrQkFBa0I7SUFDbEIsa0JBQWtCO0lBQ2xCLG1CQUFtQjtJQUNuQiwwQkFBMEI7SUFDMUIsa0JBQWtCO0lBQ2xCLGdCQUFnQjtJQUNoQixzQkFBc0I7SUFDdEIsa0JBQWtCO0lBQ2xCLDBCQUEwQjtJQUMxQixxQkFBcUI7SUFDckIsc0JBQXNCO0lBQ3RCLGtCQUFrQjtJQUNsQixvQkFBb0I7SUFDcEIsb0JBQW9CO0lBQ3BCLDJCQUEyQjtJQUMzQixnQ0FBZ0M7SUFDaEMsd0JBQXdCO0lBQ3hCLDZCQUE2QjtJQUM3Qix3RkFBd0Y7SUFDeEYsZUFBZTtJQUNmLGNBQWM7SUFDZCxvQkFBb0I7SUFDcEIsa0JBQWtCO0lBQ2xCLGlCQUFpQjtJQUNqQix1QkFBdUI7SUFDdkIsd0JBQXdCO0lBQ3hCLHVCQUF1QjtJQUN2QixtQkFBbUI7SUFDbkIsb0JBQW9CO0lBQ3BCLHdCQUF3QjtDQUNoQixDQUFDO0FBRVg7Ozs7Ozs7Ozs7OztHQVlHO0FBQ0gsTUFBTSxVQUFVLGtCQUFrQjtJQUNoQyxPQUFPO1FBQ0w7Ozs7Ozs7Ozs7OztXQVlHO1FBQ0gsc0JBQXNCLEVBQUUsS0FBSyxFQUMzQixJQUF5QixFQUN6QixZQUFzRSxFQUNILEVBQUU7WUFDckUsTUFBTSxDQUFDLEtBQUssQ0FBQyxrQ0FBa0MsQ0FBQyxDQUFDO1lBQ2pELE9BQU8sS0FBSyxDQUFDLElBQUksQ0FBQyx1QkFBdUIsQ0FBQyxDQUFDO1FBQzdDLENBQUM7UUFFRDs7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

package/dist/wallet/handlers/senders.d.ts

@@ -0,0 +1,70 @@
+import type { AztecHandlerContext } from './index.js';
+import type { AztecWalletMethodMap } from '../../types.js';
+/**
+ * Creates handlers for managing authorized senders in an Aztec wallet via JSON-RPC.
+ * Authorized senders are {@link AztecAddress}es permitted to submit transactions
+ * on behalf of the user's account. This functionality is crucial for delegation,
+ * enabling other accounts or smart contracts to act for the user under controlled conditions.
+ *
+ * Each handler function receives an {@link AztecHandlerContext}, providing access to the
+ * {@link AccountWallet} instance necessary for sender management.
+ *
+ * @returns An object where keys are sender-related method names
+ *          (e.g., "aztec_registerSender", "aztec_getSenders", "aztec_removeSender")
+ *          and values are their corresponding handler functions.
+ * @see {@link AztecWalletMethodMap} for method definitions.
+ */
+export declare function createSenderHandlers(): {
+    /**
+     * Handles the "aztec_registerSender" JSON-RPC method.
+     * Registers a new {@link AztecAddress} as an authorized sender for the account
+     * managed by the {@link AccountWallet} in the context.
+     *
+     * This allows the specified sender address to initiate transactions on behalf of the user.
+     * Common use cases include:
+     * - Delegating transaction submission to a different account.
+     * - Authorizing a smart contract to perform actions for the user.
+     * - Setting up automated transaction systems or relayers.
+     *
+     * @param ctx - The {@link AztecHandlerContext} containing the `wallet` instance.
+     * @param paramsTuple - A tuple containing the sender's address to register.
+     *                      Defined by {@link AztecWalletMethodMap.aztec_registerSender.params}.
+     * @param paramsTuple.0 - The {@link AztecAddress} to authorize as a sender.
+     * @returns A promise that resolves to the registered {@link AztecAddress}.
+     *          Type defined by {@link AztecWalletMethodMap.aztec_registerSender.result}.
+     * @throws {Error} If the `sender` parameter is missing or invalid, though type checking
+     *                 and serializer validation should catch this earlier.
+     */
+    aztec_registerSender: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_registerSender"]["params"]) => Promise<AztecWalletMethodMap["aztec_registerSender"]["result"]>;
+    /**
+     * Handles the "aztec_getSenders" JSON-RPC method.
+     * Retrieves a list of all {@link AztecAddress}es currently authorized to send
+     * transactions on behalf of the account managed by the {@link AccountWallet} in the context.
+     * This is useful for auditing and managing delegation permissions.
+     *
+     * @param ctx - The {@link AztecHandlerContext} containing the `wallet` instance.
+     * @param _paramsTuple - Parameters for this method (expected to be an empty array).
+     *                       Defined by {@link AztecWalletMethodMap.aztec_getSenders.params}.
+     * @returns A promise that resolves to an array of authorized {@link AztecAddress}es.
+     *          Type defined by {@link AztecWalletMethodMap.aztec_getSenders.result}.
+     */
+    aztec_getSenders: (ctx: AztecHandlerContext, _paramsTuple: AztecWalletMethodMap["aztec_getSenders"]["params"]) => Promise<AztecWalletMethodMap["aztec_getSenders"]["result"]>;
+    /**
+     * Handles the "aztec_removeSender" JSON-RPC method.
+     * Revokes the authorization for a previously registered sender for the account
+     * managed by the {@link AccountWallet} in the context.
+     * After successful removal, the specified address will no longer be able to
+     * submit transactions on behalf of this wallet.
+     *
+     * @param ctx - The {@link AztecHandlerContext} containing the `wallet` instance.
+     * @param paramsTuple - A tuple containing the sender's address to remove.
+     *                      Defined by {@link AztecWalletMethodMap.aztec_removeSender.params}.
+     * @param paramsTuple.0 - The {@link AztecAddress} to remove from the list of authorized senders.
+     * @returns A promise that resolves to `true` if the removal was successful.
+     *          Type defined by {@link AztecWalletMethodMap.aztec_removeSender.result}.
+     * @throws {Error} If the `sender` parameter is missing or invalid, though type checking
+     *                 and serializer validation should catch this earlier.
+     */
+    aztec_removeSender: (ctx: AztecHandlerContext, paramsTuple: AztecWalletMethodMap["aztec_removeSender"]["params"]) => Promise<AztecWalletMethodMap["aztec_removeSender"]["result"]>;
+};
+//# sourceMappingURL=senders.d.ts.map

package/dist/wallet/handlers/senders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"senders.d.ts","sourceRoot":"","sources":["../../../src/wallet/handlers/senders.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AACtD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC;AAK3D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB;IAEhC;;;;;;;;;;;;;;;;;;;OAmBG;gCAEI,mBAAmB,eACX,oBAAoB,CAAC,sBAAsB,CAAC,CAAC,QAAQ,CAAC,KAClE,OAAO,CAAC,oBAAoB,CAAC,sBAAsB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAUlE;;;;;;;;;;;OAWG;4BAEI,mBAAmB,gBACV,oBAAoB,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,KAC/D,OAAO,CAAC,oBAAoB,CAAC,kBAAkB,CAAC,CAAC,QAAQ,CAAC,CAAC;IAK9D;;;;;;;;;;;;;;;OAeG;8BAEI,mBAAmB,eACX,oBAAoB,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,KAChE,OAAO,CAAC,oBAAoB,CAAC,oBAAoB,CAAC,CAAC,QAAQ,CAAC,CAAC;EAWnE"}