@walletmesh/aztec-rpc-wallet 0.3.0 → 0.4.0

package/dist/errors.d.ts

@@ -1,7 +1,19 @@
+/**
+ * @module @walletmesh/aztec-rpc-wallet/errors
+ *
+ * This module defines custom error types and codes specific to the Aztec RPC Wallet.
+ * It provides a structured way to represent errors that can occur during
+ * interactions with the Aztec wallet, aligning with JSON-RPC error standards
+ * while offering more specific error information.
+ */
 import { JSONRPCError } from '@walletmesh/jsonrpc';
 /**
- * Enum of available Aztec Wallet RPC error types.
+ * An object acting as an enum for specific Aztec Wallet RPC error types.
+ * Each key represents a distinct error condition that can occur within the Aztec wallet system.
+ * These keys are used to look up corresponding error codes and messages in {@link AztecWalletErrorMap}.
+ *
  * @public
+ * @readonly
  */
 export declare const AztecWalletErrorType: {
     readonly unknownInternalError: "unknownInternalError";
@@ -23,28 +35,58 @@ export declare const AztecWalletErrorType: {
     readonly authWitnessNotFound: "authWitnessNotFound";
 };
 /**
- * Type representing valid Aztec Wallet RPC error types.
+ * A type alias representing the string literal union of all valid keys from {@link AztecWalletErrorType}.
+ * This provides type safety when referring to specific Aztec wallet error types.
+ *
  * @public
  */
 export type AztecWalletErrorType = (typeof AztecWalletErrorType)[keyof typeof AztecWalletErrorType];
 /**
- * Map of error codes and messages for Aztec Wallet RPC errors.
+ * A map associating each {@link AztecWalletErrorType} with a specific JSON-RPC error code
+ * and a human-readable message. This map is used by the {@link AztecWalletError} class
+ * to construct standardized error objects.
+ *
+ * The error codes are chosen from the range typically reserved for server-defined errors
+ * in JSON-RPC (e.g., -32000 to -32099).
+ *
  * @public
+ * @readonly
  */
 export declare const AztecWalletErrorMap: Record<AztecWalletErrorType, {
     code: number;
     message: string;
 }>;
 /**
- * Custom error class for Aztec Wallet RPC errors.
+ * Custom error class for representing errors specific to the Aztec RPC Wallet.
+ * It extends the base {@link JSONRPCError} from `@walletmesh/jsonrpc` and uses
+ * predefined error types and messages from {@link AztecWalletErrorMap}.
+ *
+ * This class allows for consistent error handling and reporting within the
+ * Aztec wallet system, providing both a standard JSON-RPC error code and
+ * a more specific Aztec error type.
+ *
  * @public
+ * @example
+ * ```typescript
+ * if (!isConnected) {
+ *   throw new AztecWalletError('walletNotConnected', 'Attempted to call method while disconnected.');
+ * }
+ * ```
  */
 export declare class AztecWalletError extends JSONRPCError {
     /**
-     * Creates a new AztecWalletError.
-     * @param err - The error type from AztecWalletErrorMap
-     * @param data - Optional additional error data
+     * The specific Aztec wallet error type.
+     */
+    readonly aztecErrorType: AztecWalletErrorType;
+    /**
+     * Creates a new `AztecWalletError` instance.
+     *
+     * @param errorType - The specific {@link AztecWalletErrorType} identifying the error.
+     *                    This key is used to look up the code and message from {@link AztecWalletErrorMap}.
+     * @param data - Optional additional data associated with the error. This can be a string
+     *               or a record, providing more context. It will be included in the `data`
+     *               field of the JSON-RPC error object.
      */
-    constructor(err: AztecWalletErrorType, data?: string);
+    constructor(errorType: AztecWalletErrorType, data?: string | Record<string, unknown>);
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;GAGG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;CAkBvB,CAAC;AAEX;;;GAGG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEpG;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,oBAAoB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAkB/F,CAAC;AAEF;;;GAGG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD;;;;OAIG;gBACS,GAAG,EAAE,oBAAoB,EAAE,IAAI,CAAC,EAAE,MAAM;CAGrD"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;CAkBvB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,OAAO,oBAAoB,CAAC,CAAC;AAEpG;;;;;;;;;;GAUG;AACH,eAAO,MAAM,mBAAmB,EAAE,MAAM,CAAC,oBAAoB,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAkB/F,CAAC;AAEF;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD;;OAEG;IACH,SAAgB,cAAc,EAAE,oBAAoB,CAAC;IAErD;;;;;;;;OAQG;gBACS,SAAS,EAAE,oBAAoB,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOrF"}

package/dist/errors.js

@@ -1,7 +1,19 @@
+/**
+ * @module @walletmesh/aztec-rpc-wallet/errors
+ *
+ * This module defines custom error types and codes specific to the Aztec RPC Wallet.
+ * It provides a structured way to represent errors that can occur during
+ * interactions with the Aztec wallet, aligning with JSON-RPC error standards
+ * while offering more specific error information.
+ */
 import { JSONRPCError } from '@walletmesh/jsonrpc';
 /**
- * Enum of available Aztec Wallet RPC error types.
+ * An object acting as an enum for specific Aztec Wallet RPC error types.
+ * Each key represents a distinct error condition that can occur within the Aztec wallet system.
+ * These keys are used to look up corresponding error codes and messages in {@link AztecWalletErrorMap}.
+ *
  * @public
+ * @readonly
  */
 export const AztecWalletErrorType = {
     unknownInternalError: 'unknownInternalError',
@@ -23,12 +35,19 @@ export const AztecWalletErrorType = {
     authWitnessNotFound: 'authWitnessNotFound',
 };
 /**
- * Map of error codes and messages for Aztec Wallet RPC errors.
+ * A map associating each {@link AztecWalletErrorType} with a specific JSON-RPC error code
+ * and a human-readable message. This map is used by the {@link AztecWalletError} class
+ * to construct standardized error objects.
+ *
+ * The error codes are chosen from the range typically reserved for server-defined errors
+ * in JSON-RPC (e.g., -32000 to -32099).
+ *
  * @public
+ * @readonly
  */
 export const AztecWalletErrorMap = {
     unknownInternalError: { code: -32000, message: 'Unknown internal error' },
-    refused: { code: -32001, message: 'User refused transaction' },
+    refused: { code: -32001, message: 'User refused transaction' }, // Or request
     walletNotConnected: { code: -32002, message: 'Wallet not connected' },
     contractInstanceNotRegistered: { code: -32003, message: 'Contract instance not registered' },
     contractClassNotRegistered: { code: -32004, message: 'Contract class not registered' },
@@ -46,17 +65,38 @@ export const AztecWalletErrorMap = {
     authWitnessNotFound: { code: -32016, message: 'Authorization witness not found' },
 };
 /**
- * Custom error class for Aztec Wallet RPC errors.
+ * Custom error class for representing errors specific to the Aztec RPC Wallet.
+ * It extends the base {@link JSONRPCError} from `@walletmesh/jsonrpc` and uses
+ * predefined error types and messages from {@link AztecWalletErrorMap}.
+ *
+ * This class allows for consistent error handling and reporting within the
+ * Aztec wallet system, providing both a standard JSON-RPC error code and
+ * a more specific Aztec error type.
+ *
  * @public
+ * @example
+ * ```typescript
+ * if (!isConnected) {
+ *   throw new AztecWalletError('walletNotConnected', 'Attempted to call method while disconnected.');
+ * }
+ * ```
  */
 export class AztecWalletError extends JSONRPCError {
     /**
-     * Creates a new AztecWalletError.
-     * @param err - The error type from AztecWalletErrorMap
-     * @param data - Optional additional error data
+     * Creates a new `AztecWalletError` instance.
+     *
+     * @param errorType - The specific {@link AztecWalletErrorType} identifying the error.
+     *                    This key is used to look up the code and message from {@link AztecWalletErrorMap}.
+     * @param data - Optional additional data associated with the error. This can be a string
+     *               or a record, providing more context. It will be included in the `data`
+     *               field of the JSON-RPC error object.
      */
-    constructor(err, data) {
-        super(AztecWalletErrorMap[err].code, AztecWalletErrorMap[err].message, data);
+    constructor(errorType, data) {
+        const errorDetails = AztecWalletErrorMap[errorType];
+        super(errorDetails.code, errorDetails.message, data);
+        this.aztecErrorType = errorType;
+        // Ensure the name property is set to the class name
+        this.name = 'AztecWalletError';
     }
 }
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2Vycm9ycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQSxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0scUJBQXFCLENBQUM7QUFFbkQ7OztHQUdHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sb0JBQW9CLEdBQUc7SUFDbEMsb0JBQW9CLEVBQUUsc0JBQXNCO0lBQzVDLE9BQU8sRUFBRSxTQUFTO0lBQ2xCLGtCQUFrQixFQUFFLG9CQUFvQjtJQUN4Qyw2QkFBNkIsRUFBRSwrQkFBK0I7SUFDOUQsMEJBQTBCLEVBQUUsNEJBQTRCO0lBQ3hELG1CQUFtQixFQUFFLHFCQUFxQjtJQUMxQyxlQUFlLEVBQUUsaUJBQWlCO0lBQ2xDLFlBQVksRUFBRSxjQUFjO0lBQzVCLGlCQUFpQixFQUFFLG1CQUFtQjtJQUN0QyxjQUFjLEVBQUUsZ0JBQWdCO0lBQ2hDLGFBQWEsRUFBRSxlQUFlO0lBQzlCLGdCQUFnQixFQUFFLGtCQUFrQjtJQUNwQyxlQUFlLEVBQUUsaUJBQWlCO0lBQ2xDLGNBQWMsRUFBRSxnQkFBZ0I7SUFDaEMsbUJBQW1CLEVBQUUscUJBQXFCO0lBQzFDLGFBQWEsRUFBRSxlQUFlO0lBQzlCLG1CQUFtQixFQUFFLHFCQUFxQjtDQUNsQyxDQUFDO0FBUVg7OztHQUdHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sbUJBQW1CLEdBQW9FO0lBQ2xHLG9CQUFvQixFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSx3QkFBd0IsRUFBRTtJQUN6RSxPQUFPLEVBQUUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLDBCQUEwQixFQUFFO0lBQzlELGtCQUFrQixFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSxzQkFBc0IsRUFBRTtJQUNyRSw2QkFBNkIsRUFBRSxFQUFFLElBQUksRUFBRSxDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsa0NBQWtDLEVBQUU7SUFDNUYsMEJBQTBCLEVBQUUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLCtCQUErQixFQUFFO0lBQ3RGLG1CQUFtQixFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSx1QkFBdUIsRUFBRTtJQUN2RSxlQUFlLEVBQUUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLHlCQUF5QixFQUFFO0lBQ3JFLFlBQVksRUFBRSxFQUFFLElBQUksRUFBRSxDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsNEJBQTRCLEVBQUU7SUFDckUsaUJBQWlCLEVBQUUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLHFCQUFxQixFQUFFO0lBQ25FLGNBQWMsRUFBRSxFQUFFLElBQUksRUFBRSxDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsd0JBQXdCLEVBQUU7SUFDbkUsYUFBYSxFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSxvQkFBb0IsRUFBRTtJQUM5RCxnQkFBZ0IsRUFBRSxFQUFFLElBQUksRUFBRSxDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsbUJBQW1CLEVBQUU7SUFDaEUsZUFBZSxFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSxtQkFBbUIsRUFBRTtJQUMvRCxjQUFjLEVBQUUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLGlCQUFpQixFQUFFO0lBQzVELG1CQUFtQixFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSx1QkFBdUIsRUFBRTtJQUN2RSxhQUFhLEVBQUUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLGlCQUFpQixFQUFFO0lBQzNELG1CQUFtQixFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSxpQ0FBaUMsRUFBRTtDQUNsRixDQUFDO0FBRUY7OztHQUdHO0FBQ0gsTUFBTSxPQUFPLGdCQUFpQixTQUFRLFlBQVk7SUFDaEQ7Ozs7T0FJRztJQUNILFlBQVksR0FBeUIsRUFBRSxJQUFhO1FBQ2xELEtBQUssQ0FBQyxtQkFBbUIsQ0FBQyxHQUFHLENBQUMsQ0FBQyxJQUFJLEVBQUUsbUJBQW1CLENBQUMsR0FBRyxDQUFDLENBQUMsT0FBTyxFQUFFLElBQUksQ0FBQyxDQUFDO0lBQy9FLENBQUM7Q0FDRiJ9
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZXJyb3JzLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL2Vycm9ycy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFBQTs7Ozs7OztHQU9HO0FBRUgsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLHFCQUFxQixDQUFDO0FBRW5EOzs7Ozs7O0dBT0c7QUFDSCxNQUFNLENBQUMsTUFBTSxvQkFBb0IsR0FBRztJQUNsQyxvQkFBb0IsRUFBRSxzQkFBc0I7SUFDNUMsT0FBTyxFQUFFLFNBQVM7SUFDbEIsa0JBQWtCLEVBQUUsb0JBQW9CO0lBQ3hDLDZCQUE2QixFQUFFLCtCQUErQjtJQUM5RCwwQkFBMEIsRUFBRSw0QkFBNEI7SUFDeEQsbUJBQW1CLEVBQUUscUJBQXFCO0lBQzFDLGVBQWUsRUFBRSxpQkFBaUI7SUFDbEMsWUFBWSxFQUFFLGNBQWM7SUFDNUIsaUJBQWlCLEVBQUUsbUJBQW1CO0lBQ3RDLGNBQWMsRUFBRSxnQkFBZ0I7SUFDaEMsYUFBYSxFQUFFLGVBQWU7SUFDOUIsZ0JBQWdCLEVBQUUsa0JBQWtCO0lBQ3BDLGVBQWUsRUFBRSxpQkFBaUI7SUFDbEMsY0FBYyxFQUFFLGdCQUFnQjtJQUNoQyxtQkFBbUIsRUFBRSxxQkFBcUI7SUFDMUMsYUFBYSxFQUFFLGVBQWU7SUFDOUIsbUJBQW1CLEVBQUUscUJBQXFCO0NBQ2xDLENBQUM7QUFVWDs7Ozs7Ozs7OztHQVVHO0FBQ0gsTUFBTSxDQUFDLE1BQU0sbUJBQW1CLEdBQW9FO0lBQ2xHLG9CQUFvQixFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSx3QkFBd0IsRUFBRTtJQUN6RSxPQUFPLEVBQUUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLDBCQUEwQixFQUFFLEVBQUUsYUFBYTtJQUM3RSxrQkFBa0IsRUFBRSxFQUFFLElBQUksRUFBRSxDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsc0JBQXNCLEVBQUU7SUFDckUsNkJBQTZCLEVBQUUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLGtDQUFrQyxFQUFFO0lBQzVGLDBCQUEwQixFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSwrQkFBK0IsRUFBRTtJQUN0RixtQkFBbUIsRUFBRSxFQUFFLElBQUksRUFBRSxDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsdUJBQXVCLEVBQUU7SUFDdkUsZUFBZSxFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSx5QkFBeUIsRUFBRTtJQUNyRSxZQUFZLEVBQUUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLDRCQUE0QixFQUFFO0lBQ3JFLGlCQUFpQixFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSxxQkFBcUIsRUFBRTtJQUNuRSxjQUFjLEVBQUUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLHdCQUF3QixFQUFFO0lBQ25FLGFBQWEsRUFBRSxFQUFFLElBQUksRUFBRSxDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsb0JBQW9CLEVBQUU7SUFDOUQsZ0JBQWdCLEVBQUUsRUFBRSxJQUFJLEVBQUUsQ0FBQyxLQUFLLEVBQUUsT0FBTyxFQUFFLG1CQUFtQixFQUFFO0lBQ2hFLGVBQWUsRUFBRSxFQUFFLElBQUksRUFBRSxDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsbUJBQW1CLEVBQUU7SUFDL0QsY0FBYyxFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSxpQkFBaUIsRUFBRTtJQUM1RCxtQkFBbUIsRUFBRSxFQUFFLElBQUksRUFBRSxDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsdUJBQXVCLEVBQUU7SUFDdkUsYUFBYSxFQUFFLEVBQUUsSUFBSSxFQUFFLENBQUMsS0FBSyxFQUFFLE9BQU8sRUFBRSxpQkFBaUIsRUFBRTtJQUMzRCxtQkFBbUIsRUFBRSxFQUFFLElBQUksRUFBRSxDQUFDLEtBQUssRUFBRSxPQUFPLEVBQUUsaUNBQWlDLEVBQUU7Q0FDbEYsQ0FBQztBQUVGOzs7Ozs7Ozs7Ozs7Ozs7O0dBZ0JHO0FBQ0gsTUFBTSxPQUFPLGdCQUFpQixTQUFRLFlBQVk7SUFNaEQ7Ozs7Ozs7O09BUUc7SUFDSCxZQUFZLFNBQStCLEVBQUUsSUFBdUM7UUFDbEYsTUFBTSxZQUFZLEdBQUcsbUJBQW1CLENBQUMsU0FBUyxDQUFDLENBQUM7UUFDcEQsS0FBSyxDQUFDLFlBQVksQ0FBQyxJQUFJLEVBQUUsWUFBWSxDQUFDLE9BQU8sRUFBRSxJQUFJLENBQUMsQ0FBQztRQUNyRCxJQUFJLENBQUMsY0FBYyxHQUFHLFNBQVMsQ0FBQztRQUNoQyxvREFBb0Q7UUFDcEQsSUFBSSxDQUFDLElBQUksR0FBRyxrQkFBa0IsQ0FBQztJQUNqQyxDQUFDO0NBQ0YifQ==

package/dist/index.d.ts

@@ -1,58 +1,71 @@
 /**
  * @module @walletmesh/aztec-rpc-wallet
  *
- * This module provides a JSON-RPC implementation for interacting with Aztec Network.
- * It enables communication between dApps and wallets through a standardized interface.
+ * JSON-RPC wallet integration for Aztec Protocol, built on WalletMesh router for multi-chain support.
+ * This package provides both wallet-side and dApp-side implementations for Aztec integration.
  */
 /**
- * Provider class for dApps to interact with Aztec wallets
- * @see AztecProvider
+ * Creates an Aztec wallet node that can be used with WalletRouter.
+ * This is the wallet-side implementation that handles JSON-RPC requests.
+ * @see {@link createAztecWalletNode}
  */
-export { AztecProvider } from './provider.js';
+export { createAztecWalletNode } from './wallet/create-node.js';
 /**
- * Minimal provider for direct interaction with an Aztec chain wallet
- * @see AztecChainProvider
+ * Context interface provided to all handler functions in the wallet implementation.
+ * @see {@link AztecHandlerContext}
  */
-export { AztecChainProvider } from './chainProvider.js';
+export type { AztecHandlerContext } from './wallet/handlers/index.js';
 /**
- * Wallet implementation that handles RPC requests from dApps
- * @see AztecChainWallet
+ * DApp-side wallet class that implements the aztec.js Wallet interface.
+ * @see {@link AztecDappWallet}
  */
-export { AztecChainWallet } from './wallet.js';
-export { AztecChainWalletMiddleware } from './types.js';
+export { AztecDappWallet, createAztecWallet } from './client/aztec-dapp-wallet.js';
 /**
- * Cache for contract artifacts
- * @see ContractArtifactCache
+ * Extended WalletRouterProvider with built-in Aztec serialization support.
+ * Use this instead of the base WalletRouterProvider for automatic serialization
+ * of Aztec types on the client side.
+ * @see {@link AztecRouterProvider}
+ */
+export { AztecRouterProvider } from './client/aztec-router-provider.js';
+/**
+ * Helper constants and functions for connecting to Aztec wallets.
+ * - ALL_AZTEC_METHODS: Complete list of all available Aztec methods
+ * - connectAztec: Helper to connect to Aztec and create wallet instance
+ */
+export { ALL_AZTEC_METHODS, connectAztec, } from './client/helpers.js';
+/**
+ * Helper function to register Aztec serializers with a WalletRouterProvider.
+ * This enables proper serialization of Aztec types when using the router.
+ * @see {@link registerAztecSerializers}
+ */
+export { registerAztecSerializers } from './client/register-serializers.js';
+/**
+ * Core type definitions used throughout the package.
+ * - AztecChainId: Type-safe Aztec chain ID format (e.g., "aztec:mainnet")
+ * - AztecWalletContext: Context object for wallet implementations
+ * - AztecWalletMethodMap: Complete method map for all Aztec wallet methods
+ */
+export type { AztecChainId, AztecWalletContext, AztecWalletMethodMap, } from './types.js';
+/**
+ * Cache utility for managing contract artifacts in wallet implementations.
+ * @see {@link ContractArtifactCache}
  */
 export { ContractArtifactCache } from './contractArtifactCache.js';
 /**
- * Error handling utilities for RPC communication
- * @see AztecWalletError
- * @see AztecWalletErrorMap
+ * Error handling utilities for Aztec wallet operations.
+ * - AztecWalletError: Custom error class for Aztec wallet errors
+ * - AztecWalletErrorMap: Map of error codes to error messages
  */
 export { AztecWalletError, AztecWalletErrorMap } from './errors.js';
 /**
- * Type definitions for RPC interfaces
- */
-export type { 
-/** Chain identifier type */
-AztecChainId, 
-/** Context passed through RPC middleware */
-AztecWalletContext, 
-/** Event map for wallet events */
-AztecWalletEventMap, 
-/** Base method map for core wallet functionality */
-AztecWalletBaseMethodMap, 
-/** Complete method map including all Aztec methods */
-AztecWalletMethodMap, 
-/** Middleware type for processing RPC requests */
-AztecWalletMiddleware, 
-/** Router client type for wallet mesh integration */
-AztecWalletRouterClient, 
-/** Handler type for wallet methods */
-AztecWalletMethodHandler, 
-/** Type for contract function calls */
-TransactionFunctionCall, 
-/** Parameters for transaction requests */
-TransactionParams, } from './types.js';
+ * Re-exports the primary {@link AztecWalletSerializer} and the wallet-side
+ * `registerAztecSerializers` function from the `wallet/serializers` module.
+ * These are crucial for handling Aztec-specific data types over JSON-RPC
+ * on the wallet (node) side.
+ *
+ * @see {@link AztecWalletSerializer} - The main serializer object.
+ * @see {@link module:@walletmesh/aztec-rpc-wallet/wallet/serializers} - The module providing these utilities.
+ * Note: The client-side `registerAztecSerializers` is exported separately from `./client/register-serializers.js`.
+ */
+export { AztecWalletSerializer, registerAztecSerializers as registerWalletAztecSerializers, } from './wallet/serializers.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;GAGG;AACH,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAE9C;;;GAGG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;GAGG;AACH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,0BAA0B,EAAE,MAAM,YAAY,CAAC;AAExD;;;GAGG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAEnE;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAEpE;;GAEG;AACH,YAAY;AACV,4BAA4B;AAC5B,YAAY;AACZ,4CAA4C;AAC5C,kBAAkB;AAClB,kCAAkC;AAClC,mBAAmB;AACnB,oDAAoD;AACpD,wBAAwB;AACxB,sDAAsD;AACtD,oBAAoB;AACpB,kDAAkD;AAClD,qBAAqB;AACrB,qDAAqD;AACrD,uBAAuB;AACvB,sCAAsC;AACtC,wBAAwB;AACxB,uCAAuC;AACvC,uBAAuB;AACvB,0CAA0C;AAC1C,iBAAiB,GAClB,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH;;;;GAIG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,yBAAyB,CAAC;AAEhE;;;GAGG;AACH,YAAY,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAGtE;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAEnF;;;;;GAKG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,mCAAmC,CAAC;AAExE;;;;GAIG;AACH,OAAO,EACL,iBAAiB,EACjB,YAAY,GACb,MAAM,qBAAqB,CAAC;AAE7B;;;;GAIG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,kCAAkC,CAAC;AAG5E;;;;;GAKG;AACH,YAAY,EACV,YAAY,EACZ,kBAAkB,EAClB,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAGpB;;;GAGG;AACH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE;;;;GAIG;AACH,OAAO,EAAE,gBAAgB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAGpE;;;;;;;;;GASG;AACH,OAAO,EACL,qBAAqB,EACrB,wBAAwB,IAAI,8BAA8B,GAC3D,MAAM,yBAAyB,CAAC"}

package/dist/index.js

@@ -1,33 +1,68 @@
 /**
  * @module @walletmesh/aztec-rpc-wallet
  *
- * This module provides a JSON-RPC implementation for interacting with Aztec Network.
- * It enables communication between dApps and wallets through a standardized interface.
+ * JSON-RPC wallet integration for Aztec Protocol, built on WalletMesh router for multi-chain support.
+ * This package provides both wallet-side and dApp-side implementations for Aztec integration.
  */
+// Wallet-side exports
 /**
- * Provider class for dApps to interact with Aztec wallets
- * @see AztecProvider
+ * Creates an Aztec wallet node that can be used with WalletRouter.
+ * This is the wallet-side implementation that handles JSON-RPC requests.
+ * @see {@link createAztecWalletNode}
  */
-export { AztecProvider } from './provider.js';
+export { createAztecWalletNode } from './wallet/create-node.js';
+// Client-side exports
 /**
- * Minimal provider for direct interaction with an Aztec chain wallet
- * @see AztecChainProvider
+ * DApp-side wallet class that implements the aztec.js Wallet interface.
+ * @see {@link AztecDappWallet}
  */
-export { AztecChainProvider } from './chainProvider.js';
+export { AztecDappWallet, createAztecWallet } from './client/aztec-dapp-wallet.js';
 /**
- * Wallet implementation that handles RPC requests from dApps
- * @see AztecChainWallet
+ * Extended WalletRouterProvider with built-in Aztec serialization support.
+ * Use this instead of the base WalletRouterProvider for automatic serialization
+ * of Aztec types on the client side.
+ * @see {@link AztecRouterProvider}
  */
-export { AztecChainWallet } from './wallet.js';
+export { AztecRouterProvider } from './client/aztec-router-provider.js';
 /**
- * Cache for contract artifacts
- * @see ContractArtifactCache
+ * Helper constants and functions for connecting to Aztec wallets.
+ * - ALL_AZTEC_METHODS: Complete list of all available Aztec methods
+ * - connectAztec: Helper to connect to Aztec and create wallet instance
+ */
+export { ALL_AZTEC_METHODS, connectAztec, } from './client/helpers.js';
+/**
+ * Helper function to register Aztec serializers with a WalletRouterProvider.
+ * This enables proper serialization of Aztec types when using the router.
+ * @see {@link registerAztecSerializers}
+ */
+export { registerAztecSerializers } from './client/register-serializers.js';
+// Utilities
+/**
+ * Cache utility for managing contract artifacts in wallet implementations.
+ * @see {@link ContractArtifactCache}
  */
 export { ContractArtifactCache } from './contractArtifactCache.js';
+// Error utilities
 /**
- * Error handling utilities for RPC communication
- * @see AztecWalletError
- * @see AztecWalletErrorMap
+ * Error handling utilities for Aztec wallet operations.
+ * - AztecWalletError: Custom error class for Aztec wallet errors
+ * - AztecWalletErrorMap: Map of error codes to error messages
  */
 export { AztecWalletError, AztecWalletErrorMap } from './errors.js';
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7O0dBS0c7QUFFSDs7O0dBR0c7QUFDSCxPQUFPLEVBQUUsYUFBYSxFQUFFLE1BQU0sZUFBZSxDQUFDO0FBRTlDOzs7R0FHRztBQUNILE9BQU8sRUFBRSxrQkFBa0IsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBRXhEOzs7R0FHRztBQUNILE9BQU8sRUFBRSxnQkFBZ0IsRUFBRSxNQUFNLGFBQWEsQ0FBQztBQUcvQzs7O0dBR0c7QUFDSCxPQUFPLEVBQUUscUJBQXFCLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUVuRTs7OztHQUlHO0FBQ0gsT0FBTyxFQUFFLGdCQUFnQixFQUFFLG1CQUFtQixFQUFFLE1BQU0sYUFBYSxDQUFDIn0=
+// Re-export serializers
+/**
+ * Re-exports the primary {@link AztecWalletSerializer} and the wallet-side
+ * `registerAztecSerializers` function from the `wallet/serializers` module.
+ * These are crucial for handling Aztec-specific data types over JSON-RPC
+ * on the wallet (node) side.
+ *
+ * @see {@link AztecWalletSerializer} - The main serializer object.
+ * @see {@link module:@walletmesh/aztec-rpc-wallet/wallet/serializers} - The module providing these utilities.
+ * Note: The client-side `registerAztecSerializers` is exported separately from `./client/register-serializers.js`.
+ */
+export { AztecWalletSerializer, registerAztecSerializers as registerWalletAztecSerializers, } from './wallet/serializers.js';
+// To avoid naming collision with client/register-serializers.ts,
+// the wallet-side registerAztecSerializers is re-exported as registerWalletAztecSerializers.
+// AztecWalletSerializer is unique and can be re-exported directly.
+// Other internal details of wallet/serializers.ts are not re-exported here.
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvaW5kZXgudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUE7Ozs7O0dBS0c7QUFFSCxzQkFBc0I7QUFDdEI7Ozs7R0FJRztBQUNILE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLHlCQUF5QixDQUFDO0FBUWhFLHNCQUFzQjtBQUN0Qjs7O0dBR0c7QUFDSCxPQUFPLEVBQUUsZUFBZSxFQUFFLGlCQUFpQixFQUFFLE1BQU0sK0JBQStCLENBQUM7QUFFbkY7Ozs7O0dBS0c7QUFDSCxPQUFPLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUV4RTs7OztHQUlHO0FBQ0gsT0FBTyxFQUNMLGlCQUFpQixFQUNqQixZQUFZLEdBQ2IsTUFBTSxxQkFBcUIsQ0FBQztBQUU3Qjs7OztHQUlHO0FBQ0gsT0FBTyxFQUFFLHdCQUF3QixFQUFFLE1BQU0sa0NBQWtDLENBQUM7QUFlNUUsWUFBWTtBQUNaOzs7R0FHRztBQUNILE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBRW5FLGtCQUFrQjtBQUNsQjs7OztHQUlHO0FBQ0gsT0FBTyxFQUFFLGdCQUFnQixFQUFFLG1CQUFtQixFQUFFLE1BQU0sYUFBYSxDQUFDO0FBRXBFLHdCQUF3QjtBQUN4Qjs7Ozs7Ozs7O0dBU0c7QUFDSCxPQUFPLEVBQ0wscUJBQXFCLEVBQ3JCLHdCQUF3QixJQUFJLDhCQUE4QixHQUMzRCxNQUFNLHlCQUF5QixDQUFDO0FBQ2pDLGlFQUFpRTtBQUNqRSw2RkFBNkY7QUFDN0YsbUVBQW1FO0FBQ25FLDRFQUE0RSJ9