@aztec/pxe 0.0.1-commit.f1df4d2 → 0.0.1-commit.f224bb98b
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.
- package/dest/access_scopes.d.ts +9 -0
- package/dest/access_scopes.d.ts.map +1 -0
- package/dest/access_scopes.js +6 -0
- package/dest/block_synchronizer/block_synchronizer.d.ts +4 -2
- package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
- package/dest/block_synchronizer/block_synchronizer.js +7 -1
- package/dest/config/index.d.ts +2 -2
- package/dest/config/index.d.ts.map +1 -1
- package/dest/config/index.js +1 -1
- package/dest/config/package_info.js +1 -1
- package/dest/contract_function_simulator/contract_function_simulator.d.ts +54 -28
- package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
- package/dest/contract_function_simulator/contract_function_simulator.js +177 -71
- package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +5 -5
- package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
- package/dest/contract_function_simulator/execution_tagging_index_cache.js +3 -3
- package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +2 -3
- package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts.map +1 -1
- package/dest/contract_function_simulator/noir-structs/event_validation_request.js +5 -4
- package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +1 -1
- package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts.map +1 -1
- package/dest/contract_function_simulator/noir-structs/log_retrieval_response.js +1 -3
- package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +2 -4
- package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts.map +1 -1
- package/dest/contract_function_simulator/noir-structs/note_validation_request.js +3 -5
- package/dest/contract_function_simulator/oracle/interfaces.d.ts +48 -45
- package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/oracle.d.ts +43 -44
- package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/oracle.js +130 -92
- package/dest/contract_function_simulator/oracle/private_execution.js +1 -1
- package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +55 -68
- package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/private_execution_oracle.js +98 -72
- package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +65 -42
- package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +98 -71
- package/dest/contract_logging.d.ts +22 -0
- package/dest/contract_logging.d.ts.map +1 -0
- package/dest/contract_logging.js +23 -0
- package/dest/contract_sync/contract_sync_service.d.ts +43 -0
- package/dest/contract_sync/contract_sync_service.d.ts.map +1 -0
- package/dest/contract_sync/contract_sync_service.js +97 -0
- package/dest/contract_sync/helpers.d.ts +29 -0
- package/dest/contract_sync/helpers.d.ts.map +1 -0
- package/dest/contract_sync/{index.js → helpers.js} +8 -14
- package/dest/debug/pxe_debug_utils.d.ts +14 -10
- package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
- package/dest/debug/pxe_debug_utils.js +16 -15
- package/dest/entrypoints/client/bundle/index.d.ts +4 -1
- package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
- package/dest/entrypoints/client/bundle/index.js +3 -0
- package/dest/entrypoints/client/bundle/utils.d.ts +1 -1
- package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
- package/dest/entrypoints/client/bundle/utils.js +9 -1
- package/dest/entrypoints/client/lazy/index.d.ts +4 -1
- package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
- package/dest/entrypoints/client/lazy/index.js +3 -0
- package/dest/entrypoints/client/lazy/utils.d.ts +1 -1
- package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
- package/dest/entrypoints/client/lazy/utils.js +9 -1
- package/dest/entrypoints/server/index.d.ts +4 -2
- package/dest/entrypoints/server/index.d.ts.map +1 -1
- package/dest/entrypoints/server/index.js +3 -1
- package/dest/entrypoints/server/utils.js +9 -1
- package/dest/logs/log_service.d.ts +3 -2
- package/dest/logs/log_service.d.ts.map +1 -1
- package/dest/logs/log_service.js +9 -14
- package/dest/notes/note_service.d.ts +4 -3
- package/dest/notes/note_service.d.ts.map +1 -1
- package/dest/notes/note_service.js +3 -2
- package/dest/notes_filter.d.ts +25 -0
- package/dest/notes_filter.d.ts.map +1 -0
- package/dest/notes_filter.js +4 -0
- package/dest/oracle_version.d.ts +2 -2
- package/dest/oracle_version.js +3 -3
- package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts +4 -0
- package/dest/private_kernel/hints/compute_tx_expiration_timestamp.d.ts.map +1 -0
- package/dest/private_kernel/hints/{compute_tx_include_by_timestamp.js → compute_tx_expiration_timestamp.js} +12 -12
- package/dest/private_kernel/hints/index.d.ts +1 -1
- package/dest/private_kernel/hints/index.js +1 -1
- package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts +4 -3
- package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.d.ts.map +1 -1
- package/dest/private_kernel/hints/private_kernel_reset_private_inputs_builder.js +129 -68
- package/dest/private_kernel/hints/test_utils.d.ts +122 -0
- package/dest/private_kernel/hints/test_utils.d.ts.map +1 -0
- package/dest/private_kernel/hints/test_utils.js +203 -0
- package/dest/private_kernel/private_kernel_execution_prover.d.ts +1 -1
- package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
- package/dest/private_kernel/private_kernel_execution_prover.js +19 -11
- package/dest/private_kernel/private_kernel_oracle.d.ts +6 -2
- package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
- package/dest/private_kernel/private_kernel_oracle.js +7 -3
- package/dest/pxe.d.ts +71 -24
- package/dest/pxe.d.ts.map +1 -1
- package/dest/pxe.js +100 -64
- package/dest/storage/contract_store/contract_store.d.ts +42 -15
- package/dest/storage/contract_store/contract_store.d.ts.map +1 -1
- package/dest/storage/contract_store/contract_store.js +145 -69
- package/dest/storage/note_store/note_store.d.ts +3 -3
- package/dest/storage/note_store/note_store.d.ts.map +1 -1
- package/dest/storage/note_store/note_store.js +6 -4
- package/dest/storage/tagging_store/recipient_tagging_store.d.ts +6 -6
- package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -1
- package/dest/storage/tagging_store/sender_tagging_store.d.ts +5 -5
- package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
- package/dest/storage/tagging_store/sender_tagging_store.js +4 -4
- package/dest/tagging/get_all_logs_by_tags.d.ts +1 -1
- package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
- package/dest/tagging/get_all_logs_by_tags.js +17 -3
- package/dest/tagging/index.d.ts +2 -2
- package/dest/tagging/index.d.ts.map +1 -1
- package/dest/tagging/index.js +1 -1
- package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +4 -5
- package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -1
- package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +7 -7
- package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
- package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +6 -7
- package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -1
- package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +12 -11
- package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +4 -8
- package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
- package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +3 -6
- package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +4 -7
- package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -1
- package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +14 -15
- package/package.json +25 -16
- package/src/access_scopes.ts +9 -0
- package/src/block_synchronizer/block_synchronizer.ts +6 -0
- package/src/config/index.ts +1 -1
- package/src/config/package_info.ts +1 -1
- package/src/contract_function_simulator/contract_function_simulator.ts +326 -131
- package/src/contract_function_simulator/execution_tagging_index_cache.ts +5 -5
- package/src/contract_function_simulator/noir-structs/event_validation_request.ts +8 -5
- package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +1 -4
- package/src/contract_function_simulator/noir-structs/note_validation_request.ts +3 -6
- package/src/contract_function_simulator/oracle/interfaces.ts +48 -54
- package/src/contract_function_simulator/oracle/oracle.ts +137 -137
- package/src/contract_function_simulator/oracle/private_execution.ts +1 -1
- package/src/contract_function_simulator/oracle/private_execution_oracle.ts +124 -164
- package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +146 -78
- package/src/contract_logging.ts +39 -0
- package/src/contract_sync/contract_sync_service.ts +152 -0
- package/src/contract_sync/{index.ts → helpers.ts} +13 -34
- package/src/debug/pxe_debug_utils.ts +48 -18
- package/src/entrypoints/client/bundle/index.ts +3 -0
- package/src/entrypoints/client/bundle/utils.ts +9 -1
- package/src/entrypoints/client/lazy/index.ts +3 -0
- package/src/entrypoints/client/lazy/utils.ts +9 -1
- package/src/entrypoints/server/index.ts +3 -1
- package/src/entrypoints/server/utils.ts +7 -7
- package/src/logs/log_service.ts +17 -24
- package/src/notes/note_service.ts +4 -3
- package/src/notes_filter.ts +26 -0
- package/src/oracle_version.ts +3 -3
- package/src/private_kernel/hints/{compute_tx_include_by_timestamp.ts → compute_tx_expiration_timestamp.ts} +13 -13
- package/src/private_kernel/hints/index.ts +1 -1
- package/src/private_kernel/hints/private_kernel_reset_private_inputs_builder.ts +164 -117
- package/src/private_kernel/hints/test_utils.ts +325 -0
- package/src/private_kernel/private_kernel_execution_prover.ts +19 -12
- package/src/private_kernel/private_kernel_oracle.ts +7 -7
- package/src/pxe.ts +181 -116
- package/src/storage/contract_store/contract_store.ts +174 -75
- package/src/storage/note_store/note_store.ts +12 -5
- package/src/storage/tagging_store/recipient_tagging_store.ts +9 -5
- package/src/storage/tagging_store/sender_tagging_store.ts +8 -8
- package/src/tagging/get_all_logs_by_tags.ts +28 -4
- package/src/tagging/index.ts +1 -1
- package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +7 -10
- package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +2 -2
- package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +10 -15
- package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +4 -9
- package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +11 -20
- package/dest/contract_sync/index.d.ts +0 -24
- package/dest/contract_sync/index.d.ts.map +0 -1
- package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts +0 -4
- package/dest/private_kernel/hints/compute_tx_include_by_timestamp.d.ts.map +0 -1
|
@@ -6,11 +6,10 @@ import { toACVMWitness } from '@aztec/simulator/client';
|
|
|
6
6
|
import { FunctionSelector, countArgumentsSize } from '@aztec/stdlib/abi';
|
|
7
7
|
import { siloNullifier } from '@aztec/stdlib/hash';
|
|
8
8
|
import { PrivateContextInputs } from '@aztec/stdlib/kernel';
|
|
9
|
-
import {
|
|
9
|
+
import { ExtendedDirectionalAppTaggingSecret } from '@aztec/stdlib/logs';
|
|
10
10
|
import { Tag } from '@aztec/stdlib/logs';
|
|
11
11
|
import { Note } from '@aztec/stdlib/note';
|
|
12
12
|
import { CallContext, CountedContractClassLog, NoteAndSlot } from '@aztec/stdlib/tx';
|
|
13
|
-
import { ensureContractSynced } from '../../contract_sync/index.js';
|
|
14
13
|
import { NoteService } from '../../notes/note_service.js';
|
|
15
14
|
import { syncSenderTaggingIndexes } from '../../tagging/index.js';
|
|
16
15
|
import { pickNotes } from '../pick_notes.js';
|
|
@@ -19,34 +18,51 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
19
18
|
/**
|
|
20
19
|
* The execution oracle for the private part of a transaction.
|
|
21
20
|
*/ export class PrivateExecutionOracle extends UtilityExecutionOracle {
|
|
21
|
+
isPrivate = true;
|
|
22
|
+
/**
|
|
23
|
+
* New notes created during this execution.
|
|
24
|
+
* It's possible that a note in this list has been nullified (in the same or other executions) and doesn't exist in
|
|
25
|
+
* the ExecutionNoteCache and the final proof data. But we still include those notes in the execution result because
|
|
26
|
+
* their commitments are still in the public inputs of this execution.
|
|
27
|
+
* This information is only for references (currently used for tests), and is not used for any sort of constrains.
|
|
28
|
+
* Users can also use this to get a clearer idea of what's happened during a simulation.
|
|
29
|
+
*/ newNotes = [];
|
|
30
|
+
noteHashNullifierCounterMap = new Map();
|
|
31
|
+
contractClassLogs = [];
|
|
32
|
+
offchainEffects = [];
|
|
33
|
+
nestedExecutionResults = [];
|
|
22
34
|
argsHash;
|
|
23
35
|
txContext;
|
|
24
36
|
callContext;
|
|
25
|
-
anchorBlockHeader;
|
|
26
37
|
utilityExecutor;
|
|
27
38
|
executionCache;
|
|
28
39
|
noteCache;
|
|
29
40
|
taggingIndexCache;
|
|
30
41
|
senderTaggingStore;
|
|
42
|
+
contractSyncService;
|
|
31
43
|
totalPublicCalldataCount;
|
|
32
44
|
sideEffectCounter;
|
|
33
45
|
senderForTags;
|
|
34
46
|
simulator;
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
47
|
+
constructor(args){
|
|
48
|
+
super({
|
|
49
|
+
...args,
|
|
50
|
+
contractAddress: args.callContext.contractAddress,
|
|
51
|
+
log: args.log ?? createLogger('simulator:client_execution_context')
|
|
52
|
+
});
|
|
53
|
+
this.argsHash = args.argsHash;
|
|
54
|
+
this.txContext = args.txContext;
|
|
55
|
+
this.callContext = args.callContext;
|
|
56
|
+
this.utilityExecutor = args.utilityExecutor;
|
|
57
|
+
this.executionCache = args.executionCache;
|
|
58
|
+
this.noteCache = args.noteCache;
|
|
59
|
+
this.taggingIndexCache = args.taggingIndexCache;
|
|
60
|
+
this.senderTaggingStore = args.senderTaggingStore;
|
|
61
|
+
this.contractSyncService = args.contractSyncService;
|
|
62
|
+
this.totalPublicCalldataCount = args.totalPublicCalldataCount ?? 0;
|
|
63
|
+
this.sideEffectCounter = args.sideEffectCounter ?? 0;
|
|
64
|
+
this.senderForTags = args.senderForTags;
|
|
65
|
+
this.simulator = args.simulator;
|
|
50
66
|
}
|
|
51
67
|
getPrivateContextInputs() {
|
|
52
68
|
return new PrivateContextInputs(this.callContext, this.anchorBlockHeader, this.txContext, this.sideEffectCounter);
|
|
@@ -110,7 +126,7 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
110
126
|
*
|
|
111
127
|
* The value persists through nested calls, meaning all calls down the stack will use the same
|
|
112
128
|
* 'senderForTags' value (unless it is replaced).
|
|
113
|
-
*/
|
|
129
|
+
*/ getSenderForTags() {
|
|
114
130
|
return Promise.resolve(this.senderForTags);
|
|
115
131
|
}
|
|
116
132
|
/**
|
|
@@ -123,7 +139,7 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
123
139
|
* Account contracts typically set this value before calling other contracts. The value persists
|
|
124
140
|
* through nested calls, meaning all calls down the stack will use the same 'senderForTags'
|
|
125
141
|
* value (unless it is replaced by another call to this setter).
|
|
126
|
-
*/
|
|
142
|
+
*/ setSenderForTags(senderForTags) {
|
|
127
143
|
this.senderForTags = senderForTags;
|
|
128
144
|
return Promise.resolve();
|
|
129
145
|
}
|
|
@@ -132,20 +148,20 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
132
148
|
* @param sender - The address sending the log
|
|
133
149
|
* @param recipient - The address receiving the log
|
|
134
150
|
* @returns An app tag to be used in a log.
|
|
135
|
-
*/ async
|
|
136
|
-
const
|
|
137
|
-
const index = await this.#getIndexToUseForSecret(
|
|
138
|
-
this.
|
|
139
|
-
this.taggingIndexCache.setLastUsedIndex(
|
|
151
|
+
*/ async getNextAppTagAsSender(sender, recipient) {
|
|
152
|
+
const extendedSecret = await this.#calculateExtendedDirectionalAppTaggingSecret(this.contractAddress, sender, recipient);
|
|
153
|
+
const index = await this.#getIndexToUseForSecret(extendedSecret);
|
|
154
|
+
this.logger.debug(`Incrementing tagging index for sender: ${sender}, recipient: ${recipient}, contract: ${this.contractAddress} to ${index}`);
|
|
155
|
+
this.taggingIndexCache.setLastUsedIndex(extendedSecret, index);
|
|
140
156
|
return Tag.compute({
|
|
141
|
-
|
|
157
|
+
extendedSecret,
|
|
142
158
|
index
|
|
143
159
|
});
|
|
144
160
|
}
|
|
145
|
-
async #
|
|
161
|
+
async #calculateExtendedDirectionalAppTaggingSecret(contractAddress, sender, recipient) {
|
|
146
162
|
const senderCompleteAddress = await this.getCompleteAddressOrFail(sender);
|
|
147
163
|
const senderIvsk = await this.keyStore.getMasterIncomingViewingSecretKey(sender);
|
|
148
|
-
return
|
|
164
|
+
return ExtendedDirectionalAppTaggingSecret.compute(senderCompleteAddress, senderIvsk, recipient, contractAddress, recipient);
|
|
149
165
|
}
|
|
150
166
|
async #getIndexToUseForSecret(secret) {
|
|
151
167
|
// If we have the tagging index in the cache, we use it. If not we obtain it from the execution data provider.
|
|
@@ -156,7 +172,7 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
156
172
|
// This is a tagging secret we've not yet used in this tx, so first sync our store to make sure its indices
|
|
157
173
|
// are up to date. We do this here because this store is not synced as part of the global sync because
|
|
158
174
|
// that'd be wasteful as most tagging secrets are not used in each tx.
|
|
159
|
-
await syncSenderTaggingIndexes(secret, this.
|
|
175
|
+
await syncSenderTaggingIndexes(secret, this.aztecNode, this.senderTaggingStore, await this.anchorBlockHeader.hash(), this.jobId);
|
|
160
176
|
const lastUsedIndex = await this.senderTaggingStore.getLastUsedIndex(secret, this.jobId);
|
|
161
177
|
// If lastUsedIndex is undefined, we've never used this secret, so start from 0
|
|
162
178
|
// Otherwise, the next index to use is one past the last used index
|
|
@@ -167,29 +183,29 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
167
183
|
* Store values in the execution cache.
|
|
168
184
|
* @param values - Values to store.
|
|
169
185
|
* @returns The hash of the values.
|
|
170
|
-
*/
|
|
186
|
+
*/ storeInExecutionCache(values, hash) {
|
|
171
187
|
return this.executionCache.store(values, hash);
|
|
172
188
|
}
|
|
173
189
|
/**
|
|
174
190
|
* Gets values from the execution cache.
|
|
175
191
|
* @param hash - Hash of the values.
|
|
176
192
|
* @returns The values.
|
|
177
|
-
*/
|
|
193
|
+
*/ loadFromExecutionCache(hash) {
|
|
178
194
|
const preimage = this.executionCache.getPreimage(hash);
|
|
179
195
|
if (!preimage) {
|
|
180
196
|
throw new Error(`Preimage for hash ${hash.toString()} not found in cache`);
|
|
181
197
|
}
|
|
182
198
|
return Promise.resolve(preimage);
|
|
183
199
|
}
|
|
184
|
-
async
|
|
200
|
+
async checkNullifierExists(innerNullifier) {
|
|
185
201
|
// This oracle must be overridden because while utility execution can only meaningfully check if a nullifier exists
|
|
186
202
|
// in the synched block, during private execution there's also the possibility of it being pending, i.e. created
|
|
187
203
|
// in the current transaction.
|
|
188
|
-
this.
|
|
204
|
+
this.logger.debug(`Checking existence of inner nullifier ${innerNullifier}`, {
|
|
189
205
|
contractAddress: this.contractAddress
|
|
190
206
|
});
|
|
191
207
|
const nullifier = (await siloNullifier(this.contractAddress, innerNullifier)).toBigInt();
|
|
192
|
-
return this.noteCache.getNullifiers(this.contractAddress).has(nullifier) || await super.
|
|
208
|
+
return this.noteCache.getNullifiers(this.contractAddress).has(nullifier) || await super.checkNullifierExists(innerNullifier);
|
|
193
209
|
}
|
|
194
210
|
/**
|
|
195
211
|
* Gets some notes for a storage slot.
|
|
@@ -211,7 +227,7 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
211
227
|
* @param offset - The starting index for pagination.
|
|
212
228
|
* @param status - The status of notes to fetch.
|
|
213
229
|
* @returns Array of note data.
|
|
214
|
-
*/ async
|
|
230
|
+
*/ async getNotes(owner, storageSlot, numSelects, selectByIndexes, selectByOffsets, selectByLengths, selectValues, selectComparators, sortByIndexes, sortByOffsets, sortByLengths, sortOrder, limit, offset, status) {
|
|
215
231
|
// Nullified pending notes are already removed from the list.
|
|
216
232
|
const pendingNotes = this.noteCache.getNotes(this.callContext.contractAddress, owner, storageSlot);
|
|
217
233
|
const pendingNullifiers = this.noteCache.getNullifiers(this.callContext.contractAddress);
|
|
@@ -242,7 +258,7 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
242
258
|
limit,
|
|
243
259
|
offset
|
|
244
260
|
});
|
|
245
|
-
this.
|
|
261
|
+
this.logger.debug(`Returning ${notes.length} notes for ${this.callContext.contractAddress} at ${storageSlot}: ${notes.map((n)=>`${n.noteNonce.toString()}:[${n.note.items.map((i)=>i.toString()).join(',')}]`).join(', ')}`);
|
|
246
262
|
return notes;
|
|
247
263
|
}
|
|
248
264
|
/**
|
|
@@ -255,8 +271,8 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
255
271
|
* @param noteItems - The items to be included in a Note.
|
|
256
272
|
* @param noteHash - A hash of the new note.
|
|
257
273
|
* @returns
|
|
258
|
-
*/
|
|
259
|
-
this.
|
|
274
|
+
*/ notifyCreatedNote(owner, storageSlot, randomness, noteTypeId, noteItems, noteHash, counter) {
|
|
275
|
+
this.logger.debug(`Notified of new note with inner hash ${noteHash}`, {
|
|
260
276
|
contractAddress: this.callContext.contractAddress,
|
|
261
277
|
storageSlot,
|
|
262
278
|
randomness,
|
|
@@ -287,7 +303,7 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
287
303
|
* within the current transaction/execution.
|
|
288
304
|
* @param innerNullifier - The pending nullifier to add in the list (not yet siloed by contract address).
|
|
289
305
|
* @param noteHash - A hash of the new note.
|
|
290
|
-
*/ async
|
|
306
|
+
*/ async notifyNullifiedNote(innerNullifier, noteHash, counter) {
|
|
291
307
|
const nullifiedNoteHashCounter = await this.noteCache.nullifyNote(this.callContext.contractAddress, innerNullifier, noteHash);
|
|
292
308
|
if (nullifiedNoteHashCounter !== undefined) {
|
|
293
309
|
this.noteHashNullifierCounterMap.set(nullifiedNoteHashCounter, counter);
|
|
@@ -298,19 +314,19 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
298
314
|
* within the current transaction/execution.
|
|
299
315
|
* @param innerNullifier - The pending nullifier to add in the list (not yet siloed by contract address).
|
|
300
316
|
* @param noteHash - A hash of the new note.
|
|
301
|
-
*/
|
|
302
|
-
this.
|
|
317
|
+
*/ notifyCreatedNullifier(innerNullifier) {
|
|
318
|
+
this.logger.debug(`Notified of new inner nullifier ${innerNullifier}`, {
|
|
303
319
|
contractAddress: this.contractAddress
|
|
304
320
|
});
|
|
305
321
|
return this.noteCache.nullifierCreated(this.callContext.contractAddress, innerNullifier);
|
|
306
322
|
}
|
|
307
323
|
/**
|
|
308
|
-
* Check if a nullifier has been emitted in the same transaction, i.e. if
|
|
324
|
+
* Check if a nullifier has been emitted in the same transaction, i.e. if notifyCreatedNullifier has been
|
|
309
325
|
* called for this inner nullifier from the contract with the specified address.
|
|
310
326
|
* @param innerNullifier - The inner nullifier to check.
|
|
311
327
|
* @param contractAddress - Address of the contract that emitted the nullifier.
|
|
312
328
|
* @returns A boolean indicating whether the nullifier is pending or not.
|
|
313
|
-
*/ async
|
|
329
|
+
*/ async isNullifierPending(innerNullifier, contractAddress) {
|
|
314
330
|
const siloedNullifier = await siloNullifier(contractAddress, innerNullifier);
|
|
315
331
|
const isNullifierPending = this.noteCache.getNullifiers(contractAddress).has(siloedNullifier.toBigInt());
|
|
316
332
|
return Promise.resolve(isNullifierPending);
|
|
@@ -321,10 +337,10 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
321
337
|
* keep the preimage in ts for later.
|
|
322
338
|
* @param log - The contract class log to be emitted.
|
|
323
339
|
* @param counter - The contract class log's counter.
|
|
324
|
-
*/
|
|
340
|
+
*/ notifyCreatedContractClassLog(log, counter) {
|
|
325
341
|
this.contractClassLogs.push(new CountedContractClassLog(log, counter));
|
|
326
342
|
const text = log.toBuffer().toString('hex');
|
|
327
|
-
this.
|
|
343
|
+
this.logger.verbose(`Emitted log from ContractClassRegistry: "${text.length > 100 ? text.slice(0, 100) + '...' : text}"`);
|
|
328
344
|
}
|
|
329
345
|
#checkValidStaticCall(childExecutionResult) {
|
|
330
346
|
if (childExecutionResult.publicInputs.noteHashes.claimedLength > 0 || childExecutionResult.publicInputs.nullifiers.claimedLength > 0 || childExecutionResult.publicInputs.l2ToL1Msgs.claimedLength > 0 || childExecutionResult.publicInputs.privateLogs.claimedLength > 0 || childExecutionResult.publicInputs.contractClassLogsHashes.claimedLength > 0) {
|
|
@@ -339,20 +355,49 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
339
355
|
* @param sideEffectCounter - The side effect counter at the start of the call.
|
|
340
356
|
* @param isStaticCall - Whether the call is a static call.
|
|
341
357
|
* @returns The execution result.
|
|
342
|
-
*/ async
|
|
358
|
+
*/ async callPrivateFunction(targetContractAddress, functionSelector, argsHash, sideEffectCounter, isStaticCall) {
|
|
343
359
|
if (!this.simulator) {
|
|
344
360
|
// In practice it is only when creating inline private contexts in a Noir test using TXE that we create an
|
|
345
361
|
// instance of this class without a simulator.
|
|
346
362
|
throw new Error('No simulator provided, cannot perform a nested private call');
|
|
347
363
|
}
|
|
348
364
|
const simulatorSetupTimer = new Timer();
|
|
349
|
-
this.
|
|
365
|
+
this.logger.debug(`Calling private function ${targetContractAddress}:${functionSelector} from ${this.callContext.contractAddress}`);
|
|
350
366
|
isStaticCall = isStaticCall || this.callContext.isStaticCall;
|
|
351
|
-
await ensureContractSynced(targetContractAddress, functionSelector, this.utilityExecutor, this.
|
|
367
|
+
await this.contractSyncService.ensureContractSynced(targetContractAddress, functionSelector, this.utilityExecutor, this.anchorBlockHeader, this.jobId, this.scopes);
|
|
352
368
|
const targetArtifact = await this.contractStore.getFunctionArtifactWithDebugMetadata(targetContractAddress, functionSelector);
|
|
353
369
|
const derivedTxContext = this.txContext.clone();
|
|
354
370
|
const derivedCallContext = await this.deriveCallContext(targetContractAddress, targetArtifact, isStaticCall);
|
|
355
|
-
const privateExecutionOracle = new PrivateExecutionOracle(
|
|
371
|
+
const privateExecutionOracle = new PrivateExecutionOracle({
|
|
372
|
+
argsHash,
|
|
373
|
+
txContext: derivedTxContext,
|
|
374
|
+
callContext: derivedCallContext,
|
|
375
|
+
anchorBlockHeader: this.anchorBlockHeader,
|
|
376
|
+
utilityExecutor: this.utilityExecutor,
|
|
377
|
+
authWitnesses: this.authWitnesses,
|
|
378
|
+
capsules: this.capsules,
|
|
379
|
+
executionCache: this.executionCache,
|
|
380
|
+
noteCache: this.noteCache,
|
|
381
|
+
taggingIndexCache: this.taggingIndexCache,
|
|
382
|
+
contractStore: this.contractStore,
|
|
383
|
+
noteStore: this.noteStore,
|
|
384
|
+
keyStore: this.keyStore,
|
|
385
|
+
addressStore: this.addressStore,
|
|
386
|
+
aztecNode: this.aztecNode,
|
|
387
|
+
senderTaggingStore: this.senderTaggingStore,
|
|
388
|
+
recipientTaggingStore: this.recipientTaggingStore,
|
|
389
|
+
senderAddressBookStore: this.senderAddressBookStore,
|
|
390
|
+
capsuleStore: this.capsuleStore,
|
|
391
|
+
privateEventStore: this.privateEventStore,
|
|
392
|
+
contractSyncService: this.contractSyncService,
|
|
393
|
+
jobId: this.jobId,
|
|
394
|
+
totalPublicCalldataCount: this.totalPublicCalldataCount,
|
|
395
|
+
sideEffectCounter,
|
|
396
|
+
log: this.logger,
|
|
397
|
+
scopes: this.scopes,
|
|
398
|
+
senderForTags: this.senderForTags,
|
|
399
|
+
simulator: this.simulator
|
|
400
|
+
});
|
|
356
401
|
const setupTime = simulatorSetupTimer.ms();
|
|
357
402
|
const childExecutionResult = await executePrivateFunction(this.simulator, privateExecutionOracle, targetArtifact, targetContractAddress, functionSelector);
|
|
358
403
|
if (isStaticCall) {
|
|
@@ -369,7 +414,7 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
369
414
|
returnsHash: publicInputs.returnsHash
|
|
370
415
|
};
|
|
371
416
|
}
|
|
372
|
-
|
|
417
|
+
/** Validates the calldata preimage exists in the cache and checks cumulative calldata size is within limits. */ validatePublicCalldata(calldataHash) {
|
|
373
418
|
const calldata = this.executionCache.getPreimage(calldataHash);
|
|
374
419
|
if (!calldata) {
|
|
375
420
|
throw new Error('Calldata for public call not found in cache');
|
|
@@ -378,31 +423,12 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
378
423
|
if (this.totalPublicCalldataCount > MAX_FR_CALLDATA_TO_ALL_ENQUEUED_CALLS) {
|
|
379
424
|
throw new Error(`Too many total args to all enqueued public calls! (> ${MAX_FR_CALLDATA_TO_ALL_ENQUEUED_CALLS})`);
|
|
380
425
|
}
|
|
381
|
-
}
|
|
382
|
-
/**
|
|
383
|
-
* Verify relevant information when a public function is enqueued.
|
|
384
|
-
* @param targetContractAddress - The address of the contract to call.
|
|
385
|
-
* @param calldataHash - The hash of the function selector and arguments.
|
|
386
|
-
* @param sideEffectCounter - The side effect counter at the start of the call.
|
|
387
|
-
* @param isStaticCall - Whether the call is a static call.
|
|
388
|
-
*/ privateNotifyEnqueuedPublicFunctionCall(_targetContractAddress, calldataHash, _sideEffectCounter, _isStaticCall) {
|
|
389
|
-
this.#onNewPublicFunctionCall(calldataHash);
|
|
390
|
-
return Promise.resolve();
|
|
391
|
-
}
|
|
392
|
-
/**
|
|
393
|
-
* Verify relevant information when a public teardown function is set.
|
|
394
|
-
* @param targetContractAddress - The address of the contract to call.
|
|
395
|
-
* @param argsHash - The arguments hash to pass to the function.
|
|
396
|
-
* @param sideEffectCounter - The side effect counter at the start of the call.
|
|
397
|
-
* @param isStaticCall - Whether the call is a static call.
|
|
398
|
-
*/ privateNotifySetPublicTeardownFunctionCall(_targetContractAddress, calldataHash, _sideEffectCounter, _isStaticCall) {
|
|
399
|
-
this.#onNewPublicFunctionCall(calldataHash);
|
|
400
426
|
return Promise.resolve();
|
|
401
427
|
}
|
|
402
|
-
|
|
428
|
+
notifyRevertiblePhaseStart(minRevertibleSideEffectCounter) {
|
|
403
429
|
return this.noteCache.setMinRevertibleSideEffectCounter(minRevertibleSideEffectCounter);
|
|
404
430
|
}
|
|
405
|
-
|
|
431
|
+
inRevertiblePhase(sideEffectCounter) {
|
|
406
432
|
return Promise.resolve(this.noteCache.isSideEffectCounterRevertible(sideEffectCounter));
|
|
407
433
|
}
|
|
408
434
|
/**
|
|
@@ -417,7 +443,7 @@ import { UtilityExecutionOracle } from './utility_execution_oracle.js';
|
|
|
417
443
|
getDebugFunctionName() {
|
|
418
444
|
return this.contractStore.getDebugFunctionName(this.contractAddress, this.callContext.functionSelector);
|
|
419
445
|
}
|
|
420
|
-
|
|
446
|
+
emitOffchainEffect(data) {
|
|
421
447
|
this.offchainEffects.push({
|
|
422
448
|
data
|
|
423
449
|
});
|
|
@@ -2,17 +2,20 @@ import type { ARCHIVE_HEIGHT, NOTE_HASH_TREE_HEIGHT } from '@aztec/constants';
|
|
|
2
2
|
import type { BlockNumber } from '@aztec/foundation/branded-types';
|
|
3
3
|
import { Fr } from '@aztec/foundation/curves/bn254';
|
|
4
4
|
import { Point } from '@aztec/foundation/curves/grumpkin';
|
|
5
|
+
import { createLogger } from '@aztec/foundation/log';
|
|
5
6
|
import type { MembershipWitness } from '@aztec/foundation/trees';
|
|
6
7
|
import type { KeyStore } from '@aztec/key-store';
|
|
7
8
|
import type { AuthWitness } from '@aztec/stdlib/auth-witness';
|
|
8
9
|
import { AztecAddress } from '@aztec/stdlib/aztec-address';
|
|
9
10
|
import { BlockHash } from '@aztec/stdlib/block';
|
|
10
|
-
import type { CompleteAddress, ContractInstance } from '@aztec/stdlib/contract';
|
|
11
|
+
import type { CompleteAddress, ContractInstance, PartialAddress } from '@aztec/stdlib/contract';
|
|
11
12
|
import type { AztecNode } from '@aztec/stdlib/interfaces/server';
|
|
12
13
|
import type { KeyValidationRequest } from '@aztec/stdlib/kernel';
|
|
14
|
+
import { type PublicKeys } from '@aztec/stdlib/keys';
|
|
13
15
|
import type { NoteStatus } from '@aztec/stdlib/note';
|
|
14
16
|
import { type NullifierMembershipWitness, PublicDataWitness } from '@aztec/stdlib/trees';
|
|
15
17
|
import type { BlockHeader, Capsule } from '@aztec/stdlib/tx';
|
|
18
|
+
import type { AccessScopes } from '../../access_scopes.js';
|
|
16
19
|
import type { AddressStore } from '../../storage/address_store/address_store.js';
|
|
17
20
|
import type { CapsuleStore } from '../../storage/capsule_store/capsule_store.js';
|
|
18
21
|
import type { ContractStore } from '../../storage/contract_store/contract_store.js';
|
|
@@ -23,12 +26,35 @@ import type { SenderAddressBookStore } from '../../storage/tagging_store/sender_
|
|
|
23
26
|
import { UtilityContext } from '../noir-structs/utility_context.js';
|
|
24
27
|
import type { IMiscOracle, IUtilityExecutionOracle, NoteData } from './interfaces.js';
|
|
25
28
|
import { MessageLoadOracleInputs } from './message_load_oracle_inputs.js';
|
|
29
|
+
/** Args for UtilityExecutionOracle constructor. */
|
|
30
|
+
export type UtilityExecutionOracleArgs = {
|
|
31
|
+
contractAddress: AztecAddress;
|
|
32
|
+
/** List of transient auth witnesses to be used during this simulation */
|
|
33
|
+
authWitnesses: AuthWitness[];
|
|
34
|
+
capsules: Capsule[];
|
|
35
|
+
anchorBlockHeader: BlockHeader;
|
|
36
|
+
contractStore: ContractStore;
|
|
37
|
+
noteStore: NoteStore;
|
|
38
|
+
keyStore: KeyStore;
|
|
39
|
+
addressStore: AddressStore;
|
|
40
|
+
aztecNode: AztecNode;
|
|
41
|
+
recipientTaggingStore: RecipientTaggingStore;
|
|
42
|
+
senderAddressBookStore: SenderAddressBookStore;
|
|
43
|
+
capsuleStore: CapsuleStore;
|
|
44
|
+
privateEventStore: PrivateEventStore;
|
|
45
|
+
jobId: string;
|
|
46
|
+
log?: ReturnType<typeof createLogger>;
|
|
47
|
+
scopes: AccessScopes;
|
|
48
|
+
};
|
|
26
49
|
/**
|
|
27
50
|
* The oracle for an execution of utility contract functions.
|
|
28
51
|
*/
|
|
29
52
|
export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExecutionOracle {
|
|
53
|
+
#private;
|
|
54
|
+
isMisc: true;
|
|
55
|
+
isUtility: true;
|
|
56
|
+
private contractLogger;
|
|
30
57
|
protected readonly contractAddress: AztecAddress;
|
|
31
|
-
/** List of transient auth witnesses to be used during this simulation */
|
|
32
58
|
protected readonly authWitnesses: AuthWitness[];
|
|
33
59
|
protected readonly capsules: Capsule[];
|
|
34
60
|
protected readonly anchorBlockHeader: BlockHeader;
|
|
@@ -42,24 +68,20 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
42
68
|
protected readonly capsuleStore: CapsuleStore;
|
|
43
69
|
protected readonly privateEventStore: PrivateEventStore;
|
|
44
70
|
protected readonly jobId: string;
|
|
45
|
-
protected
|
|
46
|
-
protected readonly scopes
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
50
|
-
|
|
51
|
-
/** List of transient auth witnesses to be used during this simulation */
|
|
52
|
-
authWitnesses: AuthWitness[], capsules: Capsule[], anchorBlockHeader: BlockHeader, contractStore: ContractStore, noteStore: NoteStore, keyStore: KeyStore, addressStore: AddressStore, aztecNode: AztecNode, recipientTaggingStore: RecipientTaggingStore, senderAddressBookStore: SenderAddressBookStore, capsuleStore: CapsuleStore, privateEventStore: PrivateEventStore, jobId: string, log?: import("@aztec/foundation/log").Logger, scopes?: AztecAddress[] | undefined);
|
|
53
|
-
utilityAssertCompatibleOracleVersion(version: number): void;
|
|
54
|
-
utilityGetRandomField(): Fr;
|
|
55
|
-
utilityGetUtilityContext(): UtilityContext;
|
|
71
|
+
protected logger: ReturnType<typeof createLogger>;
|
|
72
|
+
protected readonly scopes: AccessScopes;
|
|
73
|
+
constructor(args: UtilityExecutionOracleArgs);
|
|
74
|
+
assertCompatibleOracleVersion(version: number): void;
|
|
75
|
+
getRandomField(): Fr;
|
|
76
|
+
getUtilityContext(): UtilityContext;
|
|
56
77
|
/**
|
|
57
78
|
* Retrieve keys associated with a specific master public key and app address.
|
|
58
79
|
* @param pkMHash - The master public key hash.
|
|
59
80
|
* @returns A Promise that resolves to nullifier keys.
|
|
60
81
|
* @throws If the keys are not registered in the key store.
|
|
82
|
+
* @throws If scopes are defined and the account is not in the scopes.
|
|
61
83
|
*/
|
|
62
|
-
|
|
84
|
+
getKeyValidationRequest(pkMHash: Fr): Promise<KeyValidationRequest>;
|
|
63
85
|
/**
|
|
64
86
|
* Fetches the index and sibling path of a leaf at a given block from the note hash tree.
|
|
65
87
|
* @param anchorBlockHash - The hash of a block that contains the note hash tree root in which to find the membership
|
|
@@ -67,7 +89,7 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
67
89
|
* @param noteHash - The note hash to find in the note hash tree.
|
|
68
90
|
* @returns The membership witness containing the leaf index and sibling path
|
|
69
91
|
*/
|
|
70
|
-
|
|
92
|
+
getNoteHashMembershipWitness(anchorBlockHash: BlockHash, noteHash: Fr): Promise<MembershipWitness<typeof NOTE_HASH_TREE_HEIGHT> | undefined>;
|
|
71
93
|
/**
|
|
72
94
|
* Fetches the index and sibling path of a block hash in the archive tree.
|
|
73
95
|
*
|
|
@@ -79,14 +101,14 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
79
101
|
* @param blockHash - The block hash to find in the archive tree.
|
|
80
102
|
* @returns The membership witness containing the leaf index and sibling path
|
|
81
103
|
*/
|
|
82
|
-
|
|
104
|
+
getBlockHashMembershipWitness(anchorBlockHash: BlockHash, blockHash: BlockHash): Promise<MembershipWitness<typeof ARCHIVE_HEIGHT> | undefined>;
|
|
83
105
|
/**
|
|
84
106
|
* Returns a nullifier membership witness for a given nullifier at a given block.
|
|
85
107
|
* @param blockHash - The block hash at which to get the index.
|
|
86
108
|
* @param nullifier - Nullifier we try to find witness for.
|
|
87
109
|
* @returns The nullifier membership witness (if found).
|
|
88
110
|
*/
|
|
89
|
-
|
|
111
|
+
getNullifierMembershipWitness(blockHash: BlockHash, nullifier: Fr): Promise<NullifierMembershipWitness | undefined>;
|
|
90
112
|
/**
|
|
91
113
|
* Returns a low nullifier membership witness for a given nullifier at a given block.
|
|
92
114
|
* @param blockHash - The block hash at which to get the index.
|
|
@@ -96,41 +118,43 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
96
118
|
* list structure" of leaves and proving that a lower nullifier is pointing to a bigger next value than the nullifier
|
|
97
119
|
* we are trying to prove non-inclusion for.
|
|
98
120
|
*/
|
|
99
|
-
|
|
121
|
+
getLowNullifierMembershipWitness(blockHash: BlockHash, nullifier: Fr): Promise<NullifierMembershipWitness | undefined>;
|
|
100
122
|
/**
|
|
101
123
|
* Returns a public data tree witness for a given leaf slot at a given block.
|
|
102
124
|
* @param blockHash - The block hash at which to get the index.
|
|
103
125
|
* @param leafSlot - The slot of the public data tree to get the witness for.
|
|
104
126
|
* @returns - The witness
|
|
105
127
|
*/
|
|
106
|
-
|
|
128
|
+
getPublicDataWitness(blockHash: BlockHash, leafSlot: Fr): Promise<PublicDataWitness | undefined>;
|
|
107
129
|
/**
|
|
108
130
|
* Fetches a block header of a given block.
|
|
109
131
|
* @param blockNumber - The number of a block of which to get the block header.
|
|
110
132
|
* @returns Block extracted from a block with block number `blockNumber`.
|
|
111
133
|
*/
|
|
112
|
-
|
|
134
|
+
getBlockHeader(blockNumber: BlockNumber): Promise<BlockHeader | undefined>;
|
|
113
135
|
/**
|
|
114
|
-
* Retrieve the
|
|
136
|
+
* Retrieve the public keys and partial address associated to a given address.
|
|
115
137
|
* @param account - The account address.
|
|
116
|
-
* @returns
|
|
138
|
+
* @returns The public keys and partial address, or `undefined` if the account is not registered.
|
|
117
139
|
*/
|
|
118
|
-
|
|
140
|
+
tryGetPublicKeysAndPartialAddress(account: AztecAddress): Promise<{
|
|
141
|
+
publicKeys: PublicKeys;
|
|
142
|
+
partialAddress: PartialAddress;
|
|
143
|
+
} | undefined>;
|
|
119
144
|
protected getCompleteAddressOrFail(account: AztecAddress): Promise<CompleteAddress>;
|
|
120
145
|
/**
|
|
121
146
|
* Returns a contract instance associated with an address or throws if not found.
|
|
122
147
|
* @param address - Address.
|
|
123
148
|
* @returns A contract instance.
|
|
124
149
|
*/
|
|
125
|
-
|
|
126
|
-
protected getContractInstance(address: AztecAddress): Promise<ContractInstance>;
|
|
150
|
+
getContractInstance(address: AztecAddress): Promise<ContractInstance>;
|
|
127
151
|
/**
|
|
128
152
|
* Returns an auth witness for the given message hash. Checks on the list of transient witnesses
|
|
129
153
|
* for this transaction first, and falls back to the local database if not found.
|
|
130
154
|
* @param messageHash - Hash of the message to authenticate.
|
|
131
155
|
* @returns Authentication witness for the requested message hash.
|
|
132
156
|
*/
|
|
133
|
-
|
|
157
|
+
getAuthWitness(messageHash: Fr): Promise<Fr[] | undefined>;
|
|
134
158
|
/**
|
|
135
159
|
* Gets some notes for a contract address and storage slot.
|
|
136
160
|
* Returns a flattened array containing filtered notes.
|
|
@@ -153,13 +177,13 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
153
177
|
* @param status - The status of notes to fetch.
|
|
154
178
|
* @returns Array of note data.
|
|
155
179
|
*/
|
|
156
|
-
|
|
180
|
+
getNotes(owner: AztecAddress | undefined, storageSlot: Fr, numSelects: number, selectByIndexes: number[], selectByOffsets: number[], selectByLengths: number[], selectValues: Fr[], selectComparators: number[], sortByIndexes: number[], sortByOffsets: number[], sortByLengths: number[], sortOrder: number[], limit: number, offset: number, status: NoteStatus): Promise<NoteData[]>;
|
|
157
181
|
/**
|
|
158
182
|
* Check if a nullifier exists in the nullifier tree.
|
|
159
183
|
* @param innerNullifier - The inner nullifier.
|
|
160
184
|
* @returns A boolean indicating whether the nullifier exists in the tree or not.
|
|
161
185
|
*/
|
|
162
|
-
|
|
186
|
+
checkNullifierExists(innerNullifier: Fr): Promise<boolean>;
|
|
163
187
|
/**
|
|
164
188
|
* Fetches a message from the executionStore, given its key.
|
|
165
189
|
* @param contractAddress - Address of a contract by which the message was emitted.
|
|
@@ -168,7 +192,7 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
168
192
|
* @dev Contract address and secret are only used to compute the nullifier to get non-nullified messages
|
|
169
193
|
* @returns The l1 to l2 membership witness (index of message in the tree and sibling path).
|
|
170
194
|
*/
|
|
171
|
-
|
|
195
|
+
getL1ToL2MembershipWitness(contractAddress: AztecAddress, messageHash: Fr, secret: Fr): Promise<MessageLoadOracleInputs<36>>;
|
|
172
196
|
/**
|
|
173
197
|
* Read the public storage data.
|
|
174
198
|
* @param blockHash - The block hash to read storage at.
|
|
@@ -176,9 +200,9 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
176
200
|
* @param startStorageSlot - The starting storage slot.
|
|
177
201
|
* @param numberOfElements - Number of elements to read from the starting storage slot.
|
|
178
202
|
*/
|
|
179
|
-
|
|
180
|
-
|
|
181
|
-
|
|
203
|
+
storageRead(blockHash: BlockHash, contractAddress: AztecAddress, startStorageSlot: Fr, numberOfElements: number): Promise<Fr[]>;
|
|
204
|
+
log(level: number, message: string, fields: Fr[]): Promise<void>;
|
|
205
|
+
fetchTaggedLogs(pendingTaggedLogArrayBaseSlot: Fr): Promise<void>;
|
|
182
206
|
/**
|
|
183
207
|
* Validates all note and event validation requests enqueued via `enqueue_note_for_validation` and
|
|
184
208
|
* `enqueue_event_for_validation`, inserting them into the note database and event store respectively, making them
|
|
@@ -189,20 +213,19 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
189
213
|
* @param noteValidationRequestsArrayBaseSlot - The base slot of capsule array containing note validation requests.
|
|
190
214
|
* @param eventValidationRequestsArrayBaseSlot - The base slot of capsule array containing event validation requests.
|
|
191
215
|
*/
|
|
192
|
-
|
|
193
|
-
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
197
|
-
|
|
198
|
-
|
|
216
|
+
validateAndStoreEnqueuedNotesAndEvents(contractAddress: AztecAddress, noteValidationRequestsArrayBaseSlot: Fr, eventValidationRequestsArrayBaseSlot: Fr, maxNotePackedLen: number, maxEventSerializedLen: number): Promise<void>;
|
|
217
|
+
bulkRetrieveLogs(contractAddress: AztecAddress, logRetrievalRequestsArrayBaseSlot: Fr, logRetrievalResponsesArrayBaseSlot: Fr): Promise<void>;
|
|
218
|
+
storeCapsule(contractAddress: AztecAddress, slot: Fr, capsule: Fr[]): Promise<void>;
|
|
219
|
+
loadCapsule(contractAddress: AztecAddress, slot: Fr): Promise<Fr[] | null>;
|
|
220
|
+
deleteCapsule(contractAddress: AztecAddress, slot: Fr): Promise<void>;
|
|
221
|
+
copyCapsule(contractAddress: AztecAddress, srcSlot: Fr, dstSlot: Fr, numEntries: number): Promise<void>;
|
|
222
|
+
aes128Decrypt(ciphertext: Buffer, iv: Buffer, symKey: Buffer): Promise<Buffer>;
|
|
199
223
|
/**
|
|
200
224
|
* Retrieves the shared secret for a given address and ephemeral public key.
|
|
201
225
|
* @param address - The address to get the secret for.
|
|
202
226
|
* @param ephPk - The ephemeral public key to get the secret for.
|
|
203
227
|
* @returns The secret for the given address.
|
|
204
228
|
*/
|
|
205
|
-
|
|
206
|
-
protected getSharedSecret(address: AztecAddress, ephPk: Point): Promise<Point>;
|
|
229
|
+
getSharedSecret(address: AztecAddress, ephPk: Point): Promise<Point>;
|
|
207
230
|
}
|
|
208
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
231
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbGl0eV9leGVjdXRpb25fb3JhY2xlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvY29udHJhY3RfZnVuY3Rpb25fc2ltdWxhdG9yL29yYWNsZS91dGlsaXR5X2V4ZWN1dGlvbl9vcmFjbGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsY0FBYyxFQUFFLHFCQUFxQixFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDOUUsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFbkUsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ3BELE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUMxRCxPQUFPLEVBQTBCLFlBQVksRUFBRSxNQUFNLHVCQUF1QixDQUFDO0FBQzdFLE9BQU8sS0FBSyxFQUFFLGlCQUFpQixFQUFFLE1BQU0seUJBQXlCLENBQUM7QUFDakUsT0FBTyxLQUFLLEVBQUUsUUFBUSxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFDakQsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0sNEJBQTRCLENBQUM7QUFDOUQsT0FBTyxFQUFFLFlBQVksRUFBRSxNQUFNLDZCQUE2QixDQUFDO0FBQzNELE9BQU8sRUFBRSxTQUFTLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUNoRCxPQUFPLEtBQUssRUFBRSxlQUFlLEVBQUUsZ0JBQWdCLEVBQUUsY0FBYyxFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFFaEcsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDakUsT0FBTyxLQUFLLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUNqRSxPQUFPLEVBQUUsS0FBSyxVQUFVLEVBQXdCLE1BQU0sb0JBQW9CLENBQUM7QUFHM0UsT0FBTyxLQUFLLEVBQUUsVUFBVSxFQUFFLE1B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
|