@walletmesh/aztec-rpc-wallet 0.1.0

package/dist/types.d.ts

@@ -0,0 +1,391 @@
+import type { AuthWitness, AztecAddress, ContractArtifact, ContractClassWithId, ContractInstanceWithAddress, ExtendedNote, Fr, PXE, TxExecutionRequest, TxHash, TxReceipt, L2Block, LogFilter, Point, SiblingPath, PartialAddress, CompleteAddress, NodeInfo, AccountWallet, Tx } from '@aztec/aztec.js';
+import type { IntentAction, IntentInnerHash } from '@aztec/aztec.js/utils';
+import type { ExecutionRequestInit } from '@aztec/aztec.js/entrypoint';
+import type { AbiDecoded } from '@aztec/foundation/abi';
+import type { InBlock, IncomingNotesFilter, EventMetadataDefinition, PrivateExecutionResult, TxEffect, TxProvingResult, UniqueNote, GetUnencryptedLogsResponse, PXEInfo, TxSimulationResult } from '@aztec/circuit-types';
+import type { GasFees, L1_TO_L2_MSG_TREE_HEIGHT } from '@aztec/circuits.js';
+import type { JSONRPCEventMap, JSONRPCMiddleware } from '@walletmesh/jsonrpc';
+import type { JSONRPCWalletClient, WalletMethodMap } from '@walletmesh/router';
+import type { ContractArtifactCache } from './contractArtifactCache.js';
+/**
+ * Represents a single function call to a contract.
+ * @public
+ */
+export type TransactionFunctionCall = {
+    /** The address of the contract to interact with */
+    contractAddress: string;
+    /** The name of the function to call */
+    functionName: string;
+    /** The arguments to pass to the function */
+    args: unknown[];
+};
+/**
+ * Parameters for sending transactions.
+ * @public
+ */
+export type TransactionParams = {
+    /** Array of function calls to execute */
+    functionCalls: TransactionFunctionCall[];
+    /** Optional array of authorization witnesses for the transaction */
+    authwits?: string[];
+};
+export declare const BASE_WALLET_METHODS: (keyof AztecWalletBaseMethodMap)[];
+/**
+ * A mapping of JSON-RPC methods to their parameters and return types for Aztec Wallets.
+ *
+ * This extends the base WalletMethodMap with Aztec-specific methods.
+ * @public
+ */
+export interface AztecWalletBaseMethodMap extends WalletMethodMap {
+    /**
+     * Connects to the Aztec network.
+     * @returns A boolean indicating if the connection was successful
+     */
+    aztec_connect: {
+        result: boolean;
+    };
+    /**
+     * Gets the account address from the wallet.
+     * @returns The account address as a string
+     */
+    aztec_getAccount: {
+        result: string;
+    };
+    /**
+     * Sends transactions to the Aztec network.
+     * @param params - The transactions to execute and optional authorization witnesses
+     * @returns The transaction hash as a string
+     */
+    aztec_sendTransaction: {
+        params: TransactionParams;
+        result: string;
+    };
+    /**
+     * Simulates a transaction without executing it.
+     * @param params - The transaction to simulate
+     * @returns The simulation result
+     */
+    aztec_simulateTransaction: {
+        params: TransactionFunctionCall;
+        result: unknown;
+    };
+    /**
+     * Returns the list of supported methods for the wallet.
+     * @returns An array of supported methods
+     */
+    wm_getSupportedMethods: {
+        result: string[];
+    };
+}
+export interface AztecWalletEventMap extends JSONRPCEventMap {
+}
+/**
+ * Holds the context passed through RPC middleware.
+ * @public
+ */
+export type AztecWalletContext = Record<string, unknown> & {
+    /** The PXE instance for the wallet */
+    pxe: PXE;
+    wallet: AccountWallet;
+    contractArtifactCache: ContractArtifactCache;
+};
+/**
+ * Type for Aztec Router Wallet middleware.
+ * @public
+ */
+export type AztecWalletMiddleware = JSONRPCMiddleware<AztecWalletBaseMethodMap, AztecWalletContext>;
+/**
+ * Type for Aztec Chain Wallet middleware.
+ */
+export type AztecChainWalletMiddleware = JSONRPCMiddleware<AztecWalletMethodMap, AztecWalletContext>;
+/**
+ * Type for Aztec wallet router client.
+ * @public
+ */
+export type AztecWalletRouterClient = JSONRPCWalletClient<AztecWalletMethodMap>;
+/**
+ * Type for Aztec wallet RPC method map.
+ * This extends the AztecWalletBaseMethodMap with the methods used in by Aztec's `AccountWallet`
+ */
+export interface AztecWalletMethodMap extends AztecWalletBaseMethodMap {
+    aztec_getBlock: {
+        params: {
+            number: number;
+        };
+        result: L2Block;
+    };
+    aztec_getBlockNumber: {
+        result: number;
+    };
+    aztec_getChainId: {
+        result: number;
+    };
+    aztec_getVersion: {
+        result: number;
+    };
+    aztec_getNodeInfo: {
+        result: NodeInfo;
+    };
+    aztec_getProvenBlockNumber: {
+        result: number;
+    };
+    aztec_getPXEInfo: {
+        result: PXEInfo;
+    };
+    aztec_getCurrentBaseFees: {
+        result: GasFees;
+    };
+    aztec_setScopes: {
+        params: {
+            scopes: AztecAddress[];
+        };
+        result: boolean;
+    };
+    aztec_getScopes: {
+        result: AztecAddress[];
+    };
+    aztec_isL1ToL2MessageSynced: {
+        params: {
+            l1ToL2Message: Fr;
+        };
+        result: boolean;
+    };
+    aztec_getL1ToL2MembershipWitness: {
+        params: {
+            contractAddress: AztecAddress;
+            messageHash: Fr;
+            secret: Fr;
+        };
+        result: [bigint, SiblingPath<typeof L1_TO_L2_MSG_TREE_HEIGHT>];
+    };
+    aztec_addCapsule: {
+        params: {
+            capsule: Fr[];
+        };
+        result: boolean;
+    };
+    aztec_getAddress: {
+        result: AztecAddress;
+    };
+    aztec_getCompleteAddress: {
+        result: CompleteAddress;
+    };
+    aztec_registerAccount: {
+        params: {
+            secretKey: Fr;
+            partialAddress: PartialAddress;
+        };
+        result: CompleteAddress;
+    };
+    aztec_getRegisteredAccounts: {
+        result: CompleteAddress[];
+    };
+    aztec_addAuthWitness: {
+        params: {
+            authWitness: AuthWitness;
+        };
+        result: boolean;
+    };
+    aztec_getAuthWitness: {
+        params: {
+            messageHash: Fr;
+        };
+        result: Fr[];
+    };
+    aztec_createAuthWit: {
+        params: {
+            intent: Fr | Buffer | IntentAction | IntentInnerHash;
+        };
+        result: AuthWitness;
+    };
+    /**
+     * Registers a contact in the user's PXE
+     * @param params - The sender (contact) address to register
+     * @returns True if registration was successful
+     */
+    aztec_registerSender: {
+        params: {
+            sender: AztecAddress;
+        };
+        result: AztecAddress;
+    };
+    aztec_getSenders: {
+        result: AztecAddress[];
+    };
+    aztec_removeSender: {
+        params: {
+            sender: AztecAddress;
+        };
+        result: boolean;
+    };
+    aztec_getContracts: {
+        result: AztecAddress[];
+    };
+    aztec_getContractInstance: {
+        params: {
+            address: AztecAddress;
+        };
+        result: ContractInstanceWithAddress;
+    };
+    aztec_getContractClass: {
+        params: {
+            id: Fr;
+        };
+        result: ContractClassWithId;
+    };
+    aztec_getContractArtifact: {
+        params: {
+            id: Fr;
+        };
+        result: ContractArtifact;
+    };
+    aztec_isContractClassPubliclyRegistered: {
+        params: {
+            id: Fr;
+        };
+        result: boolean;
+    };
+    aztec_isContractPubliclyDeployed: {
+        params: {
+            address: AztecAddress;
+        };
+        result: boolean;
+    };
+    aztec_isContractInitialized: {
+        params: {
+            address: AztecAddress;
+        };
+        result: boolean;
+    };
+    /**
+     * Registers a contract instance in the user's PXE.
+     * @param params - The contract details to register
+     * @returns True if registration was successful
+     */
+    aztec_registerContract: {
+        params: {
+            instance: ContractInstanceWithAddress;
+            artifact?: ContractArtifact;
+        };
+        result: boolean;
+    };
+    /**
+     * Registers a contract class in the user's PXE.
+     * @param params - The contract artifact to register
+     * @returns True if registration was successful
+     */
+    aztec_registerContractClass: {
+        params: {
+            artifact: ContractArtifact;
+        };
+        result: boolean;
+    };
+    aztec_getPublicStorageAt: {
+        params: {
+            contract: AztecAddress;
+            storageSlot: Fr;
+        };
+        result: any;
+    };
+    aztec_sendTx: {
+        params: {
+            tx: Tx;
+        };
+        result: TxHash;
+    };
+    aztec_createTxExecutionRequest: {
+        params: {
+            exec: ExecutionRequestInit;
+        };
+        result: TxExecutionRequest;
+    };
+    aztec_proveTx: {
+        params: {
+            txRequest: TxExecutionRequest;
+            privateExecutionResult: PrivateExecutionResult;
+        };
+        result: TxProvingResult;
+    };
+    aztec_getTxEffect: {
+        params: {
+            txHash: TxHash;
+        };
+        result: InBlock<TxEffect>;
+    };
+    aztec_getTxReceipt: {
+        params: {
+            txHash: TxHash;
+        };
+        result: TxReceipt;
+    };
+    aztec_simulateTx: {
+        params: {
+            txRequest: TxExecutionRequest;
+            simulatePublic: boolean;
+            msgSender?: AztecAddress;
+            skipTxValidation?: boolean;
+            enforceFeePayment?: boolean;
+            profile?: boolean;
+        };
+        result: TxSimulationResult;
+    };
+    aztec_simulateUnconstrained: {
+        params: {
+            functionName: string;
+            args: unknown[];
+            to: AztecAddress;
+            from?: AztecAddress;
+        };
+        result: AbiDecoded;
+    };
+    aztec_getIncomingNotes: {
+        params: {
+            filter: IncomingNotesFilter;
+        };
+        result: UniqueNote[];
+    };
+    aztec_addNote: {
+        params: {
+            note: ExtendedNote;
+        };
+        result: boolean;
+    };
+    aztec_addNullifiedNote: {
+        params: {
+            note: ExtendedNote;
+        };
+        result: boolean;
+    };
+    aztec_getUnencryptedLogs: {
+        params: {
+            filter: LogFilter;
+        };
+        result: GetUnencryptedLogsResponse;
+    };
+    aztec_getContractClassLogs: {
+        params: {
+            filter: LogFilter;
+        };
+        result: GetUnencryptedLogsResponse;
+    };
+    aztec_getEncryptedEvents: {
+        params: {
+            event: EventMetadataDefinition;
+            from: number;
+            limit: number;
+            vpks?: Point[];
+        };
+        result: unknown[];
+    };
+    aztec_getUnencryptedEvents: {
+        params: {
+            event: EventMetadataDefinition;
+            from: number;
+            limit: number;
+        };
+        result: unknown[];
+    };
+}
+export type AztecWalletMethodHandler<T extends AztecWalletMethodMap, M extends keyof T, C extends AztecWalletContext> = (context: C, params: T[M]['params'], accountWallet: AccountWallet) => Promise<T[M]['result']> | T[M]['result'];
+export type AztecChainId = `aztec:${string}`;
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1,8 @@
+export const BASE_WALLET_METHODS = [
+    'wm_getSupportedMethods',
+    'aztec_connect',
+    'aztec_getAccount',
+    'aztec_sendTransaction',
+    'aztec_simulateTransaction',
+];
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi9zcmMvdHlwZXMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBa0VBLE1BQU0sQ0FBQyxNQUFNLG1CQUFtQixHQUF1QztJQUNyRSx3QkFBd0I7SUFDeEIsZUFBZTtJQUNmLGtCQUFrQjtJQUNsQix1QkFBdUI7SUFDdkIsMkJBQTJCO0NBQ25CLENBQUMifQ==

