@aztec/wallet-sdk 0.0.1-commit.fcb71a6 → 0.0.1-commit.fffb133c

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (73) hide show
  1. package/README.md +229 -332
  2. package/dest/base-wallet/base_wallet.d.ts +21 -11
  3. package/dest/base-wallet/base_wallet.d.ts.map +1 -1
  4. package/dest/base-wallet/base_wallet.js +45 -19
  5. package/dest/crypto.d.ts +192 -0
  6. package/dest/crypto.d.ts.map +1 -0
  7. package/dest/crypto.js +394 -0
  8. package/dest/emoji_alphabet.d.ts +35 -0
  9. package/dest/emoji_alphabet.d.ts.map +1 -0
  10. package/dest/emoji_alphabet.js +299 -0
  11. package/dest/extension/handlers/background_connection_handler.d.ts +158 -0
  12. package/dest/extension/handlers/background_connection_handler.d.ts.map +1 -0
  13. package/dest/extension/handlers/background_connection_handler.js +258 -0
  14. package/dest/extension/handlers/content_script_connection_handler.d.ts +56 -0
  15. package/dest/extension/handlers/content_script_connection_handler.d.ts.map +1 -0
  16. package/dest/extension/handlers/content_script_connection_handler.js +174 -0
  17. package/dest/extension/handlers/index.d.ts +12 -0
  18. package/dest/extension/handlers/index.d.ts.map +1 -0
  19. package/dest/extension/handlers/index.js +10 -0
  20. package/dest/extension/handlers/internal_message_types.d.ts +63 -0
  21. package/dest/extension/handlers/internal_message_types.d.ts.map +1 -0
  22. package/dest/extension/handlers/internal_message_types.js +22 -0
  23. package/dest/extension/provider/extension_provider.d.ts +107 -0
  24. package/dest/extension/provider/extension_provider.d.ts.map +1 -0
  25. package/dest/extension/provider/extension_provider.js +160 -0
  26. package/dest/extension/provider/extension_wallet.d.ts +131 -0
  27. package/dest/extension/provider/extension_wallet.d.ts.map +1 -0
  28. package/dest/extension/provider/extension_wallet.js +271 -0
  29. package/dest/extension/provider/index.d.ts +3 -0
  30. package/dest/extension/provider/index.d.ts.map +1 -0
  31. package/dest/manager/index.d.ts +2 -7
  32. package/dest/manager/index.d.ts.map +1 -1
  33. package/dest/manager/index.js +0 -4
  34. package/dest/manager/types.d.ts +108 -5
  35. package/dest/manager/types.d.ts.map +1 -1
  36. package/dest/manager/types.js +17 -1
  37. package/dest/manager/wallet_manager.d.ts +50 -7
  38. package/dest/manager/wallet_manager.d.ts.map +1 -1
  39. package/dest/manager/wallet_manager.js +178 -29
  40. package/dest/types.d.ts +123 -0
  41. package/dest/types.d.ts.map +1 -0
  42. package/dest/types.js +11 -0
  43. package/package.json +13 -10
  44. package/src/base-wallet/base_wallet.ts +65 -30
  45. package/src/crypto.ts +499 -0
  46. package/src/emoji_alphabet.ts +317 -0
  47. package/src/extension/handlers/background_connection_handler.ts +423 -0
  48. package/src/extension/handlers/content_script_connection_handler.ts +246 -0
  49. package/src/extension/handlers/index.ts +25 -0
  50. package/src/extension/handlers/internal_message_types.ts +69 -0
  51. package/src/extension/provider/extension_provider.ts +233 -0
  52. package/src/extension/provider/extension_wallet.ts +321 -0
  53. package/src/extension/provider/index.ts +7 -0
  54. package/src/manager/index.ts +3 -15
  55. package/src/manager/types.ts +112 -4
  56. package/src/manager/wallet_manager.ts +204 -31
  57. package/src/types.ts +132 -0
  58. package/dest/providers/extension/extension_provider.d.ts +0 -17
  59. package/dest/providers/extension/extension_provider.d.ts.map +0 -1
  60. package/dest/providers/extension/extension_provider.js +0 -56
  61. package/dest/providers/extension/extension_wallet.d.ts +0 -23
  62. package/dest/providers/extension/extension_wallet.d.ts.map +0 -1
  63. package/dest/providers/extension/extension_wallet.js +0 -96
  64. package/dest/providers/extension/index.d.ts +0 -4
  65. package/dest/providers/extension/index.d.ts.map +0 -1
  66. package/dest/providers/types.d.ts +0 -67
  67. package/dest/providers/types.d.ts.map +0 -1
  68. package/dest/providers/types.js +0 -3
  69. package/src/providers/extension/extension_provider.ts +0 -72
  70. package/src/providers/extension/extension_wallet.ts +0 -124
  71. package/src/providers/extension/index.ts +0 -3
  72. package/src/providers/types.ts +0 -71
  73. /package/dest/{providers/extension → extension/provider}/index.js +0 -0
