@aztec/end-to-end 0.0.1-commit.8afd444 → 0.0.1-commit.8f9871590

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 (109) hide show
  1. package/dest/bench/client_flows/client_flows_benchmark.d.ts +2 -2
  2. package/dest/bench/client_flows/client_flows_benchmark.d.ts.map +1 -1
  3. package/dest/bench/client_flows/client_flows_benchmark.js +3 -3
  4. package/dest/bench/client_flows/config.d.ts +2 -2
  5. package/dest/bench/client_flows/config.d.ts.map +1 -1
  6. package/dest/bench/client_flows/config.js +18 -0
  7. package/dest/e2e_blacklist_token_contract/blacklist_token_contract_test.d.ts +4 -2
  8. package/dest/e2e_blacklist_token_contract/blacklist_token_contract_test.d.ts.map +1 -1
  9. package/dest/e2e_blacklist_token_contract/blacklist_token_contract_test.js +10 -0
  10. package/dest/e2e_cross_chain_messaging/cross_chain_messaging_test.d.ts +2 -2
  11. package/dest/e2e_cross_chain_messaging/cross_chain_messaging_test.d.ts.map +1 -1
  12. package/dest/e2e_cross_chain_messaging/cross_chain_messaging_test.js +3 -2
  13. package/dest/e2e_deploy_contract/deploy_test.d.ts +2 -2
  14. package/dest/e2e_deploy_contract/deploy_test.d.ts.map +1 -1
  15. package/dest/e2e_epochs/epochs_test.d.ts +1 -1
  16. package/dest/e2e_epochs/epochs_test.d.ts.map +1 -1
  17. package/dest/e2e_epochs/epochs_test.js +9 -3
  18. package/dest/e2e_fees/fees_test.d.ts +2 -2
  19. package/dest/e2e_fees/fees_test.d.ts.map +1 -1
  20. package/dest/e2e_fees/fees_test.js +5 -5
  21. package/dest/e2e_p2p/p2p_network.d.ts +2 -2
  22. package/dest/e2e_p2p/p2p_network.d.ts.map +1 -1
  23. package/dest/e2e_p2p/shared.d.ts +2 -2
  24. package/dest/e2e_p2p/shared.d.ts.map +1 -1
  25. package/dest/e2e_p2p/shared.js +5 -1
  26. package/dest/e2e_storage_proof/fixtures/storage_proof_fetcher.d.ts +2 -0
  27. package/dest/e2e_storage_proof/fixtures/storage_proof_fetcher.d.ts.map +1 -0
  28. package/dest/e2e_storage_proof/fixtures/storage_proof_fetcher.js +184 -0
  29. package/dest/e2e_storage_proof/fixtures/storage_proof_fixture.d.ts +18 -0
  30. package/dest/e2e_storage_proof/fixtures/storage_proof_fixture.d.ts.map +1 -0
  31. package/dest/e2e_storage_proof/fixtures/storage_proof_fixture.js +120 -0
  32. package/dest/e2e_token_contract/token_contract_test.d.ts +4 -2
  33. package/dest/e2e_token_contract/token_contract_test.d.ts.map +1 -1
  34. package/dest/e2e_token_contract/token_contract_test.js +10 -0
  35. package/dest/fixtures/authwit_proxy.d.ts +15 -0
  36. package/dest/fixtures/authwit_proxy.d.ts.map +1 -0
  37. package/dest/fixtures/authwit_proxy.js +30 -0
  38. package/dest/fixtures/e2e_prover_test.d.ts +2 -2
  39. package/dest/fixtures/e2e_prover_test.d.ts.map +1 -1
  40. package/dest/fixtures/ha_setup.d.ts +1 -1
  41. package/dest/fixtures/ha_setup.d.ts.map +1 -1
  42. package/dest/fixtures/ha_setup.js +3 -1
  43. package/dest/fixtures/setup.d.ts +15 -15
  44. package/dest/fixtures/setup.d.ts.map +1 -1
  45. package/dest/fixtures/setup.js +20 -79
  46. package/dest/fixtures/setup_p2p_test.d.ts +10 -5
  47. package/dest/fixtures/setup_p2p_test.d.ts.map +1 -1
  48. package/dest/fixtures/setup_p2p_test.js +6 -3
  49. package/dest/shared/index.d.ts +2 -1
  50. package/dest/shared/index.d.ts.map +1 -1
  51. package/dest/shared/index.js +1 -0
  52. package/dest/shared/mock_state_view.d.ts +86 -0
  53. package/dest/shared/mock_state_view.d.ts.map +1 -0
  54. package/dest/shared/mock_state_view.js +186 -0
  55. package/dest/shared/submit-transactions.d.ts +2 -2
  56. package/dest/shared/submit-transactions.d.ts.map +1 -1
  57. package/dest/shared/uniswap_l1_l2.d.ts +1 -1
  58. package/dest/shared/uniswap_l1_l2.d.ts.map +1 -1
  59. package/dest/shared/uniswap_l1_l2.js +8 -6
  60. package/dest/simulators/token_simulator.d.ts +1 -1
  61. package/dest/simulators/token_simulator.d.ts.map +1 -1
  62. package/dest/simulators/token_simulator.js +2 -23
  63. package/dest/spartan/setup_test_wallets.d.ts +2 -2
  64. package/dest/spartan/setup_test_wallets.d.ts.map +1 -1
  65. package/dest/spartan/setup_test_wallets.js +3 -1
  66. package/dest/spartan/utils/bot.d.ts +1 -1
  67. package/dest/spartan/utils/bot.d.ts.map +1 -1
  68. package/dest/spartan/utils/bot.js +1 -1
  69. package/dest/test-wallet/test_wallet.d.ts +83 -0
  70. package/dest/test-wallet/test_wallet.d.ts.map +1 -0
  71. package/dest/test-wallet/test_wallet.js +214 -0
  72. package/dest/test-wallet/utils.d.ts +41 -0
  73. package/dest/test-wallet/utils.d.ts.map +1 -0
  74. package/dest/test-wallet/utils.js +71 -0
  75. package/package.json +40 -39
  76. package/src/bench/client_flows/client_flows_benchmark.ts +8 -12
  77. package/src/bench/client_flows/config.ts +9 -1
  78. package/src/bench/utils.ts +1 -1
  79. package/src/e2e_blacklist_token_contract/blacklist_token_contract_test.ts +11 -2
  80. package/src/e2e_cross_chain_messaging/cross_chain_messaging_test.ts +7 -8
  81. package/src/e2e_deploy_contract/deploy_test.ts +3 -3
  82. package/src/e2e_epochs/epochs_test.ts +13 -3
  83. package/src/e2e_fees/bridging_race.notest.ts +1 -1
  84. package/src/e2e_fees/fees_test.ts +11 -26
  85. package/src/e2e_nested_contract/nested_contract_test.ts +1 -1
  86. package/src/e2e_p2p/inactivity_slash_test.ts +4 -4
  87. package/src/e2e_p2p/p2p_network.ts +5 -5
  88. package/src/e2e_p2p/reqresp/utils.ts +4 -4
  89. package/src/e2e_p2p/shared.ts +3 -1
  90. package/src/e2e_storage_proof/fixtures/storage_proof.json +915 -0
  91. package/src/e2e_storage_proof/fixtures/storage_proof_fetcher.ts +190 -0
  92. package/src/e2e_storage_proof/fixtures/storage_proof_fixture.ts +173 -0
  93. package/src/e2e_token_contract/token_contract_test.ts +11 -2
  94. package/src/fixtures/authwit_proxy.ts +50 -0
  95. package/src/fixtures/dumps/epoch_proof_result.json +1 -1
  96. package/src/fixtures/e2e_prover_test.ts +4 -4
  97. package/src/fixtures/ha_setup.ts +3 -1
  98. package/src/fixtures/setup.ts +31 -109
  99. package/src/fixtures/setup_p2p_test.ts +16 -7
  100. package/src/guides/up_quick_start.sh +3 -3
  101. package/src/shared/index.ts +1 -0
  102. package/src/shared/mock_state_view.ts +188 -0
  103. package/src/shared/submit-transactions.ts +2 -1
  104. package/src/shared/uniswap_l1_l2.ts +9 -11
  105. package/src/simulators/token_simulator.ts +1 -29
  106. package/src/spartan/setup_test_wallets.ts +3 -1
  107. package/src/spartan/utils/bot.ts +1 -1
  108. package/src/test-wallet/test_wallet.ts +306 -0
  109. package/src/test-wallet/utils.ts +112 -0