package/dist/wallet.d.ts

@@ -0,0 +1,62 @@
+import type { AccountWallet, PXE } from '@aztec/aztec.js';
+import { JSONRPCNode, type JSONRPCTransport } from '@walletmesh/jsonrpc';
+import type { AztecWalletMethodMap, AztecWalletContext, AztecWalletEventMap, AztecWalletRouterClient } from './types.js';
+/**
+ * @module wallet
+ *
+ * This module provides the server-side implementation of the Aztec RPC interface.
+ * It handles incoming RPC requests from dApps and executes them using an Aztec wallet instance.
+ */
+/**
+ * JSON-RPC interface implementation for an Aztec Wallet.
+ *
+ * This class provides the core wallet functionality exposed through JSON-RPC:
+ * - Handles incoming RPC requests from dApps
+ * - Manages wallet state and context
+ * - Executes operations through the underlying Aztec wallet
+ * - Serializes responses back to JSON-RPC format
+ *
+ * The wallet supports operations like:
+ * - Account management
+ * - Transaction execution
+ * - Contract interaction
+ * - Note management
+ * - Event logging
+ *
+ * @example
+ * ```typescript
+ * // Create wallet instance
+ * const wallet = new AztecChainWallet(aztecWallet, transport);
+ *
+ * // Handle incoming RPC requests
+ * transport.on('message', async (request) => {
+ *   const response = await wallet.handleRequest(request);
+ *   // Send response back to dApp
+ * });
+ * ```
+ *
+ * @public
+ */
+export declare class AztecChainWallet extends JSONRPCNode<AztecWalletMethodMap, AztecWalletEventMap, AztecWalletContext> {
+    /**
+     * Creates a new AztecWallet instance.
+     *
+     * @param pxe - The PXE instance for the Aztec protocol
+     * @param wallet - The underlying Aztec wallet instance that executes operations
+     * @param transport - Transport layer for sending/receiving JSON-RPC messages
+     *
+     * The wallet instance sets up:
+     * - Contract artifact caching
+     * - Default request handlers
+     * - Custom serialization for Aztec types
+     */
+    constructor(pxe: PXE, wallet: AccountWallet, transport: JSONRPCTransport);
+    /**
+     * Creates a client wrapper for use with WalletMesh router.
+     * This enables the wallet to be used as a client in a routing setup.
+     *
+     * @returns Client interface for the wallet
+     */
+    asWalletRouterClient(): AztecWalletRouterClient;
+}
+//# sourceMappingURL=wallet.d.ts.map

