@aztec/txe 0.0.1-commit.c2eed6949 → 0.0.1-commit.c52d6e7

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 (168) hide show
  1. package/dest/AuthRegistry-QVGDDH5X.js +3 -0
  2. package/dest/AuthRegistry-QVGDDH5X.js.map +7 -0
  3. package/dest/ContractClassRegistry-PVNCKGG7.js +3 -0
  4. package/dest/ContractClassRegistry-PVNCKGG7.js.map +7 -0
  5. package/dest/ContractInstanceRegistry-WLOZKTR6.js +3 -0
  6. package/dest/ContractInstanceRegistry-WLOZKTR6.js.map +7 -0
  7. package/dest/FeeJuice-MAQJU53K.js +3 -0
  8. package/dest/FeeJuice-MAQJU53K.js.map +7 -0
  9. package/dest/HandshakeRegistry-GY5CPEPS.js +3 -0
  10. package/dest/HandshakeRegistry-GY5CPEPS.js.map +7 -0
  11. package/dest/MultiCallEntrypoint-QG5H33ZZ.js +3 -0
  12. package/dest/MultiCallEntrypoint-QG5H33ZZ.js.map +7 -0
  13. package/dest/SchnorrAccount-ADD65DYA.js +3 -0
  14. package/dest/SchnorrAccount-ADD65DYA.js.map +7 -0
  15. package/dest/SchnorrInitializerlessAccount-TWGKRUSY.js +3 -0
  16. package/dest/SchnorrInitializerlessAccount-TWGKRUSY.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 +22 -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-32UHX7YY.js +3 -0
  26. package/dest/chunk-32UHX7YY.js.map +7 -0
  27. package/dest/chunk-RVEPNDEP.js +304 -0
  28. package/dest/chunk-RVEPNDEP.js.map +7 -0
  29. package/dest/chunk-XWIMXLKD.js +258 -0
  30. package/dest/chunk-XWIMXLKD.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 +9 -1
  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 +72 -190
  40. package/dest/metafile.json +38833 -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 +47 -9
  45. package/dest/oracle/interfaces.d.ts.map +1 -1
  46. package/dest/oracle/tagging_secret_strategy.d.ts +12 -0
  47. package/dest/oracle/tagging_secret_strategy.d.ts.map +1 -0
  48. package/dest/oracle/tagging_secret_strategy.js +12 -0
  49. package/dest/oracle/test-resolver/default_fixtures.d.ts +16 -0
  50. package/dest/oracle/test-resolver/default_fixtures.d.ts.map +1 -0
  51. package/dest/oracle/test-resolver/default_fixtures.js +200 -0
  52. package/dest/oracle/test-resolver/index.d.ts +9 -0
  53. package/dest/oracle/test-resolver/index.d.ts.map +1 -0
  54. package/dest/oracle/test-resolver/index.js +32 -0
  55. package/dest/oracle/test-resolver/resolver.d.ts +48 -0
  56. package/dest/oracle/test-resolver/resolver.d.ts.map +1 -0
  57. package/dest/oracle/test-resolver/resolver.js +181 -0
  58. package/dest/oracle/txe_oracle_public_context.d.ts +26 -2
  59. package/dest/oracle/txe_oracle_public_context.d.ts.map +1 -1
  60. package/dest/oracle/txe_oracle_public_context.js +49 -1
  61. package/dest/oracle/txe_oracle_registry.d.ts +172 -0
  62. package/dest/oracle/txe_oracle_registry.d.ts.map +1 -0
  63. package/dest/oracle/txe_oracle_registry.js +767 -0
  64. package/dest/oracle/txe_oracle_top_level_context.d.ts +58 -18
  65. package/dest/oracle/txe_oracle_top_level_context.d.ts.map +1 -1
  66. package/dest/oracle/txe_oracle_top_level_context.js +558 -304
  67. package/dest/oracle/txe_oracle_version.d.ts +17 -0
  68. package/dest/oracle/txe_oracle_version.d.ts.map +1 -0
  69. package/dest/oracle/txe_oracle_version.js +14 -0
  70. package/dest/oracle/txe_private_execution_oracle.d.ts +17 -0
  71. package/dest/oracle/txe_private_execution_oracle.d.ts.map +1 -0
  72. package/dest/oracle/txe_private_execution_oracle.js +15 -0
  73. package/dest/rpc_server.d.ts +14 -0
  74. package/dest/rpc_server.d.ts.map +1 -0
  75. package/dest/rpc_server.js +78 -0
  76. package/dest/rpc_translator.d.ts +116 -233
  77. package/dest/rpc_translator.d.ts.map +1 -1
  78. package/dest/rpc_translator.js +799 -636
  79. package/dest/server.bundle.js +3 -0
  80. package/dest/server.bundle.js.map +7 -0
  81. package/dest/state_machine/archiver.d.ts +4 -3
  82. package/dest/state_machine/archiver.d.ts.map +1 -1
  83. package/dest/state_machine/archiver.js +24 -14
  84. package/dest/state_machine/dummy_p2p_client.d.ts +16 -7
  85. package/dest/state_machine/dummy_p2p_client.d.ts.map +1 -1
  86. package/dest/state_machine/dummy_p2p_client.js +25 -4
  87. package/dest/state_machine/global_variable_builder.d.ts +10 -6
  88. package/dest/state_machine/global_variable_builder.d.ts.map +1 -1
  89. package/dest/state_machine/global_variable_builder.js +8 -5
  90. package/dest/state_machine/index.d.ts +11 -7
  91. package/dest/state_machine/index.d.ts.map +1 -1
  92. package/dest/state_machine/index.js +50 -14
  93. package/dest/state_machine/mock_epoch_cache.d.ts +2 -2
  94. package/dest/state_machine/mock_epoch_cache.d.ts.map +1 -1
  95. package/dest/state_machine/mock_epoch_cache.js +3 -3
  96. package/dest/state_machine/synchronizer.d.ts +10 -2
  97. package/dest/state_machine/synchronizer.d.ts.map +1 -1
  98. package/dest/state_machine/synchronizer.js +19 -6
  99. package/dest/txe_session.d.ts +92 -20
  100. package/dest/txe_session.d.ts.map +1 -1
  101. package/dest/txe_session.js +324 -69
  102. package/dest/utils/block_creation.d.ts +2 -2
  103. package/dest/utils/block_creation.d.ts.map +1 -1
  104. package/dest/utils/block_creation.js +2 -2
  105. package/dest/utils/encoding.d.ts +194 -0
  106. package/dest/utils/encoding.d.ts.map +1 -0
  107. package/dest/{util → utils}/encoding.js +7 -2
  108. package/dest/{util → utils}/expected_failure_error.d.ts +1 -1
  109. package/dest/utils/expected_failure_error.d.ts.map +1 -0
  110. package/dest/utils/tx_effect_creation.d.ts +1 -1
  111. package/dest/utils/tx_effect_creation.d.ts.map +1 -1
  112. package/dest/utils/tx_effect_creation.js +0 -1
  113. package/dest/{util → utils}/txe_account_store.d.ts +1 -1
  114. package/dest/utils/txe_account_store.d.ts.map +1 -0
  115. package/dest/utils/txe_artifact_resolver.d.ts +37 -0
  116. package/dest/utils/txe_artifact_resolver.d.ts.map +1 -0
  117. package/dest/utils/txe_artifact_resolver.js +161 -0
  118. package/dest/utils/txe_public_contract_data_source.d.ts +20 -0
  119. package/dest/utils/txe_public_contract_data_source.d.ts.map +1 -0
  120. package/dest/{util → utils}/txe_public_contract_data_source.js +7 -4
  121. package/dest/worker.bundle.js +3 -0
  122. package/dest/worker.bundle.js.map +7 -0
  123. package/dest/worker.d.ts +2 -0
  124. package/dest/worker.d.ts.map +1 -0
  125. package/dest/worker.js +92 -0
  126. package/package.json +38 -21
  127. package/src/bin/check_txe_oracle_version.ts +31 -0
  128. package/src/bin/index.ts +11 -2
  129. package/src/bin/oracle_test_server.ts +51 -0
  130. package/src/constants.ts +11 -1
  131. package/src/dispatcher_pool.ts +317 -0
  132. package/src/index.ts +99 -227
  133. package/src/msgpackr_fr_extension.ts +23 -0
  134. package/src/oracle/interfaces.ts +47 -8
  135. package/src/oracle/tagging_secret_strategy.ts +25 -0
  136. package/src/oracle/test-resolver/default_fixtures.ts +271 -0
  137. package/src/oracle/test-resolver/index.ts +44 -0
  138. package/src/oracle/test-resolver/resolver.ts +245 -0
  139. package/src/oracle/txe_oracle_public_context.ts +62 -0
  140. package/src/oracle/txe_oracle_registry.ts +556 -0
  141. package/src/oracle/txe_oracle_top_level_context.ts +364 -117
  142. package/src/oracle/txe_oracle_version.ts +17 -0
  143. package/src/oracle/txe_private_execution_oracle.ts +30 -0
  144. package/src/rpc_server.ts +87 -0
  145. package/src/rpc_translator.ts +889 -901
  146. package/src/state_machine/archiver.ts +37 -16
  147. package/src/state_machine/dummy_p2p_client.ts +44 -11
  148. package/src/state_machine/global_variable_builder.ts +12 -11
  149. package/src/state_machine/index.ts +62 -32
  150. package/src/state_machine/mock_epoch_cache.ts +4 -4
  151. package/src/state_machine/synchronizer.ts +27 -6
  152. package/src/txe_session.ts +561 -85
  153. package/src/utils/block_creation.ts +2 -1
  154. package/src/{util → utils}/encoding.ts +8 -2
  155. package/src/utils/tx_effect_creation.ts +0 -2
  156. package/src/utils/txe_artifact_resolver.ts +217 -0
  157. package/src/{util → utils}/txe_public_contract_data_source.ts +6 -4
  158. package/src/worker.ts +98 -0
  159. package/dest/util/encoding.d.ts +0 -788
  160. package/dest/util/encoding.d.ts.map +0 -1
  161. package/dest/util/expected_failure_error.d.ts.map +0 -1
  162. package/dest/util/txe_account_store.d.ts.map +0 -1
  163. package/dest/util/txe_public_contract_data_source.d.ts +0 -20
  164. package/dest/util/txe_public_contract_data_source.d.ts.map +0 -1
  165. /package/dest/{util → utils}/expected_failure_error.js +0 -0
  166. /package/dest/{util → utils}/txe_account_store.js +0 -0
  167. /package/src/{util → utils}/expected_failure_error.ts +0 -0
  168. /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,926 @@ 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