@@ -119,39 +119,11 @@ export class TokenSimulator {
119
119
  }
120
120
 
121
121
  async checkPrivate() {
122
- // Private calls
123
- const defaultLookups = [];
124
- const nonDefaultLookups = [];
125
-
126
122
  for (const address of this.accounts) {
127
- if (this.lookupProvider.has(address.toString())) {
128
- nonDefaultLookups.push(address);
129
- } else {
130
- defaultLookups.push(address);
131
- }
132
- }
133
-
134
- const defaultCalls = defaultLookups.map(address => this.token.methods.balance_of_private(address));
135
- const results = (
136
- await Promise.all(
137
- chunk(defaultCalls, 4).map(batch =>
138
- new BatchCall(this.defaultWallet, batch).simulate({ from: this.defaultAddress }),
139
- ),
140
- )
141
- ).flat();
142
- for (let i = 0; i < defaultLookups.length; i++) {
143
- expect(results[i]).toEqual(this.balanceOfPrivate(defaultLookups[i]));
144
- }
145
-
146
- // We are just running individual calls for the non-default lookups
147
- // @todo We should also batch these
148
- for (const address of nonDefaultLookups) {
149
123
  const wallet = this.lookupProvider.get(address.toString());
150
124
  const asset = wallet ? this.token.withWallet(wallet) : this.token;
151
125
 
152
- const actualPrivateBalance = await asset.methods
153
- .balance_of_private({ address })
154
- .simulate({ from: this.defaultAddress });
126
+ const actualPrivateBalance = await asset.methods.balance_of_private(address).simulate({ from: address });
155
127
  expect(actualPrivateBalance).toEqual(this.balanceOfPrivate(address));
156
128
  }
157
129
  }