package/dist/wallet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet.d.ts","sourceRoot":"","sources":["../src/wallet.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAE1D,OAAO,EAAE,WAAW,EAAE,KAAK,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAGzE,OAAO,KAAK,EACV,oBAAoB,EACpB,kBAAkB,EAClB,mBAAmB,EACnB,uBAAuB,EACxB,MAAM,YAAY,CAAC;AAMpB;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AACH,qBAAa,gBAAiB,SAAQ,WAAW,CAC/C,oBAAoB,EACpB,mBAAmB,EACnB,kBAAkB,CACnB;IACC;;;;;;;;;;;OAWG;gBACS,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,gBAAgB;IAcxE;;;;;OAKG;IACH,oBAAoB,IAAI,uBAAuB;CAGhD"}

package/dist/wallet.js

@@ -0,0 +1,77 @@
+import { JSONRPCNode } from '@walletmesh/jsonrpc';
+import { JSONRPCWalletClient } from '@walletmesh/router';
+import { AztecWalletSerializer } from './serializers/index.js';
+import { ContractArtifactCache } from './contractArtifactCache.js';
+import { handler } from './handlers.js';
+/**
+ * @module wallet
+ *
+ * This module provides the server-side implementation of the Aztec RPC interface.
+ * It handles incoming RPC requests from dApps and executes them using an Aztec wallet instance.
+ */
+/**
+ * JSON-RPC interface implementation for an Aztec Wallet.
+ *
+ * This class provides the core wallet functionality exposed through JSON-RPC:
+ * - Handles incoming RPC requests from dApps
+ * - Manages wallet state and context
+ * - Executes operations through the underlying Aztec wallet
+ * - Serializes responses back to JSON-RPC format
+ *
+ * The wallet supports operations like:
+ * - Account management
+ * - Transaction execution
+ * - Contract interaction
+ * - Note management
+ * - Event logging
+ *
+ * @example
+ * ```typescript
+ * // Create wallet instance
+ * const wallet = new AztecChainWallet(aztecWallet, transport);
+ *
+ * // Handle incoming RPC requests
+ * transport.on('message', async (request) => {
+ *   const response = await wallet.handleRequest(request);
+ *   // Send response back to dApp
+ * });
+ * ```
+ *
+ * @public
+ */
+export class AztecChainWallet extends JSONRPCNode {
+    /**
+     * Creates a new AztecWallet instance.
+     *
+     * @param pxe - The PXE instance for the Aztec protocol
+     * @param wallet - The underlying Aztec wallet instance that executes operations
+     * @param transport - Transport layer for sending/receiving JSON-RPC messages
+     *
+     * The wallet instance sets up:
+     * - Contract artifact caching
+     * - Default request handlers
+     * - Custom serialization for Aztec types
+     */
+    constructor(pxe, wallet, transport) {
+        const context = {
+            pxe,
+            wallet,
+            contractArtifactCache: new ContractArtifactCache(wallet),
+        };
+        super(transport, context);
+        this.setFallbackHandler(async (handlerContext, method, params) => {
+            return await handler(handlerContext, method, params);
+        });
+        this.setFallbackSerializer(AztecWalletSerializer);
+    }
+    /**
+     * Creates a client wrapper for use with WalletMesh router.
+     * This enables the wallet to be used as a client in a routing setup.
+     *
+     * @returns Client interface for the wallet
+     */
+    asWalletRouterClient() {
+        return new JSONRPCWalletClient(this);
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoid2FsbGV0LmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vc3JjL3dhbGxldC50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiQUFFQSxPQUFPLEVBQUUsV0FBVyxFQUF5QixNQUFNLHFCQUFxQixDQUFDO0FBQ3pFLE9BQU8sRUFBRSxtQkFBbUIsRUFBRSxNQUFNLG9CQUFvQixDQUFDO0FBUXpELE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLHdCQUF3QixDQUFDO0FBRS9ELE9BQU8sRUFBRSxxQkFBcUIsRUFBRSxNQUFNLDRCQUE0QixDQUFDO0FBQ25FLE9BQU8sRUFBRSxPQUFPLEVBQUUsTUFBTSxlQUFlLENBQUM7QUFFeEM7Ozs7O0dBS0c7QUFFSDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0E2Qkc7QUFDSCxNQUFNLE9BQU8sZ0JBQWlCLFNBQVEsV0FJckM7SUFDQzs7Ozs7Ozs7Ozs7T0FXRztJQUNILFlBQVksR0FBUSxFQUFFLE1BQXFCLEVBQUUsU0FBMkI7UUFDdEUsTUFBTSxPQUFPLEdBQXVCO1lBQ2xDLEdBQUc7WUFDSCxNQUFNO1lBQ04scUJBQXFCLEVBQUUsSUFBSSxxQkFBcUIsQ0FBQyxNQUFNLENBQUM7U0FDekQsQ0FBQztRQUNGLEtBQUssQ0FBQyxTQUFTLEVBQUUsT0FBTyxDQUFDLENBQUM7UUFFMUIsSUFBSSxDQUFDLGtCQUFrQixDQUFDLEtBQUssRUFBRSxjQUFrQyxFQUFFLE1BQU0sRUFBRSxNQUFNLEVBQUUsRUFBRTtZQUNuRixPQUFPLE1BQU0sT0FBTyxDQUFDLGNBQWMsRUFBRSxNQUFNLEVBQUUsTUFBTSxDQUFDLENBQUM7UUFDdkQsQ0FBQyxDQUFDLENBQUM7UUFDSCxJQUFJLENBQUMscUJBQXFCLENBQUMscUJBQXFCLENBQUMsQ0FBQztJQUNwRCxDQUFDO0lBRUQ7Ozs7O09BS0c7SUFDSCxvQkFBb0I7UUFDbEIsT0FBTyxJQUFJLG1CQUFtQixDQUFDLElBQUksQ0FBQyxDQUFDO0lBQ3ZDLENBQUM7Q0FDRiJ9

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@walletmesh/aztec-rpc-wallet",
+  "version": "0.1.0",
+  "description": "",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/WalletMesh/aztec.git"
+  },
+  "homepage": "https://github.com/WalletMesh/aztec/tree/main/packages/aztec-rpc-wallet#readme",
+  "keywords": [],
+  "author": "",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "typedoc": "^0.27.2",
+    "typedoc-plugin-markdown": "^4.3.1"
+  },
+  "dependencies": {
+    "@aztec/aztec.js": "0.68.2",
+    "@aztec/circuit-types": "0.68.2",
+    "@aztec/circuits.js": "^0.68.2",
+    "@aztec/foundation": "0.68.2",
+    "@walletmesh/jsonrpc": "0.2.2",
+    "@walletmesh/router": "0.2.7"
+  },
+  "scripts": {
+    "build": "tsc --build tsconfig.build.json",
+    "clean": "rimraf dist node_modules",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "coverage": "vitest run --coverage",
+    "lint": "biome lint",
+    "lint:fix": "biome lint --fix",
+    "format": "biome format",
+    "format:fix": "biome format --fix",
+    "doc": "typedoc",
+    "version": "pnpm clean && pnpm build && pnpm doc && git add docs/"
+  }
+}