@aztec/aztec.js 0.0.1-commit.c7c42ec → 0.0.1-commit.cf93bcc56

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 (197) hide show
  1. package/dest/account/account.d.ts +25 -40
  2. package/dest/account/account.d.ts.map +1 -1
  3. package/dest/account/account.js +19 -47
  4. package/dest/account/account_contract.d.ts +8 -9
  5. package/dest/account/account_contract.d.ts.map +1 -1
  6. package/dest/account/account_with_secret_key.d.ts +19 -7
  7. package/dest/account/account_with_secret_key.d.ts.map +1 -1
  8. package/dest/account/account_with_secret_key.js +21 -4
  9. package/dest/account/index.d.ts +3 -2
  10. package/dest/account/index.d.ts.map +1 -1
  11. package/dest/account/index.js +2 -0
  12. package/dest/account/signerless_account.d.ts +5 -6
  13. package/dest/account/signerless_account.d.ts.map +1 -1
  14. package/dest/account/signerless_account.js +8 -11
  15. package/dest/api/account.d.ts +2 -4
  16. package/dest/api/account.d.ts.map +1 -1
  17. package/dest/api/account.js +1 -3
  18. package/dest/api/authorization.d.ts +2 -2
  19. package/dest/api/authorization.d.ts.map +1 -1
  20. package/dest/api/authorization.js +1 -1
  21. package/dest/api/contract.d.ts +18 -12
  22. package/dest/api/contract.d.ts.map +1 -1
  23. package/dest/api/contract.js +16 -10
  24. package/dest/api/deployment.d.ts +1 -2
  25. package/dest/api/deployment.d.ts.map +1 -1
  26. package/dest/api/deployment.js +0 -1
  27. package/dest/api/events.d.ts +10 -6
  28. package/dest/api/events.d.ts.map +1 -1
  29. package/dest/api/events.js +30 -20
  30. package/dest/api/fields.d.ts +2 -1
  31. package/dest/api/fields.d.ts.map +1 -1
  32. package/dest/api/fields.js +1 -0
  33. package/dest/api/keys.d.ts +1 -1
  34. package/dest/api/keys.js +1 -1
  35. package/dest/api/node.d.ts +8 -4
  36. package/dest/api/node.d.ts.map +1 -1
  37. package/dest/api/node.js +7 -3
  38. package/dest/api/protocol.d.ts +7 -1
  39. package/dest/api/protocol.d.ts.map +1 -1
  40. package/dest/api/protocol.js +6 -0
  41. package/dest/api/tx.d.ts +2 -2
  42. package/dest/api/tx.d.ts.map +1 -1
  43. package/dest/api/tx.js +1 -1
  44. package/dest/api/wallet.d.ts +3 -2
  45. package/dest/api/wallet.d.ts.map +1 -1
  46. package/dest/api/wallet.js +2 -1
  47. package/dest/authorization/call_authorization_request.d.ts +22 -1
  48. package/dest/authorization/call_authorization_request.d.ts.map +1 -1
  49. package/dest/contract/base_contract_interaction.d.ts +8 -10
  50. package/dest/contract/base_contract_interaction.d.ts.map +1 -1
  51. package/dest/contract/base_contract_interaction.js +5 -17
  52. package/dest/contract/batch_call.d.ts +1 -1
  53. package/dest/contract/batch_call.d.ts.map +1 -1
  54. package/dest/contract/batch_call.js +7 -2
  55. package/dest/contract/contract_base.d.ts +4 -1
  56. package/dest/contract/contract_base.d.ts.map +1 -1
  57. package/dest/contract/contract_function_interaction.d.ts +3 -12
  58. package/dest/contract/contract_function_interaction.d.ts.map +1 -1
  59. package/dest/contract/contract_function_interaction.js +10 -7
  60. package/dest/contract/deploy_method.d.ts +63 -16
  61. package/dest/contract/deploy_method.d.ts.map +1 -1
  62. package/dest/contract/deploy_method.js +41 -23
  63. package/dest/contract/interaction_options.d.ts +42 -5
  64. package/dest/contract/interaction_options.d.ts.map +1 -1
  65. package/dest/contract/interaction_options.js +8 -1
  66. package/dest/contract/protocol_contracts/auth-registry.d.ts +27 -0
  67. package/dest/contract/protocol_contracts/auth-registry.d.ts.map +1 -0
  68. package/dest/contract/protocol_contracts/auth-registry.js +558 -0
  69. package/dest/contract/protocol_contracts/contract-class-registry.d.ts +15 -0
  70. package/dest/contract/protocol_contracts/contract-class-registry.d.ts.map +1 -0
  71. package/dest/contract/protocol_contracts/contract-class-registry.js +139 -0
  72. package/dest/contract/protocol_contracts/contract-instance-registry.d.ts +22 -0
  73. package/dest/contract/protocol_contracts/contract-instance-registry.d.ts.map +1 -0
  74. package/dest/contract/protocol_contracts/contract-instance-registry.js +465 -0
  75. package/dest/contract/protocol_contracts/fee-juice.d.ts +21 -0
  76. package/dest/contract/protocol_contracts/fee-juice.d.ts.map +1 -0
  77. package/dest/contract/protocol_contracts/fee-juice.js +426 -0
  78. package/dest/contract/protocol_contracts/multi-call-entrypoint.d.ts +34 -0
  79. package/dest/contract/protocol_contracts/multi-call-entrypoint.d.ts.map +1 -0
  80. package/dest/contract/protocol_contracts/multi-call-entrypoint.js +585 -0
  81. package/dest/contract/protocol_contracts/public-checks.d.ts +26 -0
  82. package/dest/contract/protocol_contracts/public-checks.d.ts.map +1 -0
  83. package/dest/contract/protocol_contracts/public-checks.js +593 -0
  84. package/dest/contract/wait_for_proven.d.ts +2 -2
  85. package/dest/contract/wait_for_proven.d.ts.map +1 -1
  86. package/dest/contract/wait_for_proven.js +1 -1
  87. package/dest/contract/wait_opts.d.ts +16 -0
  88. package/dest/contract/wait_opts.d.ts.map +1 -0
  89. package/dest/contract/wait_opts.js +5 -0
  90. package/dest/deployment/publish_class.js +2 -2
  91. package/dest/deployment/publish_instance.d.ts +2 -2
  92. package/dest/deployment/publish_instance.d.ts.map +1 -1
  93. package/dest/deployment/publish_instance.js +3 -3
  94. package/dest/ethereum/portal_manager.d.ts +6 -3
  95. package/dest/ethereum/portal_manager.d.ts.map +1 -1
  96. package/dest/ethereum/portal_manager.js +10 -10
  97. package/dest/fee/fee_juice_payment_method_with_claim.js +6 -6
  98. package/dest/fee/private_fee_payment_method.js +10 -10
  99. package/dest/fee/public_fee_payment_method.js +10 -10
  100. package/dest/fee/sponsored_fee_payment.js +3 -3
  101. package/dest/scripts/generate_protocol_contract_types.d.ts +2 -0
  102. package/dest/scripts/generate_protocol_contract_types.d.ts.map +1 -0
  103. package/dest/scripts/generate_protocol_contract_types.js +120 -0
  104. package/dest/utils/authwit.d.ts +8 -6
  105. package/dest/utils/authwit.d.ts.map +1 -1
  106. package/dest/utils/authwit.js +5 -9
  107. package/dest/utils/node.d.ts +12 -1
  108. package/dest/utils/node.d.ts.map +1 -1
  109. package/dest/utils/node.js +46 -0
  110. package/dest/wallet/account_entrypoint_meta_payment_method.d.ts +5 -8
  111. package/dest/wallet/account_entrypoint_meta_payment_method.d.ts.map +1 -1
  112. package/dest/wallet/account_entrypoint_meta_payment_method.js +28 -43
  113. package/dest/wallet/account_manager.d.ts +5 -8
  114. package/dest/wallet/account_manager.d.ts.map +1 -1
  115. package/dest/wallet/account_manager.js +5 -11
  116. package/dest/wallet/capabilities.d.ts +444 -0
  117. package/dest/wallet/capabilities.d.ts.map +1 -0
  118. package/dest/wallet/capabilities.js +3 -0
  119. package/dest/wallet/deploy_account_method.d.ts +34 -6
  120. package/dest/wallet/deploy_account_method.d.ts.map +1 -1
  121. package/dest/wallet/deploy_account_method.js +7 -5
  122. package/dest/wallet/index.d.ts +2 -1
  123. package/dest/wallet/index.d.ts.map +1 -1
  124. package/dest/wallet/index.js +1 -0
  125. package/dest/wallet/wallet.d.ts +1602 -2496
  126. package/dest/wallet/wallet.d.ts.map +1 -1
  127. package/dest/wallet/wallet.js +203 -106
  128. package/package.json +24 -13
  129. package/src/account/account.ts +34 -58
  130. package/src/account/account_contract.ts +6 -7
  131. package/src/account/account_with_secret_key.ts +33 -8
  132. package/src/account/index.ts +2 -1
  133. package/src/account/signerless_account.ts +13 -12
  134. package/src/api/account.ts +9 -3
  135. package/src/api/authorization.ts +1 -0
  136. package/src/api/contract.ts +24 -9
  137. package/src/api/deployment.ts +0 -1
  138. package/src/api/events.ts +35 -27
  139. package/src/api/fields.ts +1 -0
  140. package/src/api/keys.ts +2 -2
  141. package/src/api/node.ts +7 -3
  142. package/src/api/protocol.ts +7 -0
  143. package/src/api/tx.ts +2 -0
  144. package/src/api/wallet.ts +48 -3
  145. package/src/contract/base_contract_interaction.ts +27 -15
  146. package/src/contract/batch_call.ts +4 -2
  147. package/src/contract/contract_function_interaction.ts +17 -7
  148. package/src/contract/deploy_method.ts +122 -29
  149. package/src/contract/interaction_options.ts +49 -4
  150. package/src/contract/protocol_contracts/auth-registry.ts +351 -0
  151. package/src/contract/protocol_contracts/contract-class-registry.ts +99 -0
  152. package/src/contract/protocol_contracts/contract-instance-registry.ts +302 -0
  153. package/src/contract/protocol_contracts/fee-juice.ts +264 -0
  154. package/src/contract/protocol_contracts/multi-call-entrypoint.ts +332 -0
  155. package/src/contract/protocol_contracts/public-checks.ts +316 -0
  156. package/src/contract/wait_for_proven.ts +1 -1
  157. package/src/contract/wait_opts.ts +21 -0
  158. package/src/deployment/publish_class.ts +2 -2
  159. package/src/deployment/publish_instance.ts +3 -6
  160. package/src/ethereum/portal_manager.ts +9 -8
  161. package/src/fee/fee_juice_payment_method_with_claim.ts +5 -5
  162. package/src/fee/private_fee_payment_method.ts +7 -7
  163. package/src/fee/public_fee_payment_method.ts +8 -8
  164. package/src/fee/sponsored_fee_payment.ts +3 -3
  165. package/src/scripts/generate_protocol_contract_types.ts +150 -0
  166. package/src/utils/authwit.ts +19 -7
  167. package/src/utils/node.ts +62 -0
  168. package/src/wallet/account_entrypoint_meta_payment_method.ts +28 -60
  169. package/src/wallet/account_manager.ts +5 -13
  170. package/src/wallet/capabilities.ts +491 -0
  171. package/src/wallet/deploy_account_method.ts +37 -13
  172. package/src/wallet/index.ts +1 -0
  173. package/src/wallet/wallet.ts +338 -127
  174. package/dest/account/interface.d.ts +0 -19
  175. package/dest/account/interface.d.ts.map +0 -1
  176. package/dest/account/interface.js +0 -5
  177. package/dest/contract/deploy_sent_tx.d.ts +0 -48
  178. package/dest/contract/deploy_sent_tx.d.ts.map +0 -1
  179. package/dest/contract/deploy_sent_tx.js +0 -46
  180. package/dest/contract/protocol_contracts.d.ts +0 -9
  181. package/dest/contract/protocol_contracts.d.ts.map +0 -1
  182. package/dest/contract/protocol_contracts.js +0 -26
  183. package/dest/contract/sent_tx.d.ts +0 -50
  184. package/dest/contract/sent_tx.d.ts.map +0 -1
  185. package/dest/contract/sent_tx.js +0 -90
  186. package/dest/contract/unsafe_contract.d.ts +0 -15
  187. package/dest/contract/unsafe_contract.d.ts.map +0 -1
  188. package/dest/contract/unsafe_contract.js +0 -6
  189. package/dest/deployment/broadcast_function.d.ts +0 -24
  190. package/dest/deployment/broadcast_function.d.ts.map +0 -1
  191. package/dest/deployment/broadcast_function.js +0 -74
  192. package/src/account/interface.ts +0 -25
  193. package/src/contract/deploy_sent_tx.ts +0 -75
  194. package/src/contract/protocol_contracts.ts +0 -35
  195. package/src/contract/sent_tx.ts +0 -129
  196. package/src/contract/unsafe_contract.ts +0 -19
  197. package/src/deployment/broadcast_function.ts +0 -148