@@ -0,0 +1 @@
1
+ {"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AAEzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD;;;GAGG;AACH,oBAAY,iBAAiB;IAC3B,kDAAkD;IAClD,SAAS,2BAA2B;IACpC,uCAAuC;IACvC,kBAAkB,oCAAoC;IACtD,sEAAsE;IACtE,UAAU,4BAA4B;IACtC,oDAAoD;IACpD,oBAAoB,sCAAsC;IAC1D,qDAAqD;IACrD,qBAAqB,uCAAuC;CAC7D;AAED;;;GAGG;AACH,MAAM,WAAW,UAAU;IACzB,uCAAuC;IACvC,EAAE,EAAE,MAAM,CAAC;IACX,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,MAAM,WAAW,mBAAoB,SAAQ,UAAU;IACrD,gEAAgE;IAChE,SAAS,EAAE,iBAAiB,CAAC;IAC7B;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;IAClB,gCAAgC;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,wBAAwB;IACxB,SAAS,EAAE,SAAS,CAAC;IACrB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,4CAA4C;IAC5C,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,kCAAkC;IAClC,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,6BAA6B;IAC7B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,uCAAuC;IACvC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,iCAAiC;IACjC,IAAI,EAAE,iBAAiB,CAAC,SAAS,CAAC;IAClC,iBAAiB;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,wCAAwC;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,iEAAiE;IACjE,SAAS,EAAE,SAAS,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,0CAA0C;IAC1C,IAAI,EAAE,iBAAiB,CAAC,kBAAkB,CAAC;IAC3C,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,UAAU,EAAE,UAAU,CAAC;CACxB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,mBAAmB;IACnB,IAAI,EAAE,iBAAiB,CAAC,oBAAoB,CAAC;IAC7C,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,wDAAwD;IACxD,SAAS,EAAE,iBAAiB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,mBAAmB;IACnB,IAAI,EAAE,iBAAiB,CAAC,qBAAqB,CAAC;IAC9C,gDAAgD;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,SAAS,EAAE,iBAAiB,CAAC;CAC9B"}
package/dest/types.js ADDED
@@ -0,0 +1,11 @@
1
+ /**
2
+ * Message types for wallet SDK communication.
3
+ * All types are prefixed with 'aztec-wallet-' for namespacing.
4
+ */ export var WalletMessageType = /*#__PURE__*/ function(WalletMessageType) {
5
+ /** Discovery request to find installed wallets */ WalletMessageType["DISCOVERY"] = "aztec-wallet-discovery";
6
+ /** Discovery response from a wallet */ WalletMessageType["DISCOVERY_RESPONSE"] = "aztec-wallet-discovery-response";
7
+ /** Disconnect message (unencrypted control message, bidirectional) */ WalletMessageType["DISCONNECT"] = "aztec-wallet-disconnect";
8
+ /** Key exchange request sent over MessageChannel */ WalletMessageType["KEY_EXCHANGE_REQUEST"] = "aztec-wallet-key-exchange-request";
9
+ /** Key exchange response sent over MessageChannel */ WalletMessageType["KEY_EXCHANGE_RESPONSE"] = "aztec-wallet-key-exchange-response";
10
+ return WalletMessageType;
11
+ }({});
package/package.json CHANGED
@@ -1,11 +1,14 @@
1
1
  {
2
2
  "name": "@aztec/wallet-sdk",
3
3
  "homepage": "https://github.com/AztecProtocol/aztec-packages/tree/master/yarn-project/wallet-sdk",
4
- "version": "0.0.1-commit.fcb71a6",
4
+ "version": "0.0.1-commit.fffb133c",
5
5
  "type": "module",
6
6
  "exports": {
7
7
  "./base-wallet": "./dest/base-wallet/index.js",
8
- "./providers/extension": "./dest/providers/extension/index.js",
8
+ "./extension/handlers": "./dest/extension/handlers/index.js",
9
+ "./extension/provider": "./dest/extension/provider/index.js",
10
+ "./crypto": "./dest/crypto.js",
11
+ "./types": "./dest/types.js",
9
12
  "./manager": "./dest/manager/index.js"
10
13
  },
11
14
  "typedocOptions": {
@@ -62,19 +65,19 @@
62
65
  ]
63
66
  },
