@aztec/simulator 0.0.1-commit.29c6b1a3 → 0.0.1-commit.2c0ee1788

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 (149) hide show
  1. package/README.md +4 -4
  2. package/dest/private/acvm/acvm.d.ts +4 -2
  3. package/dest/private/acvm/acvm.d.ts.map +1 -1
  4. package/dest/private/acvm/acvm.js +4 -3
  5. package/dest/private/acvm_native.d.ts +5 -3
  6. package/dest/private/acvm_native.d.ts.map +1 -1
  7. package/dest/private/acvm_native.js +8 -6
  8. package/dest/private/acvm_wasm.d.ts +4 -3
  9. package/dest/private/acvm_wasm.d.ts.map +1 -1
  10. package/dest/private/acvm_wasm.js +4 -4
  11. package/dest/private/circuit_recording/circuit_recorder.d.ts +4 -3
  12. package/dest/private/circuit_recording/circuit_recorder.d.ts.map +1 -1
  13. package/dest/private/circuit_recording/circuit_recorder.js +7 -5
  14. package/dest/private/circuit_recording/file_circuit_recorder.d.ts +3 -2
  15. package/dest/private/circuit_recording/file_circuit_recorder.d.ts.map +1 -1
  16. package/dest/private/circuit_recording/file_circuit_recorder.js +2 -2
  17. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts +7 -2
  18. package/dest/private/circuit_recording/memory_circuit_recorder.d.ts.map +1 -1
  19. package/dest/private/circuit_recording/memory_circuit_recorder.js +4 -4
  20. package/dest/private/factory.d.ts +3 -3
  21. package/dest/private/factory.d.ts.map +1 -1
  22. package/dest/private/factory.js +7 -4
  23. package/dest/public/avm/avm_gas.js +3 -3
  24. package/dest/public/avm/avm_simulator.js +1 -1
  25. package/dest/public/avm/calldata.d.ts +1 -1
  26. package/dest/public/avm/calldata.d.ts.map +1 -1
  27. package/dest/public/avm/calldata.js +3 -2
  28. package/dest/public/avm/fixtures/account_proof_fetcher.d.ts +2 -0
  29. package/dest/public/avm/fixtures/account_proof_fetcher.d.ts.map +1 -0
  30. package/dest/public/avm/fixtures/account_proof_fetcher.js +152 -0
  31. package/dest/public/avm/opcodes/accrued_substate.d.ts +2 -2
  32. package/dest/public/avm/opcodes/accrued_substate.d.ts.map +1 -1
  33. package/dest/public/avm/opcodes/accrued_substate.js +3 -4
  34. package/dest/public/avm/serialization/bytecode_serialization.js +3 -3
  35. package/dest/public/avm/serialization/instruction_serialization.d.ts +2 -2
  36. package/dest/public/avm/serialization/instruction_serialization.d.ts.map +1 -1
  37. package/dest/public/avm/serialization/instruction_serialization.js +1 -1
  38. package/dest/public/contracts_db_checkpoint.d.ts +2 -2
  39. package/dest/public/contracts_db_checkpoint.d.ts.map +1 -1
  40. package/dest/public/contracts_db_checkpoint.js +1 -1
  41. package/dest/public/executor_metrics.d.ts +1 -1
  42. package/dest/public/executor_metrics.d.ts.map +1 -1
  43. package/dest/public/executor_metrics.js +7 -2
  44. package/dest/public/fixtures/amm_test.js +2 -2
  45. package/dest/public/fixtures/bulk_test.d.ts +1 -1
  46. package/dest/public/fixtures/bulk_test.d.ts.map +1 -1
  47. package/dest/public/fixtures/bulk_test.js +4 -4
  48. package/dest/public/fixtures/custom_bytecode_tests.d.ts +3 -1
  49. package/dest/public/fixtures/custom_bytecode_tests.d.ts.map +1 -1
  50. package/dest/public/fixtures/custom_bytecode_tests.js +61 -1
  51. package/dest/public/fixtures/opcode_spammer.d.ts +1 -1
  52. package/dest/public/fixtures/opcode_spammer.d.ts.map +1 -1
  53. package/dest/public/fixtures/opcode_spammer.js +6 -6
  54. package/dest/public/fixtures/public_tx_simulation_tester.d.ts +6 -5
  55. package/dest/public/fixtures/public_tx_simulation_tester.d.ts.map +1 -1
  56. package/dest/public/fixtures/public_tx_simulation_tester.js +37 -10
  57. package/dest/public/fixtures/utils.d.ts +2 -2
  58. package/dest/public/fixtures/utils.d.ts.map +1 -1
  59. package/dest/public/fixtures/utils.js +10 -10
  60. package/dest/public/hinting_db_sources.d.ts +5 -5
  61. package/dest/public/hinting_db_sources.d.ts.map +1 -1
  62. package/dest/public/hinting_db_sources.js +7 -6
  63. package/dest/public/public_db_sources.d.ts +6 -5
  64. package/dest/public/public_db_sources.d.ts.map +1 -1
  65. package/dest/public/public_db_sources.js +14 -14
  66. package/dest/public/public_processor/guarded_merkle_tree.d.ts +5 -5
  67. package/dest/public/public_processor/guarded_merkle_tree.d.ts.map +1 -1
  68. package/dest/public/public_processor/guarded_merkle_tree.js +5 -5
  69. package/dest/public/public_processor/public_processor.d.ts +8 -4
  70. package/dest/public/public_processor/public_processor.d.ts.map +1 -1
  71. package/dest/public/public_processor/public_processor.js +75 -50
  72. package/dest/public/public_processor/public_processor_metrics.d.ts +5 -2
  73. package/dest/public/public_processor/public_processor_metrics.d.ts.map +1 -1
  74. package/dest/public/public_processor/public_processor_metrics.js +28 -4
  75. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts +3 -2
  76. package/dest/public/public_tx_simulator/contract_provider_for_cpp.d.ts.map +1 -1
  77. package/dest/public/public_tx_simulator/contract_provider_for_cpp.js +4 -3
  78. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts +5 -5
  79. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.d.ts.map +1 -1
  80. package/dest/public/public_tx_simulator/cpp_public_tx_simulator.js +10 -11
  81. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts +4 -4
  82. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.d.ts.map +1 -1
  83. package/dest/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.js +7 -7
  84. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts +4 -4
  85. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.d.ts.map +1 -1
  86. package/dest/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.js +6 -6
  87. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.d.ts +3 -2
  88. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.d.ts.map +1 -1
  89. package/dest/public/public_tx_simulator/dumping_cpp_public_tx_simulator.js +2 -2
  90. package/dest/public/public_tx_simulator/factories.d.ts +3 -2
  91. package/dest/public/public_tx_simulator/factories.d.ts.map +1 -1
  92. package/dest/public/public_tx_simulator/factories.js +4 -4
  93. package/dest/public/public_tx_simulator/public_tx_context.d.ts +10 -5
  94. package/dest/public/public_tx_simulator/public_tx_context.d.ts.map +1 -1
  95. package/dest/public/public_tx_simulator/public_tx_context.js +16 -18
  96. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts +9 -4
  97. package/dest/public/public_tx_simulator/public_tx_simulator.d.ts.map +1 -1
  98. package/dest/public/public_tx_simulator/public_tx_simulator.js +19 -12
  99. package/dest/public/side_effect_trace.d.ts +4 -4
  100. package/dest/public/side_effect_trace.d.ts.map +1 -1
  101. package/dest/public/side_effect_trace.js +3 -3
  102. package/dest/public/state_manager/state_manager.d.ts +4 -4
  103. package/dest/public/state_manager/state_manager.d.ts.map +1 -1
  104. package/dest/public/state_manager/state_manager.js +5 -5
  105. package/dest/public/test_executor_metrics.d.ts +8 -2
  106. package/dest/public/test_executor_metrics.d.ts.map +1 -1
  107. package/dest/public/test_executor_metrics.js +24 -2
  108. package/package.json +15 -16
  109. package/src/private/acvm/acvm.ts +4 -3
  110. package/src/private/acvm_native.ts +11 -5
  111. package/src/private/acvm_wasm.ts +7 -3
  112. package/src/private/circuit_recording/circuit_recorder.ts +7 -5
  113. package/src/private/circuit_recording/file_circuit_recorder.ts +7 -2
  114. package/src/private/circuit_recording/memory_circuit_recorder.ts +6 -4
  115. package/src/private/factory.ts +7 -4
  116. package/src/public/avm/avm_gas.ts +2 -2
  117. package/src/public/avm/avm_simulator.ts +1 -1
  118. package/src/public/avm/calldata.ts +3 -2
  119. package/src/public/avm/fixtures/account_proof.json +553 -0
  120. package/src/public/avm/fixtures/account_proof_fetcher.ts +166 -0
  121. package/src/public/avm/opcodes/accrued_substate.ts +3 -4
  122. package/src/public/avm/opcodes/external_calls.ts +1 -1
  123. package/src/public/avm/serialization/bytecode_serialization.ts +2 -2
  124. package/src/public/avm/serialization/instruction_serialization.ts +1 -1
  125. package/src/public/contracts_db_checkpoint.ts +1 -1
  126. package/src/public/executor_metrics.ts +4 -1
  127. package/src/public/fixtures/amm_test.ts +2 -2
  128. package/src/public/fixtures/bulk_test.ts +2 -4
  129. package/src/public/fixtures/custom_bytecode_tests.ts +139 -1
  130. package/src/public/fixtures/opcode_spammer.ts +6 -10
  131. package/src/public/fixtures/public_tx_simulation_tester.ts +47 -6
  132. package/src/public/fixtures/utils.ts +17 -12
  133. package/src/public/fuzzing/avm_fuzzer_simulator.ts +1 -1
  134. package/src/public/hinting_db_sources.ts +9 -7
  135. package/src/public/public_db_sources.ts +27 -19
  136. package/src/public/public_processor/guarded_merkle_tree.ts +6 -6
  137. package/src/public/public_processor/public_processor.ts +112 -67
  138. package/src/public/public_processor/public_processor_metrics.ts +22 -4
  139. package/src/public/public_tx_simulator/contract_provider_for_cpp.ts +8 -4
  140. package/src/public/public_tx_simulator/cpp_public_tx_simulator.ts +10 -8
  141. package/src/public/public_tx_simulator/cpp_public_tx_simulator_with_hinted_dbs.ts +7 -5
  142. package/src/public/public_tx_simulator/cpp_vs_ts_public_tx_simulator.ts +7 -5
  143. package/src/public/public_tx_simulator/dumping_cpp_public_tx_simulator.ts +3 -1
  144. package/src/public/public_tx_simulator/factories.ts +6 -3
  145. package/src/public/public_tx_simulator/public_tx_context.ts +21 -16
  146. package/src/public/public_tx_simulator/public_tx_simulator.ts +20 -12
  147. package/src/public/side_effect_trace.ts +5 -2
  148. package/src/public/state_manager/state_manager.ts +19 -4
  149. package/src/public/test_executor_metrics.ts +27 -3