+ });
106
+ }
107
+ // eslint-disable-next-line camelcase
108
+ aztec_txe_getNextBlockNumber() {
109
+ return callTxeHandler({
110
+ oracle: 'aztec_txe_getNextBlockNumber',
111
+ inputs: [],
112
+ handler: ()=>this.handlerAsTxe().getNextBlockNumber()
113
+ });
96
114
  }
97
115
  // eslint-disable-next-line camelcase
98
- async aztec_txe_getNextBlockNumber() {
99
- const nextBlockNumber = await this.handlerAsTxe().getNextBlockNumber();
100
- return toForeignCallResult([
101
- toSingle(nextBlockNumber)
102
- ]);
116
+ aztec_txe_getNextBlockTimestamp() {
117
+ return callTxeHandler({
118
+ oracle: 'aztec_txe_getNextBlockTimestamp',
119
+ inputs: [],
120
+ handler: ()=>this.handlerAsTxe().getNextBlockTimestamp()
121
+ });
103
122
  }
104
123
  // eslint-disable-next-line camelcase
105
- async aztec_txe_getNextBlockTimestamp() {
106
- const nextBlockTimestamp = await this.handlerAsTxe().getNextBlockTimestamp();
107
- return toForeignCallResult([
108
- toSingle(nextBlockTimestamp)
109
- ]);
124
+ aztec_txe_advanceBlocksBy(...inputs) {
125
+ return callTxeHandler({
126
+ oracle: 'aztec_txe_advanceBlocksBy',
127
+ inputs,
128
+ handler: ([blocks])=>this.handlerAsTxe().advanceBlocksBy(blocks)
129
+ });
110
130
  }
111
131
  // 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([]);
132
+ aztec_txe_advanceTimestampBy(...inputs) {
133
+ return callTxeHandler({
134
+ oracle: 'aztec_txe_advanceTimestampBy',
135
+ inputs,
136
+ handler: ([duration])=>this.handlerAsTxe().advanceTimestampBy(duration)
137
+ });
116
138
  }
117
139
  // eslint-disable-next-line camelcase
118
- aztec_txe_advanceTimestampBy(foreignDuration) {
119
- const duration = fromSingle(foreignDuration).toBigInt();
120
- this.handlerAsTxe().advanceTimestampBy(duration);
121
- return toForeignCallResult([]);
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
+ });
122
146
  }
123
147
  // 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
- ]);
148
+ aztec_txe_createAccount(...inputs) {
149
+ return callTxeHandler({
150
+ oracle: 'aztec_txe_createAccount',
151
+ inputs,
152
+ handler: ([secret, partialAddress])=>this.handlerAsTxe().createAccount(secret, partialAddress)
153
+ });
136
154
  }
137
155
  // 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
- ]);
156
+ aztec_txe_addAccount(...inputs) {
157
+ return callTxeHandler({
158
+ oracle: 'aztec_txe_addAccount',
159
+ inputs,
160
+ handler: ([secret])=>this.handlerAsTxe().addAccount(secret)
161
+ });
145
162
  }
146
163
  // 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