@@ -7,20 +7,14 @@ import {
7
7
  type ContractArtifact,
8
8
  ContractArtifactSchema,
9
9
  type EventMetadataDefinition,
10
- type FunctionCall,
11
- FunctionType,
10
+ FunctionCall,
12
11
  } from '@aztec/stdlib/abi';
13
12
  import { AuthWitness } from '@aztec/stdlib/auth-witness';
14
13
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
15
- import {
16
- type ContractClassMetadata,
17
- ContractClassWithIdSchema,
18
- type ContractInstanceWithAddress,
19
- ContractInstanceWithAddressSchema,
20
- type ContractMetadata,
21
- } from '@aztec/stdlib/contract';
14
+ import { type ContractInstanceWithAddress, ContractInstanceWithAddressSchema } from '@aztec/stdlib/contract';
22
15
  import { Gas } from '@aztec/stdlib/gas';
23
16
  import { AbiDecodedSchema, type ApiSchemaFor, optional, schemas, zodFor } from '@aztec/stdlib/schemas';
17
+ import type { ExecutionPayload, InTx } from '@aztec/stdlib/tx';
24
18
  import {
25
19
  Capsule,
26
20
  HashedValues,
@@ -31,18 +25,21 @@ import {
31
25
  UtilitySimulationResult,
32
26
  inTxSchema,
33
27
  } from '@aztec/stdlib/tx';
34
- import type { ExecutionPayload, InTx } from '@aztec/stdlib/tx';
35
28
 
36
29
  import { z } from 'zod';
37
30
 
38
- import type {
39
- FeeEstimationOptions,
40
- GasSettingsOption,
41
- ProfileInteractionOptions,
42
- SendInteractionOptions,
43
- SimulateInteractionOptions,
31
+ import {
32
+ type FeeEstimationOptions,
33
+ type GasSettingsOption,
34
+ type InteractionWaitOptions,
35
+ NO_WAIT,
36
+ type ProfileInteractionOptions,
37
+ type SendInteractionOptionsWithoutWait,
38
+ type SendReturn,
39
+ type SimulateInteractionOptions,
44
40
  } from '../contract/interaction_options.js';
45
41
  import type { CallIntent, IntentInnerHash } from '../utils/authwit.js';
42
+ import type { AppCapabilities, WalletCapabilities } from './capabilities.js';
46
43
 
47
44
  /**
48
45
  * A wrapper type that allows any item to be associated with an alias.
@@ -60,7 +57,7 @@ export type Aliased<T> = {
60
57
 
61
58
  /**
62
59
  * Options for simulating interactions with the wallet. Overrides the fee settings of an interaction with
63
- * a simplified version that only hints at the wallet wether the interaction contains a
60
+ * a simplified version that only hints at the wallet whether the interaction contains a
64
61
  * fee payment method or not
65
62
  */
66
63
  export type SimulateOptions = Omit<SimulateInteractionOptions, 'fee'> & {
@@ -70,7 +67,7 @@ export type SimulateOptions = Omit<SimulateInteractionOptions, 'fee'> & {
70
67
 
71
68
  /**
72
69
  * Options for profiling interactions with the wallet. Overrides the fee settings of an interaction with
73
- * a simplified version that only hints at the wallet wether the interaction contains a
70
+ * a simplified version that only hints at the wallet whether the interaction contains a
74
71
  * fee payment method or not
75
72
  */
76
73
  export type ProfileOptions = Omit<ProfileInteractionOptions, 'fee'> & {
@@ -80,45 +77,54 @@ export type ProfileOptions = Omit<ProfileInteractionOptions, 'fee'> & {
80
77
 
81
78
  /**
82
79
  * Options for sending/proving interactions with the wallet. Overrides the fee settings of an interaction with
83
- * a simplified version that only hints at the wallet wether the interaction contains a
80
+ * a simplified version that only hints at the wallet whether the interaction contains a
84
81
  * fee payment method or not
85
82
  */
86
- export type SendOptions = Omit<SendInteractionOptions, 'fee'> & {
83
+ export type SendOptions<W extends InteractionWaitOptions = undefined> = Omit<
84
+ SendInteractionOptionsWithoutWait,
85
+ 'fee'
86
+ > & {
87
87
  /** The fee options */
88
88
  fee?: GasSettingsOption;
89
+ /** Whether to wait for the transaction to be mined */
90
+ wait?: W;
89
91
  };
90
92
 
91
93
  /**
92
- * Helper type that represents all methods that can be batched.
94
+ * Helper type that represents all methods that can be batched (all methods except batch itself).
93
95
  */
94
- export type BatchableMethods = Pick<
95
- Wallet,
96
- 'registerContract' | 'sendTx' | 'registerSender' | 'simulateUtility' | 'simulateTx'
97
- >;
96
+ export type BatchableMethods = Omit<Wallet, 'batch'>;
98
97
 
99
98
  /**
100
- * From the batchable methods, we create a type that represents a method call with its name and arguments.
101
- * This is what the wallet will accept as arguments to the `batch` method.
99
+ * A method call with its name and arguments.
102
100
  */
103
- export type BatchedMethod<T extends keyof BatchableMethods> = {
101
+ type BatchedMethodInternal<T extends keyof BatchableMethods> = {
104
102
  /** The method name */
105
103
  name: T;
106
104
  /** The method arguments */
107
105
  args: Parameters<BatchableMethods[T]>;
108
106
  };
109
107
 
108
+ /**
109
+ * Union of all possible batched method calls.
110
+ * This ensures type safety: the `args` must match the specific `name`.
111
+ */
112
+ export type BatchedMethod = {
113
+ [K in keyof BatchableMethods]: BatchedMethodInternal<K>;
114
+ }[keyof BatchableMethods];
115
+
110
116
  /**
111
117
  * Helper type to extract the return type of a batched method
112
118
  */
113
119
  export type BatchedMethodResult<T> =
114
- T extends BatchedMethod<infer K> ? Awaited<ReturnType<BatchableMethods[K]>> : never;
120
+ T extends BatchedMethodInternal<infer K> ? Awaited<ReturnType<BatchableMethods[K]>> : never;
115
121
 
116
122
  /**
117
123
  * Wrapper type for batch results that includes the method name for discriminated union deserialization.
118
124
  * Each result is wrapped as \{ name: 'methodName', result: ActualResult \} to allow proper deserialization
119
125
  * when AztecAddress and TxHash would otherwise be ambiguous (both are hex strings).
120
126
  */
121
- export type BatchedMethodResultWrapper<T extends BatchedMethod<keyof BatchableMethods>> = {
127
+ export type BatchedMethodResultWrapper<T extends BatchedMethod> = {
122
128
  /** The method name */
123
129
  name: T['name'];
124
130
  /** The method result */
@@ -128,54 +134,118 @@ export type BatchedMethodResultWrapper<T extends BatchedMethod<keyof BatchableMe
128
134
  /**
129
135
  * Maps a tuple of BatchedMethod to a tuple of their wrapped return types
130
136
  */
131
- export type BatchResults<T extends readonly BatchedMethod<keyof BatchableMethods>[]> = {
137
+ export type BatchResults<T extends readonly BatchedMethod[]> = {
132
138
  [K in keyof T]: BatchedMethodResultWrapper<T[K]>;
133
139
  };
134
140
 
135
141
  /**
136
- * Filter options when querying private events.
142
+ * Base filter options for event queries.
137
143
  */
138
- export type PrivateEventFilter = {
139
- /** The address of the contract that emitted the events. */
140
- contractAddress: AztecAddress;
141
- /** Addresses of accounts that are in scope for this filter. */
142
- scopes: AztecAddress[];
144
+ export type EventFilterBase = {
143
145
  /** Transaction in which the events were emitted. */
144
146
  txHash?: TxHash;
145
147
  /** The block number from which to start fetching events (inclusive).
146
148
  * Optional. If provided, it must be greater or equal than 1.
147
149
  * Defaults to the initial L2 block number (INITIAL_L2_BLOCK_NUM).
148
- * */
150
+ */
149
151
  fromBlock?: BlockNumber;
150
152
  /** The block number until which to fetch logs (not inclusive).
151
153
  * Optional. If provided, it must be greater than fromBlock.
152
- * Defaults to the latest known block to PXE + 1.
153
154
  */
154
155
  toBlock?: BlockNumber;
155
156
  };
156
157
 
157
158
  /**
158
- * An ABI decoded private event with associated metadata.
159
+ * Filter options when querying private events.
159
160
  */
160
- export type PrivateEvent<T> = {
161
+ export type PrivateEventFilter = EventFilterBase & {
162
+ /** The address of the contract that emitted the events. */
163
+ contractAddress: AztecAddress;
164
+ /** Addresses of accounts that are in scope for this filter. */
165
+ scopes: AztecAddress[];
166
+ };
167
+
168
+ /**
169
+ * Filter options when querying public events.
170
+ */
171
+ export type PublicEventFilter = EventFilterBase & {
172
+ /** The address of the contract that emitted the events. */
173
+ contractAddress?: AztecAddress;
174
+ };
175
+
176
+ /**
177
+ * An ABI decoded event with associated metadata.
178
+ * @typeParam T - The decoded event type
179
+ * @typeParam M - Additional metadata fields (empty by default)
180
+ */
181
+ export type Event<T, M extends object = object> = {
161
182
  /** The ABI decoded event */
162
183
  event: T;
163
184
  /** Metadata describing event context information such as tx and block */
164
- metadata: InTx;
185
+ metadata: InTx & M;
186
+ };
187
+
188
+ /** An ABI decoded private event with associated metadata. */
189
+ export type PrivateEvent<T> = Event<T>;
190
+
191
+ /** An ABI decoded public event with associated metadata (includes contract address). */
192
+ export type PublicEvent<T> = Event<
193
+ T,
194
+ {
195
+ /**
196
+ * Address of the contract that emitted this event
197
+ */
198
+ contractAddress: AztecAddress;
199
+ }
200
+ >;
201
+
202
+ /**
203
+ * Contract metadata including deployment and registration status.
204
+ */
205
+ export type ContractMetadata = {
206
+ /** The contract instance */
207
+ instance?: ContractInstanceWithAddress;
208
+ /** Whether the contract has been initialized (init nullifier exists) */
209
+ isContractInitialized: boolean;
210
+ /** Whether the contract instance is publicly deployed on-chain */
211
+ isContractPublished: boolean;
212
+ /** Whether the contract has been updated to a different class */
213
+ isContractUpdated: boolean;
214
+ /** The updated contract class ID if the contract has been updated */
215
+ updatedContractClassId?: Fr | undefined;
216
+ };
217
+
218
+ /**
219
+ * Contract class metadata.
220
+ */
221
+ export type ContractClassMetadata = {
222
+ /** Whether the artifact is registered in the wallet */
223
+ isArtifactRegistered: boolean;
224
+ /** Whether the contract class is publicly registered on-chain */
225
+ isContractClassPubliclyRegistered: boolean;
226
+ };
227
+
228
+ /**
229
+ * Options for simulating a utility function call.
230
+ */
231
+ export type SimulateUtilityOptions = {
232
+ /** The scope for the utility simulation (determines which notes and keys are visible). */
233
+ scope: AztecAddress;
234
+ /** Optional auth witnesses to use during execution. */
235
+ authWitnesses?: AuthWitness[];
165
236
  };
166
237
 
167
238
  /**
168
239
  * The wallet interface.
169
240
  */
170
241
  export type Wallet = {
171
- getContractClassMetadata(id: Fr, includeArtifact?: boolean): Promise<ContractClassMetadata>;
172
- getContractMetadata(address: AztecAddress): Promise<ContractMetadata>;
173
242
  getPrivateEvents<T>(
174
243
  eventMetadata: EventMetadataDefinition,
175
244
  eventFilter: PrivateEventFilter,
176
245
  ): Promise<PrivateEvent<T>[]>;
177
246
  getChainInfo(): Promise<ChainInfo>;
178
- getTxReceipt(txHash: TxHash): Promise<TxReceipt>;
247
+ getContractMetadata(address: AztecAddress): Promise<ContractMetadata>;
248
+ getContractClassMetadata(id: Fr): Promise<ContractClassMetadata>;
179
249
  registerSender(address: AztecAddress, alias?: string): Promise<AztecAddress>;
180
250
  getAddressBook(): Promise<Aliased<AztecAddress>[]>;
181
251
  getAccounts(): Promise<Aliased<AztecAddress>[]>;
@@ -185,26 +255,19 @@ export type Wallet = {
185
255
  secretKey?: Fr,
186
256
  ): Promise<ContractInstanceWithAddress>;
187
257
  simulateTx(exec: ExecutionPayload, opts: SimulateOptions): Promise<TxSimulationResult>;
188
- simulateUtility(call: FunctionCall, authwits?: AuthWitness[]): Promise<UtilitySimulationResult>;
258
+ simulateUtility(call: FunctionCall, opts: SimulateUtilityOptions): Promise<UtilitySimulationResult>;
189
259
  profileTx(exec: ExecutionPayload, opts: ProfileOptions): Promise<TxProfileResult>;
190
- sendTx(exec: ExecutionPayload, opts: SendOptions): Promise<TxHash>;
191
- createAuthWit(from: AztecAddress, messageHashOrIntent: Fr | IntentInnerHash | CallIntent): Promise<AuthWitness>;
192
- batch<const T extends readonly BatchedMethod<keyof BatchableMethods>[]>(methods: T): Promise<BatchResults<T>>;
260
+ sendTx<W extends InteractionWaitOptions = undefined>(
261
+ exec: ExecutionPayload,
262
+ opts: SendOptions<W>,
263
+ ): Promise<SendReturn<W>>;
264
+ createAuthWit(from: AztecAddress, messageHashOrIntent: IntentInnerHash | CallIntent): Promise<AuthWitness>;
265
+ requestCapabilities(manifest: AppCapabilities): Promise<WalletCapabilities>;
266
+ batch<const T extends readonly BatchedMethod[]>(methods: T): Promise<BatchResults<T>>;
193
267
  };
194
268
 
195
- export const FunctionCallSchema = z.object({
196
- name: z.string(),
197
- to: schemas.AztecAddress,
198
- selector: schemas.FunctionSelector,
199
- type: z.nativeEnum(FunctionType),
200
- isStatic: z.boolean(),
201
- hideMsgSender: z.boolean(),
202
- args: z.array(schemas.Fr),
203
- returnTypes: z.array(AbiTypeSchema),
204
- });
205
-
206
269
  export const ExecutionPayloadSchema = z.object({
207
- calls: z.array(FunctionCallSchema),
270
+ calls: z.array(FunctionCall.schema),
208
271
  authWitnesses: z.array(AuthWitness.schema),
209
272
  capsules: z.array(Capsule.schema),
210
273
  extraHashedArgs: z.array(HashedValues.schema),
@@ -227,11 +290,19 @@ export const WalletSimulationFeeOptionSchema = GasSettingsOptionSchema.extend({
227
290
  estimateGas: optional(z.boolean()),
228
291
  });
229
292
 
293
+ export const WaitOptsSchema = z.object({
294
+ ignoreDroppedReceiptsFor: optional(z.number()),
295
+ timeout: optional(z.number()),
296
+ interval: optional(z.number()),
297
+ dontThrowOnRevert: optional(z.boolean()),
298
+ });
299
+
230
300
  export const SendOptionsSchema = z.object({
231
301
  from: schemas.AztecAddress,
232
302
  authWitnesses: optional(z.array(AuthWitness.schema)),
233
303
  capsules: optional(z.array(Capsule.schema)),
234
304
  fee: optional(GasSettingsOptionSchema),
305
+ wait: optional(z.union([z.literal(NO_WAIT), WaitOptsSchema])),
235
306
  });
236
307
 
237
308
  export const SimulateOptionsSchema = z.object({
@@ -250,59 +321,34 @@ export const ProfileOptionsSchema = SimulateOptionsSchema.extend({
250
321
  });
251
322
 
252
323
  export const MessageHashOrIntentSchema = z.union([
253
- schemas.Fr,
254
324
  z.object({ consumer: schemas.AztecAddress, innerHash: schemas.Fr }),
255
325
  z.object({
256
326
  caller: schemas.AztecAddress,
257
- call: FunctionCallSchema,
327
+ call: FunctionCall.schema,
258
328
  }),
259
329
  ]);
260
330
 
261
- export const BatchedMethodSchema = z.union([
262
- z.object({
263
- name: z.literal('registerSender'),
264
- args: z.tuple([schemas.AztecAddress, optional(z.string())]),
265
- }),
266
- z.object({
267
- name: z.literal('registerContract'),
268
- args: z.tuple([ContractInstanceWithAddressSchema, optional(ContractArtifactSchema), optional(schemas.Fr)]),
269
- }),
270
- z.object({
271
- name: z.literal('sendTx'),
272
- args: z.tuple([ExecutionPayloadSchema, SendOptionsSchema]),
273
- }),
274
- z.object({
275
- name: z.literal('simulateUtility'),
276
- args: z.tuple([FunctionCallSchema, optional(z.array(AuthWitness.schema))]),
277
- }),
278
- z.object({
279
- name: z.literal('simulateTx'),
280
- args: z.tuple([ExecutionPayloadSchema, SimulateOptionsSchema]),
281
- }),
282
- ]);
283
-
284
- export const ContractMetadataSchema = zodFor<ContractMetadata>()(
285
- z.object({
286
- contractInstance: z.union([ContractInstanceWithAddressSchema, z.undefined()]),
287
- isContractInitialized: z.boolean(),
288
- isContractPublished: z.boolean(),
289
- }),
290
- );
291
-
292
- export const ContractClassMetadataSchema = zodFor<ContractClassMetadata>()(
293
- z.object({
294
- contractClass: z.union([ContractClassWithIdSchema, z.undefined()]),
295
- isContractClassPubliclyRegistered: z.boolean(),
296
- artifact: z.union([ContractArtifactSchema, z.undefined()]),
297
- }),
298
- );
299
-
300
331
  export const EventMetadataDefinitionSchema = z.object({
301
332
  eventSelector: schemas.EventSelector,
302
333
  abiType: AbiTypeSchema,
303
334
  fieldNames: z.array(z.string()),
304
335
  });
305
336
 
337
+ const EventFilterBaseSchema = z.object({
338
+ txHash: optional(TxHash.schema),
339
+ fromBlock: optional(BlockNumberPositiveSchema),
340
+ toBlock: optional(BlockNumberPositiveSchema),
341
+ });
342
+
343
+ export const PrivateEventFilterSchema = EventFilterBaseSchema.extend({
344
+ contractAddress: schemas.AztecAddress,
345
+ scopes: z.array(schemas.AztecAddress),
346
+ });
347
+
348
+ export const PublicEventFilterSchema = EventFilterBaseSchema.extend({
349
+ contractAddress: optional(schemas.AztecAddress),
350
+ });
351
+
306
352
  export const PrivateEventSchema: z.ZodType<any> = zodFor<PrivateEvent<AbiDecoded>>()(
307
353
  z.object({
308
354
  event: AbiDecodedSchema,
@@ -310,22 +356,150 @@ export const PrivateEventSchema: z.ZodType<any> = zodFor<PrivateEvent<AbiDecoded
310
356
  }),
311
357
  );
312
358
 
313
- export const PrivateEventFilterSchema = z.object({
314
- contractAddress: schemas.AztecAddress,
315
- scopes: z.array(schemas.AztecAddress),
316
- txHash: optional(TxHash.schema),
317
- fromBlock: optional(BlockNumberPositiveSchema),
318
- toBlock: optional(BlockNumberPositiveSchema),
359
+ export const PublicEventSchema = zodFor<PublicEvent<AbiDecoded>>()(
360
+ z.object({
361
+ event: AbiDecodedSchema,
362
+ metadata: z.intersection(inTxSchema(), z.object({ contractAddress: schemas.AztecAddress })),
363
+ }),
364
+ );
365
+
366
+ export const ContractMetadataSchema = z.object({
367
+ instance: optional(ContractInstanceWithAddressSchema),
368
+ isContractInitialized: z.boolean(),
369
+ isContractPublished: z.boolean(),
370
+ isContractUpdated: z.boolean(),
371
+ updatedContractClassId: optional(schemas.Fr),
319
372
  });
320
373
 
321
- export const WalletSchema: ApiSchemaFor<Wallet> = {
374
+ export const ContractClassMetadataSchema = z.object({
375
+ isArtifactRegistered: z.boolean(),
376
+ isContractClassPubliclyRegistered: z.boolean(),
377
+ });
378
+
379
+ export const ContractFunctionPatternSchema = z.object({
380
+ contract: z.union([schemas.AztecAddress, z.literal('*')]),
381
+ function: z.union([z.string(), z.literal('*')]),
382
+ });
383
+
384
+ export const AccountsCapabilitySchema = z.object({
385
+ type: z.literal('accounts'),
386
+ canGet: optional(z.boolean()),
387
+ canCreateAuthWit: optional(z.boolean()),
388
+ });
389
+
390
+ export const GrantedAccountsCapabilitySchema = AccountsCapabilitySchema.extend({
391
+ accounts: z.array(z.object({ alias: z.string(), item: schemas.AztecAddress })),
392
+ });
393
+
394
+ export const ContractsCapabilitySchema = z.object({
395
+ type: z.literal('contracts'),
396
+ contracts: z.union([z.literal('*'), z.array(schemas.AztecAddress)]),
397
+ canRegister: optional(z.boolean()),
398
+ canGetMetadata: optional(z.boolean()),
399
+ });
400
+
401
+ export const GrantedContractsCapabilitySchema = ContractsCapabilitySchema;
402
+
403
+ export const ContractClassesCapabilitySchema = z.object({
404
+ type: z.literal('contractClasses'),
405
+ classes: z.union([z.literal('*'), z.array(schemas.Fr)]),
406
+ canGetMetadata: z.boolean(),
407
+ });
408
+
409
+ export const GrantedContractClassesCapabilitySchema = ContractClassesCapabilitySchema;
410
+
411
+ export const SimulationCapabilitySchema = z.object({
412
+ type: z.literal('simulation'),
413
+ transactions: optional(
414
+ z.object({
415
+ scope: z.union([z.literal('*'), z.array(ContractFunctionPatternSchema)]),
416
+ }),
417
+ ),
418
+ utilities: optional(
419
+ z.object({
420
+ scope: z.union([z.literal('*'), z.array(ContractFunctionPatternSchema)]),
421
+ }),
422
+ ),
423
+ });
424
+
425
+ export const GrantedSimulationCapabilitySchema = SimulationCapabilitySchema;
426
+
427
+ export const TransactionCapabilitySchema = z.object({
428
+ type: z.literal('transaction'),
429
+ scope: z.union([z.literal('*'), z.array(ContractFunctionPatternSchema)]),
430
+ });
431
+
432
+ export const GrantedTransactionCapabilitySchema = TransactionCapabilitySchema;
433
+
434
+ export const DataCapabilitySchema = z.object({
435
+ type: z.literal('data'),
436
+ addressBook: optional(z.boolean()),
437
+ privateEvents: optional(
438
+ z.object({
439
+ contracts: z.union([z.literal('*'), z.array(schemas.AztecAddress)]),
440
+ }),
441
+ ),
442
+ });
443
+
444
+ export const GrantedDataCapabilitySchema = DataCapabilitySchema;
445
+
446
+ export const CapabilitySchema = z.discriminatedUnion('type', [
447
+ AccountsCapabilitySchema,
448
+ ContractsCapabilitySchema,
449
+ ContractClassesCapabilitySchema,
450
+ SimulationCapabilitySchema,
451
+ TransactionCapabilitySchema,
452
+ DataCapabilitySchema,
453
+ ]);
454
+
455
+ export const GrantedCapabilitySchema = z.discriminatedUnion('type', [
456
+ GrantedAccountsCapabilitySchema,
457
+ GrantedContractsCapabilitySchema,
458
+ GrantedContractClassesCapabilitySchema,
459
+ GrantedSimulationCapabilitySchema,
460
+ GrantedTransactionCapabilitySchema,
461
+ GrantedDataCapabilitySchema,
462
+ ]);
463
+
464
+ export const AppCapabilitiesSchema = z.object({
465
+ version: z.literal('1.0'),
466
+ metadata: z.object({
467
+ name: z.string(),
468
+ version: z.string(),
469
+ description: optional(z.string()),
470
+ url: optional(z.string()),
471
+ icon: optional(z.string()),
472
+ }),
473
+ capabilities: z.array(CapabilitySchema),
474
+ behavior: optional(
475
+ z.object({
476
+ mode: optional(z.enum(['strict', 'permissive'])),
477
+ expiration: optional(z.number()),
478
+ }),
479
+ ),
480
+ });
481
+
482
+ export const WalletCapabilitiesSchema = z.object({
483
+ version: z.literal('1.0'),
484
+ granted: z.array(GrantedCapabilitySchema),
485
+ wallet: z.object({
486
+ name: z.string(),
487
+ version: z.string(),
488
+ }),
489
+ expiresAt: optional(z.number()),
490
+ });
491
+
492
+ /**
493
+ * Record of all wallet method schemas (excluding batch).
494
+ * This is the single source of truth for method schemas - batch schemas are derived from this.
495
+ */
496
+ const WalletMethodSchemas = {
322
497
  getChainInfo: z
323
498
  .function()
324
499
  .args()
325
500
  .returns(z.object({ chainId: schemas.Fr, version: schemas.Fr })),
326
- getContractClassMetadata: z.function().args(schemas.Fr, optional(z.boolean())).returns(ContractClassMetadataSchema),
327
501
  getContractMetadata: z.function().args(schemas.AztecAddress).returns(ContractMetadataSchema),
328
- getTxReceipt: z.function().args(TxHash.schema).returns(TxReceipt.schema),
502
+ getContractClassMetadata: z.function().args(schemas.Fr).returns(ContractClassMetadataSchema),
329
503
  getPrivateEvents: z
330
504
  .function()
331
505
  .args(EventMetadataDefinitionSchema, PrivateEventFilterSchema)
@@ -346,24 +520,61 @@ export const WalletSchema: ApiSchemaFor<Wallet> = {
346
520
  simulateTx: z.function().args(ExecutionPayloadSchema, SimulateOptionsSchema).returns(TxSimulationResult.schema),
347
521
  simulateUtility: z
348
522
  .function()
349
- .args(FunctionCallSchema, optional(z.array(AuthWitness.schema)))
523
+ .args(
524
+ FunctionCall.schema,
525
+ z.object({
526
+ scope: schemas.AztecAddress,
527
+ authWitnesses: optional(z.array(AuthWitness.schema)),
528
+ }),
529
+ )
350
530
  .returns(UtilitySimulationResult.schema),
351
531
  profileTx: z.function().args(ExecutionPayloadSchema, ProfileOptionsSchema).returns(TxProfileResult.schema),
352
- sendTx: z.function().args(ExecutionPayloadSchema, SendOptionsSchema).returns(TxHash.schema),
532
+ sendTx: z
533
+ .function()
534
+ .args(ExecutionPayloadSchema, SendOptionsSchema)
535
+ .returns(z.union([TxHash.schema, TxReceipt.schema])),
353
536
  createAuthWit: z.function().args(schemas.AztecAddress, MessageHashOrIntentSchema).returns(AuthWitness.schema),
537
+ requestCapabilities: z.function().args(AppCapabilitiesSchema).returns(WalletCapabilitiesSchema),
538
+ };
539
+
540
+ /**
541
+ * Creates batch schemas from the individual wallet methods.
542
+ * This allows us to define them once and derive batch schemas automatically,
543
+ * reducing duplication and ensuring consistency.
544
+ */
545
+ function createBatchSchemas<T extends Record<string, z.ZodFunction<z.ZodTuple<any, any>, z.ZodTypeAny>>>(
546
+ methodSchemas: T,
547
+ ) {
548
+ const names = Object.keys(methodSchemas) as (keyof T)[];
549
+
550
+ const namesAndArgs = names.map(name =>
551
+ z.object({
552
+ name: z.literal(name),
553
+ args: methodSchemas[name].parameters(),
554
+ }),
555
+ );
556
+
557
+ const namesAndReturns = names.map(name =>
558
+ z.object({
559
+ name: z.literal(name),
560
+ result: methodSchemas[name].returnType(),
561
+ }),
562
+ );
563
+
564
+ // Type assertion needed because discriminatedUnion expects a tuple type [T, T, ...T[]]
565
+ // but we're building the array dynamically. The runtime behavior is correct.
566
+ return {
567
+ input: z.discriminatedUnion('name', namesAndArgs as [(typeof namesAndArgs)[0], ...typeof namesAndArgs]),
568
+ output: z.discriminatedUnion('name', namesAndReturns as [(typeof namesAndReturns)[0], ...typeof namesAndReturns]),
569
+ };
570
+ }
571
+
572
+ const { input: BatchedMethodSchema, output: BatchedResultSchema } = createBatchSchemas(WalletMethodSchemas);
573
+
574
+ export { BatchedMethodSchema, BatchedResultSchema };
575
+
576
+ export const WalletSchema: ApiSchemaFor<Wallet> = {
577
+ ...WalletMethodSchemas,
354
578
  // @ts-expect-error - ApiSchemaFor cannot properly type generic methods with readonly arrays
355
- batch: z
356
- .function()
357
- .args(z.array(BatchedMethodSchema))
358
- .returns(
359
- z.array(
360
- z.discriminatedUnion('name', [
361
- z.object({ name: z.literal('registerSender'), result: schemas.AztecAddress }),
362
- z.object({ name: z.literal('registerContract'), result: ContractInstanceWithAddressSchema }),
363
- z.object({ name: z.literal('sendTx'), result: TxHash.schema }),
364
- z.object({ name: z.literal('simulateUtility'), result: UtilitySimulationResult.schema }),
365
- z.object({ name: z.literal('simulateTx'), result: TxSimulationResult.schema }),
366
- ]),
367
- ),
368
- ),
579
+ batch: z.function().args(z.array(BatchedMethodSchema)).returns(z.array(BatchedResultSchema)),
369
580
  };
@@ -1,19 +0,0 @@
1
- import type { AuthWitnessProvider, EntrypointInterface } from '@aztec/entrypoints/interfaces';
2
- import type { Fr } from '@aztec/foundation/curves/bn254';
3
- import type { AztecAddress } from '@aztec/stdlib/aztec-address';
4
- import type { CompleteAddress } from '@aztec/stdlib/contract';
5
- /**
6
- * Handler for interfacing with an account. Knows how to create transaction execution
7
- * requests and authorize actions for its corresponding account.
8
- */
9
- export interface AccountInterface extends EntrypointInterface, AuthWitnessProvider {
10
- /** Returns the complete address for this account. */
11
- getCompleteAddress(): CompleteAddress;
12
- /** Returns the address for this account. */
13
- getAddress(): AztecAddress;
14
- /** Returns the chain id for this account */
15
- getChainId(): Fr;
16
- /** Returns the rollup version for this account */
17
- getVersion(): Fr;
18
- }
19
- //# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW50ZXJmYWNlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvYWNjb3VudC9pbnRlcmZhY2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsbUJBQW1CLEVBQUUsbUJBQW1CLEVBQUUsTUFBTSwrQkFBK0IsQ0FBQztBQUM5RixPQUFPLEtBQUssRUFBRSxFQUFFLEVBQUUsTUFBTSxnQ0FBZ0MsQ0FBQztBQUN6RCxPQUFPLEtBQUssRUFBRSxZQUFZLEVBQUUsTUFBTSw2QkFBNkIsQ0FBQztBQUNoRSxPQUFPLEtBQUssRUFBRSxlQUFlLEVBQUUsTUFBTSx3QkFBd0IsQ0FBQztBQUk5RDs7O0dBR0c7QUFDSCxNQUFNLFdBQVcsZ0JBQWlCLFNBQVEsbUJBQW1CLEVBQUUsbUJBQW1CO0lBQ2hGLHFEQUFxRDtJQUNyRCxrQkFBa0IsSUFBSSxlQUFlLENBQUM7SUFFdEMsNENBQTRDO0lBQzVDLFVBQVUsSUFBSSxZQUFZLENBQUM7SUFFM0IsNENBQTRDO0lBQzVDLFVBQVUsSUFBSSxFQUFFLENBQUM7SUFFakIsa0RBQWtEO0lBQ2xELFVBQVUsSUFBSSxFQUFFLENBQUM7Q0FDbEIifQ==
@@ -1 +0,0 @@
1
- {"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/account/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,+BAA+B,CAAC;AAC9F,OAAO,KAAK,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACzD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAI9D;;;GAGG;AACH,MAAM,WAAW,gBAAiB,SAAQ,mBAAmB,EAAE,mBAAmB;IAChF,qDAAqD;IACrD,kBAAkB,IAAI,eAAe,CAAC;IAEtC,4CAA4C;IAC5C,UAAU,IAAI,YAAY,CAAC;IAE3B,4CAA4C;IAC5C,UAAU,IAAI,EAAE,CAAC;IAEjB,kDAAkD;IAClD,UAAU,IAAI,EAAE,CAAC;CAClB"}
@@ -1,5 +0,0 @@
1
- // docs:start:account-interface
2
- /**
3
- * Handler for interfacing with an account. Knows how to create transaction execution
4
- * requests and authorize actions for its corresponding account.
5
- */ export { }; // docs:end:account-interface