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

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