@aztec/pxe 3.0.0-rc.5 → 4.0.0-nightly.20260107
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/block_synchronizer/block_synchronizer.d.ts +39 -0
- package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -0
- package/dest/{synchronizer/synchronizer.js → block_synchronizer/block_synchronizer.js} +22 -22
- package/dest/block_synchronizer/index.d.ts +2 -0
- package/dest/block_synchronizer/index.d.ts.map +1 -0
- package/dest/block_synchronizer/index.js +1 -0
- package/dest/config/index.d.ts +4 -4
- package/dest/config/index.d.ts.map +1 -1
- package/dest/config/package_info.js +1 -1
- package/dest/contract_function_simulator/contract_function_simulator.d.ts +40 -11
- package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
- package/dest/contract_function_simulator/contract_function_simulator.js +47 -17
- package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +1 -1
- package/dest/contract_function_simulator/execution_tagging_index_cache.js +1 -1
- package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +4 -3
- package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts.map +1 -1
- package/dest/contract_function_simulator/noir-structs/log_retrieval_request.js +7 -6
- package/dest/contract_function_simulator/oracle/interfaces.d.ts +3 -4
- package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/oracle.d.ts +1 -1
- package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/oracle.js +3 -3
- package/dest/contract_function_simulator/oracle/private_execution.d.ts +7 -9
- package/dest/contract_function_simulator/oracle/private_execution.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/private_execution.js +11 -11
- package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +22 -8
- package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/private_execution_oracle.js +24 -12
- package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +47 -8
- package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +143 -37
- package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +4 -4
- package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
- package/dest/contract_function_simulator/proxied_contract_data_source.js +23 -5
- package/dest/debug/pxe_debug_utils.d.ts +31 -0
- package/dest/debug/pxe_debug_utils.d.ts.map +1 -0
- package/dest/debug/pxe_debug_utils.js +37 -0
- package/dest/entrypoints/client/bundle/index.d.ts +1 -2
- package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
- package/dest/entrypoints/client/bundle/index.js +0 -1
- 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 +10 -1
- package/dest/entrypoints/client/lazy/index.d.ts +1 -2
- package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
- package/dest/entrypoints/client/lazy/index.js +0 -1
- 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 +10 -1
- package/dest/entrypoints/pxe_creation_options.d.ts +3 -2
- package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
- package/dest/entrypoints/server/index.d.ts +2 -2
- package/dest/entrypoints/server/index.d.ts.map +1 -1
- package/dest/entrypoints/server/index.js +1 -1
- package/dest/entrypoints/server/utils.d.ts +1 -1
- package/dest/entrypoints/server/utils.d.ts.map +1 -1
- package/dest/entrypoints/server/utils.js +11 -7
- package/dest/error_enriching.d.ts +4 -4
- package/dest/error_enriching.d.ts.map +1 -1
- package/dest/error_enriching.js +6 -6
- package/dest/events/event_service.d.ts +15 -0
- package/dest/events/event_service.d.ts.map +1 -0
- package/dest/events/event_service.js +47 -0
- package/dest/events/private_event_filter_validator.d.ts +6 -5
- package/dest/events/private_event_filter_validator.d.ts.map +1 -1
- package/dest/events/private_event_filter_validator.js +4 -4
- package/dest/logs/log_service.d.ts +26 -0
- package/dest/logs/log_service.d.ts.map +1 -0
- package/dest/logs/log_service.js +120 -0
- package/dest/notes/index.d.ts +2 -0
- package/dest/notes/index.d.ts.map +1 -0
- package/dest/notes/index.js +1 -0
- package/dest/notes/note_service.d.ts +48 -0
- package/dest/notes/note_service.d.ts.map +1 -0
- package/dest/notes/note_service.js +152 -0
- package/dest/private_kernel/private_kernel_oracle_impl.d.ts +4 -4
- package/dest/private_kernel/private_kernel_oracle_impl.d.ts.map +1 -1
- package/dest/private_kernel/private_kernel_oracle_impl.js +7 -7
- package/dest/public_storage/public_storage_service.d.ts +24 -0
- package/dest/public_storage/public_storage_service.d.ts.map +1 -0
- package/dest/public_storage/public_storage_service.js +26 -0
- package/dest/pxe.d.ts +25 -33
- package/dest/pxe.d.ts.map +1 -1
- package/dest/pxe.js +125 -136
- package/dest/storage/address_store/address_store.d.ts +11 -0
- package/dest/storage/address_store/address_store.d.ts.map +1 -0
- package/dest/storage/{address_data_provider/address_data_provider.js → address_store/address_store.js} +1 -1
- package/dest/storage/address_store/index.d.ts +2 -0
- package/dest/storage/address_store/index.d.ts.map +1 -0
- package/dest/storage/address_store/index.js +1 -0
- package/dest/storage/{sync_data_provider/sync_data_provider.d.ts → anchor_block_store/anchor_block_store.d.ts} +2 -4
- package/dest/storage/anchor_block_store/anchor_block_store.d.ts.map +1 -0
- package/dest/storage/{sync_data_provider/sync_data_provider.js → anchor_block_store/anchor_block_store.js} +2 -9
- package/dest/storage/{sync_data_provider → anchor_block_store}/index.d.ts +2 -2
- package/dest/storage/anchor_block_store/index.d.ts.map +1 -0
- package/dest/storage/anchor_block_store/index.js +1 -0
- package/dest/storage/capsule_store/capsule_store.d.ts +57 -0
- package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -0
- package/dest/storage/{capsule_data_provider/capsule_data_provider.js → capsule_store/capsule_store.js} +33 -5
- package/dest/storage/capsule_store/index.d.ts +2 -0
- package/dest/storage/capsule_store/index.d.ts.map +1 -0
- package/dest/storage/capsule_store/index.js +1 -0
- package/dest/storage/{contract_data_provider/contract_data_provider.d.ts → contract_store/contract_store.d.ts} +7 -4
- package/dest/storage/contract_store/contract_store.d.ts.map +1 -0
- package/dest/storage/{contract_data_provider/contract_data_provider.js → contract_store/contract_store.js} +46 -3
- package/dest/storage/contract_store/index.d.ts +2 -0
- package/dest/storage/contract_store/index.d.ts.map +1 -0
- package/dest/storage/contract_store/index.js +1 -0
- package/dest/storage/{contract_data_provider → contract_store}/private_functions_tree.d.ts +1 -1
- package/dest/storage/contract_store/private_functions_tree.d.ts.map +1 -0
- package/dest/storage/index.d.ts +8 -8
- package/dest/storage/index.d.ts.map +1 -1
- package/dest/storage/index.js +7 -7
- package/dest/storage/note_store/index.d.ts +3 -0
- package/dest/storage/note_store/index.d.ts.map +1 -0
- package/dest/storage/note_store/index.js +2 -0
- package/dest/storage/{note_data_provider/note_data_provider.d.ts → note_store/note_store.d.ts} +7 -7
- package/dest/storage/note_store/note_store.d.ts.map +1 -0
- package/dest/storage/{note_data_provider/note_data_provider.js → note_store/note_store.js} +6 -6
- package/dest/storage/{private_event_data_provider/private_event_data_provider.d.ts → private_event_store/private_event_store.d.ts} +9 -4
- package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -0
- package/dest/storage/{private_event_data_provider/private_event_data_provider.js → private_event_store/private_event_store.js} +57 -15
- package/dest/storage/tagging_store/index.d.ts +4 -0
- package/dest/storage/tagging_store/index.d.ts.map +1 -0
- package/dest/storage/tagging_store/index.js +3 -0
- package/dest/storage/tagging_store/recipient_tagging_store.d.ts +21 -0
- package/dest/storage/tagging_store/recipient_tagging_store.d.ts.map +1 -0
- package/dest/storage/tagging_store/recipient_tagging_store.js +42 -0
- package/dest/storage/tagging_store/sender_address_book_store.d.ts +14 -0
- package/dest/storage/tagging_store/sender_address_book_store.d.ts.map +1 -0
- package/dest/storage/tagging_store/sender_address_book_store.js +30 -0
- package/dest/storage/tagging_store/sender_tagging_store.d.ts +67 -0
- package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -0
- package/dest/storage/tagging_store/sender_tagging_store.js +196 -0
- package/dest/tagging/index.d.ts +15 -6
- package/dest/tagging/index.d.ts.map +1 -1
- package/dest/tagging/index.js +23 -5
- package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +14 -0
- package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +1 -0
- package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +99 -0
- package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +12 -0
- package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -0
- package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +20 -0
- package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +14 -0
- package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +1 -0
- package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +29 -0
- package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +20 -0
- package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -0
- package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +74 -0
- package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +11 -0
- package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -0
- package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +32 -0
- package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +18 -0
- package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts.map +1 -0
- package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.js +55 -0
- package/dest/tree_membership/tree_membership_service.d.ts +52 -0
- package/dest/tree_membership/tree_membership_service.d.ts.map +1 -0
- package/dest/tree_membership/tree_membership_service.js +84 -0
- package/package.json +16 -16
- package/src/{synchronizer/synchronizer.ts → block_synchronizer/block_synchronizer.ts} +21 -22
- package/src/block_synchronizer/index.ts +1 -0
- package/src/config/index.ts +3 -3
- package/src/config/package_info.ts +1 -1
- package/src/contract_function_simulator/contract_function_simulator.ts +84 -15
- package/src/contract_function_simulator/execution_tagging_index_cache.ts +1 -1
- package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +5 -4
- package/src/contract_function_simulator/oracle/interfaces.ts +2 -3
- package/src/contract_function_simulator/oracle/oracle.ts +3 -3
- package/src/contract_function_simulator/oracle/private_execution.ts +14 -13
- package/src/contract_function_simulator/oracle/private_execution_oracle.ts +89 -19
- package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +208 -45
- package/src/contract_function_simulator/proxied_contract_data_source.ts +24 -7
- package/src/debug/pxe_debug_utils.ts +48 -0
- package/src/entrypoints/client/bundle/index.ts +0 -1
- package/src/entrypoints/client/bundle/utils.ts +7 -1
- package/src/entrypoints/client/lazy/index.ts +0 -1
- package/src/entrypoints/client/lazy/utils.ts +7 -2
- package/src/entrypoints/pxe_creation_options.ts +2 -1
- package/src/entrypoints/server/index.ts +1 -1
- package/src/entrypoints/server/utils.ts +11 -15
- package/src/error_enriching.ts +7 -15
- package/src/events/event_service.ts +77 -0
- package/src/events/private_event_filter_validator.ts +5 -4
- package/src/logs/log_service.ts +202 -0
- package/src/notes/index.ts +1 -0
- package/src/notes/note_service.ts +200 -0
- package/src/private_kernel/private_kernel_oracle_impl.ts +6 -6
- package/src/public_storage/public_storage_service.ts +33 -0
- package/src/pxe.ts +153 -162
- package/src/storage/{address_data_provider/address_data_provider.ts → address_store/address_store.ts} +1 -1
- package/src/storage/address_store/index.ts +1 -0
- package/src/storage/{sync_data_provider/sync_data_provider.ts → anchor_block_store/anchor_block_store.ts} +2 -12
- package/src/storage/anchor_block_store/index.ts +1 -0
- package/src/storage/{capsule_data_provider/capsule_data_provider.ts → capsule_store/capsule_store.ts} +33 -1
- package/src/storage/capsule_store/index.ts +1 -0
- package/src/storage/{contract_data_provider/contract_data_provider.ts → contract_store/contract_store.ts} +64 -2
- package/src/storage/contract_store/index.ts +1 -0
- package/src/storage/index.ts +7 -7
- package/src/storage/note_store/index.ts +2 -0
- package/src/storage/{note_data_provider/note_data_provider.ts → note_store/note_store.ts} +7 -7
- package/src/storage/{private_event_data_provider/private_event_data_provider.ts → private_event_store/private_event_store.ts} +69 -18
- package/src/storage/tagging_store/index.ts +3 -0
- package/src/storage/tagging_store/recipient_tagging_store.ts +53 -0
- package/src/storage/tagging_store/sender_address_book_store.ts +42 -0
- package/src/storage/tagging_store/sender_tagging_store.ts +244 -0
- package/src/tagging/index.ts +27 -5
- package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +129 -0
- package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +34 -0
- package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +43 -0
- package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +96 -0
- package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +44 -0
- package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +72 -0
- package/src/tree_membership/tree_membership_service.ts +112 -0
- package/dest/contract_function_simulator/execution_data_provider.d.ts +0 -268
- package/dest/contract_function_simulator/execution_data_provider.d.ts.map +0 -1
- package/dest/contract_function_simulator/execution_data_provider.js +0 -14
- package/dest/contract_function_simulator/pxe_oracle_interface.d.ts +0 -124
- package/dest/contract_function_simulator/pxe_oracle_interface.d.ts.map +0 -1
- package/dest/contract_function_simulator/pxe_oracle_interface.js +0 -713
- package/dest/storage/address_data_provider/address_data_provider.d.ts +0 -11
- package/dest/storage/address_data_provider/address_data_provider.d.ts.map +0 -1
- package/dest/storage/address_data_provider/index.d.ts +0 -2
- package/dest/storage/address_data_provider/index.d.ts.map +0 -1
- package/dest/storage/address_data_provider/index.js +0 -1
- package/dest/storage/capsule_data_provider/capsule_data_provider.d.ts +0 -25
- package/dest/storage/capsule_data_provider/capsule_data_provider.d.ts.map +0 -1
- package/dest/storage/capsule_data_provider/index.d.ts +0 -2
- package/dest/storage/capsule_data_provider/index.d.ts.map +0 -1
- package/dest/storage/capsule_data_provider/index.js +0 -1
- package/dest/storage/contract_data_provider/contract_data_provider.d.ts.map +0 -1
- package/dest/storage/contract_data_provider/index.d.ts +0 -2
- package/dest/storage/contract_data_provider/index.d.ts.map +0 -1
- package/dest/storage/contract_data_provider/index.js +0 -1
- package/dest/storage/contract_data_provider/private_functions_tree.d.ts.map +0 -1
- package/dest/storage/note_data_provider/index.d.ts +0 -3
- package/dest/storage/note_data_provider/index.d.ts.map +0 -1
- package/dest/storage/note_data_provider/index.js +0 -2
- package/dest/storage/note_data_provider/note_data_provider.d.ts.map +0 -1
- package/dest/storage/private_event_data_provider/private_event_data_provider.d.ts.map +0 -1
- package/dest/storage/sync_data_provider/index.d.ts.map +0 -1
- package/dest/storage/sync_data_provider/index.js +0 -1
- package/dest/storage/sync_data_provider/sync_data_provider.d.ts.map +0 -1
- package/dest/storage/tagging_data_provider/index.d.ts +0 -2
- package/dest/storage/tagging_data_provider/index.d.ts.map +0 -1
- package/dest/storage/tagging_data_provider/index.js +0 -1
- package/dest/storage/tagging_data_provider/tagging_data_provider.d.ts +0 -40
- package/dest/storage/tagging_data_provider/tagging_data_provider.d.ts.map +0 -1
- package/dest/storage/tagging_data_provider/tagging_data_provider.js +0 -89
- package/dest/synchronizer/index.d.ts +0 -2
- package/dest/synchronizer/index.d.ts.map +0 -1
- package/dest/synchronizer/index.js +0 -1
- package/dest/synchronizer/synchronizer.d.ts +0 -36
- package/dest/synchronizer/synchronizer.d.ts.map +0 -1
- package/dest/tagging/constants.d.ts +0 -2
- package/dest/tagging/constants.d.ts.map +0 -1
- package/dest/tagging/constants.js +0 -2
- package/dest/tagging/siloed_tag.d.ts +0 -14
- package/dest/tagging/siloed_tag.d.ts.map +0 -1
- package/dest/tagging/siloed_tag.js +0 -20
- package/dest/tagging/tag.d.ts +0 -12
- package/dest/tagging/tag.d.ts.map +0 -1
- package/dest/tagging/tag.js +0 -17
- package/dest/tagging/utils.d.ts +0 -18
- package/dest/tagging/utils.d.ts.map +0 -1
- package/dest/tagging/utils.js +0 -24
- package/src/contract_function_simulator/execution_data_provider.ts +0 -343
- package/src/contract_function_simulator/pxe_oracle_interface.ts +0 -1040
- package/src/storage/address_data_provider/index.ts +0 -1
- package/src/storage/capsule_data_provider/index.ts +0 -1
- package/src/storage/contract_data_provider/index.ts +0 -1
- package/src/storage/note_data_provider/index.ts +0 -2
- package/src/storage/sync_data_provider/index.ts +0 -1
- package/src/storage/tagging_data_provider/index.ts +0 -1
- package/src/storage/tagging_data_provider/tagging_data_provider.ts +0 -120
- package/src/synchronizer/index.ts +0 -1
- package/src/tagging/constants.ts +0 -2
- package/src/tagging/siloed_tag.ts +0 -22
- package/src/tagging/tag.ts +0 -16
- package/src/tagging/utils.ts +0 -31
- /package/dest/storage/{contract_data_provider → contract_store}/private_functions_tree.js +0 -0
- /package/src/storage/{contract_data_provider → contract_store}/private_functions_tree.ts +0 -0
|
@@ -1,16 +1,26 @@
|
|
|
1
1
|
import type { BlockNumber } from '@aztec/foundation/branded-types';
|
|
2
2
|
import { Fr } from '@aztec/foundation/curves/bn254';
|
|
3
3
|
import { Point } from '@aztec/foundation/curves/grumpkin';
|
|
4
|
+
import type { KeyStore } from '@aztec/key-store';
|
|
4
5
|
import type { AuthWitness } from '@aztec/stdlib/auth-witness';
|
|
5
6
|
import { AztecAddress } from '@aztec/stdlib/aztec-address';
|
|
6
7
|
import type { CompleteAddress, ContractInstance } from '@aztec/stdlib/contract';
|
|
8
|
+
import type { AztecNode } from '@aztec/stdlib/interfaces/server';
|
|
7
9
|
import type { KeyValidationRequest } from '@aztec/stdlib/kernel';
|
|
8
10
|
import type { NoteStatus } from '@aztec/stdlib/note';
|
|
9
|
-
import {
|
|
11
|
+
import { MerkleTreeId, type NullifierMembershipWitness, PublicDataWitness } from '@aztec/stdlib/trees';
|
|
10
12
|
import type { BlockHeader, Capsule } from '@aztec/stdlib/tx';
|
|
11
|
-
import type {
|
|
13
|
+
import type { AddressStore } from '../../storage/address_store/address_store.js';
|
|
14
|
+
import type { AnchorBlockStore } from '../../storage/anchor_block_store/anchor_block_store.js';
|
|
15
|
+
import type { CapsuleStore } from '../../storage/capsule_store/capsule_store.js';
|
|
16
|
+
import type { ContractStore } from '../../storage/contract_store/contract_store.js';
|
|
17
|
+
import type { NoteStore } from '../../storage/note_store/note_store.js';
|
|
18
|
+
import type { PrivateEventStore } from '../../storage/private_event_store/private_event_store.js';
|
|
19
|
+
import type { RecipientTaggingStore } from '../../storage/tagging_store/recipient_tagging_store.js';
|
|
20
|
+
import type { SenderAddressBookStore } from '../../storage/tagging_store/sender_address_book_store.js';
|
|
12
21
|
import { UtilityContext } from '../noir-structs/utility_context.js';
|
|
13
22
|
import type { IMiscOracle, IUtilityExecutionOracle, NoteData } from './interfaces.js';
|
|
23
|
+
import { MessageLoadOracleInputs } from './message_load_oracle_inputs.js';
|
|
14
24
|
/**
|
|
15
25
|
* The oracle for an execution of utility contract functions.
|
|
16
26
|
*/
|
|
@@ -19,7 +29,17 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
19
29
|
/** List of transient auth witnesses to be used during this simulation */
|
|
20
30
|
protected readonly authWitnesses: AuthWitness[];
|
|
21
31
|
protected readonly capsules: Capsule[];
|
|
22
|
-
protected readonly
|
|
32
|
+
protected readonly anchorBlockHeader: BlockHeader;
|
|
33
|
+
protected readonly contractStore: ContractStore;
|
|
34
|
+
protected readonly noteStore: NoteStore;
|
|
35
|
+
protected readonly keyStore: KeyStore;
|
|
36
|
+
protected readonly addressStore: AddressStore;
|
|
37
|
+
protected readonly aztecNode: AztecNode;
|
|
38
|
+
protected readonly anchorBlockStore: AnchorBlockStore;
|
|
39
|
+
protected readonly recipientTaggingStore: RecipientTaggingStore;
|
|
40
|
+
protected readonly senderAddressBookStore: SenderAddressBookStore;
|
|
41
|
+
protected readonly capsuleStore: CapsuleStore;
|
|
42
|
+
protected readonly privateEventStore: PrivateEventStore;
|
|
23
43
|
protected log: import("@aztec/foundation/log").Logger;
|
|
24
44
|
protected readonly scopes?: AztecAddress[] | undefined;
|
|
25
45
|
isMisc: true;
|
|
@@ -27,10 +47,10 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
27
47
|
private aztecNrDebugLog;
|
|
28
48
|
constructor(contractAddress: AztecAddress,
|
|
29
49
|
/** List of transient auth witnesses to be used during this simulation */
|
|
30
|
-
authWitnesses: AuthWitness[], capsules: Capsule[],
|
|
50
|
+
authWitnesses: AuthWitness[], capsules: Capsule[], anchorBlockHeader: BlockHeader, contractStore: ContractStore, noteStore: NoteStore, keyStore: KeyStore, addressStore: AddressStore, aztecNode: AztecNode, anchorBlockStore: AnchorBlockStore, recipientTaggingStore: RecipientTaggingStore, senderAddressBookStore: SenderAddressBookStore, capsuleStore: CapsuleStore, privateEventStore: PrivateEventStore, log?: import("@aztec/foundation/log").Logger, scopes?: AztecAddress[] | undefined);
|
|
31
51
|
utilityAssertCompatibleOracleVersion(version: number): void;
|
|
32
52
|
utilityGetRandomField(): Fr;
|
|
33
|
-
utilityGetUtilityContext():
|
|
53
|
+
utilityGetUtilityContext(): UtilityContext;
|
|
34
54
|
/**
|
|
35
55
|
* Retrieve keys associated with a specific master public key and app address.
|
|
36
56
|
* @param pkMHash - The master public key hash.
|
|
@@ -83,12 +103,14 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
83
103
|
* @throws An error if the account is not registered in the database.
|
|
84
104
|
*/
|
|
85
105
|
utilityGetPublicKeysAndPartialAddress(account: AztecAddress): Promise<CompleteAddress>;
|
|
106
|
+
protected getCompleteAddress(account: AztecAddress): Promise<CompleteAddress>;
|
|
86
107
|
/**
|
|
87
108
|
* Returns a contract instance associated with an address or throws if not found.
|
|
88
109
|
* @param address - Address.
|
|
89
110
|
* @returns A contract instance.
|
|
90
111
|
*/
|
|
91
112
|
utilityGetContractInstance(address: AztecAddress): Promise<ContractInstance>;
|
|
113
|
+
protected getContractInstance(address: AztecAddress): Promise<ContractInstance>;
|
|
92
114
|
/**
|
|
93
115
|
* Returns an auth witness for the given message hash. Checks on the list of transient witnesses
|
|
94
116
|
* for this transaction first, and falls back to the local database if not found.
|
|
@@ -126,14 +148,14 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
126
148
|
*/
|
|
127
149
|
utilityCheckNullifierExists(innerNullifier: Fr): Promise<boolean>;
|
|
128
150
|
/**
|
|
129
|
-
* Fetches a message from the
|
|
151
|
+
* Fetches a message from the executionStore, given its key.
|
|
130
152
|
* @param contractAddress - Address of a contract by which the message was emitted.
|
|
131
153
|
* @param messageHash - Hash of the message.
|
|
132
154
|
* @param secret - Secret used to compute a nullifier.
|
|
133
155
|
* @dev Contract address and secret are only used to compute the nullifier to get non-nullified messages
|
|
134
156
|
* @returns The l1 to l2 membership witness (index of message in the tree and sibling path).
|
|
135
157
|
*/
|
|
136
|
-
utilityGetL1ToL2MembershipWitness(contractAddress: AztecAddress, messageHash: Fr, secret: Fr): Promise<
|
|
158
|
+
utilityGetL1ToL2MembershipWitness(contractAddress: AztecAddress, messageHash: Fr, secret: Fr): Promise<MessageLoadOracleInputs<36>>;
|
|
137
159
|
/**
|
|
138
160
|
* Read the public storage data.
|
|
139
161
|
* @param contractAddress - The address to read storage from.
|
|
@@ -144,6 +166,16 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
144
166
|
utilityStorageRead(contractAddress: AztecAddress, startStorageSlot: Fr, blockNumber: BlockNumber, numberOfElements: number): Promise<Fr[]>;
|
|
145
167
|
utilityDebugLog(level: number, message: string, fields: Fr[]): void;
|
|
146
168
|
utilityFetchTaggedLogs(pendingTaggedLogArrayBaseSlot: Fr): Promise<void>;
|
|
169
|
+
/**
|
|
170
|
+
* Validates all note and event validation requests enqueued via `enqueue_note_for_validation` and
|
|
171
|
+
* `enqueue_event_for_validation`, inserting them into the note database and event store respectively, making them
|
|
172
|
+
* queryable via `get_notes` and `getPrivateEvents`.
|
|
173
|
+
*
|
|
174
|
+
* This automatically clears both validation request queues, so no further work needs to be done by the caller.
|
|
175
|
+
* @param contractAddress - The address of the contract that the logs are tagged for.
|
|
176
|
+
* @param noteValidationRequestsArrayBaseSlot - The base slot of capsule array containing note validation requests.
|
|
177
|
+
* @param eventValidationRequestsArrayBaseSlot - The base slot of capsule array containing event validation requests.
|
|
178
|
+
*/
|
|
147
179
|
utilityValidateEnqueuedNotesAndEvents(contractAddress: AztecAddress, noteValidationRequestsArrayBaseSlot: Fr, eventValidationRequestsArrayBaseSlot: Fr): Promise<void>;
|
|
148
180
|
utilityBulkRetrieveLogs(contractAddress: AztecAddress, logRetrievalRequestsArrayBaseSlot: Fr, logRetrievalResponsesArrayBaseSlot: Fr): Promise<void>;
|
|
149
181
|
utilityStoreCapsule(contractAddress: AztecAddress, slot: Fr, capsule: Fr[]): Promise<void>;
|
|
@@ -151,6 +183,13 @@ export declare class UtilityExecutionOracle implements IMiscOracle, IUtilityExec
|
|
|
151
183
|
utilityDeleteCapsule(contractAddress: AztecAddress, slot: Fr): Promise<void>;
|
|
152
184
|
utilityCopyCapsule(contractAddress: AztecAddress, srcSlot: Fr, dstSlot: Fr, numEntries: number): Promise<void>;
|
|
153
185
|
utilityAes128Decrypt(ciphertext: Buffer, iv: Buffer, symKey: Buffer): Promise<Buffer>;
|
|
186
|
+
/**
|
|
187
|
+
* Retrieves the shared secret for a given address and ephemeral public key.
|
|
188
|
+
* @param address - The address to get the secret for.
|
|
189
|
+
* @param ephPk - The ephemeral public key to get the secret for.
|
|
190
|
+
* @returns The secret for the given address.
|
|
191
|
+
*/
|
|
154
192
|
utilityGetSharedSecret(address: AztecAddress, ephPk: Point): Promise<Point>;
|
|
193
|
+
protected getSharedSecret(address: AztecAddress, ephPk: Point): Promise<Point>;
|
|
155
194
|
}
|
|
156
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
195
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidXRpbGl0eV9leGVjdXRpb25fb3JhY2xlLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvY29udHJhY3RfZnVuY3Rpb25fc2ltdWxhdG9yL29yYWNsZS91dGlsaXR5X2V4ZWN1dGlvbl9vcmFjbGUudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IkFBQUEsT0FBTyxLQUFLLEVBQUUsV0FBVyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFFbkUsT0FBTyxFQUFFLEVBQUUsRUFBRSxNQUFNLGdDQUFnQyxDQUFDO0FBQ3BELE9BQU8sRUFBRSxLQUFLLEVBQUUsTUFBTSxtQ0FBbUMsQ0FBQztBQUUxRCxPQUFPLEtBQUssRUFBRSxRQUFRLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUNqRCxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsTUFBTSw0QkFBNEIsQ0FBQztBQUM5RCxPQUFPLEVBQUUsWUFBWSxFQUFFLE1BQU0sNkJBQTZCLENBQUM7QUFDM0QsT0FBTyxLQUFLLEVBQUUsZUFBZSxFQUFFLGdCQUFnQixFQUFFLE1BQU0sd0JBQXdCLENBQUM7QUFFaEYsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0saUNBQWlDLENBQUM7QUFDakUsT0FBTyxLQUFLLEVBQUUsb0JBQW9CLEVBQUUsTUFBTSxzQkFBc0IsQ0FBQztBQUdqRSxPQUFPLEtBQUssRUFBRSxVQUFVLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUNyRCxPQUFPLEVBQUUsWUFBWSxFQUFFLEtBQUssMEJBQTBCLEVBQUUsaUJBQWlCLEVBQUUsTUFBTSxxQkFBcUIsQ0FBQztBQUN2RyxPQUFPLEtBQUssRUFBRSxXQUFXLEVBQUUsT0FBTyxFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFPN0QsT0FBTyxLQUFLLEVBQUUsWUFBWSxFQUFFLE1BQU0sOENBQThDLENBQUM7QUFDakYsT0FBTyxLQUFLLEVBQUUsZ0JBQWdCLEVBQUUsTUFBTSx3REFBd0QsQ0FBQztBQUMvRixPQUFPLEtB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
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"utility_execution_oracle.d.ts","sourceRoot":"","sources":["../../../src/contract_function_simulator/oracle/utility_execution_oracle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAE1D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;
|
|
1
|
+
{"version":3,"file":"utility_execution_oracle.d.ts","sourceRoot":"","sources":["../../../src/contract_function_simulator/oracle/utility_execution_oracle.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,iCAAiC,CAAC;AAEnE,OAAO,EAAE,EAAE,EAAE,MAAM,gCAAgC,CAAC;AACpD,OAAO,EAAE,KAAK,EAAE,MAAM,mCAAmC,CAAC;AAE1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAEhF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAGjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,KAAK,0BAA0B,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACvG,OAAO,KAAK,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAO7D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AACjF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,wDAAwD,CAAC;AAC/F,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8CAA8C,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gDAAgD,CAAC;AACpF,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0DAA0D,CAAC;AAClG,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wDAAwD,CAAC;AACpG,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0DAA0D,CAAC;AAMvG,OAAO,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEpE,OAAO,KAAK,EAAE,WAAW,EAAE,uBAAuB,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AACtF,OAAO,EAAE,uBAAuB,EAAE,MAAM,iCAAiC,CAAC;AAE1E;;GAEG;AACH,qBAAa,sBAAuB,YAAW,WAAW,EAAE,uBAAuB;IAO/E,SAAS,CAAC,QAAQ,CAAC,eAAe,EAAE,YAAY;IAChD,yEAAyE;IACzE,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,WAAW,EAAE;IAC/C,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,EAAE;IACtC,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,WAAW;IACjD,SAAS,CAAC,QAAQ,CAAC,aAAa,EAAE,aAAa;IAC/C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS;IACvC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IACrC,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY;IAC7C,SAAS,CAAC,QAAQ,CAAC,SAAS,EAAE,SAAS;IACvC,SAAS,CAAC,QAAQ,CAAC,gBAAgB,EAAE,gBAAgB;IACrD,SAAS,CAAC,QAAQ,CAAC,qBAAqB,EAAE,qBAAqB;IAC/D,SAAS,CAAC,QAAQ,CAAC,sBAAsB,EAAE,sBAAsB;IACjE,SAAS,CAAC,QAAQ,CAAC,YAAY,EAAE,YAAY;IAC7C,SAAS,CAAC,QAAQ,CAAC,iBAAiB,EAAE,iBAAiB;IACvD,SAAS,CAAC,GAAG;IACb,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAC;IAtB5B,MAAM,OAAiB;IACvB,SAAS,OAAiB;IAE1B,OAAO,CAAC,eAAe,CAAsC;IAE7D,YACqB,eAAe,EAAE,YAAY;IAChD,yEAAyE;IACtD,aAAa,EAAE,WAAW,EAAE,EAC5B,QAAQ,EAAE,OAAO,EAAE,EACnB,iBAAiB,EAAE,WAAW,EAC9B,aAAa,EAAE,aAAa,EAC5B,SAAS,EAAE,SAAS,EACpB,QAAQ,EAAE,QAAQ,EAClB,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,SAAS,EACpB,gBAAgB,EAAE,gBAAgB,EAClC,qBAAqB,EAAE,qBAAqB,EAC5C,sBAAsB,EAAE,sBAAsB,EAC9C,YAAY,EAAE,YAAY,EAC1B,iBAAiB,EAAE,iBAAiB,EAC7C,GAAG,yCAAgD,EAC1C,MAAM,CAAC,4BAAgB,EACxC;IAEG,oCAAoC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAIjE;IAEM,qBAAqB,IAAI,EAAE,CAEjC;IAEM,wBAAwB,IAAI,cAAc,CAQhD;IAED;;;;;OAKG;IACI,8BAA8B,CAAC,OAAO,EAAE,EAAE,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAEhF;IAED;;;;;;OAMG;IACI,2BAA2B,CAAC,WAAW,EAAE,WAAW,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,EAAE,CAAC,CAG/G;IAED;;;;;OAKG;IACU,oCAAoC,CAC/C,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,EAAE,GACZ,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC,CAEjD;IAED;;;;;;;;OAQG;IACU,uCAAuC,CAClD,WAAW,EAAE,WAAW,EACxB,SAAS,EAAE,EAAE,GACZ,OAAO,CAAC,0BAA0B,GAAG,SAAS,CAAC,CAGjD;IAED;;;;;OAKG;IACU,2BAA2B,CACtC,WAAW,EAAE,WAAW,EACxB,QAAQ,EAAE,EAAE,GACX,OAAO,CAAC,iBAAiB,GAAG,SAAS,CAAC,CAGxC;IAED;;;;OAIG;IACU,qBAAqB,CAAC,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,GAAG,SAAS,CAAC,CAQ7F;IAED;;;;;OAKG;IACI,qCAAqC,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CAE5F;IAED,UAAgB,kBAAkB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,eAAe,CAAC,CASlF;IAED;;;;OAIG;IACI,0BAA0B,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAElF;IAED,UAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAMpF;IAED;;;;;OAKG;IACI,qBAAqB,CAAC,WAAW,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,EAAE,GAAG,SAAS,CAAC,CAEvE;IAED;;;;;;;;;;;;;;;;;;;;;OAqBG;IACU,eAAe,CAC1B,KAAK,EAAE,YAAY,GAAG,SAAS,EAC/B,WAAW,EAAE,EAAE,EACf,UAAU,EAAE,MAAM,EAClB,eAAe,EAAE,MAAM,EAAE,EACzB,eAAe,EAAE,MAAM,EAAE,EACzB,eAAe,EAAE,MAAM,EAAE,EACzB,YAAY,EAAE,EAAE,EAAE,EAClB,iBAAiB,EAAE,MAAM,EAAE,EAC3B,aAAa,EAAE,MAAM,EAAE,EACvB,aAAa,EAAE,MAAM,EAAE,EACvB,aAAa,EAAE,MAAM,EAAE,EACvB,SAAS,EAAE,MAAM,EAAE,EACnB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,UAAU,GACjB,OAAO,CAAC,QAAQ,EAAE,CAAC,CAiBrB;IAED;;;;OAIG;IACU,2BAA2B,CAAC,cAAc,EAAE,EAAE,oBAK1D;IAED;;;;;;;OAOG;IACU,iCAAiC,CAAC,eAAe,EAAE,YAAY,EAAE,WAAW,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,wCAUxG;IAED;;;;;;OAMG;IACU,kBAAkB,CAC7B,eAAe,EAAE,YAAY,EAC7B,gBAAgB,EAAE,EAAE,EACpB,WAAW,EAAE,WAAW,EACxB,gBAAgB,EAAE,MAAM,iBAiBzB;IAEM,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,IAAI,CAMzE;IAEY,sBAAsB,CAAC,6BAA6B,EAAE,EAAE,iBAepE;IAED;;;;;;;;;OASG;IACU,qCAAqC,CAChD,eAAe,EAAE,YAAY,EAC7B,mCAAmC,EAAE,EAAE,EACvC,oCAAoC,EAAE,EAAE,iBAkDzC;IAEY,uBAAuB,CAClC,eAAe,EAAE,YAAY,EAC7B,iCAAiC,EAAE,EAAE,EACrC,kCAAkC,EAAE,EAAE,iBAkCvC;IAEM,mBAAmB,CAAC,eAAe,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMhG;IAEY,kBAAkB,CAAC,eAAe,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC,CAU7F;IAEM,oBAAoB,CAAC,eAAe,EAAE,YAAY,EAAE,IAAI,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAMlF;IAEM,kBAAkB,CACvB,eAAe,EAAE,YAAY,EAC7B,OAAO,EAAE,EAAE,EACX,OAAO,EAAE,EAAE,EACX,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,IAAI,CAAC,CAMf;IAGM,oBAAoB,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3F;IAED;;;;;OAKG;IACI,sBAAsB,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAEjF;IAED,UAAgB,eAAe,CAAC,OAAO,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAQnF;CACF"}
|
|
@@ -2,25 +2,58 @@ import { Aes128 } from '@aztec/foundation/crypto/aes128';
|
|
|
2
2
|
import { Fr } from '@aztec/foundation/curves/bn254';
|
|
3
3
|
import { LogLevels, applyStringFormatting, createLogger } from '@aztec/foundation/log';
|
|
4
4
|
import { siloNullifier } from '@aztec/stdlib/hash';
|
|
5
|
+
import { computeAddressSecret } from '@aztec/stdlib/keys';
|
|
6
|
+
import { deriveEcdhSharedSecret } from '@aztec/stdlib/logs';
|
|
7
|
+
import { EventService } from '../../events/event_service.js';
|
|
8
|
+
import { LogService } from '../../logs/log_service.js';
|
|
9
|
+
import { NoteService } from '../../notes/note_service.js';
|
|
10
|
+
import { ORACLE_VERSION } from '../../oracle_version.js';
|
|
11
|
+
import { PublicStorageService } from '../../public_storage/public_storage_service.js';
|
|
12
|
+
import { TreeMembershipService } from '../../tree_membership/tree_membership_service.js';
|
|
13
|
+
import { EventValidationRequest } from '../noir-structs/event_validation_request.js';
|
|
14
|
+
import { LogRetrievalRequest } from '../noir-structs/log_retrieval_request.js';
|
|
15
|
+
import { LogRetrievalResponse } from '../noir-structs/log_retrieval_response.js';
|
|
16
|
+
import { NoteValidationRequest } from '../noir-structs/note_validation_request.js';
|
|
5
17
|
import { UtilityContext } from '../noir-structs/utility_context.js';
|
|
6
18
|
import { pickNotes } from '../pick_notes.js';
|
|
19
|
+
import { MessageLoadOracleInputs } from './message_load_oracle_inputs.js';
|
|
7
20
|
/**
|
|
8
21
|
* The oracle for an execution of utility contract functions.
|
|
9
22
|
*/ export class UtilityExecutionOracle {
|
|
10
23
|
contractAddress;
|
|
11
24
|
authWitnesses;
|
|
12
25
|
capsules;
|
|
13
|
-
|
|
26
|
+
anchorBlockHeader;
|
|
27
|
+
contractStore;
|
|
28
|
+
noteStore;
|
|
29
|
+
keyStore;
|
|
30
|
+
addressStore;
|
|
31
|
+
aztecNode;
|
|
32
|
+
anchorBlockStore;
|
|
33
|
+
recipientTaggingStore;
|
|
34
|
+
senderAddressBookStore;
|
|
35
|
+
capsuleStore;
|
|
36
|
+
privateEventStore;
|
|
14
37
|
log;
|
|
15
38
|
scopes;
|
|
16
39
|
isMisc;
|
|
17
40
|
isUtility;
|
|
18
41
|
aztecNrDebugLog;
|
|
19
|
-
constructor(contractAddress, /** List of transient auth witnesses to be used during this simulation */ authWitnesses, capsules,
|
|
42
|
+
constructor(contractAddress, /** List of transient auth witnesses to be used during this simulation */ authWitnesses, capsules, anchorBlockHeader, contractStore, noteStore, keyStore, addressStore, aztecNode, anchorBlockStore, recipientTaggingStore, senderAddressBookStore, capsuleStore, privateEventStore, log = createLogger('simulator:client_view_context'), scopes){
|
|
20
43
|
this.contractAddress = contractAddress;
|
|
21
44
|
this.authWitnesses = authWitnesses;
|
|
22
45
|
this.capsules = capsules;
|
|
23
|
-
this.
|
|
46
|
+
this.anchorBlockHeader = anchorBlockHeader;
|
|
47
|
+
this.contractStore = contractStore;
|
|
48
|
+
this.noteStore = noteStore;
|
|
49
|
+
this.keyStore = keyStore;
|
|
50
|
+
this.addressStore = addressStore;
|
|
51
|
+
this.aztecNode = aztecNode;
|
|
52
|
+
this.anchorBlockStore = anchorBlockStore;
|
|
53
|
+
this.recipientTaggingStore = recipientTaggingStore;
|
|
54
|
+
this.senderAddressBookStore = senderAddressBookStore;
|
|
55
|
+
this.capsuleStore = capsuleStore;
|
|
56
|
+
this.privateEventStore = privateEventStore;
|
|
24
57
|
this.log = log;
|
|
25
58
|
this.scopes = scopes;
|
|
26
59
|
this.isMisc = true;
|
|
@@ -28,19 +61,20 @@ import { pickNotes } from '../pick_notes.js';
|
|
|
28
61
|
this.aztecNrDebugLog = createLogger('aztec-nr:debug_log');
|
|
29
62
|
}
|
|
30
63
|
utilityAssertCompatibleOracleVersion(version) {
|
|
31
|
-
|
|
64
|
+
if (version !== ORACLE_VERSION) {
|
|
65
|
+
throw new Error(`Incompatible oracle version. Expected version ${ORACLE_VERSION}, got ${version}.`);
|
|
66
|
+
}
|
|
32
67
|
}
|
|
33
68
|
utilityGetRandomField() {
|
|
34
69
|
return Fr.random();
|
|
35
70
|
}
|
|
36
|
-
|
|
37
|
-
const blockHeader = await this.executionDataProvider.getAnchorBlockHeader();
|
|
71
|
+
utilityGetUtilityContext() {
|
|
38
72
|
return UtilityContext.from({
|
|
39
|
-
blockNumber:
|
|
40
|
-
timestamp:
|
|
73
|
+
blockNumber: this.anchorBlockHeader.globalVariables.blockNumber,
|
|
74
|
+
timestamp: this.anchorBlockHeader.globalVariables.timestamp,
|
|
41
75
|
contractAddress: this.contractAddress,
|
|
42
|
-
version:
|
|
43
|
-
chainId:
|
|
76
|
+
version: this.anchorBlockHeader.globalVariables.version,
|
|
77
|
+
chainId: this.anchorBlockHeader.globalVariables.chainId
|
|
44
78
|
});
|
|
45
79
|
}
|
|
46
80
|
/**
|
|
@@ -49,7 +83,7 @@ import { pickNotes } from '../pick_notes.js';
|
|
|
49
83
|
* @returns A Promise that resolves to nullifier keys.
|
|
50
84
|
* @throws If the keys are not registered in the key store.
|
|
51
85
|
*/ utilityGetKeyValidationRequest(pkMHash) {
|
|
52
|
-
return this.
|
|
86
|
+
return this.keyStore.getKeyValidationRequest(pkMHash, this.contractAddress);
|
|
53
87
|
}
|
|
54
88
|
/**
|
|
55
89
|
* Fetches the index and sibling path of a leaf at a given block from a given tree.
|
|
@@ -58,7 +92,8 @@ import { pickNotes } from '../pick_notes.js';
|
|
|
58
92
|
* @param leafValue - The leaf value
|
|
59
93
|
* @returns The index and sibling path concatenated [index, sibling_path]
|
|
60
94
|
*/ utilityGetMembershipWitness(blockNumber, treeId, leafValue) {
|
|
61
|
-
|
|
95
|
+
const treeMembershipService = new TreeMembershipService(this.aztecNode, this.anchorBlockStore);
|
|
96
|
+
return treeMembershipService.getMembershipWitness(blockNumber, treeId, leafValue);
|
|
62
97
|
}
|
|
63
98
|
/**
|
|
64
99
|
* Returns a nullifier membership witness for a given nullifier at a given block.
|
|
@@ -66,7 +101,7 @@ import { pickNotes } from '../pick_notes.js';
|
|
|
66
101
|
* @param nullifier - Nullifier we try to find witness for.
|
|
67
102
|
* @returns The nullifier membership witness (if found).
|
|
68
103
|
*/ async utilityGetNullifierMembershipWitness(blockNumber, nullifier) {
|
|
69
|
-
return await this.
|
|
104
|
+
return await this.aztecNode.getNullifierMembershipWitness(blockNumber, nullifier);
|
|
70
105
|
}
|
|
71
106
|
/**
|
|
72
107
|
* Returns a low nullifier membership witness for a given nullifier at a given block.
|
|
@@ -77,7 +112,8 @@ import { pickNotes } from '../pick_notes.js';
|
|
|
77
112
|
* list structure" of leaves and proving that a lower nullifier is pointing to a bigger next value than the nullifier
|
|
78
113
|
* we are trying to prove non-inclusion for.
|
|
79
114
|
*/ async utilityGetLowNullifierMembershipWitness(blockNumber, nullifier) {
|
|
80
|
-
|
|
115
|
+
const treeMembershipService = new TreeMembershipService(this.aztecNode, this.anchorBlockStore);
|
|
116
|
+
return await treeMembershipService.getLowNullifierMembershipWitness(blockNumber, nullifier);
|
|
81
117
|
}
|
|
82
118
|
/**
|
|
83
119
|
* Returns a public data tree witness for a given leaf slot at a given block.
|
|
@@ -85,18 +121,20 @@ import { pickNotes } from '../pick_notes.js';
|
|
|
85
121
|
* @param leafSlot - The slot of the public data tree to get the witness for.
|
|
86
122
|
* @returns - The witness
|
|
87
123
|
*/ async utilityGetPublicDataWitness(blockNumber, leafSlot) {
|
|
88
|
-
|
|
124
|
+
const treeMembershipService = new TreeMembershipService(this.aztecNode, this.anchorBlockStore);
|
|
125
|
+
return await treeMembershipService.getPublicDataWitness(blockNumber, leafSlot);
|
|
89
126
|
}
|
|
90
127
|
/**
|
|
91
128
|
* Fetches a block header of a given block.
|
|
92
129
|
* @param blockNumber - The number of a block of which to get the block header.
|
|
93
130
|
* @returns Block extracted from a block with block number `blockNumber`.
|
|
94
131
|
*/ async utilityGetBlockHeader(blockNumber) {
|
|
95
|
-
const
|
|
96
|
-
if (
|
|
97
|
-
|
|
132
|
+
const anchorBlockNumber = (await this.anchorBlockStore.getBlockHeader()).getBlockNumber();
|
|
133
|
+
if (blockNumber > anchorBlockNumber) {
|
|
134
|
+
throw new Error(`Block number ${blockNumber} is higher than current block ${anchorBlockNumber}`);
|
|
98
135
|
}
|
|
99
|
-
|
|
136
|
+
const block = await this.aztecNode.getBlock(blockNumber);
|
|
137
|
+
return block?.getBlockHeader() || undefined;
|
|
100
138
|
}
|
|
101
139
|
/**
|
|
102
140
|
* Retrieve the complete address associated to a given address.
|
|
@@ -104,14 +142,29 @@ import { pickNotes } from '../pick_notes.js';
|
|
|
104
142
|
* @returns A complete address associated with the input address.
|
|
105
143
|
* @throws An error if the account is not registered in the database.
|
|
106
144
|
*/ utilityGetPublicKeysAndPartialAddress(account) {
|
|
107
|
-
return this.
|
|
145
|
+
return this.getCompleteAddress(account);
|
|
146
|
+
}
|
|
147
|
+
async getCompleteAddress(account) {
|
|
148
|
+
const completeAddress = await this.addressStore.getCompleteAddress(account);
|
|
149
|
+
if (!completeAddress) {
|
|
150
|
+
throw new Error(`No public key registered for address ${account}.
|
|
151
|
+
Register it by calling pxe.addAccount(...).\nSee docs for context: https://docs.aztec.network/developers/resources/debugging/aztecnr-errors#simulation-error-no-public-key-registered-for-address-0x0-register-it-by-calling-pxeregisterrecipient-or-pxeregisteraccount`);
|
|
152
|
+
}
|
|
153
|
+
return completeAddress;
|
|
108
154
|
}
|
|
109
155
|
/**
|
|
110
156
|
* Returns a contract instance associated with an address or throws if not found.
|
|
111
157
|
* @param address - Address.
|
|
112
158
|
* @returns A contract instance.
|
|
113
159
|
*/ utilityGetContractInstance(address) {
|
|
114
|
-
return this.
|
|
160
|
+
return this.getContractInstance(address);
|
|
161
|
+
}
|
|
162
|
+
async getContractInstance(address) {
|
|
163
|
+
const instance = await this.contractStore.getContractInstance(address);
|
|
164
|
+
if (!instance) {
|
|
165
|
+
throw new Error(`No contract instance found for address ${address.toString()}`);
|
|
166
|
+
}
|
|
167
|
+
return instance;
|
|
115
168
|
}
|
|
116
169
|
/**
|
|
117
170
|
* Returns an auth witness for the given message hash. Checks on the list of transient witnesses
|
|
@@ -143,7 +196,8 @@ import { pickNotes } from '../pick_notes.js';
|
|
|
143
196
|
* @param status - The status of notes to fetch.
|
|
144
197
|
* @returns Array of note data.
|
|
145
198
|
*/ async utilityGetNotes(owner, storageSlot, numSelects, selectByIndexes, selectByOffsets, selectByLengths, selectValues, selectComparators, sortByIndexes, sortByOffsets, sortByLengths, sortOrder, limit, offset, status) {
|
|
146
|
-
const
|
|
199
|
+
const noteService = new NoteService(this.noteStore, this.aztecNode, this.anchorBlockStore);
|
|
200
|
+
const dbNotes = await noteService.getNotes(this.contractAddress, owner, storageSlot, status, this.scopes);
|
|
147
201
|
return pickNotes(dbNotes, {
|
|
148
202
|
selects: selectByIndexes.slice(0, numSelects).map((index, i)=>({
|
|
149
203
|
selector: {
|
|
@@ -172,18 +226,22 @@ import { pickNotes } from '../pick_notes.js';
|
|
|
172
226
|
* @returns A boolean indicating whether the nullifier exists in the tree or not.
|
|
173
227
|
*/ async utilityCheckNullifierExists(innerNullifier) {
|
|
174
228
|
const nullifier = await siloNullifier(this.contractAddress, innerNullifier);
|
|
175
|
-
const
|
|
229
|
+
const treeMembershipService = new TreeMembershipService(this.aztecNode, this.anchorBlockStore);
|
|
230
|
+
const index = await treeMembershipService.getNullifierIndex(nullifier);
|
|
176
231
|
return index !== undefined;
|
|
177
232
|
}
|
|
178
233
|
/**
|
|
179
|
-
* Fetches a message from the
|
|
234
|
+
* Fetches a message from the executionStore, given its key.
|
|
180
235
|
* @param contractAddress - Address of a contract by which the message was emitted.
|
|
181
236
|
* @param messageHash - Hash of the message.
|
|
182
237
|
* @param secret - Secret used to compute a nullifier.
|
|
183
238
|
* @dev Contract address and secret are only used to compute the nullifier to get non-nullified messages
|
|
184
239
|
* @returns The l1 to l2 membership witness (index of message in the tree and sibling path).
|
|
185
240
|
*/ async utilityGetL1ToL2MembershipWitness(contractAddress, messageHash, secret) {
|
|
186
|
-
|
|
241
|
+
const treeMembershipService = new TreeMembershipService(this.aztecNode, this.anchorBlockStore);
|
|
242
|
+
const [messageIndex, siblingPath] = await treeMembershipService.getL1ToL2MembershipWitness(contractAddress, messageHash, secret);
|
|
243
|
+
// Assuming messageIndex is what you intended to use for the index in MessageLoadOracleInputs
|
|
244
|
+
return new MessageLoadOracleInputs(messageIndex, siblingPath);
|
|
187
245
|
}
|
|
188
246
|
/**
|
|
189
247
|
* Read the public storage data.
|
|
@@ -193,9 +251,12 @@ import { pickNotes } from '../pick_notes.js';
|
|
|
193
251
|
* @param numberOfElements - Number of elements to read from the starting storage slot.
|
|
194
252
|
*/ async utilityStorageRead(contractAddress, startStorageSlot, blockNumber, numberOfElements) {
|
|
195
253
|
const values = [];
|
|
254
|
+
const publicStorageService = new PublicStorageService(this.anchorBlockStore, this.aztecNode);
|
|
255
|
+
// TODO: why do we serialize these requests? This should probably a single call
|
|
256
|
+
// Privacy considerations?
|
|
196
257
|
for(let i = 0n; i < numberOfElements; i++){
|
|
197
258
|
const storageSlot = new Fr(startStorageSlot.value + i);
|
|
198
|
-
const value = await
|
|
259
|
+
const value = await publicStorageService.getPublicStorageAt(blockNumber, contractAddress, storageSlot);
|
|
199
260
|
this.log.debug(`Oracle storage read: slot=${storageSlot.toString()} address-${contractAddress.toString()} value=${value}`);
|
|
200
261
|
values.push(value);
|
|
201
262
|
}
|
|
@@ -209,29 +270,62 @@ import { pickNotes } from '../pick_notes.js';
|
|
|
209
270
|
this.aztecNrDebugLog[levelName](`${applyStringFormatting(message, fields)}`);
|
|
210
271
|
}
|
|
211
272
|
async utilityFetchTaggedLogs(pendingTaggedLogArrayBaseSlot) {
|
|
212
|
-
|
|
213
|
-
await
|
|
273
|
+
const logService = new LogService(this.aztecNode, this.anchorBlockStore, this.keyStore, this.capsuleStore, this.recipientTaggingStore, this.senderAddressBookStore, this.addressStore);
|
|
274
|
+
await logService.syncTaggedLogs(this.contractAddress, pendingTaggedLogArrayBaseSlot, this.scopes);
|
|
275
|
+
const noteService = new NoteService(this.noteStore, this.aztecNode, this.anchorBlockStore);
|
|
276
|
+
await noteService.syncNoteNullifiers(this.contractAddress);
|
|
214
277
|
}
|
|
215
|
-
|
|
278
|
+
/**
|
|
279
|
+
* Validates all note and event validation requests enqueued via `enqueue_note_for_validation` and
|
|
280
|
+
* `enqueue_event_for_validation`, inserting them into the note database and event store respectively, making them
|
|
281
|
+
* queryable via `get_notes` and `getPrivateEvents`.
|
|
282
|
+
*
|
|
283
|
+
* This automatically clears both validation request queues, so no further work needs to be done by the caller.
|
|
284
|
+
* @param contractAddress - The address of the contract that the logs are tagged for.
|
|
285
|
+
* @param noteValidationRequestsArrayBaseSlot - The base slot of capsule array containing note validation requests.
|
|
286
|
+
* @param eventValidationRequestsArrayBaseSlot - The base slot of capsule array containing event validation requests.
|
|
287
|
+
*/ async utilityValidateEnqueuedNotesAndEvents(contractAddress, noteValidationRequestsArrayBaseSlot, eventValidationRequestsArrayBaseSlot) {
|
|
216
288
|
// TODO(#10727): allow other contracts to deliver notes
|
|
217
289
|
if (!this.contractAddress.equals(contractAddress)) {
|
|
218
290
|
throw new Error(`Got a note validation request from ${contractAddress}, expected ${this.contractAddress}`);
|
|
219
291
|
}
|
|
220
|
-
|
|
292
|
+
// We read all note and event validation requests and process them all concurrently. This makes the process much
|
|
293
|
+
// faster as we don't need to wait for the network round-trip.
|
|
294
|
+
const noteValidationRequests = (await this.capsuleStore.readCapsuleArray(contractAddress, noteValidationRequestsArrayBaseSlot)).map(NoteValidationRequest.fromFields);
|
|
295
|
+
const eventValidationRequests = (await this.capsuleStore.readCapsuleArray(contractAddress, eventValidationRequestsArrayBaseSlot)).map(EventValidationRequest.fromFields);
|
|
296
|
+
const noteService = new NoteService(this.noteStore, this.aztecNode, this.anchorBlockStore);
|
|
297
|
+
const noteDeliveries = noteValidationRequests.map((request)=>noteService.deliverNote(request.contractAddress, request.owner, request.storageSlot, request.randomness, request.noteNonce, request.content, request.noteHash, request.nullifier, request.txHash, request.recipient));
|
|
298
|
+
const eventService = new EventService(this.anchorBlockStore, this.aztecNode, this.privateEventStore);
|
|
299
|
+
const eventDeliveries = eventValidationRequests.map((request)=>eventService.deliverEvent(request.contractAddress, request.eventTypeId, request.serializedEvent, request.eventCommitment, request.txHash, request.recipient));
|
|
300
|
+
await Promise.all([
|
|
301
|
+
...noteDeliveries,
|
|
302
|
+
...eventDeliveries
|
|
303
|
+
]);
|
|
304
|
+
// Requests are cleared once we're done.
|
|
305
|
+
await this.capsuleStore.setCapsuleArray(contractAddress, noteValidationRequestsArrayBaseSlot, []);
|
|
306
|
+
await this.capsuleStore.setCapsuleArray(contractAddress, eventValidationRequestsArrayBaseSlot, []);
|
|
221
307
|
}
|
|
222
308
|
async utilityBulkRetrieveLogs(contractAddress, logRetrievalRequestsArrayBaseSlot, logRetrievalResponsesArrayBaseSlot) {
|
|
223
309
|
// TODO(#10727): allow other contracts to process partial notes
|
|
224
310
|
if (!this.contractAddress.equals(contractAddress)) {
|
|
225
311
|
throw new Error(`Got a note validation request from ${contractAddress}, expected ${this.contractAddress}`);
|
|
226
312
|
}
|
|
227
|
-
|
|
313
|
+
// We read all log retrieval requests and process them all concurrently. This makes the process much faster as we
|
|
314
|
+
// don't need to wait for the network round-trip.
|
|
315
|
+
const logRetrievalRequests = (await this.capsuleStore.readCapsuleArray(contractAddress, logRetrievalRequestsArrayBaseSlot)).map(LogRetrievalRequest.fromFields);
|
|
316
|
+
const logService = new LogService(this.aztecNode, this.anchorBlockStore, this.keyStore, this.capsuleStore, this.recipientTaggingStore, this.senderAddressBookStore, this.addressStore);
|
|
317
|
+
const maybeLogRetrievalResponses = await logService.bulkRetrieveLogs(logRetrievalRequests);
|
|
318
|
+
// Requests are cleared once we're done.
|
|
319
|
+
await this.capsuleStore.setCapsuleArray(contractAddress, logRetrievalRequestsArrayBaseSlot, []);
|
|
320
|
+
// The responses are stored as Option<LogRetrievalResponse> in a second CapsuleArray.
|
|
321
|
+
await this.capsuleStore.setCapsuleArray(contractAddress, logRetrievalResponsesArrayBaseSlot, maybeLogRetrievalResponses.map(LogRetrievalResponse.toSerializedOption));
|
|
228
322
|
}
|
|
229
323
|
utilityStoreCapsule(contractAddress, slot, capsule) {
|
|
230
324
|
if (!contractAddress.equals(this.contractAddress)) {
|
|
231
325
|
// TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
|
|
232
326
|
throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
|
|
233
327
|
}
|
|
234
|
-
return this.
|
|
328
|
+
return this.capsuleStore.storeCapsule(this.contractAddress, slot, capsule);
|
|
235
329
|
}
|
|
236
330
|
async utilityLoadCapsule(contractAddress, slot) {
|
|
237
331
|
if (!contractAddress.equals(this.contractAddress)) {
|
|
@@ -239,28 +333,40 @@ import { pickNotes } from '../pick_notes.js';
|
|
|
239
333
|
throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
|
|
240
334
|
}
|
|
241
335
|
return(// TODO(#12425): On the following line, the pertinent capsule gets overshadowed by the transient one. Tackle this.
|
|
242
|
-
this.capsules.find((c)=>c.contractAddress.equals(contractAddress) && c.storageSlot.equals(slot))?.data ?? await this.
|
|
336
|
+
this.capsules.find((c)=>c.contractAddress.equals(contractAddress) && c.storageSlot.equals(slot))?.data ?? await this.capsuleStore.loadCapsule(this.contractAddress, slot));
|
|
243
337
|
}
|
|
244
338
|
utilityDeleteCapsule(contractAddress, slot) {
|
|
245
339
|
if (!contractAddress.equals(this.contractAddress)) {
|
|
246
340
|
// TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
|
|
247
341
|
throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
|
|
248
342
|
}
|
|
249
|
-
return this.
|
|
343
|
+
return this.capsuleStore.deleteCapsule(this.contractAddress, slot);
|
|
250
344
|
}
|
|
251
345
|
utilityCopyCapsule(contractAddress, srcSlot, dstSlot, numEntries) {
|
|
252
346
|
if (!contractAddress.equals(this.contractAddress)) {
|
|
253
347
|
// TODO(#10727): instead of this check that this.contractAddress is allowed to access the external DB
|
|
254
348
|
throw new Error(`Contract ${contractAddress} is not allowed to access ${this.contractAddress}'s PXE DB`);
|
|
255
349
|
}
|
|
256
|
-
return this.
|
|
350
|
+
return this.capsuleStore.copyCapsule(this.contractAddress, srcSlot, dstSlot, numEntries);
|
|
257
351
|
}
|
|
258
352
|
// TODO(#11849): consider replacing this oracle with a pure Noir implementation of aes decryption.
|
|
259
353
|
utilityAes128Decrypt(ciphertext, iv, symKey) {
|
|
260
354
|
const aes128 = new Aes128();
|
|
261
355
|
return aes128.decryptBufferCBC(ciphertext, iv, symKey);
|
|
262
356
|
}
|
|
263
|
-
|
|
264
|
-
|
|
357
|
+
/**
|
|
358
|
+
* Retrieves the shared secret for a given address and ephemeral public key.
|
|
359
|
+
* @param address - The address to get the secret for.
|
|
360
|
+
* @param ephPk - The ephemeral public key to get the secret for.
|
|
361
|
+
* @returns The secret for the given address.
|
|
362
|
+
*/ utilityGetSharedSecret(address, ephPk) {
|
|
363
|
+
return this.getSharedSecret(address, ephPk);
|
|
364
|
+
}
|
|
365
|
+
async getSharedSecret(address, ephPk) {
|
|
366
|
+
// TODO(#12656): return an app-siloed secret
|
|
367
|
+
const recipientCompleteAddress = await this.getCompleteAddress(address);
|
|
368
|
+
const ivskM = await this.keyStore.getMasterSecretKey(recipientCompleteAddress.publicKeys.masterIncomingViewingPublicKey);
|
|
369
|
+
const addressSecret = await computeAddressSecret(await recipientCompleteAddress.getPreaddress(), ivskM);
|
|
370
|
+
return deriveEcdhSharedSecret(addressSecret, ephPk);
|
|
265
371
|
}
|
|
266
372
|
}
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
import type { ContractOverrides } from '@aztec/stdlib/tx';
|
|
2
|
-
import type {
|
|
3
|
-
export declare class
|
|
4
|
-
static create(
|
|
2
|
+
import type { ContractStore } from '../storage/contract_store/contract_store.js';
|
|
3
|
+
export declare class ProxiedContractStoreFactory {
|
|
4
|
+
static create(contractStore: ContractStore, overrides?: ContractOverrides): ContractStore;
|
|
5
5
|
}
|
|
6
|
-
//# sourceMappingURL=data:application/json;base64,
|
|
6
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHJveGllZF9jb250cmFjdF9kYXRhX3NvdXJjZS5kLnRzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL2NvbnRyYWN0X2Z1bmN0aW9uX3NpbXVsYXRvci9wcm94aWVkX2NvbnRyYWN0X2RhdGFfc291cmNlLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUVBLE9BQU8sS0FBSyxFQUFFLGlCQUFpQixFQUFFLE1BQU0sa0JBQWtCLENBQUM7QUFFMUQsT0FBTyxLQUFLLEVBQUUsYUFBYSxFQUFFLE1BQU0sNkNBQTZDLENBQUM7QUFPakYscUJBQWEsMkJBQTJCO0lBQ3RDLE1BQU0sQ0FBQyxNQUFNLENBQUMsYUFBYSxFQUFFLGFBQWEsRUFBRSxTQUFTLENBQUMsRUFBRSxpQkFBaUIsaUJBcUV4RTtDQUNGIn0=
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"proxied_contract_data_source.d.ts","sourceRoot":"","sources":["../../src/contract_function_simulator/proxied_contract_data_source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,
|
|
1
|
+
{"version":3,"file":"proxied_contract_data_source.d.ts","sourceRoot":"","sources":["../../src/contract_function_simulator/proxied_contract_data_source.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,6CAA6C,CAAC;AAOjF,qBAAa,2BAA2B;IACtC,MAAM,CAAC,MAAM,CAAC,aAAa,EAAE,aAAa,EAAE,SAAS,CAAC,EAAE,iBAAiB,iBAqExE;CACF"}
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
import { FunctionSelector } from '@aztec/stdlib/abi';
|
|
2
2
|
/*
|
|
3
|
-
* Proxy generator for a
|
|
3
|
+
* Proxy generator for a ContractStore that allows overriding contract instances and artifacts, so
|
|
4
4
|
* the contract function simulator can execute different bytecode on certain addresses. An example use case
|
|
5
5
|
* would be overriding your own account contract so that valid signatures don't have to be provided while simulating.
|
|
6
|
-
*/ export class
|
|
7
|
-
static create(
|
|
6
|
+
*/ export class ProxiedContractStoreFactory {
|
|
7
|
+
static create(contractStore, overrides) {
|
|
8
8
|
if (!overrides) {
|
|
9
|
-
return
|
|
9
|
+
return contractStore;
|
|
10
10
|
}
|
|
11
|
-
return new Proxy(
|
|
11
|
+
return new Proxy(contractStore, {
|
|
12
12
|
get (target, prop) {
|
|
13
13
|
switch(prop){
|
|
14
14
|
case 'getContractInstance':
|
|
@@ -47,6 +47,24 @@ import { FunctionSelector } from '@aztec/stdlib/abi';
|
|
|
47
47
|
}
|
|
48
48
|
};
|
|
49
49
|
}
|
|
50
|
+
case 'getFunctionArtifactWithDebugMetadata':
|
|
51
|
+
{
|
|
52
|
+
return async (contractAddress, selector)=>{
|
|
53
|
+
if (overrides[contractAddress.toString()]) {
|
|
54
|
+
const { artifact } = overrides[contractAddress.toString()];
|
|
55
|
+
const functions = artifact.functions;
|
|
56
|
+
for(let i = 0; i < functions.length; i++){
|
|
57
|
+
const fn = functions[i];
|
|
58
|
+
const fnSelector = await FunctionSelector.fromNameAndParameters(fn.name, fn.parameters);
|
|
59
|
+
if (fnSelector.equals(selector)) {
|
|
60
|
+
return fn;
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
} else {
|
|
64
|
+
return target.getFunctionArtifactWithDebugMetadata(contractAddress, selector);
|
|
65
|
+
}
|
|
66
|
+
};
|
|
67
|
+
}
|
|
50
68
|
default:
|
|
51
69
|
{
|
|
52
70
|
const value = Reflect.get(target, prop);
|
|
@@ -0,0 +1,31 @@
|
|
|
1
|
+
import type { NoteDao, NotesFilter } from '@aztec/stdlib/note';
|
|
2
|
+
import type { PXE } from '../pxe.js';
|
|
3
|
+
import type { ContractStore } from '../storage/contract_store/contract_store.js';
|
|
4
|
+
import type { NoteStore } from '../storage/note_store/note_store.js';
|
|
5
|
+
/**
|
|
6
|
+
* Methods provided by this class might help debugging but must not be used in production.
|
|
7
|
+
* No backwards compatibility or API stability should be expected. Use at your own risk.
|
|
8
|
+
*/
|
|
9
|
+
export declare class PXEDebugUtils {
|
|
10
|
+
#private;
|
|
11
|
+
private contractStore;
|
|
12
|
+
private noteStore;
|
|
13
|
+
constructor(contractStore: ContractStore, noteStore: NoteStore);
|
|
14
|
+
/**
|
|
15
|
+
* Not injected through constructor since they're are co-dependant.
|
|
16
|
+
*/
|
|
17
|
+
setPXE(pxe: PXE): void;
|
|
18
|
+
/**
|
|
19
|
+
* A debugging utility to get notes based on the provided filter.
|
|
20
|
+
*
|
|
21
|
+
* Note that this should not be used in production code because the structure of notes is considered to be
|
|
22
|
+
* an implementation detail of contracts. This is only meant to be used for debugging purposes. If you need to obtain
|
|
23
|
+
* note-related information in production code, please implement a custom utility function on your contract and call
|
|
24
|
+
* that function instead (e.g. `get_balance(owner: AztecAddress) -> u128` utility function on a Token contract).
|
|
25
|
+
*
|
|
26
|
+
* @param filter - The filter to apply to the notes.
|
|
27
|
+
* @returns The requested notes.
|
|
28
|
+
*/
|
|
29
|
+
getNotes(filter: NotesFilter): Promise<NoteDao[]>;
|
|
30
|
+
}
|
|
31
|
+
//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoicHhlX2RlYnVnX3V0aWxzLmQudHMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvZGVidWcvcHhlX2RlYnVnX3V0aWxzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBLE9BQU8sS0FBSyxFQUFFLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxvQkFBb0IsQ0FBQztBQUUvRCxPQUFPLEtBQUssRUFBRSxHQUFHLEVBQUUsTUFBTSxXQUFXLENBQUM7QUFDckMsT0FBTyxLQUFLLEVBQUUsYUFBYSxFQUFFLE1BQU0sNkNBQTZDLENBQUM7QUFDakYsT0FBTyxLQUFLLEVBQUUsU0FBUyxFQUFFLE1BQU0scUNBQXFDLENBQUM7QUFFckU7OztHQUdHO0FBQ0gscUJBQWEsYUFBYTs7SUFJdEIsT0FBTyxDQUFDLGFBQWE7SUFDckIsT0FBTyxDQUFDLFNBQVM7SUFGbkIsWUFDVSxhQUFhLEVBQUUsYUFBYSxFQUM1QixTQUFTLEVBQUUsU0FBUyxFQUMxQjtJQUVKOztPQUVHO0lBQ0ksTUFBTSxDQUFDLEdBQUcsRUFBRSxHQUFHLFFBRXJCO0lBRUQ7Ozs7Ozs7Ozs7T0FVRztJQUNVLFFBQVEsQ0FBQyxNQUFNLEVBQUUsV0FBVyxHQUFHLE9BQU8sQ0FBQyxPQUFPLEVBQUUsQ0FBQyxDQVU3RDtDQUNGIn0=
|