- ]);
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
+ });
154
170
  }
155
171
  // 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([]);
172
+ aztec_txe_sendL1ToL2Message(...inputs) {
173
+ return callTxeHandler({
174
+ oracle: 'aztec_txe_sendL1ToL2Message',
175
+ inputs,
176
+ handler: ([content, secretHash, sender, recipient])=>this.handlerAsTxe().sendL1ToL2Message(content, secretHash, sender, recipient)
177
+ });
178
+ }
179
+ // eslint-disable-next-line camelcase
180
+ aztec_txe_setTaggingSecretStrategies(...inputs) {
181
+ return callTxeHandler({
182
+ oracle: 'aztec_txe_setTaggingSecretStrategies',
183
+ inputs,
184
+ handler: ([unconstrainedStrategy, constrainedStrategy])=>this.handlerAsTxe().setTaggingSecretStrategies(unconstrainedStrategy, constrainedStrategy)
185
+ });
186
+ }
187
+ // eslint-disable-next-line camelcase
188
+ aztec_txe_setAuthorizeAllUtilityCallTargets(...inputs) {
189
+ return callTxeHandler({
190
+ oracle: 'aztec_txe_setAuthorizeAllUtilityCallTargets',
191
+ inputs,
192
+ handler: ([authorizeAll])=>this.handlerAsTxe().setAuthorizeAllUtilityCallTargets(authorizeAll)
193
+ });
161
194
  }
162
195
  // PXE oracles
163
196
  // eslint-disable-next-line camelcase
164
- aztec_utl_assertCompatibleOracleVersion(foreignVersion) {
165
- const version = fromSingle(foreignVersion).toNumber();
166
- this.handlerAsMisc().assertCompatibleOracleVersion(version);
167
- return toForeignCallResult([]);
197
+ aztec_misc_assertCompatibleOracleVersion(...inputs) {
198
+ return callTxeHandler({
199
+ oracle: 'aztec_misc_assertCompatibleOracleVersion',
200
+ inputs,
201
+ handler: ([major, minor])=>this.handlerAsMisc().assertCompatibleOracleVersion(major, minor)
202
+ });
168
203
  }
169
204
  // eslint-disable-next-line camelcase
170
- aztec_utl_getRandomField() {
171
- const randomField = this.handlerAsMisc().getRandomField();
172
- return toForeignCallResult([
173
- toSingle(randomField)
174
- ]);
205
+ aztec_misc_getRandomField() {
206
+ return callTxeHandler({
207
+ oracle: 'aztec_misc_getRandomField',
208
+ inputs: [],
209
+ handler: ()=>this.handlerAsMisc().getRandomField()
210
+ });
175
211
  }
176
212
  // 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
- ]);
213
+ aztec_txe_getLastBlockTimestamp() {
214
+ return callTxeHandler({
215
+ oracle: 'aztec_txe_getLastBlockTimestamp',
216
+ inputs: [],
217
+ handler: ()=>this.handlerAsTxe().getLastBlockTimestamp()
218
+ });
182
219
  }
183
220
  // 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
- ]);
221
+ aztec_txe_getLastTxEffects() {
222
+ return callTxeHandler({
223
+ oracle: 'aztec_txe_getLastTxEffects',
224
+ inputs: [],
225
+ handler: ()=>this.handlerAsTxe().getLastTxEffects()
226
+ });
191
227
  }
192
228
  // 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
- }
229
+ aztec_txe_getLastCallOffchainEffects() {
230
+ return callTxeHandler({
231
+ oracle: 'aztec_txe_getLastCallOffchainEffects',
232
+ inputs: [],
233
+ handler: ()=>this.stateHandler.getLastCallOffchainEffects()
234
+ });
379
235
  }
380
236
  // 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));
237
+ aztec_txe_getLastCallContext() {
238
+ return callTxeHandler({
239
+ oracle: 'aztec_txe_getLastCallContext',
240
+ inputs: [],
241
+ handler: ()=>this.stateHandler.getLastCallContext()
242
+ });
385
243
  }
386
244
  // 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');
245
+ aztec_txe_getPrivateEvents(...inputs) {
246
+ return callTxeHandler({
247
+ oracle: 'aztec_txe_getPrivateEvents',
248
+ inputs,
249
+ handler: ([selector, contractAddress, scope])=>this.stateHandler.getPrivateEvents(selector, contractAddress, scope)
250
+ });
389
251
  }
390
252
  // 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());
253
+ aztec_prv_setHashPreimage(...inputs) {
254
+ return callTxeHandler({
255
+ oracle: 'aztec_prv_setHashPreimage',
256
+ inputs,
257
+ handler: ([values, hash])=>this.handlerAsPrivate().setHashPreimage(values, hash)
258
+ });
399
259
  }
400
260
  // 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