@@ -1,6 +1,6 @@
1
1
  import type { ContractClassPublishedEvent } from '@aztec/protocol-contracts/class-registry';
2
2
  import type { Gas } from '@aztec/stdlib/gas';
3
- import type { TxExecutionPhase } from '@aztec/stdlib/tx';
3
+ import { TxExecutionPhase } from '@aztec/stdlib/tx';
4
4
  import {
5
5
  Attributes,
6
6
  type Gauge,
@@ -9,6 +9,7 @@ import {
9
9
  type TelemetryClient,
10
10
  type Tracer,
11
11
  type UpDownCounter,
12
+ createUpDownCounterWithDefault,
12
13
  } from '@aztec/telemetry-client';
13
14
 
14
15
  export class PublicProcessorMetrics {
@@ -29,19 +30,27 @@ export class PublicProcessorMetrics {
29
30
 
30
31
  private treeInsertionDuration: Histogram;
31
32
 
33
+ private silentlySkippedCount: UpDownCounter;
34
+ private silentlySkippedDuration: Histogram;
35
+
32
36
  constructor(client: TelemetryClient, name = 'PublicProcessor') {
33
37
  this.tracer = client.getTracer(name);
34
38
  const meter = client.getMeter(name);
35
39
 
36
40
  this.txDuration = meter.createHistogram(Metrics.PUBLIC_PROCESSOR_TX_DURATION);
37
41
 
38
- this.txCount = meter.createUpDownCounter(Metrics.PUBLIC_PROCESSOR_TX_COUNT);
42
+ this.txCount = createUpDownCounterWithDefault(meter, Metrics.PUBLIC_PROCESSOR_TX_COUNT, {
43
+ [Attributes.OK]: [true, false],
44
+ });
39
45
 
40
- this.txPhaseCount = meter.createUpDownCounter(Metrics.PUBLIC_PROCESSOR_TX_PHASE_COUNT);
46
+ this.txPhaseCount = createUpDownCounterWithDefault(meter, Metrics.PUBLIC_PROCESSOR_TX_PHASE_COUNT);
41
47
 
42
48
  this.phaseDuration = meter.createHistogram(Metrics.PUBLIC_PROCESSOR_PHASE_DURATION);
43
49
 
44
- this.phaseCount = meter.createUpDownCounter(Metrics.PUBLIC_PROCESSOR_PHASE_COUNT);
50
+ this.phaseCount = createUpDownCounterWithDefault(meter, Metrics.PUBLIC_PROCESSOR_PHASE_COUNT, {
51
+ [Attributes.TX_PHASE_NAME]: [TxExecutionPhase.SETUP, TxExecutionPhase.APP_LOGIC, TxExecutionPhase.TEARDOWN],
52
+ [Attributes.OK]: [true, false],
53
+ });
45
54
 
46
55
  this.bytecodeDeployed = meter.createHistogram(Metrics.PUBLIC_PROCESSOR_DEPLOY_BYTECODE_SIZE);
47
56
 
@@ -54,6 +63,10 @@ export class PublicProcessorMetrics {
54
63
  this.gasRate = meter.createHistogram(Metrics.PUBLIC_PROCESSOR_GAS_RATE);
55
64
 
56
65
  this.treeInsertionDuration = meter.createHistogram(Metrics.PUBLIC_PROCESSOR_TREE_INSERTION);
66
+
67
+ this.silentlySkippedCount = createUpDownCounterWithDefault(meter, Metrics.PUBLIC_PROCESSOR_SILENTLY_SKIPPED_COUNT);
68
+
69
+ this.silentlySkippedDuration = meter.createHistogram(Metrics.PUBLIC_PROCESSOR_SILENTLY_SKIPPED_DURATION);
57
70
  }
58
71
 
59
72
  recordPhaseDuration(phaseName: TxExecutionPhase, durationMs: number) {
@@ -117,4 +130,9 @@ export class PublicProcessorMetrics {
117
130
  recordTreeInsertions(durationUs: number) {
118
131
  this.treeInsertionDuration.record(Math.ceil(durationUs));
119
132
  }
133
+
134
+ recordSilentlySkipped(durationMs: number) {
135
+ this.silentlySkippedCount.add(1);
136
+ this.silentlySkippedDuration.record(Math.ceil(durationMs));
137
+ }
120
138
  }
@@ -1,5 +1,5 @@
1
1
  import { Fr } from '@aztec/foundation/curves/bn254';
2
- import { type Logger, createLogger } from '@aztec/foundation/log';
2
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
3
3
  import type { ContractProvider } from '@aztec/native';
4
4
  import { FunctionSelector } from '@aztec/stdlib/abi';
5
5
  import { deserializeFromMessagePack, serializeWithMessagePack } from '@aztec/stdlib/avm';
@@ -10,12 +10,15 @@ import type { GlobalVariables } from '@aztec/stdlib/tx';
10
10
  import type { PublicContractsDB } from '../public_db_sources.js';
11
11
 
12
12
  export class ContractProviderForCpp implements ContractProvider {
13
- private log: Logger = createLogger('simulator:contract_provider_for_cpp');
13
+ private log: Logger;
14
14
 
15
15
  constructor(
16
16
  private contractsDB: PublicContractsDB,
17
17
  private globalVariables: GlobalVariables,
18
- ) {}
18
+ bindings?: LoggerBindings,
19
+ ) {
20
+ this.log = createLogger('simulator:contract_provider_for_cpp', bindings);
21
+ }
19
22
 
20
23
  public getContractInstance = async (address: string): Promise<Buffer | undefined> => {
21
24
  this.log.trace(`Contract provider callback: getContractInstance(${address})`);
@@ -49,6 +52,7 @@ export class ContractProviderForCpp implements ContractProvider {
49
52
  return serializeWithMessagePack(contractClass);
50
53
  };
51
54
 
55
+ // eslint-disable-next-line require-await
52
56
  public addContracts = async (contractDeploymentDataBuffer: Buffer): Promise<void> => {
53
57
  this.log.trace(`Contract provider callback: addContracts`);
54
58
 
@@ -59,7 +63,7 @@ export class ContractProviderForCpp implements ContractProvider {
59
63
 
60
64
  // Add contracts to the contracts DB
61
65
  this.log.trace(`Calling contractsDB.addContracts`);
62
- await this.contractsDB.addContracts(contractDeploymentData);
66
+ this.contractsDB.addContracts(contractDeploymentData);
63
67
  };
64
68
 
65
69
  public getBytecodeCommitment = async (classId: string): Promise<Buffer | undefined> => {
@@ -1,4 +1,4 @@
1
- import { type Logger, createLogger, logLevel } from '@aztec/foundation/log';
1
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
2
2
  import { sleep } from '@aztec/foundation/sleep';
3
3
  import { type CancellationToken, avmSimulate, cancelSimulation, createCancellationToken } from '@aztec/native';
4
4
  import { ProtocolContractsList } from '@aztec/protocol-contracts';
@@ -44,9 +44,10 @@ export class CppPublicTxSimulator extends PublicTxSimulator implements PublicTxS
44
44
  contractsDB: PublicContractsDB,
45
45
  globalVariables: GlobalVariables,
46
46
  config?: Partial<PublicSimulatorConfig>,
47
+ bindings?: LoggerBindings,
47
48
  ) {
48
- super(merkleTree, contractsDB, globalVariables, config);
49
- this.log = createLogger(`simulator:cpp_public_tx_simulator`);
49
+ super(merkleTree, contractsDB, globalVariables, config, undefined, bindings);
50
+ this.log = createLogger(`simulator:cpp_public_tx_simulator`, bindings);
50
51
  }
51
52
 
52
53
  /**
@@ -84,7 +85,7 @@ export class CppPublicTxSimulator extends PublicTxSimulator implements PublicTxS
84
85
  );
85
86
 
86
87
  // Create contract provider for callbacks to TypeScript PublicContractsDB from C++
87
- const contractProvider = new ContractProviderForCpp(this.contractsDB, this.globalVariables);
88
+ const contractProvider = new ContractProviderForCpp(this.contractsDB, this.globalVariables, this.bindings);
88
89
 
89
90
  // Serialize to msgpack and call the C++ simulator
90
91
  this.log.trace(`Serializing fast simulation inputs to msgpack...`);
@@ -99,8 +100,7 @@ export class CppPublicTxSimulator extends PublicTxSimulator implements PublicTxS
99
100
  inputBuffer,
100
101
  contractProvider,
101
102
  wsCppHandle,
102
- logLevel,
103
- // TODO: re-enable logging
103
+ this.log.level,
104
104
  undefined,
105
105
  this.cancellationToken,
106
106
  );
@@ -171,8 +171,9 @@ export class MeasuredCppPublicTxSimulator extends CppPublicTxSimulator implement
171
171
  globalVariables: GlobalVariables,
172
172
  protected readonly metrics: ExecutorMetricsInterface,
173
173
  config?: Partial<PublicSimulatorConfig>,
174
+ bindings?: LoggerBindings,
174
175
  ) {
175
- super(merkleTree, contractsDB, globalVariables, config);
176
+ super(merkleTree, contractsDB, globalVariables, config, bindings);
176
177
  }
177
178
 
178
179
  public override async simulate(tx: Tx, txLabel: string = 'unlabeledTx'): Promise<PublicTxResult> {
@@ -200,9 +201,10 @@ export class TelemetryCppPublicTxSimulator extends MeasuredCppPublicTxSimulator
200
201
  globalVariables: GlobalVariables,
201
202
  telemetryClient: TelemetryClient = getTelemetryClient(),
202
203
  config?: Partial<PublicSimulatorConfig>,
204
+ bindings?: LoggerBindings,
203
205
  ) {
204
206
  const metrics = new ExecutorMetrics(telemetryClient, 'CppPublicTxSimulator');
205
- super(merkleTree, contractsDB, globalVariables, metrics, config);
207
+ super(merkleTree, contractsDB, globalVariables, metrics, config, bindings);
206
208
  this.tracer = metrics.tracer;
207
209
  }
208
210
  }
@@ -1,4 +1,4 @@
1
- import { type Logger, createLogger, logLevel } from '@aztec/foundation/log';
1
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
2
2
  import { avmSimulateWithHintedDbs } from '@aztec/native';
3
3
  import {
4
4
  AvmCircuitInputs,
@@ -34,9 +34,10 @@ export class CppPublicTxSimulatorHintedDbs extends PublicTxSimulator implements
34
34
  contractsDB: PublicContractsDB,
35
35
  globalVariables: GlobalVariables,
36
36
  config?: Partial<PublicSimulatorConfig>,
37
+ bindings?: LoggerBindings,
37
38
  ) {
38
- super(merkleTree, contractsDB, globalVariables, config);
39
- this.log = createLogger(`simulator:cpp_public_tx_simulator_hinted_dbs`);
39
+ super(merkleTree, contractsDB, globalVariables, config, undefined, bindings);
40
+ this.log = createLogger(`simulator:cpp_public_tx_simulator_hinted_dbs`, bindings);
40
41
  }
41
42
 
42
43
  /**
@@ -74,7 +75,7 @@ export class CppPublicTxSimulatorHintedDbs extends PublicTxSimulator implements
74
75
 
75
76
  let resultBuffer: Buffer;
76
77
  try {
77
- resultBuffer = await avmSimulateWithHintedDbs(inputBuffer, logLevel);
78
+ resultBuffer = await avmSimulateWithHintedDbs(inputBuffer, this.log.level);
78
79
  } catch (error: any) {
79
80
  throw new SimulationError(`C++ hinted simulation failed: ${error.message}`, []);
80
81
  }
@@ -115,8 +116,9 @@ export class MeasuredCppPublicTxSimulatorHintedDbs
115
116
  globalVariables: GlobalVariables,
116
117
  protected readonly metrics: ExecutorMetricsInterface,
117
118
  config?: Partial<PublicSimulatorConfig>,
119
+ bindings?: LoggerBindings,
118
120
  ) {
119
- super(merkleTree, contractsDB, globalVariables, config);
121
+ super(merkleTree, contractsDB, globalVariables, config, bindings);
120
122
  }
121
123
 
122
124
  public override async simulate(tx: Tx, txLabel: string = 'unlabeledTx'): Promise<PublicTxResult> {
@@ -1,4 +1,4 @@
1
- import { type Logger, createLogger, logLevel } from '@aztec/foundation/log';
1
+ import { type Logger, type LoggerBindings, createLogger, logLevel } from '@aztec/foundation/log';
2
2
  import { avmSimulate } from '@aztec/native';
3
3
  import { ProtocolContractsList } from '@aztec/protocol-contracts';
4
4
  import {
@@ -37,9 +37,10 @@ export class CppVsTsPublicTxSimulator extends PublicTxSimulator implements Publi
37
37
  contractsDB: PublicContractsDB,
38
38
  globalVariables: GlobalVariables,
39
39
  config?: Partial<PublicSimulatorConfig>,
40
+ bindings?: LoggerBindings,
40
41
  ) {
41
- super(merkleTree, contractsDB, globalVariables, config);
42
- this.log = createLogger(`simulator:cpp_vs_public_tx_simulator`);
42
+ super(merkleTree, contractsDB, globalVariables, config, undefined, bindings);
43
+ this.log = createLogger(`simulator:cpp_vs_public_tx_simulator`, bindings);
43
44
  }
44
45
 
45
46
  /**
@@ -103,7 +104,7 @@ export class CppVsTsPublicTxSimulator extends PublicTxSimulator implements Publi
103
104
  );
104
105
 
105
106
  // Create contract provider for callbacks to TypeScript PublicContractsDB from C++
106
- const contractProvider = new ContractProviderForCpp(this.contractsDB, this.globalVariables);
107
+ const contractProvider = new ContractProviderForCpp(this.contractsDB, this.globalVariables, this.bindings);
107
108
 
108
109
  // Serialize to msgpack and call the C++ simulator
109
110
  this.log.debug(`Serializing fast simulation inputs to msgpack...`);
@@ -220,8 +221,9 @@ export class MeasuredCppVsTsPublicTxSimulator
220
221
  globalVariables: GlobalVariables,
221
222
  protected readonly metrics: ExecutorMetricsInterface,
222
223
  config?: Partial<PublicSimulatorConfig>,
224
+ bindings?: LoggerBindings,
223
225
  ) {
224
- super(merkleTree, contractsDB, globalVariables, config);
226
+ super(merkleTree, contractsDB, globalVariables, config, bindings);
225
227
  }
226
228
 
227
229
  public override async simulate(tx: Tx, txLabel: string = 'unlabeledTx'): Promise<PublicTxResult> {
@@ -1,3 +1,4 @@
1
+ import type { LoggerBindings } from '@aztec/foundation/log';
1
2
  import {
2
3
  AvmCircuitInputs,
3
4
  AvmCircuitPublicInputs,
@@ -29,8 +30,9 @@ export class DumpingCppPublicTxSimulator extends CppPublicTxSimulator {
29
30
  globalVariables: GlobalVariables,
30
31
  config: Partial<PublicSimulatorConfig>,
31
32
  outputDir: string,
33
+ bindings?: LoggerBindings,
32
34
  ) {
33
- super(merkleTree, contractsDB, globalVariables, config);
35
+ super(merkleTree, contractsDB, globalVariables, config, bindings);
34
36
  assert(config.collectHints === true, 'collectHints must be enabled to dump AVM circuit inputs');
35
37
  assert(config.collectPublicInputs === true, 'collectPublicInputs must be enabled to dump AVM circuit inputs');
36
38
  this.outputDir = outputDir;
@@ -1,3 +1,4 @@
1
+ import type { LoggerBindings } from '@aztec/foundation/log';
1
2
  import { PublicSimulatorConfig } from '@aztec/stdlib/avm';
2
3
  import type { MerkleTreeWriteOperations } from '@aztec/stdlib/trees';
3
4
  import type { GlobalVariables } from '@aztec/stdlib/tx';
@@ -17,10 +18,12 @@ export function createPublicTxSimulatorForBlockBuilding(
17
18
  contractsDB: PublicContractsDB,
18
19
  globalVariables: GlobalVariables,
19
20
  telemetryClient: TelemetryClient,
21
+ bindings?: LoggerBindings,
22
+ collectDebugLogs = false,
20
23
  ) {
21
24
  const config = PublicSimulatorConfig.from({
22
25
  skipFeeEnforcement: false,
23
- collectDebugLogs: false,
26
+ collectDebugLogs,
24
27
  collectHints: false,
25
28
  collectPublicInputs: false,
26
29
  collectStatistics: false,
@@ -35,7 +38,7 @@ export function createPublicTxSimulatorForBlockBuilding(
35
38
  collectHints: true,
36
39
  collectPublicInputs: true,
37
40
  };
38
- return new DumpingCppPublicTxSimulator(merkleTree, contractsDB, globalVariables, dumpingConfig, dumpDir);
41
+ return new DumpingCppPublicTxSimulator(merkleTree, contractsDB, globalVariables, dumpingConfig, dumpDir, bindings);
39
42
  }
40
- return new TelemetryCppPublicTxSimulator(merkleTree, contractsDB, globalVariables, telemetryClient, config);
43
+ return new TelemetryCppPublicTxSimulator(merkleTree, contractsDB, globalVariables, telemetryClient, config, bindings);
41
44
  }
@@ -7,7 +7,7 @@ import {
7
7
  } from '@aztec/constants';
8
8
  import { padArrayEnd } from '@aztec/foundation/collection';
9
9
  import { Fr } from '@aztec/foundation/curves/bn254';
10
- import { type Logger, createLogger } from '@aztec/foundation/log';
10
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
11
11
  import {
12
12
  AvmAccumulatedData,
13
13
  AvmAccumulatedDataArrayLengths,
@@ -87,8 +87,9 @@ export class PublicTxContext {
87
87
  public readonly revertibleAccumulatedDataFromPrivate: PrivateToPublicAccumulatedData,
88
88
  public readonly feePayer: AztecAddress,
89
89
  private readonly trace: SideEffectTrace,
90
+ bindings?: LoggerBindings,
90
91
  ) {
91
- this.log = createLogger(`simulator:public_tx_context`);
92
+ this.log = createLogger(`simulator:public_tx_context`, bindings);
92
93
  }
93
94
 
94
95
  public static async create(
@@ -98,13 +99,14 @@ export class PublicTxContext {
98
99
  globalVariables: GlobalVariables,
99
100
  protocolContracts: ProtocolContracts,
100
101
  proverId: Fr,
102
+ bindings?: LoggerBindings,
101
103
  ) {
102
104
  const contractDeploymentData = AllContractDeploymentData.fromTx(tx);
103
105
  const nonRevertibleContractDeploymentData = contractDeploymentData.getNonRevertibleContractDeploymentData();
104
106
  const revertibleContractDeploymentData = contractDeploymentData.getRevertibleContractDeploymentData();
105
107
  const nonRevertibleAccumulatedDataFromPrivate = tx.data.forPublic!.nonRevertibleAccumulatedData;
106
108
 
107
- const trace = new SideEffectTrace();
109
+ const trace = new SideEffectTrace(0, bindings);
108
110
 
109
111
  const firstNullifier = nonRevertibleAccumulatedDataFromPrivate.nullifiers[0];
110
112
 
@@ -115,6 +117,7 @@ export class PublicTxContext {
115
117
  trace,
116
118
  firstNullifier,
117
119
  globalVariables.timestamp,
120
+ bindings,
118
121
  );
119
122
 
120
123
  const gasSettings = tx.data.constants.txContext.gasSettings;
@@ -124,7 +127,7 @@ export class PublicTxContext {
124
127
 
125
128
  return new PublicTxContext(
126
129
  tx.getTxHash(),
127
- new PhaseStateManager(txStateManager),
130
+ new PhaseStateManager(txStateManager, bindings),
128
131
  await txStateManager.getTreeSnapshots(),
129
132
  globalVariables,
130
133
  protocolContracts,
@@ -142,6 +145,7 @@ export class PublicTxContext {
142
145
  tx.data.forPublic!.revertibleAccumulatedData,
143
146
  tx.data.feePayer,
144
147
  trace,
148
+ bindings,
145
149
  );
146
150
  }
147
151
 
@@ -170,14 +174,8 @@ export class PublicTxContext {
170
174
  }
171
175
  if (phase === TxExecutionPhase.SETUP) {
172
176
  this.log.warn(`Setup phase reverted! The transaction will be thrown out.`);
173
- } else if (phase === TxExecutionPhase.APP_LOGIC) {
174
- this.revertCode = RevertCode.APP_LOGIC_REVERTED;
175
- } else if (phase === TxExecutionPhase.TEARDOWN) {
176
- if (this.revertCode.equals(RevertCode.APP_LOGIC_REVERTED)) {
177
- this.revertCode = RevertCode.BOTH_REVERTED;
178
- } else {
179
- this.revertCode = RevertCode.TEARDOWN_REVERTED;
180
- }
177
+ } else if (phase === TxExecutionPhase.APP_LOGIC || phase === TxExecutionPhase.TEARDOWN) {
178
+ this.revertCode = RevertCode.REVERTED;
181
179
  }
182
180
  }
183
181
 
@@ -243,8 +241,12 @@ export class PublicTxContext {
243
241
  }
244
242
 
245
243
  /**
246
- * The gasUsed by public and private,
247
- * as if the entire teardown gas limit was consumed.
244
+ * The gasUsed by public and private, as if the entire teardown gas limit was consumed.
245
+ *
246
+ * This is intentional: teardown is used for gas accounting and refunds, so the transaction
247
+ * fee must be deterministic _before_ teardown executes. If fees depended on teardown's actual
248
+ * consumption there would be a circular dependency. Billing the full teardown gas limit
249
+ * (set by the user) makes the fee known in advance and available to the teardown function.
248
250
  */
249
251
  getTotalGasUsed(): Gas {
250
252
  return this.gasUsedByPrivate.add(this.gasUsedByPublic);
@@ -441,8 +443,11 @@ class PhaseStateManager {
441
443
 
442
444
  private currentlyActiveStateManager: PublicPersistableStateManager | undefined;
443
445
 
444
- constructor(private readonly txStateManager: PublicPersistableStateManager) {
445
- this.log = createLogger(`simulator:public_phase_state_manager`);
446
+ constructor(
447
+ private readonly txStateManager: PublicPersistableStateManager,
448
+ bindings?: LoggerBindings,
449
+ ) {
450
+ this.log = createLogger(`simulator:public_phase_state_manager`, bindings);
446
451
  }
447
452
 
448
453
  async fork() {
@@ -1,6 +1,6 @@
1
- import { AVM_MAX_PROCESSABLE_L2_GAS } from '@aztec/constants';
1
+ import { MAX_PROCESSABLE_L2_GAS } from '@aztec/constants';
2
2
  import { Fr } from '@aztec/foundation/curves/bn254';
3
- import { type Logger, createLogger } from '@aztec/foundation/log';
3
+ import { type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
4
4
  import { ProtocolContractAddress, ProtocolContractsList } from '@aztec/protocol-contracts';
5
5
  import { computeFeePayerBalanceStorageSlot } from '@aztec/protocol-contracts/fee-juice';
6
6
  import { AvmExecutionHints, AvmTxHint, PublicSimulatorConfig, PublicTxEffect, PublicTxResult } from '@aztec/stdlib/avm';
@@ -27,7 +27,6 @@ import { type PublicContractsDB, PublicTreesDB } from '../public_db_sources.js';
27
27
  import {
28
28
  L2ToL1MessageLimitReachedError,
29
29
  NoteHashLimitReachedError,
30
- NullifierCollisionError,
31
30
  NullifierLimitReachedError,
32
31
  } from '../side_effect_errors.js';
33
32
  import type { PublicPersistableStateManager } from '../state_manager/state_manager.js';
@@ -81,6 +80,7 @@ type ProcessedPhase = {
81
80
  export class PublicTxSimulator implements PublicTxSimulatorInterface {
82
81
  protected log: Logger;
83
82
  protected readonly config: PublicSimulatorConfig;
83
+ protected readonly bindings?: LoggerBindings;
84
84
 
85
85
  constructor(
86
86
  protected merkleTree: MerkleTreeWriteOperations,
@@ -88,9 +88,11 @@ export class PublicTxSimulator implements PublicTxSimulatorInterface {
88
88
  protected globalVariables: GlobalVariables,
89
89
  config?: Partial<PublicSimulatorConfig>,
90
90
  protected protocolContracts: ProtocolContracts = ProtocolContractsList,
91
+ bindings?: LoggerBindings,
91
92
  ) {
92
93
  this.config = PublicSimulatorConfig.from(config ?? {});
93
- this.log = createLogger(`simulator:public_tx_simulator`);
94
+ this.bindings = bindings;
95
+ this.log = createLogger(`simulator:public_tx_simulator`, bindings);
94
96
  }
95
97
 
96
98
  /**
@@ -119,6 +121,7 @@ export class PublicTxSimulator implements PublicTxSimulatorInterface {
119
121
  this.globalVariables,
120
122
  this.protocolContracts,
121
123
  this.config.proverId,
124
+ this.bindings,
122
125
  );
123
126
 
124
127
  // This will throw if there is a nullifier collision.
@@ -143,7 +146,8 @@ export class PublicTxSimulator implements PublicTxSimulatorInterface {
143
146
  hintingContractsDB.createCheckpoint();
144
147
 
145
148
  try {
146
- // This will throw if there is a nullifier collision or other insertion error (limit reached).
149
+ // This may throw: a side-effect limit error triggers a soft revert (caught below), while a
150
+ // nullifier collision is unrecoverable and propagates out of simulate() to throw out the tx.
147
151
  await this.insertRevertiblesFromPrivate(context);
148
152
 
149
153
  // Only proceed with app logic if there was no revert during revertible insertion.
@@ -195,8 +199,8 @@ export class PublicTxSimulator implements PublicTxSimulatorInterface {
195
199
 
196
200
  // Such transactions should be filtered by GasTxValidator.
197
201
  assert(
198
- context.getActualGasUsed().l2Gas <= AVM_MAX_PROCESSABLE_L2_GAS,
199
- `Transaction consumes ${context.getActualGasUsed().l2Gas} L2 gas, which exceeds the AVM maximum processable gas of ${AVM_MAX_PROCESSABLE_L2_GAS}`,
202
+ context.getActualGasUsed().l2Gas <= MAX_PROCESSABLE_L2_GAS,
203
+ `Transaction consumes ${context.getActualGasUsed().l2Gas} L2 gas, which exceeds the maximum processable gas of ${MAX_PROCESSABLE_L2_GAS}`,
200
204
  );
201
205
  await this.payFee(context);
202
206
 
@@ -397,7 +401,7 @@ export class PublicTxSimulator implements PublicTxSimulatorInterface {
397
401
  // However, things work as expected because later calls to getters on the hintingContractsDB
398
402
  // will pick up the new contracts and will generate the necessary hints.
399
403
  // So, a consumer of the hints will always see the new contracts.
400
- await this.contractsDB.addContracts(context.nonRevertibleContractDeploymentData);
404
+ this.contractsDB.addContracts(context.nonRevertibleContractDeploymentData);
401
405
  }
402
406
 
403
407
  /**
@@ -405,9 +409,13 @@ export class PublicTxSimulator implements PublicTxSimulatorInterface {
405
409
  * Throws TxSimRevertibleInsertionsRevert if there is some checked error during revertible insertions.
406
410
  * This function checks for the following errors:
407
411
  * - NullifierLimitReachedError
408
- * - NullifierCollisionError
409
412
  * - NoteHashLimitReachedError
410
413
  * - L2ToL1MessageLimitReachedError
414
+ *
415
+ * Note: NullifierCollisionError is intentionally NOT caught here. A nullifier collision
416
+ * during revertible insertions is unprovable (the nullifier originated from private, so
417
+ * a collision indicates the tx should never have been proposed). It propagates as-is to
418
+ * make the transaction unrecoverable, matching the AVM circuit behavior.
411
419
  */
412
420
  protected async insertRevertiblesFromPrivate(context: PublicTxContext) {
413
421
  const stateManager = context.state.getActiveStateManager();
@@ -417,7 +425,7 @@ export class PublicTxSimulator implements PublicTxSimulatorInterface {
417
425
  await stateManager.writeSiloedNullifier(siloedNullifier);
418
426
  }
419
427
  } catch (e: any) {
420
- if (e instanceof NullifierLimitReachedError || e instanceof NullifierCollisionError) {
428
+ if (e instanceof NullifierLimitReachedError) {
421
429
  context.revert(
422
430
  TxExecutionPhase.APP_LOGIC,
423
431
  new SimulationError(
@@ -427,7 +435,7 @@ export class PublicTxSimulator implements PublicTxSimulatorInterface {
427
435
  );
428
436
  throw new TxSimRevertibleInsertionsRevert();
429
437
  } else {
430
- // Unchecked/unknown error - re-throw as-is
438
+ // Unchecked/unknown error or NullifierCollisionError (unrecoverable) - re-throw as-is
431
439
  throw e;
432
440
  }
433
441
  }
@@ -482,7 +490,7 @@ export class PublicTxSimulator implements PublicTxSimulatorInterface {
482
490
  // However, things work as expected because later calls to getters on the hintingContractsDB
483
491
  // will pick up the new contracts and will generate the necessary hints.
484
492
  // So, a consumer of the hints will always see the new contracts.
485
- await this.contractsDB.addContracts(context.revertibleContractDeploymentData);
493
+ this.contractsDB.addContracts(context.revertibleContractDeploymentData);
486
494
  }
487
495
 
488
496
  private async payFee(context: PublicTxContext) {
@@ -9,7 +9,7 @@ import {
9
9
  } from '@aztec/constants';
10
10
  import { Fr } from '@aztec/foundation/curves/bn254';
11
11
  import { EthAddress } from '@aztec/foundation/eth-address';
12
- import { type LogLevel, createLogger } from '@aztec/foundation/log';
12
+ import { type LogLevel, type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
13
13
  import { PublicDataUpdateRequest } from '@aztec/stdlib/avm';
14
14
  import type { AztecAddress } from '@aztec/stdlib/aztec-address';
15
15
  import { computePublicDataTreeLeafSlot } from '@aztec/stdlib/hash';
@@ -61,7 +61,7 @@ export class SideEffectArrayLengths {
61
61
  * Trace side effects for an enqueued public call's execution.
62
62
  */
63
63
  export class SideEffectTrace implements PublicSideEffectTraceInterface {
64
- public log = createLogger('simulator:side_effect_trace');
64
+ public log: Logger;
65
65
 
66
66
  /** The side effect counter increments with every call to the trace. */
67
67
  private sideEffectCounter: number;
@@ -79,6 +79,7 @@ export class SideEffectTrace implements PublicSideEffectTraceInterface {
79
79
  constructor(
80
80
  /** The counter of this trace's first side effect. */
81
81
  public readonly startSideEffectCounter: number = 0,
82
+ bindings?: LoggerBindings,
82
83
  /** Track parent's (or previous kernel's) lengths so the AVM can properly enforce TX-wide limits,
83
84
  * otherwise the public kernel can fail to prove because TX limits are breached.
84
85
  */
@@ -90,11 +91,13 @@ export class SideEffectTrace implements PublicSideEffectTraceInterface {
90
91
  private debugLogMemoryReads: number = 0,
91
92
  ) {
92
93
  this.sideEffectCounter = startSideEffectCounter;
94
+ this.log = createLogger('simulator:side_effect_trace', bindings);
93
95
  }
94
96
 
95
97
  public fork() {
96
98
  return new SideEffectTrace(
97
99
  this.sideEffectCounter,
100
+ this.log.getBindings(),
98
101
  new SideEffectArrayLengths(
99
102
  this.previousSideEffectArrayLengths.publicDataWrites + this.userPublicDataWritesLength,
100
103
  this.previousSideEffectArrayLengths.protocolPublicDataWrites + this.protocolPublicDataWritesLength,
@@ -2,7 +2,7 @@ import { CONTRACT_INSTANCE_REGISTRY_CONTRACT_ADDRESS, MAX_PROTOCOL_CONTRACTS } f
2
2
  import { poseidon2Hash } from '@aztec/foundation/crypto/poseidon';
3
3
  import { Fr } from '@aztec/foundation/curves/bn254';
4
4
  import { jsonStringify } from '@aztec/foundation/json-rpc';
5
- import { type LogLevel, createLogger } from '@aztec/foundation/log';
5
+ import { type LogLevel, type Logger, type LoggerBindings, createLogger } from '@aztec/foundation/log';
6
6
  import { ProtocolContractAddress } from '@aztec/protocol-contracts';
7
7
  import { FunctionSelector } from '@aztec/stdlib/abi';
8
8
  import { AztecAddress } from '@aztec/stdlib/aztec-address';
@@ -42,7 +42,7 @@ import { PublicStorage } from './public_storage.js';
42
42
  * Manages merging of successful/reverted child state into current state.
43
43
  */
44
44
  export class PublicPersistableStateManager {
45
- private readonly log = createLogger('simulator:state_manager');
45
+ private readonly log: Logger;
46
46
 
47
47
  /** Make sure a forked state is never merged twice. */
48
48
  private alreadyMergedIntoParent = false;
@@ -56,7 +56,10 @@ export class PublicPersistableStateManager {
56
56
  private readonly doMerkleOperations: boolean = true,
57
57
  private readonly publicStorage: PublicStorage = new PublicStorage(treesDB),
58
58
  private readonly nullifiers: NullifierManager = new NullifierManager(treesDB),
59
- ) {}
59
+ bindings?: LoggerBindings,
60
+ ) {
61
+ this.log = createLogger('simulator:state_manager', bindings);
62
+ }
60
63
 
61
64
  /**
62
65
  * Create a new state manager
@@ -67,8 +70,19 @@ export class PublicPersistableStateManager {
67
70
  trace: PublicSideEffectTraceInterface,
68
71
  firstNullifier: Fr,
69
72
  timestamp: UInt64,
73
+ bindings?: LoggerBindings,
70
74
  ): PublicPersistableStateManager {
71
- return new PublicPersistableStateManager(treesDB, contractsDB, trace, firstNullifier, timestamp);
75
+ return new PublicPersistableStateManager(
76
+ treesDB,
77
+ contractsDB,
78
+ trace,
79
+ firstNullifier,
80
+ timestamp,
81
+ undefined,
82
+ undefined,
83
+ undefined,
84
+ bindings,
85
+ );
72
86
  }
73
87
 
74
88
  /**
@@ -85,6 +99,7 @@ export class PublicPersistableStateManager {
85
99
  this.doMerkleOperations,
86
100
  this.publicStorage.fork(),
87
101
  this.nullifiers.fork(),
102
+ this.log.getBindings(),
88
103
  );
89
104
  }
90
105