@walletmesh/aztec-rpc-wallet 0.2.0 → 0.3.1

package/docs/type-aliases/AztecChainId.md

@@ -0,0 +1,11 @@
+[**@walletmesh/aztec-rpc-wallet v0.3.1**](../README.md)
+
+***
+
+[@walletmesh/aztec-rpc-wallet](../globals.md) / AztecChainId
+
+# Type Alias: AztecChainId
+
+> **AztecChainId**: `` `aztec:${string}` ``
+
+Defined in: [aztec/rpc-wallet/src/types.ts:296](https://github.com/WalletMesh/walletmesh-packages/blob/65bc501d5bed45d0e6d444f53e29595da551d59e/aztec/rpc-wallet/src/types.ts#L296)

package/docs/type-aliases/AztecChainWalletMiddleware.md

@@ -0,0 +1,13 @@
+[**@walletmesh/aztec-rpc-wallet v0.3.1**](../README.md)
+
+***
+
+[@walletmesh/aztec-rpc-wallet](../globals.md) / AztecChainWalletMiddleware
+
+# Type Alias: AztecChainWalletMiddleware
+
+> **AztecChainWalletMiddleware**: `JSONRPCMiddleware`\<[`AztecWalletMethodMap`](../interfaces/AztecWalletMethodMap.md), [`AztecWalletContext`](AztecWalletContext.md)\>
+
+Defined in: [aztec/rpc-wallet/src/types.ts:149](https://github.com/WalletMesh/walletmesh-packages/blob/65bc501d5bed45d0e6d444f53e29595da551d59e/aztec/rpc-wallet/src/types.ts#L149)
+
+Type for Aztec Chain Wallet middleware.

package/docs/type-aliases/AztecWalletContext.md

@@ -0,0 +1,29 @@
+[**@walletmesh/aztec-rpc-wallet v0.3.1**](../README.md)
+
+***
+
+[@walletmesh/aztec-rpc-wallet](../globals.md) / AztecWalletContext
+
+# Type Alias: AztecWalletContext
+
+> **AztecWalletContext**: `Record`\<`string`, `unknown`\> & `object`
+
+Defined in: [aztec/rpc-wallet/src/types.ts:133](https://github.com/WalletMesh/walletmesh-packages/blob/65bc501d5bed45d0e6d444f53e29595da551d59e/aztec/rpc-wallet/src/types.ts#L133)
+
+Holds the context passed through RPC middleware.
+
+## Type declaration
+
+### contractArtifactCache
+
+> **contractArtifactCache**: [`ContractArtifactCache`](../classes/ContractArtifactCache.md)
+
+### pxe
+
+> **pxe**: `PXE`
+
+The PXE instance for the wallet
+
+### wallet
+
+> **wallet**: `AccountWallet`

package/docs/type-aliases/AztecWalletMethodHandler.md

@@ -0,0 +1,37 @@
+[**@walletmesh/aztec-rpc-wallet v0.3.1**](../README.md)
+
+***
+
+[@walletmesh/aztec-rpc-wallet](../globals.md) / AztecWalletMethodHandler
+
+# Type Alias: AztecWalletMethodHandler()\<T, M, C\>
+
+> **AztecWalletMethodHandler**\<`T`, `M`, `C`\>: (`context`, `params`, `accountWallet`) => `Promise`\<`T`\[`M`\]\[`"result"`\]\> \| `T`\[`M`\]\[`"result"`\]
+
+Defined in: [aztec/rpc-wallet/src/types.ts:286](https://github.com/WalletMesh/walletmesh-packages/blob/65bc501d5bed45d0e6d444f53e29595da551d59e/aztec/rpc-wallet/src/types.ts#L286)
+
+## Type Parameters
+
+• **T** *extends* [`AztecWalletMethodMap`](../interfaces/AztecWalletMethodMap.md)
+
+• **M** *extends* keyof `T`
+
+• **C** *extends* [`AztecWalletContext`](AztecWalletContext.md)
+
+## Parameters
+
+### context
+
+`C`
+
+### params
+
+`T`\[`M`\]\[`"params"`\]
+
+### accountWallet
+
+`AccountWallet`
+
+## Returns
+
+`Promise`\<`T`\[`M`\]\[`"result"`\]\> \| `T`\[`M`\]\[`"result"`\]

package/docs/type-aliases/AztecWalletMiddleware.md

@@ -0,0 +1,13 @@
+[**@walletmesh/aztec-rpc-wallet v0.3.1**](../README.md)
+
+***
+
+[@walletmesh/aztec-rpc-wallet](../globals.md) / AztecWalletMiddleware
+
+# Type Alias: AztecWalletMiddleware
+
+> **AztecWalletMiddleware**: `JSONRPCMiddleware`\<[`AztecWalletBaseMethodMap`](../interfaces/AztecWalletBaseMethodMap.md), [`AztecWalletContext`](AztecWalletContext.md)\>
+
+Defined in: [aztec/rpc-wallet/src/types.ts:144](https://github.com/WalletMesh/walletmesh-packages/blob/65bc501d5bed45d0e6d444f53e29595da551d59e/aztec/rpc-wallet/src/types.ts#L144)
+
+Type for Aztec Router Wallet middleware.

package/docs/type-aliases/AztecWalletRouterClient.md

@@ -0,0 +1,13 @@
+[**@walletmesh/aztec-rpc-wallet v0.3.1**](../README.md)
+
+***
+
+[@walletmesh/aztec-rpc-wallet](../globals.md) / AztecWalletRouterClient
+
+# Type Alias: AztecWalletRouterClient
+
+> **AztecWalletRouterClient**: `JSONRPCWalletClient`\<[`AztecWalletMethodMap`](../interfaces/AztecWalletMethodMap.md)\>
+
+Defined in: [aztec/rpc-wallet/src/types.ts:155](https://github.com/WalletMesh/walletmesh-packages/blob/65bc501d5bed45d0e6d444f53e29595da551d59e/aztec/rpc-wallet/src/types.ts#L155)
+
+Type for Aztec wallet router client.

package/docs/type-aliases/TransactionFunctionCall.md

@@ -0,0 +1,33 @@
+[**@walletmesh/aztec-rpc-wallet v0.3.1**](../README.md)
+
+***
+
+[@walletmesh/aztec-rpc-wallet](../globals.md) / TransactionFunctionCall
+
+# Type Alias: TransactionFunctionCall
+
+> **TransactionFunctionCall**: `object`
+
+Defined in: [aztec/rpc-wallet/src/types.ts:49](https://github.com/WalletMesh/walletmesh-packages/blob/65bc501d5bed45d0e6d444f53e29595da551d59e/aztec/rpc-wallet/src/types.ts#L49)
+
+Represents a single function call to a contract.
+
+## Type declaration
+
+### args
+
+> **args**: `unknown`[]
+
+The arguments to pass to the function
+
+### contractAddress
+
+> **contractAddress**: `string`
+
+The address of the contract to interact with
+
+### functionName
+
+> **functionName**: `string`
+
+The name of the function to call

package/docs/type-aliases/TransactionParams.md

@@ -0,0 +1,27 @@
+[**@walletmesh/aztec-rpc-wallet v0.3.1**](../README.md)
+
+***
+
+[@walletmesh/aztec-rpc-wallet](../globals.md) / TransactionParams
+
+# Type Alias: TransactionParams
+
+> **TransactionParams**: `object`
+
+Defined in: [aztec/rpc-wallet/src/types.ts:62](https://github.com/WalletMesh/walletmesh-packages/blob/65bc501d5bed45d0e6d444f53e29595da551d59e/aztec/rpc-wallet/src/types.ts#L62)
+
+Parameters for sending transactions.
+
+## Type declaration
+
+### authwits?
+
+> `optional` **authwits**: `string`[]
+
+Optional array of authorization witnesses for the transaction
+
+### functionCalls
+
+> **functionCalls**: [`TransactionFunctionCall`](TransactionFunctionCall.md)[]
+
+Array of function calls to execute

package/docs/variables/AztecWalletErrorMap.md

@@ -0,0 +1,13 @@
+[**@walletmesh/aztec-rpc-wallet v0.3.1**](../README.md)
+
+***
+
+[@walletmesh/aztec-rpc-wallet](../globals.md) / AztecWalletErrorMap
+
+# Variable: AztecWalletErrorMap
+
+> `const` **AztecWalletErrorMap**: `Record`\<`AztecWalletErrorType`, \{ `code`: `number`; `message`: `string`; \}\>
+
+Defined in: [aztec/rpc-wallet/src/errors.ts:37](https://github.com/WalletMesh/walletmesh-packages/blob/65bc501d5bed45d0e6d444f53e29595da551d59e/aztec/rpc-wallet/src/errors.ts#L37)
+
+Map of error codes and messages for Aztec Wallet RPC errors.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@walletmesh/aztec-rpc-wallet",
-  "version": "0.2.0",
+  "version": "0.3.1",
   "description": "",
   "type": "module",
   "main": "dist/index.js",
@@ -21,12 +21,12 @@
     "typedoc-plugin-markdown": "^4.3.1"
   },
   "dependencies": {
-    "@aztec/aztec.js": "0.72.1",
-    "@aztec/circuit-types": "0.72.1",
-    "@aztec/circuits.js": "0.72.1",
-    "@aztec/foundation": "0.72.1",
-    "@walletmesh/jsonrpc": "0.3.0",
-    "@walletmesh/router": "0.3.0"
+    "@aztec/aztec.js": "0.76.2",
+    "@aztec/circuit-types": "0.76.2",
+    "@aztec/circuits.js": "0.76.2",
+    "@aztec/foundation": "0.76.2",
+    "@walletmesh/jsonrpc": "0.4.0",
+    "@walletmesh/router": "0.4.0"
   },
   "scripts": {
     "build": "tsc --build tsconfig.build.json",
@@ -38,7 +38,7 @@
     "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/"
+    "docs": "typedoc",
+    "version": "pnpm clean && pnpm build && pnpm run docs"
   }
 }

package/src/aztecRemoteWallet.test.ts

@@ -1,7 +1,6 @@
 import { describe, expect, it, vi, beforeEach } from 'vitest';
-import { Fr, getContractClassFromArtifact } from '@aztec/aztec.js';
+import { AztecAddress, Fr, getContractClassFromArtifact } from '@aztec/aztec.js';
 import type {
-  AztecAddress,
   TxExecutionRequest,
   ContractInstanceWithAddress,
   ContractClassWithId,
@@ -163,10 +162,12 @@ describe('AztecRemoteWallet', () => {
     });
 
     it('adds capsule', async () => {
-      const mockCapsule = [Fr.fromString('1')];
+      const mockCapsule = [await Fr.random()]
+      const contract = await AztecAddress.random();
+      const storageSlot = await Fr.random();
       mockChainBuilder.execute.mockResolvedValueOnce(true);
-      await wallet.addCapsule(mockCapsule);
-      expect(mockChainBuilder.call).toHaveBeenCalledWith('aztec_addCapsule', { capsule: mockCapsule });
+      await wallet.addCapsule(contract, storageSlot, mockCapsule);
+      expect(mockChainBuilder.call).toHaveBeenCalledWith('aztec_addCapsule', { contract, storageSlot, capsule: mockCapsule });
     });
 
     it('registers account', async () => {
@@ -202,34 +203,6 @@ describe('AztecRemoteWallet', () => {
       contractClass = await getContractClassFromArtifact(mockContract.artifact);
     });
 
-    it('gets contract instance', async () => {
-      mockChainBuilder.execute.mockResolvedValueOnce(mockContract.instance);
-
-      const result = await wallet.getContractInstance(mockContract.instance.address);
-      expect(result).toBe(mockContract.instance);
-      expect(mockChainBuilder.call).toHaveBeenCalledWith('aztec_getContractInstance', {
-        address: mockContract.instance.address,
-      });
-    });
-
-    it('gets contract class', async () => {
-      mockChainBuilder.execute.mockResolvedValueOnce(contractClass);
-
-      const result = await wallet.getContractClass(contractClass.id);
-      expect(result).toBe(contractClass);
-      expect(mockChainBuilder.call).toHaveBeenCalledWith('aztec_getContractClass', { id: contractClass.id });
-    });
-
-    it('gets contract artifact', async () => {
-      mockChainBuilder.execute.mockResolvedValueOnce(mockContract.artifact);
-
-      const result = await wallet.getContractArtifact(contractClass.id);
-      expect(result).toBe(mockContract.artifact);
-      expect(mockChainBuilder.call).toHaveBeenCalledWith('aztec_getContractArtifact', {
-        id: contractClass.id,
-      });
-    });
-
     it('registers contract', async () => {
       mockChainBuilder.execute.mockResolvedValueOnce(true);
       await wallet.registerContract({ instance: mockContract.instance, artifact: mockContract.artifact });
@@ -255,6 +228,28 @@ describe('AztecRemoteWallet', () => {
       expect(result).toBe(mockContracts);
       expect(mockChainBuilder.call).toHaveBeenCalledWith('aztec_getContracts');
     });
+
+    it('gets contract metadata', async () => {
+      const mockMetadata = { contractInstance: mockContract.instance };
+      mockChainBuilder.execute.mockResolvedValueOnce(mockMetadata);
+
+      const result = await wallet.getContractMetadata(mockContract.instance.address);
+      expect(result).toBe(mockMetadata);
+      expect(mockChainBuilder.call).toHaveBeenCalledWith('aztec_getContractMetadata', {
+        address: mockContract.instance.address,
+      });
+    });
+
+    it('gets contract class metadata', async () => {
+      const mockMetadata = { artifact: mockContract.artifact };
+      mockChainBuilder.execute.mockResolvedValueOnce(mockMetadata);
+
+      const result = await wallet.getContractClassMetadata(contractClass.id);
+      expect(result).toBe(mockMetadata);
+      expect(mockChainBuilder.call).toHaveBeenCalledWith('aztec_getContractClassMetadata', {
+        id: contractClass.id,
+      });
+    });
   });
 
   describe('auth witness operations', () => {
@@ -392,39 +387,6 @@ describe('AztecRemoteWallet', () => {
     });
   });
 
-  describe('contract verification operations', () => {
-    it('checks if contract class is publicly registered', async () => {
-      const mockId = Fr.fromString('1');
-      mockChainBuilder.execute.mockResolvedValueOnce(true);
-
-      const result = await wallet.isContractClassPubliclyRegistered(mockId);
-      expect(result).toBe(true);
-      expect(mockChainBuilder.call).toHaveBeenCalledWith('aztec_isContractClassPubliclyRegistered', {
-        id: mockId,
-      });
-    });
-
-    it('checks if contract is publicly deployed', async () => {
-      mockChainBuilder.execute.mockResolvedValueOnce(true);
-
-      const result = await wallet.isContractPubliclyDeployed(mockAddress);
-      expect(result).toBe(true);
-      expect(mockChainBuilder.call).toHaveBeenCalledWith('aztec_isContractPubliclyDeployed', {
-        address: mockAddress,
-      });
-    });
-
-    it('checks if contract is initialized', async () => {
-      mockChainBuilder.execute.mockResolvedValueOnce(true);
-
-      const result = await wallet.isContractInitialized(mockAddress);
-      expect(result).toBe(true);
-      expect(mockChainBuilder.call).toHaveBeenCalledWith('aztec_isContractInitialized', {
-        address: mockAddress,
-      });
-    });
-  });
-
   describe('PXE operations', () => {
     it('gets PXE info', async () => {
       const mockInfo = { version: '1.0.0' } as unknown as PXEInfo;

package/src/aztecRemoteWallet.ts

@@ -2,7 +2,6 @@ import type {
   AuthWitness,
   AztecAddress,
   ContractArtifact,
-  ContractClassWithId,
   ContractInstanceWithAddress,
   ExtendedNote,
   TxExecutionRequest,
@@ -34,6 +33,8 @@ import type {
   TxEffect,
   GetPublicLogsResponse,
   GetContractClassLogsResponse,
+  ContractMetadata,
+  ContractClassMetadata,
 } from '@aztec/circuit-types';
 import type { GasFees, L1_TO_L2_MSG_TREE_HEIGHT } from '@aztec/circuits.js';
 
@@ -171,31 +172,24 @@ export class AztecRemoteWallet implements Wallet {
     return scopes;
   }
 
-  async getContractInstance(address: AztecAddress): Promise<ContractInstanceWithAddress | undefined> {
+  async getContractMetadata(address: AztecAddress): Promise<ContractMetadata> {
     return this._provider
       .chain(this._providerChainId)
-      .call('aztec_getContractInstance', { address })
-      .execute() as Promise<AztecWalletMethodMap['aztec_getContractInstance']['result']>;
+      .call('aztec_getContractMetadata', { address })
+      .execute() as Promise<AztecWalletMethodMap['aztec_getContractMetadata']['result']>;
   }
 
-  async getContractClass(id: Fr): Promise<ContractClassWithId | undefined> {
+  async getContractClassMetadata(id: Fr, includeArtifact?: boolean): Promise<ContractClassMetadata> {
     return this._provider
       .chain(this._providerChainId)
-      .call('aztec_getContractClass', { id })
-      .execute() as Promise<AztecWalletMethodMap['aztec_getContractClass']['result']>;
+      .call('aztec_getContractClassMetadata', { id, includeArtifact })
+      .execute() as Promise<AztecWalletMethodMap['aztec_getContractClassMetadata']['result']>;
   }
 
-  async getContractArtifact(id: Fr): Promise<ContractArtifact | undefined> {
-    return this._provider
-      .chain(this._providerChainId)
-      .call('aztec_getContractArtifact', { id })
-      .execute() as Promise<AztecWalletMethodMap['aztec_getContractArtifact']['result']>;
-  }
-
-  async addCapsule(capsule: Fr[]): Promise<void> {
+  async addCapsule(contract: AztecAddress, storageSlot: Fr, capsule: Fr[]): Promise<void> {
     const result = (await this._provider
       .chain(this._providerChainId)
-      .call('aztec_addCapsule', { capsule })
+      .call('aztec_addCapsule', { contract, storageSlot, capsule })
       .execute()) as AztecWalletMethodMap['aztec_addCapsule']['result'];
     if (!result) throw new Error('Failed to add capsule');
   }
@@ -414,27 +408,6 @@ export class AztecRemoteWallet implements Wallet {
       .execute()) as Promise<AztecWalletMethodMap['aztec_getAuthWitness']['result']>;
   }
 
-  async isContractClassPubliclyRegistered(id: Fr): Promise<boolean> {
-    return this._provider
-      .chain(this._providerChainId)
-      .call('aztec_isContractClassPubliclyRegistered', { id })
-      .execute() as Promise<AztecWalletMethodMap['aztec_isContractClassPubliclyRegistered']['result']>;
-  }
-
-  async isContractPubliclyDeployed(address: AztecAddress): Promise<boolean> {
-    return this._provider
-      .chain(this._providerChainId)
-      .call('aztec_isContractPubliclyDeployed', { address })
-      .execute() as Promise<AztecWalletMethodMap['aztec_isContractPubliclyDeployed']['result']>;
-  }
-
-  async isContractInitialized(address: AztecAddress): Promise<boolean> {
-    return this._provider
-      .chain(this._providerChainId)
-      .call('aztec_isContractInitialized', { address })
-      .execute() as Promise<AztecWalletMethodMap['aztec_isContractInitialized']['result']>;
-  }
-
   async getPXEInfo(): Promise<PXEInfo> {
     return this._provider.chain(this._providerChainId).call('aztec_getPXEInfo').execute() as Promise<
       AztecWalletMethodMap['aztec_getPXEInfo']['result']