- ]);
261
+ aztec_prv_getHashPreimage(...inputs) {
262
+ return callTxeHandler({
263
+ oracle: 'aztec_prv_getHashPreimage',
264
+ inputs,
265
+ handler: ([hash])=>this.handlerAsPrivate().getHashPreimage(hash)
266
+ });
267
+ }
268
+ // eslint-disable-next-line camelcase
269
+ aztec_misc_log(...inputs) {
270
+ return callTxeHandler({
271
+ oracle: 'aztec_misc_log',
272
+ inputs,
273
+ handler: ([level, message, fieldsSize, fields])=>this.handlerAsMisc().log(level, message, fieldsSize, fields)
274
+ });
275
+ }
276
+ // eslint-disable-next-line camelcase
277
+ aztec_utl_getFromPublicStorage(...inputs) {
278
+ return callTxeHandler({
279
+ oracle: 'aztec_utl_getFromPublicStorage',
280
+ inputs,
281
+ handler: ([blockHash, contractAddress, startStorageSlot, numberOfElements])=>this.handlerAsUtility().getFromPublicStorage(blockHash, contractAddress, startStorageSlot, numberOfElements)
282
+ });
283
+ }
284
+ // eslint-disable-next-line camelcase
285
+ aztec_utl_getPublicDataWitness(...inputs) {
286
+ return callTxeHandler({
287
+ oracle: 'aztec_utl_getPublicDataWitness',
288
+ inputs,
289
+ handler: ([blockHash, leafSlot])=>this.handlerAsUtility().getPublicDataWitness(blockHash, leafSlot)
290
+ });
291
+ }
292
+ // eslint-disable-next-line camelcase
293
+ aztec_utl_getNotes(...inputs) {
294
+ return callTxeHandler({
295
+ oracle: 'aztec_utl_getNotes',
296
+ inputs,
297
+ 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)
298
+ });
299
+ }
300
+ // eslint-disable-next-line camelcase
301
+ aztec_prv_notifyCreatedNote(...inputs) {
302
+ return callTxeHandler({
303
+ oracle: 'aztec_prv_notifyCreatedNote',
304
+ inputs,
305
+ handler: ([owner, storageSlot, randomness, noteTypeId, note, noteHash, counter])=>this.handlerAsPrivate().notifyCreatedNote(owner, storageSlot, randomness, noteTypeId, note, noteHash, counter)
306
+ });
307
+ }
308
+ // eslint-disable-next-line camelcase
309
+ aztec_prv_notifyNullifiedNote(...inputs) {
310
+ return callTxeHandler({
311
+ oracle: 'aztec_prv_notifyNullifiedNote',
312
+ inputs,
313
+ handler: ([innerNullifier, noteHash, counter])=>this.handlerAsPrivate().notifyNullifiedNote(innerNullifier, noteHash, counter)
314
+ });
315
+ }
316
+ // eslint-disable-next-line camelcase
317
+ aztec_prv_notifyCreatedNullifier(...inputs) {
318
+ return callTxeHandler({
319
+ oracle: 'aztec_prv_notifyCreatedNullifier',
320
+ inputs,
321
+ handler: ([innerNullifier])=>this.handlerAsPrivate().notifyCreatedNullifier(innerNullifier)
322
+ });
323
+ }
324
+ // eslint-disable-next-line camelcase
325
+ aztec_prv_isNullifierPending(...inputs) {
326
+ return callTxeHandler({
327
+ oracle: 'aztec_prv_isNullifierPending',
328
+ inputs,
329
+ handler: ([innerNullifier, contractAddress])=>this.handlerAsPrivate().isNullifierPending(innerNullifier, contractAddress)
330
+ });
331
+ }
332
+ // eslint-disable-next-line camelcase
333
+ aztec_utl_doesNullifierExist(...inputs) {
334
+ return callTxeHandler({
335
+ oracle: 'aztec_utl_doesNullifierExist',
336
+ inputs,
337
+ handler: ([innerNullifier])=>this.handlerAsUtility().doesNullifierExist(innerNullifier)
338
+ });
339
+ }
340
+ // eslint-disable-next-line camelcase
341
+ aztec_utl_getContractInstance(...inputs) {
342
+ return callTxeHandler({
343
+ oracle: 'aztec_utl_getContractInstance',
344
+ inputs,
345
+ handler: ([address])=>this.handlerAsUtility().getContractInstance(address)
346
+ });
347
+ }
348
+ // eslint-disable-next-line camelcase
349
+ aztec_utl_getPublicKeysAndPartialAddress(...inputs) {
350
+ return callTxeHandler({
351
+ oracle: 'aztec_utl_getPublicKeysAndPartialAddress',
352
+ inputs,
353
+ handler: ([address])=>this.handlerAsUtility().getPublicKeysAndPartialAddress(address)
354
+ });
355
+ }
356
+ // eslint-disable-next-line camelcase
357
+ aztec_utl_getKeyValidationRequest(...inputs) {
358
+ return callTxeHandler({
359
+ oracle: 'aztec_utl_getKeyValidationRequest',
360
+ inputs,
361
+ handler: ([pkMHash, keyIndex])=>this.handlerAsUtility().getKeyValidationRequest(pkMHash, keyIndex)
362
+ });
410
363
  }
411
364
  // eslint-disable-next-line camelcase
412
- aztec_prv_validatePublicCalldata(_foreignCalldataHash) {
413
- throw new Error('Enqueueing public calls is not supported in TestEnvironment::private_context');
365
+ aztec_prv_callPrivateFunction(...inputs) {
366
+ return callTxeHandler({
367
+ oracle: 'aztec_prv_callPrivateFunction',
368
+ inputs,
369
+ handler: ([contractAddress, functionSelector, argsHash, sideEffectCounter, isStaticCall])=>this.handlerAsPrivate().callPrivateFunction(contractAddress, functionSelector, argsHash, sideEffectCounter, isStaticCall)
370
+ });
414
371
  }
415
372
  // eslint-disable-next-line camelcase
416
- aztec_prv_notifyRevertiblePhaseStart(_foreignMinRevertibleSideEffectCounter) {
417
- throw new Error('Enqueueing public calls is not supported in TestEnvironment::private_context');
373
+ aztec_utl_getNullifierMembershipWitness(...inputs) {
374
+ return callTxeHandler({
375
+ oracle: 'aztec_utl_getNullifierMembershipWitness',
376
+ inputs,
377
+ handler: ([blockHash, nullifier])=>this.handlerAsUtility().getNullifierMembershipWitness(blockHash, nullifier)
378
+ });
418
379
  }
419
380
  // 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
- ]);
381
+ aztec_utl_getL1ToL2MembershipWitnessV2(...inputs) {
382
+ return callTxeHandler({
383
+ oracle: 'aztec_utl_getL1ToL2MembershipWitnessV2',
384
+ inputs,
385
+ handler: ([messageHash, nullifier])=>this.handlerAsUtility().getL1ToL2MembershipWitnessV2(messageHash, nullifier)
386
+ });
387
+ }
388
+ // eslint-disable-next-line camelcase
389
+ aztec_utl_getAuthWitness(...inputs) {
390
+ return callTxeHandler({
391
+ oracle: 'aztec_utl_getAuthWitness',
392
+ inputs,
393
+ handler: ([messageHash])=>this.handlerAsUtility().getAuthWitness(messageHash)
394
+ });
395
+ }
396
+ // eslint-disable-next-line camelcase
397
+ aztec_prv_assertValidPublicCalldata(...inputs) {
398
+ return callTxeHandler({
399
+ oracle: 'aztec_prv_assertValidPublicCalldata',
400
+ inputs,
401
+ handler: ([calldataHash])=>this.handlerAsPrivate().assertValidPublicCalldata(calldataHash)
402
+ });
403
+ }
404
+ // eslint-disable-next-line camelcase
405
+ aztec_prv_notifyRevertiblePhaseStart(...inputs) {
406
+ return callTxeHandler({
407
+ oracle: 'aztec_prv_notifyRevertiblePhaseStart',
408
+ inputs,
409
+ handler: ([minRevertibleSideEffectCounter])=>this.handlerAsPrivate().notifyRevertiblePhaseStart(minRevertibleSideEffectCounter)
410
+ });
411
+ }
412
+ // eslint-disable-next-line camelcase
413
+ aztec_prv_isExecutionInRevertiblePhase(...inputs) {
414
+ return callTxeHandler({
415
+ oracle: 'aztec_prv_isExecutionInRevertiblePhase',
416
+ inputs,
417
+ handler: ([sideEffectCounter])=>this.handlerAsPrivate().isExecutionInRevertiblePhase(sideEffectCounter)
418
+ });
426
419
  }
427
420
  // eslint-disable-next-line camelcase
428
421
  aztec_utl_getUtilityContext() {
429
- const context = this.handlerAsUtility().getUtilityContext();
430
- return toForeignCallResult(context.toNoirRepresentation());
422
+ return callTxeHandler({
423
+ oracle: 'aztec_utl_getUtilityContext',
424
+ inputs: [],
425
+ handler: ()=>this.handlerAsUtility().getUtilityContext()
426
+ });
431
427
  }