64
67
  "dependencies": {
65
- "@aztec/aztec.js": "0.0.1-commit.fcb71a6",
66
- "@aztec/constants": "0.0.1-commit.fcb71a6",
67
- "@aztec/entrypoints": "0.0.1-commit.fcb71a6",
68
- "@aztec/foundation": "0.0.1-commit.fcb71a6",
69
- "@aztec/pxe": "0.0.1-commit.fcb71a6",
70
- "@aztec/stdlib": "0.0.1-commit.fcb71a6"
68
+ "@aztec/aztec.js": "0.0.1-commit.fffb133c",
69
+ "@aztec/constants": "0.0.1-commit.fffb133c",
70
+ "@aztec/entrypoints": "0.0.1-commit.fffb133c",
71
+ "@aztec/foundation": "0.0.1-commit.fffb133c",
72
+ "@aztec/pxe": "0.0.1-commit.fffb133c",
73
+ "@aztec/stdlib": "0.0.1-commit.fffb133c"
71
74
  },
72
75
  "devDependencies": {
73
- "@aztec/noir-contracts.js": "0.0.1-commit.fcb71a6",
76
+ "@aztec/noir-contracts.js": "0.0.1-commit.fffb133c",
74
77
  "@jest/globals": "^30.0.0",
75
78
  "@types/jest": "^30.0.0",
76
79
  "@types/node": "^22.15.17",
77
- "@typescript/native-preview": "7.0.0-dev.20251126.1",
80
+ "@typescript/native-preview": "7.0.0-dev.20260113.1",
78
81
  "jest": "^30.0.0",
79
82
  "jest-mock-extended": "^4.0.0",
80
83
  "resolve-typescript-plugin": "^2.0.1",
@@ -1,10 +1,11 @@
1
1
  import type { Account } from '@aztec/aztec.js/account';
2
2
  import type { CallIntent, IntentInnerHash } from '@aztec/aztec.js/authorization';
3
+ import { type InteractionWaitOptions, NO_WAIT, type SendReturn } from '@aztec/aztec.js/contracts';
3
4
  import type { FeePaymentMethod } from '@aztec/aztec.js/fee';
5
+ import { waitForTx } from '@aztec/aztec.js/node';
4
6
  import type {
5
7
  Aliased,
6
8
  BatchResults,
7
- BatchableMethods,
8
9
  BatchedMethod,
9
10
  PrivateEvent,
10
11
  PrivateEventFilter,
@@ -34,20 +35,17 @@ import {
34
35
  import type { AuthWitness } from '@aztec/stdlib/auth-witness';
35
36
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
36
37
  import {
37
- type ContractClassMetadata,
38
38
  type ContractInstanceWithAddress,
39
- type ContractMetadata,
40
39
  computePartialAddress,
41
40
  getContractClassFromArtifact,
42
41
  } from '@aztec/stdlib/contract';
43
42
  import { SimulationError } from '@aztec/stdlib/errors';
44
43
  import { Gas, GasSettings } from '@aztec/stdlib/gas';
44
+ import { siloNullifier } from '@aztec/stdlib/hash';
45
45
  import type { AztecNode } from '@aztec/stdlib/interfaces/client';
46
46
  import type {
47
47
  TxExecutionRequest,
48
- TxHash,
49
48
  TxProfileResult,
50
- TxReceipt,
51
49
  TxSimulationResult,
52
50
  UtilitySimulationResult,
53
51
  } from '@aztec/stdlib/tx';
@@ -76,7 +74,7 @@ export type FeeOptions = {
76
74
  export abstract class BaseWallet implements Wallet {
77
75
  protected log = createLogger('wallet-sdk:base_wallet');
78
76
 
79
- protected baseFeePadding = 0.5;
77
+ protected minFeePadding = 0.5;
80
78
  protected cancellableTransactions = false;
81
79
 
82
80
  // Protected because we want to force wallets to instantiate their own PXE.
@@ -121,20 +119,25 @@ export abstract class BaseWallet implements Wallet {
121
119
  ? mergeExecutionPayloads([feeExecutionPayload, executionPayload])
122
120
  : executionPayload;
123
121
  const fromAccount = await this.getAccountFromAddress(from);
124
- return fromAccount.createTxExecutionRequest(finalExecutionPayload, feeOptions.gasSettings, executionOptions);
122
+ const chainInfo = await this.getChainInfo();
123
+ return fromAccount.createTxExecutionRequest(
124
+ finalExecutionPayload,
125
+ feeOptions.gasSettings,
126
+ chainInfo,
127
+ executionOptions,
128
+ );
125
129
  }
126
130
 
127
131
  public async createAuthWit(
128
132
  from: AztecAddress,
129
- messageHashOrIntent: Fr | IntentInnerHash | CallIntent,
133
+ messageHashOrIntent: IntentInnerHash | CallIntent,
130
134
  ): Promise<AuthWitness> {
131
135
  const account = await this.getAccountFromAddress(from);
132
- return account.createAuthWit(messageHashOrIntent);
136
+ const chainInfo = await this.getChainInfo();
137
+ return account.createAuthWit(messageHashOrIntent, chainInfo);
133
138
  }
134
139
 
135
- public async batch<const T extends readonly BatchedMethod<keyof BatchableMethods>[]>(
136
- methods: T,
137
- ): Promise<BatchResults<T>> {
140
+ public async batch<const T extends readonly BatchedMethod[]>(methods: T): Promise<BatchResults<T>> {
138
141
  const results: any[] = [];
139
142
  for (const method of methods) {
140
143
  const { name, args } = method;
@@ -165,7 +168,7 @@ export abstract class BaseWallet implements Wallet {
165
168
  gasSettings?: Partial<FieldsOf<GasSettings>>,
166
169
  ): Promise<FeeOptions> {
167
170
  const maxFeesPerGas =
168
- gasSettings?.maxFeesPerGas ?? (await this.aztecNode.getCurrentBaseFees()).mul(1 + this.baseFeePadding);
171
+ gasSettings?.maxFeesPerGas ?? (await this.aztecNode.getCurrentMinFees()).mul(1 + this.minFeePadding);
169
172
  let accountFeePaymentMethodOptions;
170
173
  // The transaction does not include a fee payment method, so we set the flag
171
174
  // for the account to use its fee juice balance
@@ -227,7 +230,7 @@ export abstract class BaseWallet implements Wallet {
227
230
  artifact?: ContractArtifact,
228
231
  secretKey?: Fr,
229
232
  ): Promise<ContractInstanceWithAddress> {
230
- const { contractInstance: existingInstance } = await this.pxe.getContractMetadata(instance.address);
233
+ const existingInstance = await this.pxe.getContractInstance(instance.address);
231
234
 
232
235
  if (existingInstance) {
233
236
  // Instance already registered in the wallet
@@ -244,13 +247,12 @@ export abstract class BaseWallet implements Wallet {
244
247
  // Instance not registered yet
245
248
  if (!artifact) {
246
249
  // Try to get the artifact from the wallet's contract class storage
247
- const classMetadata = await this.pxe.getContractClassMetadata(instance.currentContractClassId, true);
248
- if (!classMetadata.artifact) {
250
+ artifact = await this.pxe.getContractArtifact(instance.currentContractClassId);
251
+ if (!artifact) {
249
252
  throw new Error(
250
253
  `Cannot register contract at ${instance.address.toString()}: artifact is required but not provided, and wallet does not have the artifact for contract class ${instance.currentContractClassId.toString()}`,
251
254
  );
252
255
  }
253
- artifact = classMetadata.artifact;
254
256
  }
255
257
  await this.pxe.registerContract({ artifact, instance });
256
258
  }
@@ -280,7 +282,10 @@ export abstract class BaseWallet implements Wallet {
280
282
  return this.pxe.profileTx(txRequest, opts.profileMode, opts.skipProofGeneration ?? true);
281
283
  }
282
284
 
283
- async sendTx(executionPayload: ExecutionPayload, opts: SendOptions): Promise<TxHash> {
285
+ public async sendTx<W extends InteractionWaitOptions = undefined>(
286
+ executionPayload: ExecutionPayload,
287
+ opts: SendOptions<W>,
288
+ ): Promise<SendReturn<W>> {
284
289
  const feeOptions = await this.completeFeeOptions(opts.from, executionPayload.feePayer, opts.fee?.gasSettings);
285
290
  const txRequest = await this.createTxExecutionRequestFromPayloadAndFee(executionPayload, opts.from, feeOptions);
286
291
  const provenTx = await this.pxe.proveTx(txRequest);
@@ -294,7 +299,15 @@ export abstract class BaseWallet implements Wallet {
294
299
  throw this.contextualizeError(err, inspect(tx));
295
300
  });
296
301
  this.log.info(`Sent transaction ${txHash}`);
297
- return txHash;
302
+
303
+ // If wait is NO_WAIT, return txHash immediately
304
+ if (opts.wait === NO_WAIT) {
305
+ return txHash as SendReturn<W>;
306
+ }
307
+
308
+ // Otherwise, wait for the full receipt (default behavior on wait: undefined)
309
+ const waitOpts = typeof opts.wait === 'object' ? opts.wait : undefined;
310
+ return (await waitForTx(this.aztecNode, txHash, waitOpts)) as SendReturn<W>;
298
311
  }
299
312
 
300
313
  protected contextualizeError(err: Error, ...context: string[]): Error {
@@ -315,17 +328,6 @@ export abstract class BaseWallet implements Wallet {
315
328
  return this.pxe.simulateUtility(call, authwits);
316
329
  }
317
330
 
318
- getContractClassMetadata(id: Fr, includeArtifact: boolean = false): Promise<ContractClassMetadata> {
319
- return this.pxe.getContractClassMetadata(id, includeArtifact);
320
- }
321
- getContractMetadata(address: AztecAddress): Promise<ContractMetadata> {
322
- return this.pxe.getContractMetadata(address);
323
- }
324
-
325
- getTxReceipt(txHash: TxHash): Promise<TxReceipt> {
326
- return this.aztecNode.getTxReceipt(txHash);
327
- }
328
-
329
331
  async getPrivateEvents<T>(
330
332
  eventDef: EventMetadataDefinition,
331
333
  eventFilter: PrivateEventFilter,
@@ -345,4 +347,37 @@ export abstract class BaseWallet implements Wallet {
345
347
 
346
348
  return decodedEvents;
347
349
  }
350
+
351
+ async getContractMetadata(address: AztecAddress) {
352
+ const instance = await this.pxe.getContractInstance(address);
353
+ const initNullifier = await siloNullifier(address, address.toField());
354
+ const publiclyRegisteredContract = await this.aztecNode.getContract(address);
355
+ const [initNullifierMembershipWitness, publiclyRegisteredContractClass] = await Promise.all([
356
+ this.aztecNode.getNullifierMembershipWitness('latest', initNullifier),
357
+ publiclyRegisteredContract
358
+ ? this.aztecNode.getContractClass(
359
+ publiclyRegisteredContract.currentContractClassId || instance?.currentContractClassId,
360
+ )
361
+ : undefined,
362
+ ]);
363
+ const isContractUpdated =
364
+ publiclyRegisteredContract &&
365
+ !publiclyRegisteredContract.currentContractClassId.equals(publiclyRegisteredContract.originalContractClassId);
366
+ return {
367
+ instance: instance ?? undefined,
368
+ isContractInitialized: !!initNullifierMembershipWitness,
369
+ isContractPublished: !!publiclyRegisteredContract,
370
+ isContractClassPubliclyRegistered: !!publiclyRegisteredContractClass,
371
+ isContractUpdated: !!isContractUpdated,
372
+ updatedContractClassId: isContractUpdated ? publiclyRegisteredContract.currentContractClassId : undefined,
373
+ };
374
+ }
375
+
376
+ async getContractClassMetadata(id: Fr) {
377
+ const publiclyRegisteredContractClass = await this.aztecNode.getContractClass(id);
378
+ return {
379
+ isArtifactRegistered: !!(await this.pxe.getContractArtifact(id)),
380
+ isContractClassPubliclyRegistered: !!publiclyRegisteredContractClass,
381
+ };
382
+ }
348
383
  }