@aztec/txe 5.0.0-private.20260319 → 5.0.0-rc.1

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 (154) hide show
  1. package/dest/AuthRegistry-CPGFQR26.js +3 -0
  2. package/dest/AuthRegistry-CPGFQR26.js.map +7 -0
  3. package/dest/ContractClassRegistry-EHVIHGEK.js +3 -0
  4. package/dest/ContractClassRegistry-EHVIHGEK.js.map +7 -0
  5. package/dest/ContractInstanceRegistry-DWZDXHRG.js +3 -0
  6. package/dest/ContractInstanceRegistry-DWZDXHRG.js.map +7 -0
  7. package/dest/FeeJuice-MI32ZO7B.js +3 -0
  8. package/dest/FeeJuice-MI32ZO7B.js.map +7 -0
  9. package/dest/HandshakeRegistry-3KSP3ITH.js +3 -0
  10. package/dest/HandshakeRegistry-3KSP3ITH.js.map +7 -0
  11. package/dest/MultiCallEntrypoint-IU7HYFYE.js +3 -0
  12. package/dest/MultiCallEntrypoint-IU7HYFYE.js.map +7 -0
  13. package/dest/SchnorrAccount-6TUE7JX4.js +3 -0
  14. package/dest/SchnorrAccount-6TUE7JX4.js.map +7 -0
  15. package/dest/SchnorrInitializerlessAccount-S3DU2DJK.js +3 -0
  16. package/dest/SchnorrInitializerlessAccount-S3DU2DJK.js.map +7 -0
  17. package/dest/bin/check_txe_oracle_version.d.ts +2 -0
  18. package/dest/bin/check_txe_oracle_version.d.ts.map +1 -0
  19. package/dest/bin/check_txe_oracle_version.js +61 -0
  20. package/dest/bin/index.js +3 -30
  21. package/dest/bin/index.js.map +7 -0
  22. package/dest/bin/oracle_test_server.d.ts +3 -0
  23. package/dest/bin/oracle_test_server.d.ts.map +1 -0
  24. package/dest/bin/oracle_test_server.js +41 -0
  25. package/dest/chunk-5U25VAFR.js +265 -0
  26. package/dest/chunk-5U25VAFR.js.map +7 -0
  27. package/dest/chunk-BJVAAXNA.js +3 -0
  28. package/dest/chunk-BJVAAXNA.js.map +7 -0
  29. package/dest/chunk-UPW55EJX.js +304 -0
  30. package/dest/chunk-UPW55EJX.js.map +7 -0
  31. package/dest/constants.d.ts +5 -1
  32. package/dest/constants.d.ts.map +1 -1
  33. package/dest/constants.js +8 -0
  34. package/dest/dispatcher_pool.d.ts +67 -0
  35. package/dest/dispatcher_pool.d.ts.map +1 -0
  36. package/dest/dispatcher_pool.js +286 -0
  37. package/dest/index.d.ts +51 -7
  38. package/dest/index.d.ts.map +1 -1
  39. package/dest/index.js +70 -190
  40. package/dest/metafile.json +38829 -0
  41. package/dest/msgpackr_fr_extension.d.ts +2 -0
  42. package/dest/msgpackr_fr_extension.d.ts.map +1 -0
  43. package/dest/msgpackr_fr_extension.js +21 -0
  44. package/dest/oracle/interfaces.d.ts +33 -8
  45. package/dest/oracle/interfaces.d.ts.map +1 -1
  46. package/dest/oracle/test-resolver/fixtures.d.ts +43 -0
  47. package/dest/oracle/test-resolver/fixtures.d.ts.map +1 -0
  48. package/dest/oracle/test-resolver/fixtures.js +39 -0
  49. package/dest/oracle/test-resolver/index.d.ts +9 -0
  50. package/dest/oracle/test-resolver/index.d.ts.map +1 -0
  51. package/dest/oracle/test-resolver/index.js +33 -0
  52. package/dest/oracle/test-resolver/resolver.d.ts +34 -0
  53. package/dest/oracle/test-resolver/resolver.d.ts.map +1 -0
  54. package/dest/oracle/test-resolver/resolver.js +114 -0
  55. package/dest/oracle/txe_oracle_public_context.d.ts +26 -2
  56. package/dest/oracle/txe_oracle_public_context.d.ts.map +1 -1
  57. package/dest/oracle/txe_oracle_public_context.js +43 -1
  58. package/dest/oracle/txe_oracle_registry.d.ts +14 -0
  59. package/dest/oracle/txe_oracle_registry.d.ts.map +1 -0
  60. package/dest/oracle/txe_oracle_registry.js +562 -0
  61. package/dest/oracle/txe_oracle_top_level_context.d.ts +33 -20
  62. package/dest/oracle/txe_oracle_top_level_context.d.ts.map +1 -1
  63. package/dest/oracle/txe_oracle_top_level_context.js +151 -58
  64. package/dest/oracle/txe_oracle_version.d.ts +17 -0
  65. package/dest/oracle/txe_oracle_version.d.ts.map +1 -0
  66. package/dest/oracle/txe_oracle_version.js +14 -0
  67. package/dest/oracle/txe_private_execution_oracle.d.ts +17 -0
  68. package/dest/oracle/txe_private_execution_oracle.d.ts.map +1 -0
  69. package/dest/oracle/txe_private_execution_oracle.js +15 -0
  70. package/dest/rpc_server.d.ts +14 -0
  71. package/dest/rpc_server.d.ts.map +1 -0
  72. package/dest/rpc_server.js +78 -0
  73. package/dest/rpc_translator.d.ts +103 -233
  74. package/dest/rpc_translator.d.ts.map +1 -1
  75. package/dest/rpc_translator.js +695 -636
  76. package/dest/server.bundle.js +3 -0
  77. package/dest/server.bundle.js.map +7 -0
  78. package/dest/state_machine/archiver.d.ts +4 -3
  79. package/dest/state_machine/archiver.d.ts.map +1 -1
  80. package/dest/state_machine/archiver.js +26 -15
  81. package/dest/state_machine/dummy_p2p_client.d.ts +14 -7
  82. package/dest/state_machine/dummy_p2p_client.d.ts.map +1 -1
  83. package/dest/state_machine/dummy_p2p_client.js +19 -4
  84. package/dest/state_machine/global_variable_builder.d.ts +9 -4
  85. package/dest/state_machine/global_variable_builder.d.ts.map +1 -1
  86. package/dest/state_machine/global_variable_builder.js +9 -3
  87. package/dest/state_machine/index.d.ts +4 -2
  88. package/dest/state_machine/index.d.ts.map +1 -1
  89. package/dest/state_machine/index.js +11 -3
  90. package/dest/state_machine/mock_epoch_cache.d.ts +1 -2
  91. package/dest/state_machine/mock_epoch_cache.d.ts.map +1 -1
  92. package/dest/state_machine/mock_epoch_cache.js +0 -3
  93. package/dest/state_machine/synchronizer.js +1 -1
  94. package/dest/txe_session.d.ts +86 -19
  95. package/dest/txe_session.d.ts.map +1 -1
  96. package/dest/txe_session.js +244 -45
  97. package/dest/utils/encoding.d.ts +191 -0
  98. package/dest/utils/encoding.d.ts.map +1 -0
  99. package/dest/{util → utils}/encoding.js +7 -2
  100. package/dest/{util → utils}/expected_failure_error.d.ts +1 -1
  101. package/dest/utils/expected_failure_error.d.ts.map +1 -0
  102. package/dest/{util → utils}/txe_account_store.d.ts +1 -1
  103. package/dest/utils/txe_account_store.d.ts.map +1 -0
  104. package/dest/utils/txe_artifact_resolver.d.ts +37 -0
  105. package/dest/utils/txe_artifact_resolver.d.ts.map +1 -0
  106. package/dest/utils/txe_artifact_resolver.js +161 -0
  107. package/dest/utils/txe_public_contract_data_source.d.ts +20 -0
  108. package/dest/utils/txe_public_contract_data_source.d.ts.map +1 -0
  109. package/dest/{util → utils}/txe_public_contract_data_source.js +1 -3
  110. package/dest/worker.bundle.js +3 -0
  111. package/dest/worker.bundle.js.map +7 -0
  112. package/dest/worker.d.ts +2 -0
  113. package/dest/worker.d.ts.map +1 -0
  114. package/dest/worker.js +92 -0
  115. package/package.json +38 -21
  116. package/src/bin/check_txe_oracle_version.ts +70 -0
  117. package/src/bin/index.ts +11 -2
  118. package/src/bin/oracle_test_server.ts +51 -0
  119. package/src/constants.ts +10 -0
  120. package/src/dispatcher_pool.ts +317 -0
  121. package/src/index.ts +97 -227
  122. package/src/msgpackr_fr_extension.ts +23 -0
  123. package/src/oracle/interfaces.ts +29 -7
  124. package/src/oracle/test-resolver/fixtures.ts +84 -0
  125. package/src/oracle/test-resolver/index.ts +45 -0
  126. package/src/oracle/test-resolver/resolver.ts +165 -0
  127. package/src/oracle/txe_oracle_public_context.ts +60 -0
  128. package/src/oracle/txe_oracle_registry.ts +401 -0
  129. package/src/oracle/txe_oracle_top_level_context.ts +185 -67
  130. package/src/oracle/txe_oracle_version.ts +17 -0
  131. package/src/oracle/txe_private_execution_oracle.ts +30 -0
  132. package/src/rpc_server.ts +87 -0
  133. package/src/rpc_translator.ts +765 -913
  134. package/src/state_machine/archiver.ts +38 -16
  135. package/src/state_machine/dummy_p2p_client.ts +35 -11
  136. package/src/state_machine/global_variable_builder.ts +18 -3
  137. package/src/state_machine/index.ts +17 -5
  138. package/src/state_machine/mock_epoch_cache.ts +0 -4
  139. package/src/state_machine/synchronizer.ts +1 -1
  140. package/src/txe_session.ts +434 -57
  141. package/src/{util → utils}/encoding.ts +8 -2
  142. package/src/utils/txe_artifact_resolver.ts +217 -0
  143. package/src/{util → utils}/txe_public_contract_data_source.ts +0 -2
  144. package/src/worker.ts +98 -0
  145. package/dest/util/encoding.d.ts +0 -720
  146. package/dest/util/encoding.d.ts.map +0 -1
  147. package/dest/util/expected_failure_error.d.ts.map +0 -1
  148. package/dest/util/txe_account_store.d.ts.map +0 -1
  149. package/dest/util/txe_public_contract_data_source.d.ts +0 -20
  150. package/dest/util/txe_public_contract_data_source.d.ts.map +0 -1
  151. /package/dest/{util → utils}/expected_failure_error.js +0 -0
  152. /package/dest/{util → utils}/txe_account_store.js +0 -0
  153. /package/src/{util → utils}/expected_failure_error.ts +0 -0
  154. /package/src/{util → utils}/txe_account_store.ts +0 -0