432
428
  // 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));
429
+ aztec_utl_getBlockHeader(...inputs) {
430
+ return callTxeHandler({
431
+ oracle: 'aztec_utl_getBlockHeader',
432
+ inputs,
433
+ handler: ([blockNumber])=>this.handlerAsUtility().getBlockHeader(blockNumber)
434
+ });
440
435
  }
441
436
  // 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());
437
+ aztec_utl_getNoteHashMembershipWitness(...inputs) {
438
+ return callTxeHandler({
439
+ oracle: 'aztec_utl_getNoteHashMembershipWitness',
440
+ inputs,
441
+ handler: ([blockHash, noteHash])=>this.handlerAsUtility().getNoteHashMembershipWitness(blockHash, noteHash)
442
+ });
450
443
  }
451
444
  // 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());
445
+ aztec_utl_getBlockHashMembershipWitness(...inputs) {
446
+ return callTxeHandler({
447
+ oracle: 'aztec_utl_getBlockHashMembershipWitness',
448
+ inputs,
449
+ handler: ([anchorBlockHash, blockHash])=>this.handlerAsUtility().getBlockHashMembershipWitness(anchorBlockHash, blockHash)
450
+ });
460
451
  }
461
452
  // 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
- }
453
+ aztec_utl_areBlockHashesInArchive(...inputs) {
454
+ return callTxeHandler({
455
+ oracle: 'aztec_utl_areBlockHashesInArchive',
456
+ inputs,
457
+ handler: ([anchorBlockHash, blockHashes])=>this.handlerAsUtility().areBlockHashesInArchive(anchorBlockHash, blockHashes)
458
+ });
532
459
  }
533
460
  // 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([]);
461
+ aztec_utl_getLowNullifierMembershipWitness(...inputs) {
462
+ return callTxeHandler({
463
+ oracle: 'aztec_utl_getLowNullifierMembershipWitness',
464
+ inputs,
465
+ handler: ([blockHash, nullifier])=>this.handlerAsUtility().getLowNullifierMembershipWitness(blockHash, nullifier)
466
+ });
539
467
  }
540
468
  // 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([]);
469
+ aztec_utl_getPendingTaggedLogsV2(...inputs) {
470
+ return callTxeHandler({
471
+ oracle: 'aztec_utl_getPendingTaggedLogsV2',
472
+ inputs,
473
+ handler: ([scope, providedSecrets])=>this.handlerAsUtility().getPendingTaggedLogsV2(scope, providedSecrets)
474
+ });
548
475
  }
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
476
  // 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
- }
477
+ aztec_utl_validateAndStoreEnqueuedNotesAndEvents(...inputs) {
478
+ return callTxeHandler({
479
+ oracle: 'aztec_utl_validateAndStoreEnqueuedNotesAndEvents',
480
+ inputs,
481
+ handler: ([noteValidationRequests, eventValidationRequests, scope])=>this.handlerAsUtility().validateAndStoreEnqueuedNotesAndEvents(noteValidationRequests, eventValidationRequests, scope)
482
+ });
575
483
  }
576
484
  // 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));
485
+ aztec_utl_getLogsByTagV2(...inputs) {
486
+ return callTxeHandler({
487
+ oracle: 'aztec_utl_getLogsByTagV2',
488
+ inputs,
489
+ handler: ([requestArrayBaseSlot])=>this.handlerAsUtility().getLogsByTagV2(requestArrayBaseSlot)
490
+ });
586
491
  }
587
492
  // 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([]));
493
+ aztec_utl_getResolvedTxs(...inputs) {
494
+ return callTxeHandler({
495
+ oracle: 'aztec_utl_getResolvedTxs',
496
+ inputs,
497
+ handler: ([requestArrayBaseSlot])=>this.handlerAsUtility().getResolvedTxs(requestArrayBaseSlot)
498
+ });
594
499
  }
595
500
  // eslint-disable-next-line camelcase
596
- aztec_utl_emitOffchainEffect(_foreignData) {
597
- throw new Error('Offchain effects are not yet supported in the TestEnvironment');
501
+ aztec_utl_getTxEffects(...inputs) {
502
+ return callTxeHandler({
503
+ oracle: 'aztec_utl_getTxEffects',
504
+ inputs,
505
+ handler: ([txHashes])=>this.handlerAsUtility().getTxEffects(txHashes)
506
+ });
598
507
  }
599
- // AVM opcodes
600
508
  // eslint-disable-next-line camelcase
601
- aztec_avm_emitPublicLog(_foreignMessage) {
602
- // TODO(#8811): Implement
603
- return toForeignCallResult([]);
509
+ aztec_utl_setCapsule(...inputs) {
510
+ return callTxeHandler({
511
+ oracle: 'aztec_utl_setCapsule',
512
+ inputs,
513
+ handler: ([contractAddress, slot, capsule, scope])=>this.handlerAsUtility().setCapsule(contractAddress, slot, capsule, scope)
514
+ });
604
515
  }
605
516
  // 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
- ]);
517
+ aztec_utl_getCapsule(...inputs) {
518
+ return callTxeHandler({
519
+ oracle: 'aztec_utl_getCapsule',
520
+ inputs,
521
+ handler: ([contractAddress, slot, tSize, scope])=>this.handlerAsUtility().getCapsule(contractAddress, slot, tSize, scope)
522
+ });
613
523
  }
614
524
  // 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([]);
525
+ aztec_utl_deleteCapsule(...inputs) {
526
+ return callTxeHandler({
527
+ oracle: 'aztec_utl_deleteCapsule',
528
+ inputs,
529
+ handler: ([contractAddress, slot, scope])=>this.handlerAsUtility().deleteCapsule(contractAddress, slot, scope)
530
+ });
620
531
  }
621
532
  // 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
- ]);
533
+ aztec_utl_copyCapsule(...inputs) {
534
+ return callTxeHandler({
535
+ oracle: 'aztec_utl_copyCapsule',
536
+ inputs,
537
+ handler: ([contractAddress, srcSlot, dstSlot, numEntries, scope])=>this.handlerAsUtility().copyCapsule(contractAddress, srcSlot, dstSlot, numEntries, scope)
538
+ });
630
539
  }
631
540
  // 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
- ]);
541
+ aztec_utl_pushEphemeral(...inputs) {
542
+ return callTxeHandler({
543
+ oracle: 'aztec_utl_pushEphemeral',
544
+ inputs,
545
+ handler: ([slot, elements])=>this.handlerAsUtility().pushEphemeral(slot, elements)
546
+ });
640
547
  }
641
548
  // 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
- ]);
549
+ aztec_utl_popEphemeral(...inputs) {
550
+ return callTxeHandler({
551
+ oracle: 'aztec_utl_popEphemeral',
552
+ inputs,
553
+ handler: ([slot])=>this.handlerAsUtility().popEphemeral(slot)
554
+ });
650
555
  }