@@ -13,11 +13,13 @@ import type { Logger } from '@aztec/foundation/log';
13
13
  import { retryUntil } from '@aztec/foundation/retry';
14
14
  import { TokenContract } from '@aztec/noir-contracts.js/Token';
15
15
  import type { AztecNodeAdmin } from '@aztec/stdlib/interfaces/client';
16
- import { TestWallet, proveInteraction, registerInitialLocalNetworkAccountsInWallet } from '@aztec/test-wallet/server';
16
+ import { registerInitialLocalNetworkAccountsInWallet } from '@aztec/wallets/testing';
17
17
 
18
18
  import { getACVMConfig } from '../fixtures/get_acvm_config.js';
19
19
  import { getBBConfig } from '../fixtures/get_bb_config.js';
20
20
  import { getSponsoredFPCAddress, registerSponsoredFPC } from '../fixtures/utils.js';
21
+ import { TestWallet } from '../test-wallet/test_wallet.js';
22
+ import { proveInteraction } from '../test-wallet/utils.js';
21
23
 
22
24
  export interface TestAccounts {
23
25
  aztecNode: AztecNode;
@@ -34,7 +34,7 @@ export async function installTransferBot({
34
34
  logger: log,
35
35
  replicas = 1,
36
36
  txIntervalSeconds = 10,
37
- followChain = 'PENDING',
37
+ followChain = 'CHECKPOINTED',
38
38
  mnemonic = process.env.LABS_INFRA_MNEMONIC ?? 'test test test test test test test test test test test junk',
39
39
  mnemonicStartIndex,
40
40
  botPrivateKey = process.env.BOT_TRANSFERS_L2_PRIVATE_KEY ?? '0xcafe01',
@@ -0,0 +1,306 @@
1
+ import { EcdsaKAccountContract, EcdsaRAccountContract } from '@aztec/accounts/ecdsa';
2
+ import { SchnorrAccountContract } from '@aztec/accounts/schnorr';
3
+ import { StubAccountContractArtifact, createStubAccount } from '@aztec/accounts/stub';
4
+ import { type Account, type AccountContract, SignerlessAccount } from '@aztec/aztec.js/account';
5
+ import {
6
+ type CallIntent,
7
+ type ContractFunctionInteractionCallIntent,
8
+ type IntentInnerHash,
9
+ SetPublicAuthwitContractInteraction,
10
+ computeInnerAuthWitHashFromAction,
11
+ isContractFunctionInteractionCallIntent,
12
+ lookupValidity,
13
+ } from '@aztec/aztec.js/authorization';
14
+ import type { AztecNode } from '@aztec/aztec.js/node';
15
+ import { AccountManager, type SendOptions } from '@aztec/aztec.js/wallet';
16
+ import type { DefaultAccountEntrypointOptions } from '@aztec/entrypoints/account';
17
+ import { Fq, Fr } from '@aztec/foundation/curves/bn254';
18
+ import { GrumpkinScalar } from '@aztec/foundation/curves/grumpkin';
19
+ import type { AccessScopes, NotesFilter } from '@aztec/pxe/client/lazy';
20
+ import { type PXEConfig, getPXEConfig } from '@aztec/pxe/config';
21
+ import { PXE, type PXECreationOptions, createPXE } from '@aztec/pxe/server';
22
+ import { AuthWitness } from '@aztec/stdlib/auth-witness';
23
+ import { AztecAddress } from '@aztec/stdlib/aztec-address';
24
+ import { getContractInstanceFromInstantiationParams } from '@aztec/stdlib/contract';
25
+ import { deriveSigningKey } from '@aztec/stdlib/keys';
26
+ import type { NoteDao } from '@aztec/stdlib/note';
27
+ import type { BlockHeader, TxHash, TxReceipt, TxSimulationResult } from '@aztec/stdlib/tx';
28
+ import { ExecutionPayload, mergeExecutionPayloads } from '@aztec/stdlib/tx';
29
+ import { BaseWallet, type FeeOptions } from '@aztec/wallet-sdk/base-wallet';
30
+
31
+ import { AztecNodeProxy, ProvenTx } from './utils.js';
32
+
33
+ /**
34
+ * Data for generating an account.
35
+ */
36
+ export interface AccountData {
37
+ secret: Fr;
38
+ salt: Fr;
39
+ contract: AccountContract;
40
+ }
41
+
42
+ /**
43
+ * Wallet implementation that stores accounts in memory and provides extra debugging
44
+ * utilities
45
+ * It is intended to be used in e2e tests.
46
+ */
47
+ export class TestWallet extends BaseWallet {
48
+ constructor(
49
+ pxe: PXE,
50
+ private readonly nodeRef: AztecNodeProxy,
51
+ ) {
52
+ super(pxe, nodeRef);
53
+ }
54
+
55
+ static async create(
56
+ node: AztecNode,
57
+ overridePXEConfig?: Partial<PXEConfig>,
58
+ options: PXECreationOptions = { loggers: {} },
59
+ ): Promise<TestWallet> {
60
+ const nodeRef = new AztecNodeProxy(node);
61
+ const pxeConfig = Object.assign(getPXEConfig(), {
62
+ proverEnabled: overridePXEConfig?.proverEnabled ?? false,
63
+ ...overridePXEConfig,
64
+ });
65
+ const pxe = await createPXE(nodeRef, pxeConfig, options);
66
+ return new TestWallet(pxe, nodeRef);
67
+ }
68
+
69
+ /**
70
+ * Updates the underlying node that this wallet and its PXE communicate with.
71
+ * @param node - The new AztecNode to forward all calls to.
72
+ */
73
+ updateNode(node: AztecNode): void {
74
+ this.nodeRef.updateTargetNode(node);
75
+ }
76
+
77
+ createSchnorrAccount(secret: Fr, salt: Fr, signingKey?: Fq): Promise<AccountManager> {
78
+ signingKey = signingKey ?? deriveSigningKey(secret);
79
+ const accountData = {
80
+ secret,
81
+ salt,
82
+ contract: new SchnorrAccountContract(signingKey),
83
+ };
84
+ return this.createAccount(accountData);
85
+ }
86
+
87
+ createECDSARAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager> {
88
+ const accountData = {
89
+ secret,
90
+ salt,
91
+ contract: new EcdsaRAccountContract(signingKey),
92
+ };
93
+ return this.createAccount(accountData);
94
+ }
95
+
96
+ createECDSAKAccount(secret: Fr, salt: Fr, signingKey: Buffer): Promise<AccountManager> {
97
+ const accountData = {
98
+ secret,
99
+ salt,
100
+ contract: new EcdsaKAccountContract(signingKey),
101
+ };
102
+ return this.createAccount(accountData);
103
+ }
104
+
105
+ async getFakeAccountDataFor(address: AztecAddress) {
106
+ const originalAccount = await this.getAccountFromAddress(address);
107
+ if (originalAccount instanceof SignerlessAccount) {
108
+ throw new Error(`Cannot create fake account data for SignerlessAccount at address: ${address}`);
109
+ }
110
+ const originalAddress = (originalAccount as Account).getCompleteAddress();
111
+ const contractInstance = await this.pxe.getContractInstance(originalAddress.address);
112
+ if (!contractInstance) {
113
+ throw new Error(`No contract instance found for address: ${originalAddress.address}`);
114
+ }
115
+ const stubAccount = createStubAccount(originalAddress);
116
+ const instance = await getContractInstanceFromInstantiationParams(StubAccountContractArtifact, {
117
+ salt: Fr.random(),
118
+ });
119
+ return {
120
+ account: stubAccount,
121
+ instance,
122
+ artifact: StubAccountContractArtifact,
123
+ };
124
+ }
125
+ protected accounts: Map<string, Account> = new Map();
126
+
127
+ /**
128
+ * Toggle for running "simulated simulations" when calling simulateTx.
129
+ *
130
+ * When this flag is true, simulateViaEntrypoint constructs a request using a fake account
131
+ * (and accepts contract overrides on the input) and the PXE emulates kernel effects without
132
+ * generating kernel witnesses. When false, simulateViaEntrypoint defers to the standard
133
+ * simulation path via the real account entrypoint.
134
+ */
135
+ private simulatedSimulations = false;
136
+
137
+ enableSimulatedSimulations() {
138
+ this.simulatedSimulations = true;
139
+ }
140
+
141
+ disableSimulatedSimulations() {
142
+ this.simulatedSimulations = false;
143
+ }
144
+
145
+ setMinFeePadding(value?: number) {
146
+ this.minFeePadding = value ?? 0.5;
147
+ }
148
+
149
+ protected getAccountFromAddress(address: AztecAddress): Promise<Account> {
150
+ let account: Account | undefined;
151
+ if (address.equals(AztecAddress.ZERO)) {
152
+ account = new SignerlessAccount();
153
+ } else {
154
+ account = this.accounts.get(address?.toString() ?? '');
155
+ }
156
+
157
+ if (!account) {
158
+ throw new Error(`Account not found in wallet for address: ${address}`);
159
+ }
160
+
161
+ return Promise.resolve(account);
162
+ }
163
+
164
+ getAccounts() {
165
+ return Promise.resolve(Array.from(this.accounts.values()).map(acc => ({ alias: '', item: acc.getAddress() })));
166
+ }
167
+
168
+ async createAccount(accountData?: AccountData): Promise<AccountManager> {
169
+ const secret = accountData?.secret ?? Fr.random();
170
+ const salt = accountData?.salt ?? Fr.random();
171
+ const contract = accountData?.contract ?? new SchnorrAccountContract(GrumpkinScalar.random());
172
+
173
+ const accountManager = await AccountManager.create(this, secret, contract, salt);
174
+
175
+ const instance = accountManager.getInstance();
176
+ const artifact = await contract.getContractArtifact();
177
+
178
+ await this.registerContract(instance, artifact, secret);
179
+
180
+ this.accounts.set(accountManager.address.toString(), await accountManager.getAccount());
181
+
182
+ return accountManager;
183
+ }
184
+
185
+ lookupValidity(
186
+ onBehalfOf: AztecAddress,
187
+ intent: IntentInnerHash | CallIntent | ContractFunctionInteractionCallIntent,
188
+ witness: AuthWitness,
189
+ ): Promise<{
190
+ isValidInPrivate: boolean;
191
+ isValidInPublic: boolean;
192
+ }> {
193
+ return lookupValidity(this, onBehalfOf, intent, witness);
194
+ }
195
+
196
+ public setPublicAuthWit(
197
+ from: AztecAddress,
198
+ messageHashOrIntent: Fr | IntentInnerHash | CallIntent | ContractFunctionInteractionCallIntent,
199
+ authorized: boolean,
200
+ ): Promise<SetPublicAuthwitContractInteraction> {
201
+ return SetPublicAuthwitContractInteraction.create(this, from, messageHashOrIntent, authorized);
202
+ }
203
+
204
+ public override async createAuthWit(
205
+ from: AztecAddress,
206
+ intent: IntentInnerHash | CallIntent | ContractFunctionInteractionCallIntent,
207
+ ): Promise<AuthWitness> {
208
+ const account = await this.getAccountFromAddress(from);
209
+ const chainInfo = await this.getChainInfo();
210
+ let intentInnerHash: IntentInnerHash;
211
+ if ('caller' in intent) {
212
+ const call = isContractFunctionInteractionCallIntent(intent)
213
+ ? await intent.action.getFunctionCall()
214
+ : intent.call;
215
+ const innerHash = await computeInnerAuthWitHashFromAction(intent.caller, call);
216
+ intentInnerHash = { innerHash, consumer: call.to };
217
+ } else {
218
+ intentInnerHash = intent;
219
+ }
220
+ return account.createAuthWit(intentInnerHash, chainInfo);
221
+ }
222
+
223
+ /**
224
+ * Override simulateViaEntrypoint to use fake accounts for kernelless simulation
225
+ * when simulatedSimulations is enabled. Otherwise falls through to the real entrypoint path.
226
+ */
227
+ protected override async simulateViaEntrypoint(
228
+ executionPayload: ExecutionPayload,
229
+ from: AztecAddress,
230
+ feeOptions: FeeOptions,
231
+ scopes: AccessScopes,
232
+ skipTxValidation?: boolean,
233
+ skipFeeEnforcement?: boolean,
234
+ ): Promise<TxSimulationResult> {
235
+ if (!this.simulatedSimulations) {
236
+ return super.simulateViaEntrypoint(
237
+ executionPayload,
238
+ from,
239
+ feeOptions,
240
+ scopes,
241
+ skipTxValidation,
242
+ skipFeeEnforcement,
243
+ );
244
+ }
245
+
246
+ const feeExecutionPayload = await feeOptions.walletFeePaymentMethod?.getExecutionPayload();
247
+ const executionOptions: DefaultAccountEntrypointOptions = {
248
+ txNonce: Fr.random(),
249
+ cancellable: this.cancellableTransactions,
250
+ feePaymentMethodOptions: feeOptions.accountFeePaymentMethodOptions,
251
+ };
252
+ const finalExecutionPayload = feeExecutionPayload
253
+ ? mergeExecutionPayloads([feeExecutionPayload, executionPayload])
254
+ : executionPayload;
255
+ const { account: fromAccount, instance, artifact } = await this.getFakeAccountDataFor(from);
256
+ const chainInfo = await this.getChainInfo();
257
+ const txRequest = await fromAccount.createTxExecutionRequest(
258
+ finalExecutionPayload,
259
+ feeOptions.gasSettings,
260
+ chainInfo,
261
+ executionOptions,
262
+ );
263
+ const contractOverrides = {
264
+ [from.toString()]: { instance, artifact },
265
+ };
266
+ return this.pxe.simulateTx(txRequest, {
267
+ simulatePublic: true,
268
+ skipFeeEnforcement: true,
269
+ skipTxValidation: true,
270
+ overrides: { contracts: contractOverrides },
271
+ scopes,
272
+ });
273
+ }
274
+
275
+ async proveTx(exec: ExecutionPayload, opts: Omit<SendOptions, 'wait'>): Promise<ProvenTx> {
276
+ const fee = await this.completeFeeOptions(opts.from, exec.feePayer, opts.fee?.gasSettings);
277
+ const txRequest = await this.createTxExecutionRequestFromPayloadAndFee(exec, opts.from, fee);
278
+ const txProvingResult = await this.pxe.proveTx(txRequest, this.scopesFor(opts.from));
279
+ return new ProvenTx(
280
+ this.aztecNode,
281
+ await txProvingResult.toTx(),
282
+ txProvingResult.getOffchainEffects(),
283
+ txProvingResult.stats,
284
+ );
285
+ }
286
+
287
+ getTxReceipt(txHash: TxHash): Promise<TxReceipt> {
288
+ return this.aztecNode.getTxReceipt(txHash);
289
+ }
290
+
291
+ getNotes(filter: NotesFilter): Promise<NoteDao[]> {
292
+ return this.pxe.debug.getNotes(filter);
293
+ }
294
+
295
+ getSyncedBlockHeader(): Promise<BlockHeader> {
296
+ return this.pxe.getSyncedBlockHeader();
297
+ }
298
+
299
+ sync(): Promise<void> {
300
+ return this.pxe.debug.sync();
301
+ }
302
+
303
+ stop(): Promise<void> {
304
+ return this.pxe.stop();
305
+ }
306
+ }
@@ -0,0 +1,112 @@
1
+ import {
2
+ ContractFunctionInteraction,
3
+ DeployMethod,
4
+ type DeployOptions,
5
+ NO_WAIT,
6
+ type NoWait,
7
+ type SendInteractionOptions,
8
+ type WaitOpts,
9
+ toSendOptions,
10
+ } from '@aztec/aztec.js/contracts';
11
+ import { type AztecNode, waitForTx } from '@aztec/aztec.js/node';
12
+ import { SimulationError } from '@aztec/stdlib/errors';
13
+ import { type OffchainEffect, type ProvingStats, Tx, TxHash, type TxReceipt } from '@aztec/stdlib/tx';
14
+
15
+ import { inspect } from 'util';
16
+
17
+ import type { TestWallet } from './test_wallet.js';
18
+
19
+ export type ProvenTxSendOpts = {
20
+ wait?: NoWait | WaitOpts;
21
+ };
22
+
23
+ export type ProvenTxSendReturn<T extends NoWait | WaitOpts | undefined> = T extends NoWait ? TxHash : TxReceipt;
24
+
25
+ export class ProvenTx extends Tx {
26
+ constructor(
27
+ private node: AztecNode,
28
+ tx: Tx,
29
+ public offchainEffects: OffchainEffect[],
30
+ public stats?: ProvingStats,
31
+ ) {
32
+ super(tx.getTxHash(), tx.data, tx.chonkProof, tx.contractClassLogFields, tx.publicFunctionCalldata);
33
+ }
34
+
35
+ send(options?: Omit<ProvenTxSendOpts, 'wait'>): Promise<TxReceipt>;
36
+ send<W extends ProvenTxSendOpts['wait']>(options: ProvenTxSendOpts & { wait: W }): Promise<ProvenTxSendReturn<W>>;
37
+ async send(options?: ProvenTxSendOpts): Promise<TxHash | TxReceipt> {
38
+ const txHash = this.getTxHash();
39
+ await this.node.sendTx(this).catch(err => {
40
+ throw this.contextualizeError(err, inspect(this));
41
+ });
42
+
43
+ if (options?.wait === NO_WAIT) {
44
+ return txHash;
45
+ }
46
+
47
+ const waitOpts = typeof options?.wait === 'object' ? options.wait : undefined;
48
+ return await waitForTx(this.node, txHash, waitOpts);
49
+ }
50
+
51
+ private contextualizeError(err: Error, ...context: string[]): Error {
52
+ let contextStr = '';
53
+ if (context.length > 0) {
54
+ contextStr = `\nContext:\n${context.join('\n')}`;
55
+ }
56
+ if (err instanceof SimulationError) {
57
+ err.setAztecContext(contextStr);
58
+ }
59
+ return err;
60
+ }
61
+ }
62
+
63
+ export async function proveInteraction(
64
+ wallet: TestWallet,
65
+ interaction: ContractFunctionInteraction | DeployMethod,
66
+ options: SendInteractionOptions | DeployOptions,
67
+ ) {
68
+ let execPayload;
69
+ if (interaction instanceof DeployMethod) {
70
+ execPayload = await interaction.request(interaction.convertDeployOptionsToRequestOptions(options));
71
+ } else {
72
+ execPayload = await interaction.request(options);
73
+ }
74
+ return wallet.proveTx(execPayload, toSendOptions(options));
75
+ }
76
+
77
+ /**
78
+ * Extends AztecNode via declaration merging so instances can be used wherever AztecNode is expected.
79
+ * The actual method forwarding is handled by a Proxy in the class constructor.
80
+ */
81
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
82
+ export interface AztecNodeProxy extends AztecNode {}
83
+
84
+ /**
85
+ * Mutable wrapper around an AztecNode that forwards all calls to the current target.
86
+ * Allows swapping the underlying node at runtime via updateTargetNode, which is useful
87
+ * for tests that need to redirect a wallet from one node to another without recreating it.
88
+ */
89
+ // eslint-disable-next-line @typescript-eslint/no-unsafe-declaration-merging
90
+ export class AztecNodeProxy {
91
+ constructor(private target: AztecNode) {
92
+ return new Proxy(this, {
93
+ get: (obj, prop, receiver) => {
94
+ // Own properties and methods (updateTargetNode, target) are served directly.
95
+ if (Reflect.has(obj, prop)) {
96
+ return Reflect.get(obj, prop, receiver);
97
+ }
98
+ // Everything else is forwarded to the current target node.
99
+ const val = (obj.target as unknown as Record<string | symbol, unknown>)[prop];
100
+ return typeof val === 'function' ? val.bind(obj.target) : val;
101
+ },
102
+ });
103
+ }
104
+
105
+ /**
106
+ * Updates the underlying node that this reference points to.
107
+ * @param node - The new node to forward calls to.
108
+ */
109
+ updateTargetNode(node: AztecNode): void {
110
+ this.target = node;
111
+ }
112
+ }