@@ -1,13 +1,4 @@
1
- import { Fr, Point } from '@aztec/aztec.js/fields';
2
- import { MAX_NOTE_HASHES_PER_TX, MAX_NULLIFIERS_PER_TX } from '@aztec/constants';
3
- import { BlockNumber } from '@aztec/foundation/branded-types';
4
- import { packAsHintedNote } from '@aztec/pxe/simulator';
5
- import { EventSelector, FunctionSelector, NoteSelector } from '@aztec/stdlib/abi';
6
- import { AztecAddress } from '@aztec/stdlib/aztec-address';
7
- import { BlockHash } from '@aztec/stdlib/block';
8
- import { addressFromSingle, arrayOfArraysToBoundedVecOfArrays, arrayToBoundedVec, bufferToU8Array, fromArray, fromSingle, fromUintArray, fromUintBoundedVec, toArray, toForeignCallResult, toSingle } from './util/encoding.js';
9
- const MAX_EVENT_LEN = 10; // This is MAX_MESSAGE_CONTENT_LEN - PRIVATE_EVENT_MSG_PLAINTEXT_RESERVED_FIELDS_LEN
10
- const MAX_PRIVATE_EVENTS_PER_TXE_QUERY = 5;
1
+ import { callTxeHandler } from './oracle/txe_oracle_registry.js';
11
2
  export class UnavailableOracleError extends Error {
12
3
  constructor(oracleName){
13
4
  super(`${oracleName} oracles not available with the current handler`);
@@ -60,754 +51,822 @@ export class RPCTranslator {
60
51
  }
61
52
  return this.oracleHandler;
62
53
  }
54
+ // eslint-disable-next-line camelcase
55
+ aztec_txe_assertCompatibleOracleVersion(...inputs) {
56
+ return callTxeHandler({
57
+ oracle: 'aztec_txe_assertCompatibleOracleVersion',
58
+ inputs,
59
+ handler: ([major, minor])=>{
60
+ this.stateHandler.setTxeOracleVersion(major, minor);
61
+ }
62
+ });
63
+ }
63
64
  // TXE session state transition functions - these get handled by the state handler
64
65
  // eslint-disable-next-line camelcase
65
- async aztec_txe_setTopLevelTXEContext() {
66
- await this.stateHandler.enterTopLevelState();
67
- return toForeignCallResult([]);
66
+ aztec_txe_setTopLevelTXEContext() {
67
+ return callTxeHandler({
68
+ oracle: 'aztec_txe_setTopLevelTXEContext',
69
+ inputs: [],
70
+ handler: ()=>this.stateHandler.enterTopLevelState()
71
+ });
68
72
  }
69
73
  // eslint-disable-next-line camelcase
70
- async aztec_txe_setPrivateTXEContext(foreignContractAddressIsSome, foreignContractAddressValue, foreignAnchorBlockNumberIsSome, foreignAnchorBlockNumberValue) {
71
- const contractAddress = fromSingle(foreignContractAddressIsSome).toBool() ? AztecAddress.fromField(fromSingle(foreignContractAddressValue)) : undefined;
72
- const anchorBlockNumber = fromSingle(foreignAnchorBlockNumberIsSome).toBool() ? BlockNumber(fromSingle(foreignAnchorBlockNumberValue).toNumber()) : undefined;
73
- const privateContextInputs = await this.stateHandler.enterPrivateState(contractAddress, anchorBlockNumber);
74
- return toForeignCallResult(privateContextInputs.toFields().map(toSingle));
74
+ aztec_txe_setPrivateTXEContext(...inputs) {
75
+ return callTxeHandler({
76
+ oracle: 'aztec_txe_setPrivateTXEContext',
77
+ inputs,
78
+ handler: ([contractAddress, anchorBlockNumber, gasSettings])=>this.stateHandler.enterPrivateState(contractAddress, anchorBlockNumber, gasSettings)
79
+ });
75
80
  }
76
81
  // eslint-disable-next-line camelcase
77
- async aztec_txe_setPublicTXEContext(foreignContractAddressIsSome, foreignContractAddressValue) {
78
- const contractAddress = fromSingle(foreignContractAddressIsSome).toBool() ? AztecAddress.fromField(fromSingle(foreignContractAddressValue)) : undefined;
79
- await this.stateHandler.enterPublicState(contractAddress);
80
- return toForeignCallResult([]);
82
+ aztec_txe_setPublicTXEContext(...inputs) {
83
+ return callTxeHandler({
84
+ oracle: 'aztec_txe_setPublicTXEContext',
85
+ inputs,
86
+ handler: ([contractAddress])=>this.stateHandler.enterPublicState(contractAddress)
87
+ });
81
88
  }
82
89
  // eslint-disable-next-line camelcase
83
- async aztec_txe_setUtilityTXEContext(foreignContractAddressIsSome, foreignContractAddressValue) {
84
- const contractAddress = fromSingle(foreignContractAddressIsSome).toBool() ? AztecAddress.fromField(fromSingle(foreignContractAddressValue)) : undefined;
85
- await this.stateHandler.enterUtilityState(contractAddress);
86
- return toForeignCallResult([]);
90
+ aztec_txe_setUtilityTXEContext(...inputs) {
91
+ return callTxeHandler({
92
+ oracle: 'aztec_txe_setUtilityTXEContext',
93
+ inputs,
94
+ handler: ([contractAddress])=>this.stateHandler.enterUtilityState(contractAddress)
95
+ });
87
96
  }
88
97
  // Other oracles - these get handled by the oracle handler
89
98
  // TXE-specific oracles
90
99
  // eslint-disable-next-line camelcase
91
100
  aztec_txe_getDefaultAddress() {
92
- const defaultAddress = this.handlerAsTxe().getDefaultAddress();
93
- return toForeignCallResult([
94
- toSingle(defaultAddress)
95
- ]);
101
+ return callTxeHandler({
102
+ oracle: 'aztec_txe_getDefaultAddress',
103
+ inputs: [],
104
+ handler: ()=>this.handlerAsTxe().getDefaultAddress()
105
+ });
96
106
  }
97
107
  // eslint-disable-next-line camelcase
98
- async aztec_txe_getNextBlockNumber() {
99
- const nextBlockNumber = await this.handlerAsTxe().getNextBlockNumber();
100
- return toForeignCallResult([
101
- toSingle(nextBlockNumber)
102
- ]);
108
+ aztec_txe_getNextBlockNumber() {
109
+ return callTxeHandler({
110
+ oracle: 'aztec_txe_getNextBlockNumber',
111
+ inputs: [],
112
+ handler: ()=>this.handlerAsTxe().getNextBlockNumber()
113
+ });
103
114
  }
104
115
  // eslint-disable-next-line camelcase
105
- async aztec_txe_getNextBlockTimestamp() {
106
- const nextBlockTimestamp = await this.handlerAsTxe().getNextBlockTimestamp();
107
- return toForeignCallResult([
108
- toSingle(nextBlockTimestamp)
109
- ]);
116
+ aztec_txe_getNextBlockTimestamp() {
117
+ return callTxeHandler({
118
+ oracle: 'aztec_txe_getNextBlockTimestamp',
119
+ inputs: [],
120
+ handler: ()=>this.handlerAsTxe().getNextBlockTimestamp()
121
+ });
110
122
  }
111
123
  // eslint-disable-next-line camelcase
112
- async aztec_txe_advanceBlocksBy(foreignBlocks) {
113
- const blocks = fromSingle(foreignBlocks).toNumber();
114
- await this.handlerAsTxe().advanceBlocksBy(blocks);
115
- return toForeignCallResult([]);
124
+ aztec_txe_advanceBlocksBy(...inputs) {
125
+ return callTxeHandler({
126
+ oracle: 'aztec_txe_advanceBlocksBy',
127
+ inputs,
128
+ handler: ([blocks])=>this.handlerAsTxe().advanceBlocksBy(blocks)
129
+ });
116
130
  }
117
131
  // eslint-disable-next-line camelcase
118
- aztec_txe_advanceTimestampBy(foreignDuration) {
119
- const duration = fromSingle(foreignDuration).toBigInt();
120
- this.handlerAsTxe().advanceTimestampBy(duration);
121
- return toForeignCallResult([]);
132
+ aztec_txe_advanceTimestampBy(...inputs) {
133
+ return callTxeHandler({
134
+ oracle: 'aztec_txe_advanceTimestampBy',
135
+ inputs,
136
+ handler: ([duration])=>this.handlerAsTxe().advanceTimestampBy(duration)
137
+ });
122
138
  }
123
139
  // eslint-disable-next-line camelcase
124
- async aztec_txe_deploy(artifact, instance, foreignSecret) {
125
- const secret = fromSingle(foreignSecret);
126
- await this.handlerAsTxe().deploy(artifact, instance, secret);
127
- return toForeignCallResult([
128
- toArray([
129
- instance.salt,
130
- instance.deployer.toField(),
131
- instance.currentContractClassId,
132
- instance.initializationHash,
133
- ...instance.publicKeys.toFields()
134
- ])
135
- ]);
140
+ aztec_txe_deploy(...inputs) {
141
+ return callTxeHandler({
142
+ oracle: 'aztec_txe_deploy',
143
+ inputs,
144
+ handler: ([contractPath, initializer, _, args, secret, salt, deployer])=>this.handlerAsTxe().deploy(contractPath, initializer, args, secret, salt, deployer)
145
+ });
136
146
  }
137
147
  // eslint-disable-next-line camelcase
138
- async aztec_txe_createAccount(foreignSecret) {
139
- const secret = fromSingle(foreignSecret);
140
- const completeAddress = await this.handlerAsTxe().createAccount(secret);
141
- return toForeignCallResult([
142
- toSingle(completeAddress.address),
143
- ...completeAddress.publicKeys.toFields().map(toSingle)
144
- ]);
148
+ aztec_txe_createAccount(...inputs) {
149
+ return callTxeHandler({
150
+ oracle: 'aztec_txe_createAccount',
151
+ inputs,
152
+ handler: ([secret])=>this.handlerAsTxe().createAccount(secret)
153
+ });
145
154
  }
146
155
  // eslint-disable-next-line camelcase
147
- async aztec_txe_addAccount(artifact, instance, foreignSecret) {
148
- const secret = fromSingle(foreignSecret);
149
- const completeAddress = await this.handlerAsTxe().addAccount(artifact, instance, secret);
150
- return toForeignCallResult([
151
- toSingle(completeAddress.address),
152
- ...completeAddress.publicKeys.toFields().map(toSingle)
153
- ]);
156
+ aztec_txe_addAccount(...inputs) {
157
+ return callTxeHandler({
158
+ oracle: 'aztec_txe_addAccount',
159
+ inputs,
160
+ handler: ([secret])=>this.handlerAsTxe().addAccount(secret)
161
+ });
154
162
  }
155
163
  // eslint-disable-next-line camelcase
156
- async aztec_txe_addAuthWitness(foreignAddress, foreignMessageHash) {
157
- const address = addressFromSingle(foreignAddress);
158
- const messageHash = fromSingle(foreignMessageHash);
159
- await this.handlerAsTxe().addAuthWitness(address, messageHash);
160
- return toForeignCallResult([]);
164
+ aztec_txe_addAuthWitness(...inputs) {
165
+ return callTxeHandler({
166
+ oracle: 'aztec_txe_addAuthWitness',
167
+ inputs,
168
+ handler: ([address, messageHash])=>this.handlerAsTxe().addAuthWitness(address, messageHash)
169
+ });
161
170
  }
162
171
  // PXE oracles
163
172
  // eslint-disable-next-line camelcase
164
- aztec_utl_assertCompatibleOracleVersion(foreignVersion) {
165
- const version = fromSingle(foreignVersion).toNumber();
166
- this.handlerAsMisc().assertCompatibleOracleVersion(version);
167
- return toForeignCallResult([]);
173
+ aztec_misc_assertCompatibleOracleVersion(...inputs) {
174
+ return callTxeHandler({
175
+ oracle: 'aztec_misc_assertCompatibleOracleVersion',
176
+ inputs,
177
+ handler: ([major, minor])=>this.handlerAsMisc().assertCompatibleOracleVersion(major, minor)
178
+ });
168
179
  }
169
180
  // eslint-disable-next-line camelcase
170
- aztec_utl_getRandomField() {
171
- const randomField = this.handlerAsMisc().getRandomField();
172
- return toForeignCallResult([
173
- toSingle(randomField)
174
- ]);
181
+ aztec_misc_getRandomField() {
182
+ return callTxeHandler({
183
+ oracle: 'aztec_misc_getRandomField',
184
+ inputs: [],
185
+ handler: ()=>this.handlerAsMisc().getRandomField()
186
+ });
175
187
  }
176
188
  // eslint-disable-next-line camelcase
177
- async aztec_txe_getLastBlockTimestamp() {
178
- const timestamp = await this.handlerAsTxe().getLastBlockTimestamp();
179
- return toForeignCallResult([
180
- toSingle(new Fr(timestamp))
181
- ]);
189
+ aztec_txe_getLastBlockTimestamp() {
190
+ return callTxeHandler({
191
+ oracle: 'aztec_txe_getLastBlockTimestamp',
192
+ inputs: [],
193
+ handler: ()=>this.handlerAsTxe().getLastBlockTimestamp()
194
+ });
182
195
  }
183
196
  // eslint-disable-next-line camelcase
184
- async aztec_txe_getLastTxEffects() {
185
- const { txHash, noteHashes, nullifiers } = await this.handlerAsTxe().getLastTxEffects();
186
- return toForeignCallResult([
187
- toSingle(txHash.hash),
188
- ...arrayToBoundedVec(toArray(noteHashes), MAX_NOTE_HASHES_PER_TX),
189
- ...arrayToBoundedVec(toArray(nullifiers), MAX_NULLIFIERS_PER_TX)
190
- ]);
197
+ aztec_txe_getLastTxEffects() {
198
+ return callTxeHandler({
199
+ oracle: 'aztec_txe_getLastTxEffects',
200
+ inputs: [],
201
+ handler: ()=>this.handlerAsTxe().getLastTxEffects()
202
+ });
191
203
  }
192
204
  // eslint-disable-next-line camelcase
193
- async aztec_txe_getPrivateEvents(foreignSelector, foreignContractAddress, foreignScope) {
194
- const selector = EventSelector.fromField(fromSingle(foreignSelector));
195
- const contractAddress = addressFromSingle(foreignContractAddress);
196
- const scope = addressFromSingle(foreignScope);
197
- // TODO(F-335): Avoid doing the following 2 calls here.
198
- {
199
- await this.handlerAsTxe().syncContractNonOracleMethod(contractAddress, scope, this.stateHandler.getCurrentJob());
200
- // We cycle job to commit the stores after the contract sync.
201
- await this.stateHandler.cycleJob();
202
- }
203
- const events = await this.handlerAsTxe().getPrivateEvents(selector, contractAddress, scope);
204
- if (events.length > MAX_PRIVATE_EVENTS_PER_TXE_QUERY) {
205
- throw new Error(`Array of length ${events.length} larger than maxLen ${MAX_PRIVATE_EVENTS_PER_TXE_QUERY}`);
206
- }
207
- if (events.some((e)=>e.length > MAX_EVENT_LEN)) {
208
- throw new Error(`Some private event has length larger than maxLen ${MAX_EVENT_LEN}`);
209
- }
210
- // This is a workaround as Noir does not currently let us return nested structs with arrays. We instead return a raw
211
- // multidimensional array in get_private_events_oracle and create the BoundedVecs here.
212
- const rawArrayStorage = events.map((e)=>e.concat(Array(MAX_EVENT_LEN - e.length).fill(new Fr(0)))).concat(Array(MAX_PRIVATE_EVENTS_PER_TXE_QUERY - events.length).fill(Array(MAX_EVENT_LEN).fill(new Fr(0)))).flat();
213
- const eventLengths = events.map((e)=>new Fr(e.length)).concat(Array(MAX_PRIVATE_EVENTS_PER_TXE_QUERY - events.length).fill(new Fr(0)));
214
- const queryLength = new Fr(events.length);
215
- return toForeignCallResult([
216
- toArray(rawArrayStorage),
217
- toArray(eventLengths),
218
- toSingle(queryLength)
219
- ]);
220
- }
221
- // eslint-disable-next-line camelcase
222
- aztec_prv_storeInExecutionCache(foreignValues, foreignHash) {
223
- const values = fromArray(foreignValues);
224
- const hash = fromSingle(foreignHash);
225
- this.handlerAsPrivate().storeInExecutionCache(values, hash);
226
- return toForeignCallResult([]);
227
- }
228
- // eslint-disable-next-line camelcase
229
- async aztec_prv_loadFromExecutionCache(foreignHash) {
230
- const hash = fromSingle(foreignHash);
231
- const returns = await this.handlerAsPrivate().loadFromExecutionCache(hash);
232
- return toForeignCallResult([
233
- toArray(returns)
234
- ]);
235
- }
236
- // When the argument is a slice, noir automatically adds a length field to oracle call.
237
- // When the argument is an array, we add the field length manually to the signature.
238
- // eslint-disable-next-line camelcase
239
- async aztec_utl_log(foreignLevel, foreignMessage, _foreignLength, foreignFields) {
240
- const level = fromSingle(foreignLevel).toNumber();
241
- const message = fromArray(foreignMessage).map((field)=>String.fromCharCode(field.toNumber())).join('');
242
- const fields = fromArray(foreignFields);
243
- await this.handlerAsMisc().log(level, message, fields);
244
- return toForeignCallResult([]);
245
- }
246
- // eslint-disable-next-line camelcase
247
- async aztec_utl_storageRead(foreignBlockHash, foreignContractAddress, foreignStartStorageSlot, foreignNumberOfElements) {
248
- const blockHash = new BlockHash(fromSingle(foreignBlockHash));
249
- const contractAddress = addressFromSingle(foreignContractAddress);
250
- const startStorageSlot = fromSingle(foreignStartStorageSlot);
251
- const numberOfElements = fromSingle(foreignNumberOfElements).toNumber();
252
- const values = await this.handlerAsUtility().storageRead(blockHash, contractAddress, startStorageSlot, numberOfElements);
253
- return toForeignCallResult([
254
- toArray(values)
255
- ]);
256
- }
257
- // eslint-disable-next-line camelcase
258
- async aztec_utl_getPublicDataWitness(foreignBlockHash, foreignLeafSlot) {
259
- const blockHash = new BlockHash(fromSingle(foreignBlockHash));
260
- const leafSlot = fromSingle(foreignLeafSlot);
261
- const witness = await this.handlerAsUtility().getPublicDataWitness(blockHash, leafSlot);
262
- if (!witness) {
263
- throw new Error(`Public data witness not found for slot ${leafSlot} at block ${blockHash.toString()}.`);
264
- }
265
- return toForeignCallResult(witness.toNoirRepresentation());
266
- }
267
- // eslint-disable-next-line camelcase
268
- async aztec_utl_getNotes(foreignOwnerIsSome, foreignOwnerValue, foreignStorageSlot, foreignNumSelects, foreignSelectByIndexes, foreignSelectByOffsets, foreignSelectByLengths, foreignSelectValues, foreignSelectComparators, foreignSortByIndexes, foreignSortByOffsets, foreignSortByLengths, foreignSortOrder, foreignLimit, foreignOffset, foreignStatus, foreignMaxNotes, foreignPackedHintedNoteLength) {
269
- // Parse Option<AztecAddress>: ownerIsSome is 0 for None, 1 for Some
270
- const owner = fromSingle(foreignOwnerIsSome).toBool() ? AztecAddress.fromField(fromSingle(foreignOwnerValue)) : undefined;
271
- const storageSlot = fromSingle(foreignStorageSlot);
272
- const numSelects = fromSingle(foreignNumSelects).toNumber();
273
- const selectByIndexes = fromArray(foreignSelectByIndexes).map((fr)=>fr.toNumber());
274
- const selectByOffsets = fromArray(foreignSelectByOffsets).map((fr)=>fr.toNumber());
275
- const selectByLengths = fromArray(foreignSelectByLengths).map((fr)=>fr.toNumber());
276
- const selectValues = fromArray(foreignSelectValues);
277
- const selectComparators = fromArray(foreignSelectComparators).map((fr)=>fr.toNumber());
278
- const sortByIndexes = fromArray(foreignSortByIndexes).map((fr)=>fr.toNumber());
279
- const sortByOffsets = fromArray(foreignSortByOffsets).map((fr)=>fr.toNumber());
280
- const sortByLengths = fromArray(foreignSortByLengths).map((fr)=>fr.toNumber());
281
- const sortOrder = fromArray(foreignSortOrder).map((fr)=>fr.toNumber());
282
- const limit = fromSingle(foreignLimit).toNumber();
283
- const offset = fromSingle(foreignOffset).toNumber();
284
- const status = fromSingle(foreignStatus).toNumber();
285
- const maxNotes = fromSingle(foreignMaxNotes).toNumber();
286
- const packedHintedNoteLength = fromSingle(foreignPackedHintedNoteLength).toNumber();
287
- const noteDatas = await this.handlerAsUtility().getNotes(owner, storageSlot, numSelects, selectByIndexes, selectByOffsets, selectByLengths, selectValues, selectComparators, sortByIndexes, sortByOffsets, sortByLengths, sortOrder, limit, offset, status);
288
- const returnDataAsArrayOfArrays = noteDatas.map((noteData)=>packAsHintedNote({
289
- contractAddress: noteData.contractAddress,
290
- owner: noteData.owner,
291
- randomness: noteData.randomness,
292
- storageSlot: noteData.storageSlot,
293
- noteNonce: noteData.noteNonce,
294
- isPending: noteData.isPending,
295
- note: noteData.note
296
- }));
297
- // Now we convert each sub-array to an array of ForeignCallSingles
298
- const returnDataAsArrayOfForeignCallSingleArrays = returnDataAsArrayOfArrays.map((subArray)=>subArray.map(toSingle));
299
- // At last we convert the array of arrays to a bounded vec of arrays
300
- return toForeignCallResult(arrayOfArraysToBoundedVecOfArrays(returnDataAsArrayOfForeignCallSingleArrays, maxNotes, packedHintedNoteLength));
301
- }
302
- // eslint-disable-next-line camelcase
303
- aztec_prv_notifyCreatedNote(foreignOwner, foreignStorageSlot, foreignRandomness, foreignNoteTypeId, foreignNote, foreignNoteHash, foreignCounter) {
304
- const owner = addressFromSingle(foreignOwner);
305
- const storageSlot = fromSingle(foreignStorageSlot);
306
- const randomness = fromSingle(foreignRandomness);
307
- const noteTypeId = NoteSelector.fromField(fromSingle(foreignNoteTypeId));
308
- const note = fromArray(foreignNote);
309
- const noteHash = fromSingle(foreignNoteHash);
310
- const counter = fromSingle(foreignCounter).toNumber();
311
- this.handlerAsPrivate().notifyCreatedNote(owner, storageSlot, randomness, noteTypeId, note, noteHash, counter);
312
- return toForeignCallResult([]);
313
- }
314
- // eslint-disable-next-line camelcase
315
- async aztec_prv_notifyNullifiedNote(foreignInnerNullifier, foreignNoteHash, foreignCounter) {
316
- const innerNullifier = fromSingle(foreignInnerNullifier);
317
- const noteHash = fromSingle(foreignNoteHash);
318
- const counter = fromSingle(foreignCounter).toNumber();
319
- await this.handlerAsPrivate().notifyNullifiedNote(innerNullifier, noteHash, counter);
320
- return toForeignCallResult([]);
321
- }
322
- // eslint-disable-next-line camelcase
323
- async aztec_prv_notifyCreatedNullifier(foreignInnerNullifier) {
324
- const innerNullifier = fromSingle(foreignInnerNullifier);
325
- await this.handlerAsPrivate().notifyCreatedNullifier(innerNullifier);
326
- return toForeignCallResult([]);
327
- }
328
- // eslint-disable-next-line camelcase
329
- async aztec_prv_isNullifierPending(foreignInnerNullifier, foreignContractAddress) {
330
- const innerNullifier = fromSingle(foreignInnerNullifier);
331
- const contractAddress = addressFromSingle(foreignContractAddress);
332
- const isPending = await this.handlerAsPrivate().isNullifierPending(innerNullifier, contractAddress);
333
- return toForeignCallResult([
334
- toSingle(new Fr(isPending))
335
- ]);
336
- }
337
- // eslint-disable-next-line camelcase
338
- async aztec_utl_checkNullifierExists(foreignInnerNullifier) {
339
- const innerNullifier = fromSingle(foreignInnerNullifier);
340
- const exists = await this.handlerAsUtility().checkNullifierExists(innerNullifier);
341
- return toForeignCallResult([
342
- toSingle(new Fr(exists))
343
- ]);
344
- }
345
- // eslint-disable-next-line camelcase
346
- async aztec_utl_getContractInstance(foreignAddress) {
347
- const address = addressFromSingle(foreignAddress);
348
- const instance = await this.handlerAsUtility().getContractInstance(address);
349
- return toForeignCallResult([
350
- instance.salt,
351
- instance.deployer.toField(),
352
- instance.currentContractClassId,
353
- instance.initializationHash,
354
- ...instance.publicKeys.toFields()
355
- ].map(toSingle));
356
- }
357
- // eslint-disable-next-line camelcase
358
- async aztec_utl_tryGetPublicKeysAndPartialAddress(foreignAddress) {
359
- const address = addressFromSingle(foreignAddress);
360
- const result = await this.handlerAsUtility().tryGetPublicKeysAndPartialAddress(address);
361
- // We are going to return a Noir Option struct to represent the possibility of null values. Options are a struct
362
- // with two fields: `some` (a boolean) and `value` (a field array in this case).
363
- if (result === undefined) {
364
- // No data was found so we set `some` to 0 and pad `value` with zeros get the correct return size.
365
- return toForeignCallResult([
366
- toSingle(new Fr(0)),
367
- toArray(Array(13).fill(new Fr(0)))
368
- ]);
369
- } else {
370
- // Data was found so we set `some` to 1 and return it along with `value`.
371
- return toForeignCallResult([
372
- toSingle(new Fr(1)),
373
- toArray([
374
- ...result.publicKeys.toFields(),
375
- result.partialAddress
376
- ])
377
- ]);
378
- }
205
+ aztec_txe_getLastCallOffchainEffects() {
206
+ return callTxeHandler({
207
+ oracle: 'aztec_txe_getLastCallOffchainEffects',
208
+ inputs: [],
209
+ handler: ()=>this.stateHandler.getLastCallOffchainEffects()
210
+ });
379
211
  }
380
212
  // eslint-disable-next-line camelcase
381
- async aztec_utl_getKeyValidationRequest(foreignPkMHash) {
382
- const pkMHash = fromSingle(foreignPkMHash);
383
- const keyValidationRequest = await this.handlerAsUtility().getKeyValidationRequest(pkMHash);
384
- return toForeignCallResult(keyValidationRequest.toFields().map(toSingle));
213
+ aztec_txe_getLastCallContext() {
214
+ return callTxeHandler({
215
+ oracle: 'aztec_txe_getLastCallContext',
216
+ inputs: [],
217
+ handler: ()=>this.stateHandler.getLastCallContext()
218
+ });
385
219
  }
386
220
  // eslint-disable-next-line camelcase
387
- aztec_prv_callPrivateFunction(_foreignTargetContractAddress, _foreignFunctionSelector, _foreignArgsHash, _foreignSideEffectCounter, _foreignIsStaticCall) {
388
- throw new Error('Contract calls are forbidden inside a `TestEnvironment::private_context`, use `private_call` instead');
221
+ aztec_txe_getPrivateEvents(...inputs) {
222
+ return callTxeHandler({
223
+ oracle: 'aztec_txe_getPrivateEvents',
224
+ inputs,
225
+ handler: ([selector, contractAddress, scope])=>this.stateHandler.getPrivateEvents(selector, contractAddress, scope)
226
+ });
389
227
  }
390
228
  // eslint-disable-next-line camelcase
391
- async aztec_utl_getNullifierMembershipWitness(foreignBlockHash, foreignNullifier) {
392
- const blockHash = new BlockHash(fromSingle(foreignBlockHash));
393
- const nullifier = fromSingle(foreignNullifier);
394
- const witness = await this.handlerAsUtility().getNullifierMembershipWitness(blockHash, nullifier);
395
- if (!witness) {
396
- throw new Error(`Nullifier membership witness not found at block ${blockHash}.`);
397
- }
398
- return toForeignCallResult(witness.toNoirRepresentation());
229
+ aztec_prv_setHashPreimage(...inputs) {
230
+ return callTxeHandler({
231
+ oracle: 'aztec_prv_setHashPreimage',
232
+ inputs,
233
+ handler: ([values, hash])=>this.handlerAsPrivate().setHashPreimage(values, hash)
234
+ });
399
235
  }
400
236
  // eslint-disable-next-line camelcase
401
- async aztec_utl_getAuthWitness(foreignMessageHash) {
402
- const messageHash = fromSingle(foreignMessageHash);
403
- const authWitness = await this.handlerAsUtility().getAuthWitness(messageHash);
404
- if (!authWitness) {
405
- throw new Error(`Auth witness not found for message hash ${messageHash}.`);
406
- }
407
- return toForeignCallResult([
408
- toArray(authWitness)
409
- ]);
237
+ aztec_prv_getHashPreimage(...inputs) {
238
+ return callTxeHandler({
239
+ oracle: 'aztec_prv_getHashPreimage',
240
+ inputs,
241
+ handler: ([hash])=>this.handlerAsPrivate().getHashPreimage(hash)
242
+ });
243
+ }
244
+ // eslint-disable-next-line camelcase
245
+ aztec_misc_log(...inputs) {
246
+ return callTxeHandler({
247
+ oracle: 'aztec_misc_log',
248
+ inputs,
249
+ handler: ([level, message, fieldsSize, fields])=>this.handlerAsMisc().log(level, message, fieldsSize, fields)
250
+ });
251
+ }
252
+ // eslint-disable-next-line camelcase
253
+ aztec_utl_getFromPublicStorage(...inputs) {
254
+ return callTxeHandler({
255
+ oracle: 'aztec_utl_getFromPublicStorage',
256
+ inputs,
257
+ handler: ([blockHash, contractAddress, startStorageSlot, numberOfElements])=>this.handlerAsUtility().getFromPublicStorage(blockHash, contractAddress, startStorageSlot, numberOfElements)
258
+ });
259
+ }
260
+ // eslint-disable-next-line camelcase
261
+ aztec_utl_getPublicDataWitness(...inputs) {
262
+ return callTxeHandler({
263
+ oracle: 'aztec_utl_getPublicDataWitness',
264
+ inputs,
265
+ handler: ([blockHash, leafSlot])=>this.handlerAsUtility().getPublicDataWitness(blockHash, leafSlot)
266
+ });
267
+ }
268
+ // eslint-disable-next-line camelcase
269
+ aztec_utl_getNotes(...inputs) {
270
+ return callTxeHandler({
271
+ oracle: 'aztec_utl_getNotes',
272
+ inputs,
273
+ handler: ([owner, storageSlot, numSelects, selectByIndexes, selectByOffsets, selectByLengths, selectValues, selectComparators, sortByIndexes, sortByOffsets, sortByLengths, sortOrder, limit, offset, status, maxNotes, packedHintedNoteLength])=>this.handlerAsUtility().getNotes(owner, storageSlot, numSelects, selectByIndexes, selectByOffsets, selectByLengths, selectValues, selectComparators, sortByIndexes, sortByOffsets, sortByLengths, sortOrder, limit, offset, status, maxNotes, packedHintedNoteLength)
274
+ });
275
+ }
276
+ // eslint-disable-next-line camelcase
277
+ aztec_prv_notifyCreatedNote(...inputs) {
278
+ return callTxeHandler({
279
+ oracle: 'aztec_prv_notifyCreatedNote',
280
+ inputs,
281
+ handler: ([owner, storageSlot, randomness, noteTypeId, note, noteHash, counter])=>this.handlerAsPrivate().notifyCreatedNote(owner, storageSlot, randomness, noteTypeId, note, noteHash, counter)
282
+ });
283
+ }
284
+ // eslint-disable-next-line camelcase
285
+ aztec_prv_notifyNullifiedNote(...inputs) {
286
+ return callTxeHandler({
287
+ oracle: 'aztec_prv_notifyNullifiedNote',
288
+ inputs,
289
+ handler: ([innerNullifier, noteHash, counter])=>this.handlerAsPrivate().notifyNullifiedNote(innerNullifier, noteHash, counter)
290
+ });
291
+ }
292
+ // eslint-disable-next-line camelcase
293
+ aztec_prv_notifyCreatedNullifier(...inputs) {
294
+ return callTxeHandler({
295
+ oracle: 'aztec_prv_notifyCreatedNullifier',
296
+ inputs,
297
+ handler: ([innerNullifier])=>this.handlerAsPrivate().notifyCreatedNullifier(innerNullifier)
298
+ });
410
299
  }
411
300
  // eslint-disable-next-line camelcase
412
- aztec_prv_validatePublicCalldata(_foreignCalldataHash) {
413
- throw new Error('Enqueueing public calls is not supported in TestEnvironment::private_context');
301
+ aztec_prv_isNullifierPending(...inputs) {
302
+ return callTxeHandler({
303
+ oracle: 'aztec_prv_isNullifierPending',
304
+ inputs,
305
+ handler: ([innerNullifier, contractAddress])=>this.handlerAsPrivate().isNullifierPending(innerNullifier, contractAddress)
306
+ });
414
307
  }
415
308
  // eslint-disable-next-line camelcase
416
- aztec_prv_notifyRevertiblePhaseStart(_foreignMinRevertibleSideEffectCounter) {
417
- throw new Error('Enqueueing public calls is not supported in TestEnvironment::private_context');
309
+ aztec_utl_doesNullifierExist(...inputs) {
310
+ return callTxeHandler({
311
+ oracle: 'aztec_utl_doesNullifierExist',
312
+ inputs,
313
+ handler: ([innerNullifier])=>this.handlerAsUtility().doesNullifierExist(innerNullifier)
314
+ });
418
315
  }
419
316
  // eslint-disable-next-line camelcase
420
- async aztec_prv_inRevertiblePhase(foreignSideEffectCounter) {
421
- const sideEffectCounter = fromSingle(foreignSideEffectCounter).toNumber();
422
- const isRevertible = await this.handlerAsPrivate().inRevertiblePhase(sideEffectCounter);
423
- return toForeignCallResult([
424
- toSingle(new Fr(isRevertible))
425
- ]);
317
+ aztec_utl_getContractInstance(...inputs) {
318
+ return callTxeHandler({
319
+ oracle: 'aztec_utl_getContractInstance',
320
+ inputs,
321
+ handler: ([address])=>this.handlerAsUtility().getContractInstance(address)
322
+ });
323
+ }
324
+ // eslint-disable-next-line camelcase
325
+ aztec_utl_getPublicKeysAndPartialAddress(...inputs) {
326
+ return callTxeHandler({
327
+ oracle: 'aztec_utl_getPublicKeysAndPartialAddress',
328
+ inputs,
329
+ handler: ([address])=>this.handlerAsUtility().getPublicKeysAndPartialAddress(address)
330
+ });
331
+ }
332
+ // eslint-disable-next-line camelcase
333
+ aztec_utl_getKeyValidationRequest(...inputs) {
334
+ return callTxeHandler({
335
+ oracle: 'aztec_utl_getKeyValidationRequest',
336
+ inputs,
337
+ handler: ([pkMHash])=>this.handlerAsUtility().getKeyValidationRequest(pkMHash)
338
+ });
339
+ }
340
+ // eslint-disable-next-line camelcase
341
+ aztec_prv_callPrivateFunction(...inputs) {
342
+ return callTxeHandler({
343
+ oracle: 'aztec_prv_callPrivateFunction',
344
+ inputs,
345
+ handler: ([contractAddress, functionSelector, argsHash, sideEffectCounter, isStaticCall])=>this.handlerAsPrivate().callPrivateFunction(contractAddress, functionSelector, argsHash, sideEffectCounter, isStaticCall)
346
+ });
347
+ }
348
+ // eslint-disable-next-line camelcase
349
+ aztec_utl_getNullifierMembershipWitness(...inputs) {
350
+ return callTxeHandler({
351
+ oracle: 'aztec_utl_getNullifierMembershipWitness',
352
+ inputs,
353
+ handler: ([blockHash, nullifier])=>this.handlerAsUtility().getNullifierMembershipWitness(blockHash, nullifier)
354
+ });
355
+ }
356
+ // eslint-disable-next-line camelcase
357
+ aztec_utl_getAuthWitness(...inputs) {
358
+ return callTxeHandler({
359
+ oracle: 'aztec_utl_getAuthWitness',
360
+ inputs,
361
+ handler: ([messageHash])=>this.handlerAsUtility().getAuthWitness(messageHash)
362
+ });
363
+ }
364
+ // eslint-disable-next-line camelcase
365
+ aztec_prv_assertValidPublicCalldata(...inputs) {
366
+ return callTxeHandler({
367
+ oracle: 'aztec_prv_assertValidPublicCalldata',
368
+ inputs,
369
+ handler: ([calldataHash])=>this.handlerAsPrivate().assertValidPublicCalldata(calldataHash)
370
+ });
371
+ }
372
+ // eslint-disable-next-line camelcase
373
+ aztec_prv_notifyRevertiblePhaseStart(...inputs) {
374
+ return callTxeHandler({
375
+ oracle: 'aztec_prv_notifyRevertiblePhaseStart',
376
+ inputs,
377
+ handler: ([minRevertibleSideEffectCounter])=>this.handlerAsPrivate().notifyRevertiblePhaseStart(minRevertibleSideEffectCounter)
378
+ });
379
+ }
380
+ // eslint-disable-next-line camelcase
381
+ aztec_prv_isExecutionInRevertiblePhase(...inputs) {
382
+ return callTxeHandler({
383
+ oracle: 'aztec_prv_isExecutionInRevertiblePhase',
384
+ inputs,
385
+ handler: ([sideEffectCounter])=>this.handlerAsPrivate().isExecutionInRevertiblePhase(sideEffectCounter)
386
+ });
426
387
  }
427
388
  // eslint-disable-next-line camelcase
428
389
  aztec_utl_getUtilityContext() {
429
- const context = this.handlerAsUtility().getUtilityContext();
430
- return toForeignCallResult(context.toNoirRepresentation());
390
+ return callTxeHandler({
391
+ oracle: 'aztec_utl_getUtilityContext',
392
+ inputs: [],
393
+ handler: ()=>this.handlerAsUtility().getUtilityContext()
394
+ });
431
395
  }
432
396
  // eslint-disable-next-line camelcase
433
- async aztec_utl_getBlockHeader(foreignBlockNumber) {
434
- const blockNumber = BlockNumber(fromSingle(foreignBlockNumber).toNumber());
435
- const header = await this.handlerAsUtility().getBlockHeader(blockNumber);
436
- if (!header) {
437
- throw new Error(`Block header not found for block ${blockNumber}.`);
438
- }
439
- return toForeignCallResult(header.toFields().map(toSingle));
397
+ aztec_utl_getBlockHeader(...inputs) {
398
+ return callTxeHandler({
399
+ oracle: 'aztec_utl_getBlockHeader',
400
+ inputs,
401
+ handler: ([blockNumber])=>this.handlerAsUtility().getBlockHeader(blockNumber)
402
+ });
440
403
  }
441
404
  // eslint-disable-next-line camelcase
442
- async aztec_utl_getNoteHashMembershipWitness(foreignAnchorBlockHash, foreignNoteHash) {
443
- const blockHash = new BlockHash(fromSingle(foreignAnchorBlockHash));
444
- const noteHash = fromSingle(foreignNoteHash);
445
- const witness = await this.handlerAsUtility().getNoteHashMembershipWitness(blockHash, noteHash);
446
- if (!witness) {
447
- throw new Error(`Note hash ${noteHash} not found in the note hash tree at block ${blockHash.toString()}.`);
448
- }
449
- return toForeignCallResult(witness.toNoirRepresentation());
405
+ aztec_utl_getNoteHashMembershipWitness(...inputs) {
406
+ return callTxeHandler({
407
+ oracle: 'aztec_utl_getNoteHashMembershipWitness',
408
+ inputs,
409
+ handler: ([blockHash, noteHash])=>this.handlerAsUtility().getNoteHashMembershipWitness(blockHash, noteHash)
410
+ });
450
411
  }
451
412
  // eslint-disable-next-line camelcase
452
- async aztec_utl_getBlockHashMembershipWitness(foreignAnchorBlockHash, foreignBlockHash) {
453
- const anchorBlockHash = new BlockHash(fromSingle(foreignAnchorBlockHash));
454
- const blockHash = new BlockHash(fromSingle(foreignBlockHash));
455
- const witness = await this.handlerAsUtility().getBlockHashMembershipWitness(anchorBlockHash, blockHash);
456
- if (!witness) {
457
- throw new Error(`Block hash ${blockHash.toString()} not found in the archive tree at anchor block ${anchorBlockHash.toString()}.`);
458
- }
459
- return toForeignCallResult(witness.toNoirRepresentation());
413
+ aztec_utl_getBlockHashMembershipWitness(...inputs) {
414
+ return callTxeHandler({
415
+ oracle: 'aztec_utl_getBlockHashMembershipWitness',
416
+ inputs,
417
+ handler: ([anchorBlockHash, blockHash])=>this.handlerAsUtility().getBlockHashMembershipWitness(anchorBlockHash, blockHash)
418
+ });
460
419
  }
461
420
  // eslint-disable-next-line camelcase
462
- async aztec_utl_getLowNullifierMembershipWitness(foreignBlockHash, foreignNullifier) {
463
- const blockHash = new BlockHash(fromSingle(foreignBlockHash));
464
- const nullifier = fromSingle(foreignNullifier);
465
- const witness = await this.handlerAsUtility().getLowNullifierMembershipWitness(blockHash, nullifier);
466
- if (!witness) {
467
- throw new Error(`Low nullifier witness not found for nullifier ${nullifier} at block ${blockHash}.`);
468
- }
469
- return toForeignCallResult(witness.toNoirRepresentation());
470
- }
471
- // eslint-disable-next-line camelcase
472
- async aztec_utl_fetchTaggedLogs(foreignPendingTaggedLogArrayBaseSlot) {
473
- const pendingTaggedLogArrayBaseSlot = fromSingle(foreignPendingTaggedLogArrayBaseSlot);
474
- await this.handlerAsUtility().fetchTaggedLogs(pendingTaggedLogArrayBaseSlot);
475
- return toForeignCallResult([]);
476
- }
477
- // eslint-disable-next-line camelcase
478
- async aztec_utl_validateAndStoreEnqueuedNotesAndEvents(foreignContractAddress, foreignNoteValidationRequestsArrayBaseSlot, foreignEventValidationRequestsArrayBaseSlot, foreignMaxNotePackedLen, foreignMaxEventSerializedLen) {
479
- const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
480
- const noteValidationRequestsArrayBaseSlot = fromSingle(foreignNoteValidationRequestsArrayBaseSlot);
481
- const eventValidationRequestsArrayBaseSlot = fromSingle(foreignEventValidationRequestsArrayBaseSlot);
482
- const maxNotePackedLen = fromSingle(foreignMaxNotePackedLen).toNumber();
483
- const maxEventSerializedLen = fromSingle(foreignMaxEventSerializedLen).toNumber();
484
- await this.handlerAsUtility().validateAndStoreEnqueuedNotesAndEvents(contractAddress, noteValidationRequestsArrayBaseSlot, eventValidationRequestsArrayBaseSlot, maxNotePackedLen, maxEventSerializedLen);
485
- return toForeignCallResult([]);
486
- }
487
- // eslint-disable-next-line camelcase
488
- async aztec_utl_bulkRetrieveLogs(foreignContractAddress, foreignLogRetrievalRequestsArrayBaseSlot, foreignLogRetrievalResponsesArrayBaseSlot) {
489
- const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
490
- const logRetrievalRequestsArrayBaseSlot = fromSingle(foreignLogRetrievalRequestsArrayBaseSlot);
491
- const logRetrievalResponsesArrayBaseSlot = fromSingle(foreignLogRetrievalResponsesArrayBaseSlot);
492
- await this.handlerAsUtility().bulkRetrieveLogs(contractAddress, logRetrievalRequestsArrayBaseSlot, logRetrievalResponsesArrayBaseSlot);
493
- return toForeignCallResult([]);
494
- }
495
- // eslint-disable-next-line camelcase
496
- async aztec_utl_utilityResolveMessageContexts(foreignContractAddress, foreignMessageContextRequestsArrayBaseSlot, foreignMessageContextResponsesArrayBaseSlot) {
497
- const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
498
- const messageContextRequestsArrayBaseSlot = fromSingle(foreignMessageContextRequestsArrayBaseSlot);
499
- const messageContextResponsesArrayBaseSlot = fromSingle(foreignMessageContextResponsesArrayBaseSlot);
500
- await this.handlerAsUtility().utilityResolveMessageContexts(contractAddress, messageContextRequestsArrayBaseSlot, messageContextResponsesArrayBaseSlot);
501
- return toForeignCallResult([]);
502
- }
503
- // eslint-disable-next-line camelcase
504
- async aztec_utl_storeCapsule(foreignContractAddress, foreignSlot, foreignCapsule) {
505
- const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
506
- const slot = fromSingle(foreignSlot);
507
- const capsule = fromArray(foreignCapsule);
508
- await this.handlerAsUtility().storeCapsule(contractAddress, slot, capsule);
509
- return toForeignCallResult([]);
510
- }
511
- // eslint-disable-next-line camelcase
512
- async aztec_utl_loadCapsule(foreignContractAddress, foreignSlot, foreignTSize) {
513
- const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
514
- const slot = fromSingle(foreignSlot);
515
- const tSize = fromSingle(foreignTSize).toNumber();
516
- const values = await this.handlerAsUtility().loadCapsule(contractAddress, slot);
517
- // We are going to return a Noir Option struct to represent the possibility of null values. Options are a struct
518
- // with two fields: `some` (a boolean) and `value` (a field array in this case).
519
- if (values === null) {
520
- // No data was found so we set `some` to 0 and pad `value` with zeros get the correct return size.
521
- return toForeignCallResult([
522
- toSingle(new Fr(0)),
523
- toArray(Array(tSize).fill(new Fr(0)))
524
- ]);
525
- } else {
526
- // Data was found so we set `some` to 1 and return it along with `value`.
527
- return toForeignCallResult([
528
- toSingle(new Fr(1)),
529
- toArray(values)
530
- ]);
531
- }
421
+ aztec_utl_getLowNullifierMembershipWitness(...inputs) {
422
+ return callTxeHandler({
423
+ oracle: 'aztec_utl_getLowNullifierMembershipWitness',
424
+ inputs,
425
+ handler: ([blockHash, nullifier])=>this.handlerAsUtility().getLowNullifierMembershipWitness(blockHash, nullifier)
426
+ });
532
427
  }
533
428
  // eslint-disable-next-line camelcase
534
- async aztec_utl_deleteCapsule(foreignContractAddress, foreignSlot) {
535
- const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
536
- const slot = fromSingle(foreignSlot);
537
- await this.handlerAsUtility().deleteCapsule(contractAddress, slot);
538
- return toForeignCallResult([]);
429
+ aztec_utl_getPendingTaggedLogs(...inputs) {
430
+ return callTxeHandler({
431
+ oracle: 'aztec_utl_getPendingTaggedLogs',
432
+ inputs,
433
+ handler: ([scope, providedSecrets])=>this.handlerAsUtility().getPendingTaggedLogs(scope, providedSecrets)
434
+ });
539
435
  }
540
436
  // eslint-disable-next-line camelcase
541
- async aztec_utl_copyCapsule(foreignContractAddress, foreignSrcSlot, foreignDstSlot, foreignNumEntries) {
542
- const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
543
- const srcSlot = fromSingle(foreignSrcSlot);
544
- const dstSlot = fromSingle(foreignDstSlot);
545
- const numEntries = fromSingle(foreignNumEntries).toNumber();
546
- await this.handlerAsUtility().copyCapsule(contractAddress, srcSlot, dstSlot, numEntries);
547
- return toForeignCallResult([]);
437
+ aztec_utl_validateAndStoreEnqueuedNotesAndEvents(...inputs) {
438
+ return callTxeHandler({
439
+ oracle: 'aztec_utl_validateAndStoreEnqueuedNotesAndEvents',
440
+ inputs,
441
+ handler: ([noteValidationRequests, eventValidationRequests, scope])=>this.handlerAsUtility().validateAndStoreEnqueuedNotesAndEvents(noteValidationRequests, eventValidationRequests, scope)
442
+ });
548
443
  }
549
- // TODO: I forgot to add a corresponding function here, when I introduced an oracle method to txe_oracle.ts.
550
- // The compiler didn't throw an error, so it took me a while to learn of the existence of this file, and that I need
551
- // to implement this function here. Isn't there a way to programmatically identify that this is missing, given the
552
- // existence of a txe_oracle method?
553
444
  // eslint-disable-next-line camelcase
554
- async aztec_utl_tryAes128Decrypt(foreignCiphertextBVecStorage, foreignCiphertextLength, foreignIv, foreignSymKey) {
555
- const ciphertext = fromUintBoundedVec(foreignCiphertextBVecStorage, foreignCiphertextLength, 8);
556
- const iv = fromUintArray(foreignIv, 8);
557
- const symKey = fromUintArray(foreignSymKey, 8);
558
- // Noir Option<BoundedVec> is encoded as [is_some: Field, storage: Field[], length: Field].
559
- try {
560
- const plaintextBuffer = await this.handlerAsUtility().aes128Decrypt(ciphertext, iv, symKey);
561
- const [storage, length] = arrayToBoundedVec(bufferToU8Array(plaintextBuffer), foreignCiphertextBVecStorage.length);
562
- return toForeignCallResult([
563
- toSingle(new Fr(1)),
564
- storage,
565
- length
566
- ]);
567
- } catch {
568
- const zeroStorage = toArray(Array(foreignCiphertextBVecStorage.length).fill(new Fr(0)));
569
- return toForeignCallResult([
570
- toSingle(new Fr(0)),
571
- zeroStorage,
572
- toSingle(new Fr(0))
573
- ]);
574
- }
445
+ aztec_utl_getLogsByTag(...inputs) {
446
+ return callTxeHandler({
447
+ oracle: 'aztec_utl_getLogsByTag',
448
+ inputs,
449
+ handler: ([requestArrayBaseSlot])=>this.handlerAsUtility().getLogsByTag(requestArrayBaseSlot)
450
+ });
575
451
  }
576
452
  // eslint-disable-next-line camelcase
577
- async aztec_utl_getSharedSecret(foreignAddress, foreignEphPKField0, foreignEphPKField1, foreignEphPKField2) {
578
- const address = AztecAddress.fromField(fromSingle(foreignAddress));
579
- const ephPK = Point.fromFields([
580
- fromSingle(foreignEphPKField0),
581
- fromSingle(foreignEphPKField1),
582
- fromSingle(foreignEphPKField2)
583
- ]);
584
- const secret = await this.handlerAsUtility().getSharedSecret(address, ephPK);
585
- return toForeignCallResult(secret.toFields().map(toSingle));
453
+ aztec_utl_getMessageContextsByTxHash(...inputs) {
454
+ return callTxeHandler({
455
+ oracle: 'aztec_utl_getMessageContextsByTxHash',
456
+ inputs,
457
+ handler: ([requestArrayBaseSlot])=>this.handlerAsUtility().getMessageContextsByTxHash(requestArrayBaseSlot)
458
+ });
586
459
  }
587
460
  // eslint-disable-next-line camelcase
588
- aztec_utl_invalidateContractSyncCache(foreignContractAddress, foreignScopes, foreignScopeCount) {
589
- const contractAddress = addressFromSingle(foreignContractAddress);
590
- const count = fromSingle(foreignScopeCount).toNumber();
591
- const scopes = fromArray(foreignScopes).slice(0, count).map((f)=>new AztecAddress(f));
592
- this.handlerAsUtility().invalidateContractSyncCache(contractAddress, scopes);
593
- return Promise.resolve(toForeignCallResult([]));
461
+ aztec_utl_setCapsule(...inputs) {
462
+ return callTxeHandler({
463
+ oracle: 'aztec_utl_setCapsule',
464
+ inputs,
465
+ handler: ([contractAddress, slot, capsule, scope])=>this.handlerAsUtility().setCapsule(contractAddress, slot, capsule, scope)
466
+ });
594
467
  }
595
468
  // eslint-disable-next-line camelcase
596
- aztec_utl_emitOffchainEffect(_foreignData) {
597
- throw new Error('Offchain effects are not yet supported in the TestEnvironment');
469
+ aztec_utl_getCapsule(...inputs) {
470
+ return callTxeHandler({
471
+ oracle: 'aztec_utl_getCapsule',
472
+ inputs,
473
+ handler: ([contractAddress, slot, tSize, scope])=>this.handlerAsUtility().getCapsule(contractAddress, slot, tSize, scope)
474
+ });
598
475
  }
599
- // AVM opcodes
600
476
  // eslint-disable-next-line camelcase
601
- aztec_avm_emitPublicLog(_foreignMessage) {
602
- // TODO(#8811): Implement
603
- return toForeignCallResult([]);
477
+ aztec_utl_deleteCapsule(...inputs) {
478
+ return callTxeHandler({
479
+ oracle: 'aztec_utl_deleteCapsule',
480
+ inputs,
481
+ handler: ([contractAddress, slot, scope])=>this.handlerAsUtility().deleteCapsule(contractAddress, slot, scope)
482
+ });
604
483
  }
605
484
  // eslint-disable-next-line camelcase
606
- async aztec_avm_storageRead(foreignSlot, foreignContractAddress) {
607
- const slot = fromSingle(foreignSlot);
608
- const contractAddress = AztecAddress.fromField(fromSingle(foreignContractAddress));
609
- const value = (await this.handlerAsAvm().storageRead(slot, contractAddress)).value;
610
- return toForeignCallResult([
611
- toSingle(new Fr(value))
612
- ]);
485
+ aztec_utl_copyCapsule(...inputs) {
486
+ return callTxeHandler({
487
+ oracle: 'aztec_utl_copyCapsule',
488
+ inputs,
489
+ handler: ([contractAddress, srcSlot, dstSlot, numEntries, scope])=>this.handlerAsUtility().copyCapsule(contractAddress, srcSlot, dstSlot, numEntries, scope)
490
+ });
613
491
  }
614
492
  // eslint-disable-next-line camelcase
615
- async aztec_avm_storageWrite(foreignSlot, foreignValue) {
616
- const slot = fromSingle(foreignSlot);
617
- const value = fromSingle(foreignValue);
618
- await this.handlerAsAvm().storageWrite(slot, value);
619
- return toForeignCallResult([]);
493
+ aztec_utl_pushEphemeral(...inputs) {
494
+ return callTxeHandler({
495
+ oracle: 'aztec_utl_pushEphemeral',
496
+ inputs,
497
+ handler: ([slot, elements])=>this.handlerAsUtility().pushEphemeral(slot, elements)
498
+ });
620
499
  }
621
500
  // eslint-disable-next-line camelcase
622
- async aztec_avm_getContractInstanceDeployer(foreignAddress) {
623
- const address = addressFromSingle(foreignAddress);
624
- const instance = await this.handlerAsUtility().getContractInstance(address);
625
- return toForeignCallResult([
626
- toSingle(instance.deployer),
627
- // AVM requires an extra boolean indicating the instance was found
628
- toSingle(new Fr(1))
629
- ]);
501
+ aztec_utl_popEphemeral(...inputs) {
502
+ return callTxeHandler({
503
+ oracle: 'aztec_utl_popEphemeral',
504
+ inputs,
505
+ handler: ([slot])=>this.handlerAsUtility().popEphemeral(slot)
506
+ });
630
507
  }
631
508
  // eslint-disable-next-line camelcase
632
- async aztec_avm_getContractInstanceClassId(foreignAddress) {
633
- const address = addressFromSingle(foreignAddress);
634
- const instance = await this.handlerAsUtility().getContractInstance(address);
635
- return toForeignCallResult([
636
- toSingle(instance.currentContractClassId),
637
- // AVM requires an extra boolean indicating the instance was found
638
- toSingle(new Fr(1))
639
- ]);
509
+ aztec_utl_getEphemeral(...inputs) {
510
+ return callTxeHandler({
511
+ oracle: 'aztec_utl_getEphemeral',
512
+ inputs,
513
+ handler: ([slot, index])=>this.handlerAsUtility().getEphemeral(slot, index)
514
+ });
640
515
  }
641
516
  // eslint-disable-next-line camelcase
642
- async aztec_avm_getContractInstanceInitializationHash(foreignAddress) {
643
- const address = addressFromSingle(foreignAddress);
644
- const instance = await this.handlerAsUtility().getContractInstance(address);
645
- return toForeignCallResult([
646
- toSingle(instance.initializationHash),
647
- // AVM requires an extra boolean indicating the instance was found
648
- toSingle(new Fr(1))
649
- ]);
517
+ aztec_utl_setEphemeral(...inputs) {
518
+ return callTxeHandler({
519
+ oracle: 'aztec_utl_setEphemeral',
520
+ inputs,
521
+ handler: ([slot, index, elements])=>this.handlerAsUtility().setEphemeral(slot, index, elements)
522
+ });
650
523
  }
651
524
  // eslint-disable-next-line camelcase
652
- async aztec_avm_sender() {
653
- const sender = await this.handlerAsAvm().sender();
654
- return toForeignCallResult([
655
- toSingle(sender)
656
- ]);
525
+ aztec_utl_getEphemeralLen(...inputs) {
526
+ return callTxeHandler({
527
+ oracle: 'aztec_utl_getEphemeralLen',
528
+ inputs,
529
+ handler: ([slot])=>this.handlerAsUtility().getEphemeralLen(slot)
530
+ });
657
531
  }
658
532
  // eslint-disable-next-line camelcase
659
- async aztec_avm_emitNullifier(foreignNullifier) {
660
- const nullifier = fromSingle(foreignNullifier);
661
- await this.handlerAsAvm().emitNullifier(nullifier);
662
- return toForeignCallResult([]);
533
+ aztec_utl_removeEphemeral(...inputs) {
534
+ return callTxeHandler({
535
+ oracle: 'aztec_utl_removeEphemeral',
536
+ inputs,
537
+ handler: ([slot, index])=>this.handlerAsUtility().removeEphemeral(slot, index)
538
+ });
663
539
  }
664
540
  // eslint-disable-next-line camelcase
665
- async aztec_avm_emitNoteHash(foreignNoteHash) {
666
- const noteHash = fromSingle(foreignNoteHash);
667
- await this.handlerAsAvm().emitNoteHash(noteHash);
668
- return toForeignCallResult([]);
541
+ aztec_utl_clearEphemeral(...inputs) {
542
+ return callTxeHandler({
543
+ oracle: 'aztec_utl_clearEphemeral',
544
+ inputs,
545
+ handler: ([slot])=>this.handlerAsUtility().clearEphemeral(slot)
546
+ });
669
547
  }
670
548
  // eslint-disable-next-line camelcase
671
- async aztec_avm_nullifierExists(foreignSiloedNullifier) {
672
- const siloedNullifier = fromSingle(foreignSiloedNullifier);
673
- const exists = await this.handlerAsAvm().nullifierExists(siloedNullifier);
674
- return toForeignCallResult([
675
- toSingle(new Fr(exists))
676
- ]);
549
+ aztec_utl_pushTransient(...inputs) {
550
+ return callTxeHandler({
551
+ oracle: 'aztec_utl_pushTransient',
552
+ inputs,
553
+ handler: ([slot, elements])=>this.handlerAsUtility().pushTransient(slot, elements)
554
+ });
677
555
  }
678
556
  // eslint-disable-next-line camelcase
679
- async aztec_avm_address() {
680
- const contractAddress = await this.handlerAsAvm().address();
681
- return toForeignCallResult([
682
- toSingle(contractAddress.toField())
683
- ]);
557
+ aztec_utl_popTransient(...inputs) {
558
+ return callTxeHandler({
559
+ oracle: 'aztec_utl_popTransient',
560
+ inputs,
561
+ handler: ([slot])=>this.handlerAsUtility().popTransient(slot)
562
+ });
684
563
  }
685
564
  // eslint-disable-next-line camelcase
686
- async aztec_avm_blockNumber() {
687
- const blockNumber = await this.handlerAsAvm().blockNumber();
688
- return toForeignCallResult([
689
- toSingle(new Fr(blockNumber))
690
- ]);
565
+ aztec_utl_getTransient(...inputs) {
566
+ return callTxeHandler({
567
+ oracle: 'aztec_utl_getTransient',
568
+ inputs,
569
+ handler: ([slot, index])=>this.handlerAsUtility().getTransient(slot, index)
570
+ });
691
571
  }
692
572
  // eslint-disable-next-line camelcase
693
- async aztec_avm_timestamp() {
694
- const timestamp = await this.handlerAsAvm().timestamp();
695
- return toForeignCallResult([
696
- toSingle(new Fr(timestamp))
697
- ]);
573
+ aztec_utl_setTransient(...inputs) {
574
+ return callTxeHandler({
575
+ oracle: 'aztec_utl_setTransient',
576
+ inputs,
577
+ handler: ([slot, index, elements])=>this.handlerAsUtility().setTransient(slot, index, elements)
578
+ });
698
579
  }
699
580
  // eslint-disable-next-line camelcase
700
- async aztec_avm_isStaticCall() {
701
- const isStaticCall = await this.handlerAsAvm().isStaticCall();
702
- return toForeignCallResult([
703
- toSingle(new Fr(isStaticCall ? 1 : 0))
704
- ]);
581
+ aztec_utl_getTransientLen(...inputs) {
582
+ return callTxeHandler({
583
+ oracle: 'aztec_utl_getTransientLen',
584
+ inputs,
585
+ handler: ([slot])=>this.handlerAsUtility().getTransientLen(slot)
586
+ });
705
587
  }
706
588
  // eslint-disable-next-line camelcase
707
- async aztec_avm_chainId() {
708
- const chainId = await this.handlerAsAvm().chainId();
709
- return toForeignCallResult([
710
- toSingle(chainId)
711
- ]);
589
+ aztec_utl_removeTransient(...inputs) {
590
+ return callTxeHandler({
591
+ oracle: 'aztec_utl_removeTransient',
592
+ inputs,
593
+ handler: ([slot, index])=>this.handlerAsUtility().removeTransient(slot, index)
594
+ });
712
595
  }
713
596
  // eslint-disable-next-line camelcase
714
- async aztec_avm_version() {
715
- const version = await this.handlerAsAvm().version();
716
- return toForeignCallResult([
717
- toSingle(version)
718
- ]);
597
+ aztec_utl_clearTransient(...inputs) {
598
+ return callTxeHandler({
599
+ oracle: 'aztec_utl_clearTransient',
600
+ inputs,
601
+ handler: ([slot])=>this.handlerAsUtility().clearTransient(slot)
602
+ });
719
603
  }
604
+ // TODO: I forgot to add a corresponding function here, when I introduced an oracle method to txe_oracle.ts.
605
+ // The compiler didn't throw an error, so it took me a while to learn of the existence of this file, and that I need
606
+ // to implement this function here. Isn't there a way to programmatically identify that this is missing, given the
607
+ // existence of a txe_oracle method?
720
608
  // eslint-disable-next-line camelcase
721
- aztec_avm_returndataSize() {
722
- throw new Error('Contract calls are forbidden inside a `TestEnvironment::public_context`, use `public_call` instead');
609
+ aztec_utl_decryptAes128(...inputs) {
610
+ return callTxeHandler({
611
+ oracle: 'aztec_utl_decryptAes128',
612
+ inputs,
613
+ handler: ([ciphertext, iv, symKey])=>this.handlerAsUtility().decryptAes128(ciphertext, iv, symKey)
614
+ });
615
+ }
616
+ // eslint-disable-next-line camelcase
617
+ aztec_utl_getSharedSecrets(...inputs) {
618
+ return callTxeHandler({
619
+ oracle: 'aztec_utl_getSharedSecrets',
620
+ inputs,
621
+ handler: ([address, ephPksSlot, contractAddress])=>this.handlerAsUtility().getSharedSecrets(address, ephPksSlot, contractAddress)
622
+ });
623
+ }
624
+ // eslint-disable-next-line camelcase
625
+ aztec_utl_setContractSyncCacheInvalid(...inputs) {
626
+ return callTxeHandler({
627
+ oracle: 'aztec_utl_setContractSyncCacheInvalid',
628
+ inputs,
629
+ handler: ([contractAddress, scopes])=>this.handlerAsUtility().setContractSyncCacheInvalid(contractAddress, scopes)
630
+ });
631
+ }
632
+ // eslint-disable-next-line camelcase
633
+ aztec_utl_emitOffchainEffect(...inputs) {
634
+ return callTxeHandler({
635
+ oracle: 'aztec_utl_emitOffchainEffect',
636
+ inputs,
637
+ handler: ([data])=>{
638
+ // Record the raw payload against the currently-executing top-level call. The Noir side
639
+ // (via `env.offchain_messages()`) is responsible for decoding the protocol-reserved prefix
640
+ // (`OFFCHAIN_MESSAGE_IDENTIFIER`, recipient) and turning each payload into an `OffchainMessage` struct suitable
641
+ // for `offchain_receive`.
642
+ this.stateHandler.recordOffchainEffect(data);
643
+ }
644
+ });
723
645
  }
646
+ // AVM opcodes
724
647
  // eslint-disable-next-line camelcase
725
- aztec_avm_returndataCopy(_foreignRdOffset, _foreignCopySize) {
726
- throw new Error('Contract calls are forbidden inside a `TestEnvironment::public_context`, use `public_call` instead');
648
+ aztec_avm_emitPublicLog() {
649
+ return callTxeHandler({
650
+ oracle: 'aztec_avm_emitPublicLog',
651
+ inputs: [],
652
+ // TODO(#8811): Implement
653
+ handler: ()=>{}
654
+ });
727
655
  }
728
656
  // eslint-disable-next-line camelcase
729
- aztec_avm_call(_foreignL2Gas, _foreignDaGas, _foreignAddress, _foreignLength, _foreignArgs) {
730
- throw new Error('Contract calls are forbidden inside a `TestEnvironment::public_context`, use `public_call` instead');
657
+ aztec_avm_storageRead(...inputs) {
658
+ return callTxeHandler({
659
+ oracle: 'aztec_avm_storageRead',
660
+ inputs,
661
+ handler: ([slot, contractAddress])=>this.handlerAsAvm().storageRead(slot, contractAddress)
662
+ });
731
663
  }
732
664
  // eslint-disable-next-line camelcase
733
- aztec_avm_staticCall(_foreignL2Gas, _foreignDaGas, _foreignAddress, _foreignLength, _foreignArgs) {
734
- throw new Error('Contract calls are forbidden inside a `TestEnvironment::public_context`, use `public_call` instead');
665
+ aztec_avm_storageWrite(...inputs) {
666
+ return callTxeHandler({
667
+ oracle: 'aztec_avm_storageWrite',
668
+ inputs,
669
+ handler: ([slot, value])=>this.handlerAsAvm().storageWrite(slot, value)
670
+ });
735
671
  }
736
672
  // eslint-disable-next-line camelcase
737
- aztec_avm_successCopy() {
738
- throw new Error('Contract calls are forbidden inside a `TestEnvironment::public_context`, use `public_call` instead');
739
- }
740
- // eslint-disable-next-line camelcase
741
- async aztec_txe_privateCallNewFlow(foreignFrom, foreignTargetContractAddress, foreignFunctionSelector, foreignArgs, foreignArgsHash, foreignIsStaticCall) {
742
- const from = addressFromSingle(foreignFrom);
743
- const targetContractAddress = addressFromSingle(foreignTargetContractAddress);
744
- const functionSelector = FunctionSelector.fromField(fromSingle(foreignFunctionSelector));
745
- const args = fromArray(foreignArgs);
746
- const argsHash = fromSingle(foreignArgsHash);
747
- const isStaticCall = fromSingle(foreignIsStaticCall).toBool();
748
- const returnValues = await this.handlerAsTxe().privateCallNewFlow(from, targetContractAddress, functionSelector, args, argsHash, isStaticCall, this.stateHandler.getCurrentJob());
749
- // TODO(F-335): Avoid doing the following call here.
750
- await this.stateHandler.cycleJob();
751
- return toForeignCallResult([
752
- toArray(returnValues)
753
- ]);
754
- }
755
- // eslint-disable-next-line camelcase
756
- async aztec_txe_executeUtilityFunction(foreignTargetContractAddress, foreignFunctionSelector, foreignArgs) {
757
- const targetContractAddress = addressFromSingle(foreignTargetContractAddress);
758
- const functionSelector = FunctionSelector.fromField(fromSingle(foreignFunctionSelector));
759
- const args = fromArray(foreignArgs);
760
- const returnValues = await this.handlerAsTxe().executeUtilityFunction(targetContractAddress, functionSelector, args, this.stateHandler.getCurrentJob());
761
- // TODO(F-335): Avoid doing the following call here.
762
- await this.stateHandler.cycleJob();
763
- return toForeignCallResult([
764
- toArray(returnValues)
765
- ]);
766
- }
767
- // eslint-disable-next-line camelcase
768
- async aztec_txe_publicCallNewFlow(foreignFrom, foreignAddress, foreignCalldata, foreignIsStaticCall) {
769
- const from = addressFromSingle(foreignFrom);
770
- const address = addressFromSingle(foreignAddress);
771
- const calldata = fromArray(foreignCalldata);
772
- const isStaticCall = fromSingle(foreignIsStaticCall).toBool();
773
- const returnValues = await this.handlerAsTxe().publicCallNewFlow(from, address, calldata, isStaticCall);
774
- // TODO(F-335): Avoid doing the following call here.
775
- await this.stateHandler.cycleJob();
776
- return toForeignCallResult([
777
- toArray(returnValues)
778
- ]);
779
- }
780
- // eslint-disable-next-line camelcase
781
- async aztec_prv_getSenderForTags() {
782
- const sender = await this.handlerAsPrivate().getSenderForTags();
783
- // Return a Noir Option struct with `some` and `value` fields
784
- if (sender === undefined) {
785
- // No sender found, return Option with some=0 and value=0
786
- return toForeignCallResult([
787
- toSingle(0),
788
- toSingle(0)
789
- ]);
790
- } else {
791
- // Sender found, return Option with some=1 and value=sender address
792
- return toForeignCallResult([
793
- toSingle(1),
794
- toSingle(sender)
795
- ]);
796
- }
673
+ aztec_avm_getContractInstanceDeployer(...inputs) {
674
+ return callTxeHandler({
675
+ oracle: 'aztec_avm_getContractInstanceDeployer',
676
+ inputs,
677
+ handler: ([address])=>this.handlerAsAvm().getContractInstanceDeployer(address)
678
+ });
679
+ }
680
+ // eslint-disable-next-line camelcase
681
+ aztec_avm_getContractInstanceClassId(...inputs) {
682
+ return callTxeHandler({
683
+ oracle: 'aztec_avm_getContractInstanceClassId',
684
+ inputs,
685
+ handler: ([address])=>this.handlerAsAvm().getContractInstanceClassId(address)
686
+ });
687
+ }
688
+ // eslint-disable-next-line camelcase
689
+ aztec_avm_getContractInstanceInitializationHash(...inputs) {
690
+ return callTxeHandler({
691
+ oracle: 'aztec_avm_getContractInstanceInitializationHash',
692
+ inputs,
693
+ handler: ([address])=>this.handlerAsAvm().getContractInstanceInitializationHash(address)
694
+ });
695
+ }
696
+ // eslint-disable-next-line camelcase
697
+ aztec_avm_getContractInstanceImmutablesHash(...inputs) {
698
+ return callTxeHandler({
699
+ oracle: 'aztec_avm_getContractInstanceImmutablesHash',
700
+ inputs,
701
+ handler: ([address])=>this.handlerAsAvm().getContractInstanceImmutablesHash(address)
702
+ });
703
+ }
704
+ // eslint-disable-next-line camelcase
705
+ aztec_avm_sender() {
706
+ return callTxeHandler({
707
+ oracle: 'aztec_avm_sender',
708
+ inputs: [],
709
+ handler: ()=>this.handlerAsAvm().sender()
710
+ });
711
+ }
712
+ // eslint-disable-next-line camelcase
713
+ aztec_avm_emitNullifier(...inputs) {
714
+ return callTxeHandler({
715
+ oracle: 'aztec_avm_emitNullifier',
716
+ inputs,
717
+ handler: ([nullifier])=>this.handlerAsAvm().emitNullifier(nullifier)
718
+ });
719
+ }
720
+ // eslint-disable-next-line camelcase
721
+ aztec_avm_emitNoteHash(...inputs) {
722
+ return callTxeHandler({
723
+ oracle: 'aztec_avm_emitNoteHash',
724
+ inputs,
725
+ handler: ([noteHash])=>this.handlerAsAvm().emitNoteHash(noteHash)
726
+ });
727
+ }
728
+ // eslint-disable-next-line camelcase
729
+ aztec_avm_nullifierExists(...inputs) {
730
+ return callTxeHandler({
731
+ oracle: 'aztec_avm_nullifierExists',
732
+ inputs,
733
+ handler: ([siloedNullifier])=>this.handlerAsAvm().nullifierExists(siloedNullifier)
734
+ });
735
+ }
736
+ // eslint-disable-next-line camelcase
737
+ aztec_avm_address() {
738
+ return callTxeHandler({
739
+ oracle: 'aztec_avm_address',
740
+ inputs: [],
741
+ handler: ()=>this.handlerAsAvm().address()
742
+ });
743
+ }
744
+ // eslint-disable-next-line camelcase
745
+ aztec_avm_blockNumber() {
746
+ return callTxeHandler({
747
+ oracle: 'aztec_avm_blockNumber',
748
+ inputs: [],
749
+ handler: ()=>this.handlerAsAvm().blockNumber()
750
+ });
751
+ }
752
+ // eslint-disable-next-line camelcase
753
+ aztec_avm_timestamp() {
754
+ return callTxeHandler({
755
+ oracle: 'aztec_avm_timestamp',
756
+ inputs: [],
757
+ handler: ()=>this.handlerAsAvm().timestamp()
758
+ });
797
759
  }
798
760
  // eslint-disable-next-line camelcase
799
- async aztec_prv_setSenderForTags(foreignSenderForTags) {
800
- const senderForTags = AztecAddress.fromField(fromSingle(foreignSenderForTags));
801
- await this.handlerAsPrivate().setSenderForTags(senderForTags);
802
- return toForeignCallResult([]);
761
+ aztec_avm_isStaticCall() {
762
+ return callTxeHandler({
763
+ oracle: 'aztec_avm_isStaticCall',
764
+ inputs: [],
765
+ handler: ()=>this.handlerAsAvm().isStaticCall()
766
+ });
803
767
  }
804
768
  // eslint-disable-next-line camelcase
805
- async aztec_prv_getNextAppTagAsSender(foreignSender, foreignRecipient) {
806
- const sender = AztecAddress.fromField(fromSingle(foreignSender));
807
- const recipient = AztecAddress.fromField(fromSingle(foreignRecipient));
808
- const nextAppTag = await this.handlerAsPrivate().getNextAppTagAsSender(sender, recipient);
809
- return toForeignCallResult([
810
- toSingle(nextAppTag.value)
811
- ]);
769
+ aztec_avm_chainId() {
770
+ return callTxeHandler({
771
+ oracle: 'aztec_avm_chainId',
772
+ inputs: [],
773
+ handler: ()=>this.handlerAsAvm().chainId()
774
+ });
775
+ }
776
+ // eslint-disable-next-line camelcase
777
+ aztec_avm_version() {
778
+ return callTxeHandler({
779
+ oracle: 'aztec_avm_version',
780
+ inputs: [],
781
+ handler: ()=>this.handlerAsAvm().version()
782
+ });
783
+ }
784
+ // eslint-disable-next-line camelcase
785
+ aztec_avm_returndataSize() {
786
+ return callTxeHandler({
787
+ oracle: 'aztec_avm_returndataSize',
788
+ inputs: [],
789
+ handler: ()=>this.handlerAsAvm().returndataSize()
790
+ });
791
+ }
792
+ // eslint-disable-next-line camelcase
793
+ aztec_avm_returndataCopy(...inputs) {
794
+ return callTxeHandler({
795
+ oracle: 'aztec_avm_returndataCopy',
796
+ inputs,
797
+ handler: ([rdOffset, copySize])=>this.handlerAsAvm().returndataCopy(rdOffset, copySize)
798
+ });
799
+ }
800
+ // eslint-disable-next-line camelcase
801
+ aztec_avm_call(...inputs) {
802
+ return callTxeHandler({
803
+ oracle: 'aztec_avm_call',
804
+ inputs,
805
+ handler: ([l2Gas, daGas, address, argsLength, args])=>this.handlerAsAvm().call(l2Gas, daGas, address, argsLength, args)
806
+ });
807
+ }
808
+ // eslint-disable-next-line camelcase
809
+ aztec_avm_staticCall(...inputs) {
810
+ return callTxeHandler({
811
+ oracle: 'aztec_avm_staticCall',
812
+ inputs,
813
+ handler: ([l2Gas, daGas, address, argsLength, args])=>this.handlerAsAvm().staticCall(l2Gas, daGas, address, argsLength, args)
814
+ });
815
+ }
816
+ // eslint-disable-next-line camelcase
817
+ aztec_avm_successCopy() {
818
+ return callTxeHandler({
819
+ oracle: 'aztec_avm_successCopy',
820
+ inputs: [],
821
+ handler: ()=>this.handlerAsAvm().successCopy()
822
+ });
823
+ }
824
+ // eslint-disable-next-line camelcase
825
+ aztec_txe_privateCallNewFlow(...inputs) {
826
+ return callTxeHandler({
827
+ oracle: 'aztec_txe_privateCallNewFlow',
828
+ inputs,
829
+ handler: ([from, targetContractAddress, functionSelector, args, argsHash, isStaticCall, additionalScopes, authorizedUtilityCallTargets, gasSettings])=>this.stateHandler.executePrivateCall(from, targetContractAddress, functionSelector, args, argsHash, isStaticCall, additionalScopes, authorizedUtilityCallTargets, gasSettings)
830
+ });
831
+ }
832
+ // eslint-disable-next-line camelcase
833
+ aztec_txe_executeUtilityFunction(...inputs) {
834
+ return callTxeHandler({
835
+ oracle: 'aztec_txe_executeUtilityFunction',
836
+ inputs,
837
+ handler: ([targetContractAddress, functionSelector, args, authorizedUtilityCallTargets])=>this.stateHandler.executeUtilityFunction(targetContractAddress, functionSelector, args, authorizedUtilityCallTargets)
838
+ });
839
+ }
840
+ // eslint-disable-next-line camelcase
841
+ aztec_txe_publicCallNewFlow(...inputs) {
842
+ return callTxeHandler({
843
+ oracle: 'aztec_txe_publicCallNewFlow',
844
+ inputs,
845
+ handler: ([from, address, calldata, isStaticCall, gasSettings])=>this.stateHandler.executePublicCall(from, address, calldata, isStaticCall, gasSettings)
846
+ });
847
+ }
848
+ // eslint-disable-next-line camelcase
849
+ aztec_prv_getSenderForTags() {
850
+ return callTxeHandler({
851
+ oracle: 'aztec_prv_getSenderForTags',
852
+ inputs: [],
853
+ handler: ()=>this.handlerAsPrivate().getSenderForTags()
854
+ });
855
+ }
856
+ // eslint-disable-next-line camelcase
857
+ aztec_prv_getAppTaggingSecret(...inputs) {
858
+ return callTxeHandler({
859
+ oracle: 'aztec_prv_getAppTaggingSecret',
860
+ inputs,
861
+ handler: ([sender, recipient])=>this.handlerAsPrivate().getAppTaggingSecret(sender, recipient)
862
+ });
863
+ }
864
+ // eslint-disable-next-line camelcase
865
+ aztec_prv_getNextTaggingIndex(...inputs) {
866
+ return callTxeHandler({
867
+ oracle: 'aztec_prv_getNextTaggingIndex',
868
+ inputs,
869
+ handler: ([secret, deliveryMode])=>this.handlerAsPrivate().getNextTaggingIndex(secret, deliveryMode)
870
+ });
812
871
  }
813
872
  }