651
556
  // eslint-disable-next-line camelcase
652
- async aztec_avm_sender() {
653
- const sender = await this.handlerAsAvm().sender();
654
- return toForeignCallResult([
655
- toSingle(sender)
656
- ]);
557
+ aztec_utl_getEphemeral(...inputs) {
558
+ return callTxeHandler({
559
+ oracle: 'aztec_utl_getEphemeral',
560
+ inputs,
561
+ handler: ([slot, index])=>this.handlerAsUtility().getEphemeral(slot, index)
562
+ });
657
563
  }
658
564
  // 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([]);
565
+ aztec_utl_setEphemeral(...inputs) {
566
+ return callTxeHandler({
567
+ oracle: 'aztec_utl_setEphemeral',
568
+ inputs,
569
+ handler: ([slot, index, elements])=>this.handlerAsUtility().setEphemeral(slot, index, elements)
570
+ });
663
571
  }
664
572
  // 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([]);
573
+ aztec_utl_getEphemeralLen(...inputs) {
574
+ return callTxeHandler({
575
+ oracle: 'aztec_utl_getEphemeralLen',
576
+ inputs,
577
+ handler: ([slot])=>this.handlerAsUtility().getEphemeralLen(slot)
578
+ });
669
579
  }
670
580
  // 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
- ]);
581
+ aztec_utl_removeEphemeral(...inputs) {
582
+ return callTxeHandler({
583
+ oracle: 'aztec_utl_removeEphemeral',
584
+ inputs,
585
+ handler: ([slot, index])=>this.handlerAsUtility().removeEphemeral(slot, index)
586
+ });
677
587
  }
678
588
  // 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
- ]);
589
+ aztec_utl_clearEphemeral(...inputs) {
590
+ return callTxeHandler({
591
+ oracle: 'aztec_utl_clearEphemeral',
592
+ inputs,
593
+ handler: ([slot])=>this.handlerAsUtility().clearEphemeral(slot)
594
+ });
684
595
  }
685
596
  // 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
- ]);
597
+ aztec_utl_pushTransient(...inputs) {
598
+ return callTxeHandler({
599
+ oracle: 'aztec_utl_pushTransient',
600
+ inputs,
601
+ handler: ([slot, elements])=>this.handlerAsUtility().pushTransient(slot, elements)
602
+ });
691
603
  }
692
604
  // 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
- ]);
605
+ aztec_utl_popTransient(...inputs) {
606
+ return callTxeHandler({
607
+ oracle: 'aztec_utl_popTransient',
608
+ inputs,
609
+ handler: ([slot])=>this.handlerAsUtility().popTransient(slot)
610
+ });
698
611
  }
699
612
  // 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
- ]);
613
+ aztec_utl_getTransient(...inputs) {
614
+ return callTxeHandler({
615
+ oracle: 'aztec_utl_getTransient',
616
+ inputs,
617
+ handler: ([slot, index])=>this.handlerAsUtility().getTransient(slot, index)
618
+ });
705
619
  }
706
620
  // eslint-disable-next-line camelcase
707
- async aztec_avm_chainId() {
708
- const chainId = await this.handlerAsAvm().chainId();
709
- return toForeignCallResult([
710
- toSingle(chainId)
711
- ]);
621
+ aztec_utl_setTransient(...inputs) {
622
+ return callTxeHandler({
623
+ oracle: 'aztec_utl_setTransient',
624
+ inputs,
625
+ handler: ([slot, index, elements])=>this.handlerAsUtility().setTransient(slot, index, elements)
626
+ });
712
627
  }
713
628
  // eslint-disable-next-line camelcase
714
- async aztec_avm_version() {
715
- const version = await this.handlerAsAvm().version();
716
- return toForeignCallResult([
717
- toSingle(version)
718
- ]);
629
+ aztec_utl_getTransientLen(...inputs) {
630
+ return callTxeHandler({
631
+ oracle: 'aztec_utl_getTransientLen',
632
+ inputs,
633
+ handler: ([slot])=>this.handlerAsUtility().getTransientLen(slot)
634
+ });
719
635
  }
720
636
  // 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');
637
+ aztec_utl_removeTransient(...inputs) {
638
+ return callTxeHandler({
639
+ oracle: 'aztec_utl_removeTransient',
640
+ inputs,
641
+ handler: ([slot, index])=>this.handlerAsUtility().removeTransient(slot, index)
642
+ });
723
643
  }
724
644
  // 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');
645
+ aztec_utl_clearTransient(...inputs) {
646
+ return callTxeHandler({
647
+ oracle: 'aztec_utl_clearTransient',
648
+ inputs,
649
+ handler: ([slot])=>this.handlerAsUtility().clearTransient(slot)
650
+ });
727
651
  }
652
+ // TODO: I forgot to add a corresponding function here, when I introduced an oracle method to txe_oracle.ts.
653
+ // 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
654
+ // to implement this function here. Isn't there a way to programmatically identify that this is missing, given the
655
+ // existence of a txe_oracle method?
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_utl_decryptAes128(...inputs) {
658
+ return callTxeHandler({
659
+ oracle: 'aztec_utl_decryptAes128',
660
+ inputs,
661
+ handler: ([ciphertext, iv, symKey])=>this.handlerAsUtility().decryptAes128(ciphertext, iv, symKey)
662
+ });
663
+ }
664
+ // eslint-disable-next-line camelcase
665
+ aztec_utl_getSharedSecrets(...inputs) {
666
+ return callTxeHandler({
667
+ oracle: 'aztec_utl_getSharedSecrets',
668
+ inputs,
669
+ handler: ([address, ephPksSlot, contractAddress])=>this.handlerAsUtility().getSharedSecrets(address, ephPksSlot, contractAddress)
670
+ });
671
+ }
672
+ // eslint-disable-next-line camelcase
673
+ aztec_utl_setContractSyncCacheInvalid(...inputs) {
674
+ return callTxeHandler({
675
+ oracle: 'aztec_utl_setContractSyncCacheInvalid',
676
+ inputs,
677
+ handler: ([contractAddress, scopes])=>this.handlerAsUtility().setContractSyncCacheInvalid(contractAddress, scopes)
678
+ });
679
+ }
680
+ // eslint-disable-next-line camelcase
681
+ aztec_utl_emitOffchainEffect(...inputs) {
682
+ return callTxeHandler({
683
+ oracle: 'aztec_utl_emitOffchainEffect',
684
+ inputs,
685
+ handler: ([data])=>{
686
+ // Record the raw payload against the currently-executing top-level call. The Noir side
687
+ // (via `env.offchain_messages()`) is responsible for decoding the protocol-reserved prefix
688
+ // (`OFFCHAIN_MESSAGE_IDENTIFIER`, recipient) and turning each payload into an `OffchainMessage` struct suitable
689
+ // for `offchain_receive`.
690
+ this.stateHandler.recordOffchainEffect(data);
691
+ }
692
+ });
693
+ }
694
+ // eslint-disable-next-line camelcase
695
+ aztec_utl_recordFact(...inputs) {
696
+ return callTxeHandler({
697
+ oracle: 'aztec_utl_recordFact',
698
+ inputs,
699
+ handler: ([contractAddress, scope, factCollectionTypeId, factCollectionId, factTypeId, payload, originBlock])=>this.handlerAsUtility().recordFact(contractAddress, scope, factCollectionTypeId, factCollectionId, factTypeId, payload, originBlock)
700
+ });
701
+ }
702
+ // eslint-disable-next-line camelcase
703
+ aztec_utl_deleteFactCollection(...inputs) {
704
+ return callTxeHandler({
705
+ oracle: 'aztec_utl_deleteFactCollection',
706
+ inputs,
707
+ handler: ([contractAddress, scope, factCollectionTypeId, factCollectionId])=>this.handlerAsUtility().deleteFactCollection(contractAddress, scope, factCollectionTypeId, factCollectionId)
708
+ });
709
+ }
710
+ // eslint-disable-next-line camelcase
711
+ aztec_utl_getFactCollection(...inputs) {
712
+ return callTxeHandler({
713
+ oracle: 'aztec_utl_getFactCollection',
714
+ inputs,
715
+ handler: ([contractAddress, scope, factCollectionTypeId, factCollectionId])=>this.handlerAsUtility().getFactCollection(contractAddress, scope, factCollectionTypeId, factCollectionId)
716
+ });
717
+ }
718
+ // eslint-disable-next-line camelcase
719
+ aztec_utl_getFactCollectionsByType(...inputs) {
720
+ return callTxeHandler({
721
+ oracle: 'aztec_utl_getFactCollectionsByType',
722
+ inputs,
723
+ handler: ([contractAddress, scope, factCollectionTypeId])=>this.handlerAsUtility().getFactCollectionsByType(contractAddress, scope, factCollectionTypeId)
724
+ });
725
+ }
726
+ // eslint-disable-next-line camelcase
727
+ aztec_utl_callUtilityFunction(...inputs) {
728
+ return callTxeHandler({
729
+ oracle: 'aztec_utl_callUtilityFunction',
730
+ inputs,
731
+ handler: ([contractAddress, functionSelector, args])=>this.handlerAsUtility().callUtilityFunction(contractAddress, functionSelector, args)
732
+ });
731
733
  }
734
+ // AVM opcodes
732
735
  // 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');
736
+ aztec_avm_emitPublicLog() {
737
+ return callTxeHandler({
738
+ oracle: 'aztec_avm_emitPublicLog',
739
+ inputs: [],
740
+ // TODO(#8811): Implement
741
+ handler: ()=>{}
742
+ });
735
743
  }
736
744
  // 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
- }
745
+ aztec_avm_storageRead(...inputs) {
746
+ return callTxeHandler({
747
+ oracle: 'aztec_avm_storageRead',
748
+ inputs,
749
+ handler: ([slot, contractAddress])=>this.handlerAsAvm().storageRead(slot, contractAddress)
750
+ });
751
+ }
752
+ // eslint-disable-next-line camelcase
753
+ aztec_avm_storageWrite(...inputs) {
754
+ return callTxeHandler({
755
+ oracle: 'aztec_avm_storageWrite',
756
+ inputs,
757
+ handler: ([slot, value])=>this.handlerAsAvm().storageWrite(slot, value)
758
+ });
759
+ }
760
+ // eslint-disable-next-line camelcase
761
+ aztec_avm_getContractInstanceDeployer(...inputs) {
762
+ return callTxeHandler({
763
+ oracle: 'aztec_avm_getContractInstanceDeployer',
764
+ inputs,
765
+ handler: ([address])=>this.handlerAsAvm().getContractInstanceDeployer(address)
766
+ });
767
+ }
768
+ // eslint-disable-next-line camelcase
769
+ aztec_avm_getContractInstanceClassId(...inputs) {
770
+ return callTxeHandler({
771
+ oracle: 'aztec_avm_getContractInstanceClassId',
772
+ inputs,
773
+ handler: ([address])=>this.handlerAsAvm().getContractInstanceClassId(address)
774
+ });
775
+ }
776
+ // eslint-disable-next-line camelcase
777
+ aztec_avm_getContractInstanceInitializationHash(...inputs) {
778
+ return callTxeHandler({
779
+ oracle: 'aztec_avm_getContractInstanceInitializationHash',
780
+ inputs,
781
+ handler: ([address])=>this.handlerAsAvm().getContractInstanceInitializationHash(address)
782
+ });
783
+ }
784
+ // eslint-disable-next-line camelcase
785
+ aztec_avm_getContractInstanceImmutablesHash(...inputs) {
786
+ return callTxeHandler({
787
+ oracle: 'aztec_avm_getContractInstanceImmutablesHash',
788
+ inputs,
789
+ handler: ([address])=>this.handlerAsAvm().getContractInstanceImmutablesHash(address)
790
+ });
791
+ }
792
+ // eslint-disable-next-line camelcase
793
+ aztec_avm_sender() {
794
+ return callTxeHandler({
795
+ oracle: 'aztec_avm_sender',
796
+ inputs: [],
797
+ handler: ()=>this.handlerAsAvm().sender()
798
+ });
797
799
  }
798
800
  // 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([]);
801
+ aztec_avm_emitNullifier(...inputs) {
802
+ return callTxeHandler({
803
+ oracle: 'aztec_avm_emitNullifier',
804
+ inputs,
805
+ handler: ([nullifier])=>this.handlerAsAvm().emitNullifier(nullifier)
806
+ });
803
807
  }
804
808
  // 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
- ]);
809
+ aztec_avm_emitNoteHash(...inputs) {
810
+ return callTxeHandler({
811
+ oracle: 'aztec_avm_emitNoteHash',
812
+ inputs,
813
+ handler: ([noteHash])=>this.handlerAsAvm().emitNoteHash(noteHash)
814
+ });
815
+ }
816
+ // eslint-disable-next-line camelcase
817
+ aztec_avm_nullifierExists(...inputs) {
818
+ return callTxeHandler({
819
+ oracle: 'aztec_avm_nullifierExists',
820
+ inputs,
821
+ handler: ([siloedNullifier])=>this.handlerAsAvm().nullifierExists(siloedNullifier)
822
+ });
823
+ }
824
+ // eslint-disable-next-line camelcase
825
+ aztec_avm_address() {
826
+ return callTxeHandler({
827
+ oracle: 'aztec_avm_address',
828
+ inputs: [],
829
+ handler: ()=>this.handlerAsAvm().address()
830
+ });
831
+ }
832
+ // eslint-disable-next-line camelcase
833
+ aztec_avm_blockNumber() {
834
+ return callTxeHandler({
835
+ oracle: 'aztec_avm_blockNumber',
836
+ inputs: [],
837
+ handler: ()=>this.handlerAsAvm().blockNumber()
838
+ });
839
+ }
840
+ // eslint-disable-next-line camelcase
841
+ aztec_avm_timestamp() {
842
+ return callTxeHandler({
843
+ oracle: 'aztec_avm_timestamp',
844
+ inputs: [],
845
+ handler: ()=>this.handlerAsAvm().timestamp()
846
+ });
847
+ }
848
+ // eslint-disable-next-line camelcase
849
+ aztec_avm_isStaticCall() {
850
+ return callTxeHandler({
851
+ oracle: 'aztec_avm_isStaticCall',
852
+ inputs: [],
853
+ handler: ()=>this.handlerAsAvm().isStaticCall()
854
+ });
855
+ }
856
+ // eslint-disable-next-line camelcase
857
+ aztec_avm_chainId() {
858
+ return callTxeHandler({
859
+ oracle: 'aztec_avm_chainId',
860
+ inputs: [],
861
+ handler: ()=>this.handlerAsAvm().chainId()
862
+ });
863
+ }
864
+ // eslint-disable-next-line camelcase
865
+ aztec_avm_version() {
866
+ return callTxeHandler({
867
+ oracle: 'aztec_avm_version',
868
+ inputs: [],
869
+ handler: ()=>this.handlerAsAvm().version()
870
+ });
871
+ }
872
+ // eslint-disable-next-line camelcase
873
+ aztec_avm_returndataSize() {
874
+ return callTxeHandler({
875
+ oracle: 'aztec_avm_returndataSize',
876
+ inputs: [],
877
+ handler: ()=>this.handlerAsAvm().returndataSize()
878
+ });
879
+ }
880
+ // eslint-disable-next-line camelcase
881
+ aztec_avm_returndataCopy(...inputs) {
882
+ return callTxeHandler({
883
+ oracle: 'aztec_avm_returndataCopy',
884
+ inputs,
885
+ handler: ([rdOffset, copySize])=>this.handlerAsAvm().returndataCopy(rdOffset, copySize)
886
+ });
887
+ }
888
+ // eslint-disable-next-line camelcase
889
+ aztec_avm_call(...inputs) {
890
+ return callTxeHandler({
891
+ oracle: 'aztec_avm_call',
892
+ inputs,
893
+ handler: ([l2Gas, daGas, address, argsLength, args])=>this.handlerAsAvm().call(l2Gas, daGas, address, argsLength, args)
894
+ });
895
+ }
896
+ // eslint-disable-next-line camelcase
897
+ aztec_avm_staticCall(...inputs) {
898
+ return callTxeHandler({
899
+ oracle: 'aztec_avm_staticCall',
900
+ inputs,
901
+ handler: ([l2Gas, daGas, address, argsLength, args])=>this.handlerAsAvm().staticCall(l2Gas, daGas, address, argsLength, args)
902
+ });
903
+ }
904
+ // eslint-disable-next-line camelcase
905
+ aztec_avm_successCopy() {
906
+ return callTxeHandler({
907
+ oracle: 'aztec_avm_successCopy',
908
+ inputs: [],
909
+ handler: ()=>this.handlerAsAvm().successCopy()
910
+ });
911
+ }
912
+ // eslint-disable-next-line camelcase
913
+ aztec_txe_privateCallNewFlow(...inputs) {
914
+ return callTxeHandler({
915
+ oracle: 'aztec_txe_privateCallNewFlow',
916
+ inputs,
917
+ handler: ([from, targetContractAddress, functionSelector, args, argsHash, isStaticCall, additionalScopes, authorizedUtilityCallTargets, gasSettings])=>this.stateHandler.executePrivateCall(from, targetContractAddress, functionSelector, args, argsHash, isStaticCall, additionalScopes, authorizedUtilityCallTargets, gasSettings)
918
+ });
919
+ }
920
+ // eslint-disable-next-line camelcase
921
+ aztec_txe_executeUtilityFunction(...inputs) {
922
+ return callTxeHandler({
923
+ oracle: 'aztec_txe_executeUtilityFunction',
924
+ inputs,
925
+ handler: ([from, targetContractAddress, functionSelector, args, authorizedUtilityCallTargets])=>this.stateHandler.executeUtilityFunction(from, targetContractAddress, functionSelector, args, authorizedUtilityCallTargets)
926
+ });
927
+ }
928
+ // eslint-disable-next-line camelcase
929
+ aztec_txe_publicCallNewFlow(...inputs) {
930
+ return callTxeHandler({
931
+ oracle: 'aztec_txe_publicCallNewFlow',
932
+ inputs,
933
+ handler: ([from, address, calldata, isStaticCall, gasSettings])=>this.stateHandler.executePublicCall(from, address, calldata, isStaticCall, gasSettings)
934
+ });
935
+ }
936
+ // eslint-disable-next-line camelcase
937
+ aztec_prv_getSenderForTags() {
938
+ return callTxeHandler({
939
+ oracle: 'aztec_prv_getSenderForTags',
940
+ inputs: [],
941
+ handler: ()=>this.handlerAsPrivate().getSenderForTags()
942
+ });
943
+ }
944
+ // eslint-disable-next-line camelcase
945
+ aztec_prv_resolveTaggingStrategy(...inputs) {
946
+ return callTxeHandler({
947
+ oracle: 'aztec_prv_resolveTaggingStrategy',
948
+ inputs,
949
+ handler: ([sender, recipient, deliveryMode])=>this.handlerAsPrivate().resolveTaggingStrategy(sender, recipient, deliveryMode)
950
+ });
951
+ }
952
+ // eslint-disable-next-line camelcase
953
+ aztec_prv_resolveCustomRequest(...inputs) {
954
+ return callTxeHandler({
955
+ oracle: 'aztec_prv_resolveCustomRequest',
956
+ inputs,
957
+ handler: ([kind, payload])=>this.handlerAsPrivate().resolveCustomRequest(kind, payload)
958
+ });
959
+ }
960
+ // eslint-disable-next-line camelcase
961
+ aztec_prv_getAppTaggingSecret(...inputs) {
962
+ return callTxeHandler({
963
+ oracle: 'aztec_prv_getAppTaggingSecret',
964
+ inputs,
965
+ handler: ([sender, recipient])=>this.handlerAsPrivate().getAppTaggingSecret(sender, recipient)
966
+ });
967
+ }
968
+ // eslint-disable-next-line camelcase
969
+ aztec_prv_getNextTaggingIndex(...inputs) {
970
+ return callTxeHandler({
971
+ oracle: 'aztec_prv_getNextTaggingIndex',
972
+ inputs,
973
+ handler: ([secret, deliveryMode])=>this.handlerAsPrivate().getNextTaggingIndex(secret, deliveryMode)
974
+ });
812
975
  }
813
976
  }