@aztec/pxe 0.0.1-commit.e3c1de76 → 0.0.1-commit.e57c76e
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/bin/check_oracle_version.js +43 -99
- package/dest/bin/index.d.ts +2 -0
- package/dest/bin/index.d.ts.map +1 -0
- package/dest/bin/index.js +1 -0
- package/dest/bin/oracle_version_helpers.d.ts +26 -0
- package/dest/bin/oracle_version_helpers.d.ts.map +1 -0
- package/dest/bin/oracle_version_helpers.js +93 -0
- package/dest/block_synchronizer/block_stream_source.d.ts +10 -0
- package/dest/block_synchronizer/block_stream_source.d.ts.map +1 -0
- package/dest/block_synchronizer/block_stream_source.js +62 -0
- package/dest/block_synchronizer/block_synchronizer.d.ts +9 -3
- package/dest/block_synchronizer/block_synchronizer.d.ts.map +1 -1
- package/dest/block_synchronizer/block_synchronizer.js +37 -11
- package/dest/config/index.d.ts +8 -2
- package/dest/config/index.d.ts.map +1 -1
- package/dest/config/index.js +13 -15
- package/dest/config/package_info.js +1 -1
- package/dest/contract_function_simulator/contract_function_simulator.d.ts +66 -29
- package/dest/contract_function_simulator/contract_function_simulator.d.ts.map +1 -1
- package/dest/contract_function_simulator/contract_function_simulator.js +216 -75
- package/dest/contract_function_simulator/ephemeral_array_service.d.ts +28 -0
- package/dest/contract_function_simulator/ephemeral_array_service.d.ts.map +1 -0
- package/dest/contract_function_simulator/ephemeral_array_service.js +78 -0
- package/dest/contract_function_simulator/execution_note_cache.d.ts +2 -2
- package/dest/contract_function_simulator/execution_note_cache.d.ts.map +1 -1
- package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts +7 -11
- package/dest/contract_function_simulator/execution_tagging_index_cache.d.ts.map +1 -1
- package/dest/contract_function_simulator/execution_tagging_index_cache.js +19 -15
- package/dest/contract_function_simulator/index.d.ts +14 -2
- package/dest/contract_function_simulator/index.d.ts.map +1 -1
- package/dest/contract_function_simulator/index.js +11 -0
- package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts +48 -0
- package/dest/contract_function_simulator/noir-structs/bounded_vec.d.ts.map +1 -0
- package/dest/contract_function_simulator/noir-structs/bounded_vec.js +45 -0
- package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts +37 -0
- package/dest/contract_function_simulator/noir-structs/ephemeral_array.d.ts.map +1 -0
- package/dest/contract_function_simulator/noir-structs/ephemeral_array.js +59 -0
- package/dest/contract_function_simulator/noir-structs/event_validation_request.d.ts +3 -4
- 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 +8 -9
- package/dest/contract_function_simulator/noir-structs/log_retrieval_request.d.ts +13 -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 +35 -4
- package/dest/contract_function_simulator/noir-structs/log_retrieval_response.d.ts +2 -2
- 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 +2 -4
- package/dest/contract_function_simulator/noir-structs/note_data.d.ts +27 -0
- package/dest/contract_function_simulator/noir-structs/note_data.d.ts.map +1 -0
- package/dest/contract_function_simulator/noir-structs/note_data.js +3 -0
- package/dest/contract_function_simulator/noir-structs/note_validation_request.d.ts +3 -5
- 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 +6 -10
- package/dest/contract_function_simulator/noir-structs/option.d.ts +61 -0
- package/dest/contract_function_simulator/noir-structs/option.d.ts.map +1 -0
- package/dest/contract_function_simulator/noir-structs/option.js +62 -0
- package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts +11 -0
- package/dest/contract_function_simulator/noir-structs/provided_secret.d.ts.map +1 -0
- package/dest/contract_function_simulator/noir-structs/provided_secret.js +24 -0
- package/dest/contract_function_simulator/oracle/interfaces.d.ts +16 -98
- package/dest/contract_function_simulator/oracle/interfaces.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/interfaces.js +2 -2
- package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts +2 -2
- package/dest/contract_function_simulator/oracle/note_packing_utils.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/note_packing_utils.js +2 -2
- package/dest/contract_function_simulator/oracle/oracle.d.ts +75 -46
- package/dest/contract_function_simulator/oracle/oracle.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/oracle.js +471 -275
- package/dest/contract_function_simulator/oracle/oracle_registry.d.ts +127 -0
- package/dest/contract_function_simulator/oracle/oracle_registry.d.ts.map +1 -0
- package/dest/contract_function_simulator/oracle/oracle_registry.js +786 -0
- package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts +139 -0
- package/dest/contract_function_simulator/oracle/oracle_type_mappings.d.ts.map +1 -0
- package/dest/contract_function_simulator/oracle/oracle_type_mappings.js +560 -0
- package/dest/contract_function_simulator/oracle/private_execution.js +5 -3
- package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts +68 -95
- package/dest/contract_function_simulator/oracle/private_execution_oracle.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/private_execution_oracle.js +141 -110
- package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts +156 -76
- package/dest/contract_function_simulator/oracle/utility_execution_oracle.d.ts.map +1 -1
- package/dest/contract_function_simulator/oracle/utility_execution_oracle.js +450 -166
- package/dest/contract_function_simulator/pick_notes.d.ts +1 -1
- package/dest/contract_function_simulator/pick_notes.d.ts.map +1 -1
- package/dest/contract_function_simulator/pick_notes.js +20 -3
- package/dest/contract_function_simulator/proxied_contract_data_source.d.ts +1 -1
- package/dest/contract_function_simulator/proxied_contract_data_source.d.ts.map +1 -1
- package/dest/contract_function_simulator/proxied_contract_data_source.js +35 -64
- package/dest/contract_logging.d.ts +27 -0
- package/dest/contract_logging.d.ts.map +1 -0
- package/dest/contract_logging.js +38 -0
- package/dest/contract_sync/contract_sync_service.d.ts +42 -0
- package/dest/contract_sync/contract_sync_service.d.ts.map +1 -0
- package/dest/contract_sync/contract_sync_service.js +135 -0
- package/dest/contract_sync/helpers.d.ts +27 -0
- package/dest/contract_sync/helpers.d.ts.map +1 -0
- package/dest/contract_sync/{index.js → helpers.js} +16 -17
- package/dest/debug/pxe_debug_utils.d.ts +14 -15
- package/dest/debug/pxe_debug_utils.d.ts.map +1 -1
- package/dest/debug/pxe_debug_utils.js +16 -21
- package/dest/entrypoints/client/bundle/index.d.ts +3 -1
- package/dest/entrypoints/client/bundle/index.d.ts.map +1 -1
- package/dest/entrypoints/client/bundle/index.js +2 -0
- package/dest/entrypoints/client/bundle/utils.d.ts +2 -2
- package/dest/entrypoints/client/bundle/utils.d.ts.map +1 -1
- package/dest/entrypoints/client/bundle/utils.js +21 -5
- package/dest/entrypoints/client/lazy/index.d.ts +3 -1
- package/dest/entrypoints/client/lazy/index.d.ts.map +1 -1
- package/dest/entrypoints/client/lazy/index.js +2 -0
- package/dest/entrypoints/client/lazy/utils.d.ts +2 -2
- package/dest/entrypoints/client/lazy/utils.d.ts.map +1 -1
- package/dest/entrypoints/client/lazy/utils.js +21 -5
- package/dest/entrypoints/pxe_creation_options.d.ts +9 -1
- package/dest/entrypoints/pxe_creation_options.d.ts.map +1 -1
- package/dest/entrypoints/pxe_creation_options.js +3 -1
- package/dest/entrypoints/server/index.d.ts +5 -3
- package/dest/entrypoints/server/index.d.ts.map +1 -1
- package/dest/entrypoints/server/index.js +4 -2
- package/dest/entrypoints/server/utils.d.ts +4 -3
- package/dest/entrypoints/server/utils.d.ts.map +1 -1
- package/dest/entrypoints/server/utils.js +21 -5
- package/dest/events/event_service.d.ts +15 -6
- package/dest/events/event_service.d.ts.map +1 -1
- package/dest/events/event_service.js +44 -11
- package/dest/events/private_event_filter_validator.d.ts +3 -2
- package/dest/events/private_event_filter_validator.d.ts.map +1 -1
- package/dest/events/private_event_filter_validator.js +15 -0
- package/dest/hooks/authorize_utility_call.d.ts +41 -0
- package/dest/hooks/authorize_utility_call.d.ts.map +1 -0
- package/dest/hooks/authorize_utility_call.js +4 -0
- package/dest/hooks/execution_hooks.d.ts +42 -0
- package/dest/hooks/execution_hooks.d.ts.map +1 -0
- package/dest/hooks/execution_hooks.js +9 -0
- package/dest/hooks/index.d.ts +4 -0
- package/dest/hooks/index.d.ts.map +1 -0
- package/dest/hooks/index.js +1 -0
- package/dest/logs/log_service.d.ts +9 -8
- package/dest/logs/log_service.d.ts.map +1 -1
- package/dest/logs/log_service.js +131 -84
- package/dest/messages/message_context_service.d.ts +17 -0
- package/dest/messages/message_context_service.d.ts.map +1 -0
- package/dest/messages/message_context_service.js +55 -0
- package/dest/notes/note_service.d.ts +27 -5
- package/dest/notes/note_service.d.ts.map +1 -1
- package/dest/notes/note_service.js +83 -58
- package/dest/notes_filter.d.ts +24 -0
- package/dest/notes_filter.d.ts.map +1 -0
- package/dest/notes_filter.js +4 -0
- package/dest/oracle_version.d.ts +4 -3
- package/dest/oracle_version.d.ts.map +1 -1
- package/dest/oracle_version.js +20 -10
- package/dest/private_kernel/batch_planner.d.ts +47 -0
- package/dest/private_kernel/batch_planner.d.ts.map +1 -0
- package/dest/private_kernel/batch_planner.js +104 -0
- 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 +130 -69
- 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 +202 -0
- package/dest/private_kernel/private_kernel_execution_prover.d.ts +6 -2
- package/dest/private_kernel/private_kernel_execution_prover.d.ts.map +1 -1
- package/dest/private_kernel/private_kernel_execution_prover.js +166 -65
- package/dest/private_kernel/private_kernel_oracle.d.ts +15 -11
- package/dest/private_kernel/private_kernel_oracle.d.ts.map +1 -1
- package/dest/private_kernel/private_kernel_oracle.js +31 -25
- package/dest/pxe.d.ts +120 -24
- package/dest/pxe.d.ts.map +1 -1
- package/dest/pxe.js +231 -134
- package/dest/storage/anchor_block_store/anchor_block_store.js +1 -1
- package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts +42 -0
- package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.d.ts.map +1 -0
- package/dest/storage/backwards_compatibility_tests/kv_store_snapshot.js +93 -0
- package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts +15 -0
- package/dest/storage/backwards_compatibility_tests/schema_tests.d.ts.map +1 -0
- package/dest/storage/backwards_compatibility_tests/schema_tests.js +591 -0
- package/dest/storage/backwards_compatibility_tests/store_spy.d.ts +19 -0
- package/dest/storage/backwards_compatibility_tests/store_spy.d.ts.map +1 -0
- package/dest/storage/backwards_compatibility_tests/store_spy.js +63 -0
- package/dest/storage/capsule_store/capsule_service.d.ts +21 -0
- package/dest/storage/capsule_store/capsule_service.d.ts.map +1 -0
- package/dest/storage/capsule_store/capsule_service.js +50 -0
- package/dest/storage/capsule_store/capsule_store.d.ts +9 -9
- package/dest/storage/capsule_store/capsule_store.d.ts.map +1 -1
- package/dest/storage/capsule_store/capsule_store.js +36 -28
- package/dest/storage/capsule_store/index.d.ts +2 -1
- package/dest/storage/capsule_store/index.d.ts.map +1 -1
- package/dest/storage/capsule_store/index.js +1 -0
- 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 +146 -87
- package/dest/storage/metadata.d.ts +1 -1
- package/dest/storage/metadata.js +1 -1
- 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/open_pxe_stores.d.ts +33 -0
- package/dest/storage/open_pxe_stores.d.ts.map +1 -0
- package/dest/storage/open_pxe_stores.js +27 -0
- package/dest/storage/private_event_store/private_event_store.d.ts +1 -1
- package/dest/storage/private_event_store/private_event_store.d.ts.map +1 -1
- package/dest/storage/private_event_store/private_event_store.js +3 -0
- package/dest/storage/private_event_store/stored_private_event.js +1 -1
- 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 +29 -28
- package/dest/storage/tagging_store/sender_tagging_store.d.ts.map +1 -1
- package/dest/storage/tagging_store/sender_tagging_store.js +141 -115
- package/dest/tagging/get_all_logs_by_tags.d.ts +34 -10
- package/dest/tagging/get_all_logs_by_tags.d.ts.map +1 -1
- package/dest/tagging/get_all_logs_by_tags.js +45 -32
- package/dest/tagging/index.d.ts +6 -5
- package/dest/tagging/index.d.ts.map +1 -1
- package/dest/tagging/index.js +4 -3
- package/dest/tagging/persist_sender_tagging_index_ranges.d.ts +29 -0
- package/dest/tagging/persist_sender_tagging_index_ranges.d.ts.map +1 -0
- package/dest/tagging/persist_sender_tagging_index_ranges.js +42 -0
- package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts +56 -0
- package/dest/tagging/recipient_sync/sync_tagged_private_logs.d.ts.map +1 -0
- package/dest/tagging/recipient_sync/sync_tagged_private_logs.js +163 -0
- package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts +3 -3
- package/dest/tagging/recipient_sync/utils/find_highest_indexes.d.ts.map +1 -1
- package/dest/tagging/recipient_sync/utils/find_highest_indexes.js +2 -2
- package/dest/tagging/reconcile_tagging_index_ranges.d.ts +36 -0
- package/dest/tagging/reconcile_tagging_index_ranges.d.ts.map +1 -0
- package/dest/tagging/reconcile_tagging_index_ranges.js +74 -0
- package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts +4 -9
- package/dest/tagging/sender_sync/sync_sender_tagging_indexes.d.ts.map +1 -1
- package/dest/tagging/sender_sync/sync_sender_tagging_indexes.js +32 -14
- package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts +13 -7
- package/dest/tagging/sender_sync/utils/get_status_change_of_pending.d.ts.map +1 -1
- package/dest/tagging/sender_sync/utils/get_status_change_of_pending.js +41 -10
- package/dest/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.d.ts +5 -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 +37 -25
- package/package.json +29 -17
- package/src/bin/check_oracle_version.ts +49 -122
- package/src/bin/index.ts +1 -0
- package/src/bin/oracle_version_helpers.ts +121 -0
- package/src/block_synchronizer/block_stream_source.ts +81 -0
- package/src/block_synchronizer/block_synchronizer.ts +39 -11
- package/src/config/index.ts +15 -9
- package/src/config/package_info.ts +1 -1
- package/src/contract_function_simulator/contract_function_simulator.ts +391 -136
- package/src/contract_function_simulator/ephemeral_array_service.ts +110 -0
- package/src/contract_function_simulator/execution_note_cache.ts +1 -1
- package/src/contract_function_simulator/execution_tagging_index_cache.ts +19 -18
- package/src/contract_function_simulator/index.ts +51 -1
- package/src/contract_function_simulator/noir-structs/bounded_vec.ts +55 -0
- package/src/contract_function_simulator/noir-structs/ephemeral_array.ts +66 -0
- package/src/contract_function_simulator/noir-structs/event_validation_request.ts +9 -8
- package/src/contract_function_simulator/noir-structs/log_retrieval_request.ts +36 -3
- package/src/contract_function_simulator/noir-structs/log_retrieval_response.ts +2 -5
- package/src/contract_function_simulator/noir-structs/note_data.ts +27 -0
- package/src/contract_function_simulator/noir-structs/note_validation_request.ts +4 -9
- package/src/contract_function_simulator/noir-structs/option.ts +69 -0
- package/src/contract_function_simulator/noir-structs/provided_secret.ts +27 -0
- package/src/contract_function_simulator/oracle/interfaces.ts +12 -176
- package/src/contract_function_simulator/oracle/note_packing_utils.ts +3 -3
- package/src/contract_function_simulator/oracle/oracle.ts +564 -473
- package/src/contract_function_simulator/oracle/oracle_registry.ts +585 -0
- package/src/contract_function_simulator/oracle/oracle_type_mappings.ts +553 -0
- package/src/contract_function_simulator/oracle/private_execution.ts +4 -4
- package/src/contract_function_simulator/oracle/private_execution_oracle.ts +173 -205
- package/src/contract_function_simulator/oracle/utility_execution_oracle.ts +664 -245
- package/src/contract_function_simulator/pick_notes.ts +22 -3
- package/src/contract_function_simulator/proxied_contract_data_source.ts +41 -64
- package/src/contract_logging.ts +52 -0
- package/src/contract_sync/contract_sync_service.ts +189 -0
- package/src/contract_sync/{index.ts → helpers.ts} +17 -29
- package/src/debug/pxe_debug_utils.ts +47 -25
- package/src/entrypoints/client/bundle/index.ts +2 -0
- package/src/entrypoints/client/bundle/utils.ts +19 -6
- package/src/entrypoints/client/lazy/index.ts +2 -0
- package/src/entrypoints/client/lazy/utils.ts +19 -6
- package/src/entrypoints/pxe_creation_options.ts +14 -0
- package/src/entrypoints/server/index.ts +4 -2
- package/src/entrypoints/server/utils.ts +22 -13
- package/src/events/event_service.ts +69 -21
- package/src/events/private_event_filter_validator.ts +21 -1
- package/src/hooks/authorize_utility_call.ts +44 -0
- package/src/hooks/execution_hooks.ts +48 -0
- package/src/hooks/index.ts +7 -0
- package/src/logs/log_service.ts +162 -145
- package/src/messages/message_context_service.ts +62 -0
- package/src/notes/note_service.ts +120 -85
- package/src/notes_filter.ts +24 -0
- package/src/oracle_version.ts +20 -10
- package/src/private_kernel/batch_planner.ts +169 -0
- 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 +165 -118
- package/src/private_kernel/hints/test_utils.ts +318 -0
- package/src/private_kernel/private_kernel_execution_prover.ts +254 -89
- package/src/private_kernel/private_kernel_oracle.ts +42 -32
- package/src/pxe.ts +416 -181
- package/src/storage/anchor_block_store/anchor_block_store.ts +1 -1
- package/src/storage/backwards_compatibility_tests/__snapshots__/AddressStore.json +22 -0
- package/src/storage/backwards_compatibility_tests/__snapshots__/AnchorBlockStore.json +3 -0
- package/src/storage/backwards_compatibility_tests/__snapshots__/CapsuleStore.json +16 -0
- package/src/storage/backwards_compatibility_tests/__snapshots__/ContractStore.json +28 -0
- package/src/storage/backwards_compatibility_tests/__snapshots__/KeyStore.json +52 -0
- package/src/storage/backwards_compatibility_tests/__snapshots__/L2TipsKVStore.json +46 -0
- package/src/storage/backwards_compatibility_tests/__snapshots__/NoteStore.json +36 -0
- package/src/storage/backwards_compatibility_tests/__snapshots__/PrivateEventStore.json +44 -0
- package/src/storage/backwards_compatibility_tests/__snapshots__/RecipientTaggingStore.json +18 -0
- package/src/storage/backwards_compatibility_tests/__snapshots__/SenderAddressBookStore.json +16 -0
- package/src/storage/backwards_compatibility_tests/__snapshots__/SenderTaggingStore.json +22 -0
- package/src/storage/backwards_compatibility_tests/__snapshots__/opened_stores.json +97 -0
- package/src/storage/backwards_compatibility_tests/kv_store_snapshot.ts +122 -0
- package/src/storage/backwards_compatibility_tests/schema_tests.ts +712 -0
- package/src/storage/backwards_compatibility_tests/store_spy.ts +73 -0
- package/src/storage/capsule_store/capsule_service.ts +90 -0
- package/src/storage/capsule_store/capsule_store.ts +44 -26
- package/src/storage/capsule_store/index.ts +1 -0
- package/src/storage/contract_store/contract_store.ts +182 -104
- package/src/storage/metadata.ts +1 -1
- package/src/storage/note_store/note_store.ts +9 -5
- package/src/storage/open_pxe_stores.ts +49 -0
- package/src/storage/private_event_store/private_event_store.ts +4 -0
- package/src/storage/private_event_store/stored_private_event.ts +1 -1
- package/src/storage/tagging_store/recipient_tagging_store.ts +5 -5
- package/src/storage/tagging_store/sender_tagging_store.ts +185 -138
- package/src/tagging/get_all_logs_by_tags.ts +87 -35
- package/src/tagging/index.ts +5 -4
- package/src/tagging/persist_sender_tagging_index_ranges.ts +57 -0
- package/src/tagging/recipient_sync/sync_tagged_private_logs.ts +240 -0
- package/src/tagging/recipient_sync/utils/find_highest_indexes.ts +4 -4
- package/src/tagging/reconcile_tagging_index_ranges.ts +102 -0
- package/src/tagging/sender_sync/sync_sender_tagging_indexes.ts +52 -17
- package/src/tagging/sender_sync/utils/get_status_change_of_pending.ts +44 -14
- package/src/tagging/sender_sync/utils/load_and_store_new_tagging_indexes.ts +27 -27
- package/dest/contract_sync/index.d.ts +0 -23
- 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
- package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts +0 -15
- package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.d.ts.map +0 -1
- package/dest/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.js +0 -99
- package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts +0 -15
- package/dest/tagging/recipient_sync/utils/load_logs_for_range.d.ts.map +0 -1
- package/dest/tagging/recipient_sync/utils/load_logs_for_range.js +0 -32
- package/src/tagging/recipient_sync/load_private_logs_for_sender_recipient_pair.ts +0 -143
- package/src/tagging/recipient_sync/utils/load_logs_for_range.ts +0 -49
package/src/tagging/index.ts
CHANGED
|
@@ -4,16 +4,17 @@
|
|
|
4
4
|
* The objective of the sender sync algorithm is to determine which tags have already been used by a sender, thereby
|
|
5
5
|
* deciding which tag should be used next.
|
|
6
6
|
*
|
|
7
|
-
* The objective of the recipient sync algorithm is to
|
|
7
|
+
* The objective of the recipient sync algorithm is to fetch and sync the corresponding logs.
|
|
8
8
|
*
|
|
9
9
|
* @module tagging
|
|
10
10
|
*/
|
|
11
11
|
|
|
12
|
-
export {
|
|
12
|
+
export { syncTaggedPrivateLogs } from './recipient_sync/sync_tagged_private_logs.js';
|
|
13
13
|
export { syncSenderTaggingIndexes } from './sender_sync/sync_sender_tagging_indexes.js';
|
|
14
|
+
export { persistSenderTaggingIndexRangesForTx } from './persist_sender_tagging_index_ranges.js';
|
|
14
15
|
export { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from './constants.js';
|
|
15
16
|
export { getAllPrivateLogsByTags, getAllPublicLogsByTagsFromContract } from './get_all_logs_by_tags.js';
|
|
16
17
|
|
|
17
18
|
// Re-export tagging-related types from stdlib
|
|
18
|
-
export {
|
|
19
|
-
export { type PreTag } from '@aztec/stdlib/logs';
|
|
19
|
+
export { AppTaggingSecret, Tag, SiloedTag } from '@aztec/stdlib/logs';
|
|
20
|
+
export { type PreTag, type TaggingIndexRange } from '@aztec/stdlib/logs';
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
import type { Logger } from '@aztec/foundation/log';
|
|
2
|
+
import type { PrivateKernelTailCircuitPublicInputs } from '@aztec/stdlib/kernel';
|
|
3
|
+
import type { TaggingIndexRange } from '@aztec/stdlib/logs';
|
|
4
|
+
import type { TxHash } from '@aztec/stdlib/tx';
|
|
5
|
+
|
|
6
|
+
import type { SenderTaggingStore } from '../storage/tagging_store/sender_tagging_store.js';
|
|
7
|
+
import { reconcileTaggingIndexRangesAgainstSurvivingTags } from './reconcile_tagging_index_ranges.js';
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* Persists the tagging index ranges that a tx used as a sender, after reconciling them against the kernel's surviving
|
|
11
|
+
* private logs.
|
|
12
|
+
*
|
|
13
|
+
* The tagging index cache reserves an index for every log emission attempted during private execution, but the kernel
|
|
14
|
+
* may then squash some of those logs (e.g. when a note is created and nullified within the same tx). This function
|
|
15
|
+
* shrinks the recorded ranges to match the actual on-chain footprint before writing them, so that what we persist is
|
|
16
|
+
* consistent with what the network will see.
|
|
17
|
+
*
|
|
18
|
+
* @remarks Storing the recorded ranges in the DB may not be seen as necessary because we sync from chain before sending
|
|
19
|
+
* new logs, but the sync can only see logs already included in blocks. If we sent another transaction before this one
|
|
20
|
+
* was included from the same PXE, and that transaction contained a log with a tag derived from the same secret, we
|
|
21
|
+
* would reuse the tag and the transactions would be linked. Persisting in the DB prevents that linkage.
|
|
22
|
+
*
|
|
23
|
+
* @param store - The sender tagging store.
|
|
24
|
+
* @param recordedRanges - The tagging index ranges as recorded during private execution (pre-squash).
|
|
25
|
+
* @param publicInputs - The final kernel public inputs, used to determine which private logs survived squashing.
|
|
26
|
+
* @param getTxHash - Lazy accessor for the tx hash. Called only when there is something to persist, since computing
|
|
27
|
+
* the tx hash is expensive.
|
|
28
|
+
* @param jobId - Job context for staged writes to the store. See `JobCoordinator` for more details.
|
|
29
|
+
* @param log - Logger.
|
|
30
|
+
*/
|
|
31
|
+
export async function persistSenderTaggingIndexRangesForTx(
|
|
32
|
+
store: SenderTaggingStore,
|
|
33
|
+
recordedRanges: TaggingIndexRange[],
|
|
34
|
+
publicInputs: PrivateKernelTailCircuitPublicInputs,
|
|
35
|
+
getTxHash: () => Promise<TxHash>,
|
|
36
|
+
jobId: string,
|
|
37
|
+
log: Logger,
|
|
38
|
+
): Promise<void> {
|
|
39
|
+
if (recordedRanges.length === 0) {
|
|
40
|
+
log.debug(`No tagging index ranges used in the tx`);
|
|
41
|
+
return;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
const survivingTags = new Set(
|
|
45
|
+
publicInputs.getNonEmptyPrivateLogs().map(privateLog => privateLog.fields[0].toString()),
|
|
46
|
+
);
|
|
47
|
+
const reconciledRanges = await reconcileTaggingIndexRangesAgainstSurvivingTags(recordedRanges, survivingTags);
|
|
48
|
+
|
|
49
|
+
if (reconciledRanges.length === 0) {
|
|
50
|
+
log.debug(`All tagging index ranges used in the tx were squashed by the kernel`, { recordedRanges });
|
|
51
|
+
return;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
const txHash = await getTxHash();
|
|
55
|
+
await store.storePendingIndexes(reconciledRanges, txHash, jobId);
|
|
56
|
+
log.debug(`Stored used tagging index ranges as sender for the tx`, { recordedRanges, reconciledRanges });
|
|
57
|
+
}
|
|
@@ -0,0 +1,240 @@
|
|
|
1
|
+
import { BlockNumber } from '@aztec/foundation/branded-types';
|
|
2
|
+
import { isDefined } from '@aztec/foundation/types';
|
|
3
|
+
import type { BlockHash } from '@aztec/stdlib/block';
|
|
4
|
+
import type { AztecNode } from '@aztec/stdlib/interfaces/client';
|
|
5
|
+
import type { AppTaggingSecret, LogResult } from '@aztec/stdlib/logs';
|
|
6
|
+
import { SiloedTag } from '@aztec/stdlib/logs';
|
|
7
|
+
import type { BlockHeader } from '@aztec/stdlib/tx';
|
|
8
|
+
|
|
9
|
+
import type { RecipientTaggingStore } from '../../storage/tagging_store/recipient_tagging_store.js';
|
|
10
|
+
import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../constants.js';
|
|
11
|
+
import { getAllPrivateLogsByTags } from '../get_all_logs_by_tags.js';
|
|
12
|
+
import { findHighestIndexes } from './utils/find_highest_indexes.js';
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* Fetches and syncs tagged private logs for multiple sender-recipient pairs, batching tag queries across all secrets
|
|
16
|
+
* into shared RPC calls.
|
|
17
|
+
*
|
|
18
|
+
* # Explanation of how the algorithm works
|
|
19
|
+
*
|
|
20
|
+
* For each secret we sync logs that correspond to the tagging index range
|
|
21
|
+
* (highestAgedIndex, highestFinalizedIndex + WINDOW_LEN]
|
|
22
|
+
*
|
|
23
|
+
* highestAgedIndex is the highest index that was used in a tx that is included in a block at least
|
|
24
|
+
* `MAX_TX_LIFETIME` seconds ago.
|
|
25
|
+
* highestFinalizedIndex is the highest index that was used in a tx that is included in a finalized block.
|
|
26
|
+
*
|
|
27
|
+
* "(" denotes an open end of the range - the index is not included in the range.
|
|
28
|
+
* "]" denotes a closed end of the range - the index is included in the range.
|
|
29
|
+
*
|
|
30
|
+
* ## Explanation of highestAgedIndex
|
|
31
|
+
*
|
|
32
|
+
* highestAgedIndex is chosen such that for all tagging indexes `i <= highestAgedIndex` we know that no new logs can
|
|
33
|
+
* ever appear.
|
|
34
|
+
*
|
|
35
|
+
* This relies on the "maximum inclusion timestamp" rule enforced by the kernel and rollup circuits:
|
|
36
|
+
* - a transaction's maximum inclusion timestamp is at most `MAX_TX_LIFETIME` seconds after
|
|
37
|
+
* the timestamp of its anchor block; and
|
|
38
|
+
* - a rollup only includes transactions whose inclusion timestamp is >= the L2 block's timestamp.
|
|
39
|
+
*
|
|
40
|
+
* Suppose some device used index `I` in a transaction anchored to block `B_N` at time `N`, and that block is now at
|
|
41
|
+
* least `MAX_TX_LIFETIME` seconds in the past. Then there is no possibility of any *other* device
|
|
42
|
+
* trying to use an index <= `I` while anchoring to a *newer* block than `B_N` because if we were anchoring to
|
|
43
|
+
* a newer block than `B_N` then we would already have seen the log with index `I` and hence the device would have
|
|
44
|
+
* chosen a larger index.
|
|
45
|
+
* If that *other* device would anchor to a block older than `B_N` then that tx could never be included in a block
|
|
46
|
+
* because it would already have been expired.
|
|
47
|
+
*
|
|
48
|
+
* Therefore, once we see that index `I` has been used in a block that is at least `MAX_TX_LIFETIME`
|
|
49
|
+
* seconds old, we can safely stop syncing logs for all indexes <= `I` and set highestAgedIndex = `I`.
|
|
50
|
+
*
|
|
51
|
+
* ## Explanation of the upper bound `highestFinalizedIndex + WINDOW_LEN`
|
|
52
|
+
*
|
|
53
|
+
* When a sender chooses a tagging index, they will select an index that is at most `WINDOW_LEN` greater than
|
|
54
|
+
* the highest finalized index. If that index was already used, they will throw an error. For this reason we
|
|
55
|
+
* don't have to look further than `highestFinalizedIndex + WINDOW_LEN`.
|
|
56
|
+
*
|
|
57
|
+
* ## Batching across secrets
|
|
58
|
+
*
|
|
59
|
+
* Instead of running one RPC call per secret, we merge tags from all pending secrets into a single flat array,
|
|
60
|
+
* make one batched `getAllPrivateLogsByTags` call (which internally chunks at MAX_RPC_LEN), then split results
|
|
61
|
+
* back per secret using tracked offsets. Only secrets whose window advanced are kept for the next iteration.
|
|
62
|
+
*/
|
|
63
|
+
export async function syncTaggedPrivateLogs(
|
|
64
|
+
secrets: AppTaggingSecret[],
|
|
65
|
+
aztecNode: AztecNode,
|
|
66
|
+
taggingStore: RecipientTaggingStore,
|
|
67
|
+
anchorBlockHeader: BlockHeader,
|
|
68
|
+
finalizedBlockNumber: BlockNumber,
|
|
69
|
+
jobId: string,
|
|
70
|
+
): Promise<LogResult[]> {
|
|
71
|
+
if (secrets.length === 0) {
|
|
72
|
+
return [];
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
const anchorBlockNumber = anchorBlockHeader.getBlockNumber();
|
|
76
|
+
const anchorBlockHash = await anchorBlockHeader.hash();
|
|
77
|
+
const currentTimestamp = anchorBlockHeader.globalVariables.timestamp;
|
|
78
|
+
|
|
79
|
+
// Read stored indexes from the db and compute the initial [start, end) range for each secret
|
|
80
|
+
let pending = await getIndexRangesForSecrets(secrets, taggingStore, jobId);
|
|
81
|
+
const allLogs: LogResult[] = [];
|
|
82
|
+
|
|
83
|
+
while (pending.length > 0) {
|
|
84
|
+
// Compute tags for all pending secrets and fetch logs in batched RPC calls
|
|
85
|
+
const logsPerSecret = await fetchLogsForSecrets(pending, aztecNode, anchorBlockNumber, anchorBlockHash);
|
|
86
|
+
|
|
87
|
+
const nextRound = await Promise.all(
|
|
88
|
+
pending.map(async (pendingSecret, i) => {
|
|
89
|
+
const logsFoundWithSecret = logsPerSecret[i];
|
|
90
|
+
if (logsFoundWithSecret.length === 0) {
|
|
91
|
+
// No logs found, no need to update indexes or advance window.
|
|
92
|
+
return undefined;
|
|
93
|
+
}
|
|
94
|
+
|
|
95
|
+
allLogs.push(...logsFoundWithSecret.map(({ log }) => log));
|
|
96
|
+
|
|
97
|
+
// Persist new indexes. If the finalized index moved forward, the window advances
|
|
98
|
+
// and we need another round for this secret.
|
|
99
|
+
return await updateIndexesAndAdvanceWindow(
|
|
100
|
+
pendingSecret,
|
|
101
|
+
logsFoundWithSecret,
|
|
102
|
+
taggingStore,
|
|
103
|
+
currentTimestamp,
|
|
104
|
+
finalizedBlockNumber,
|
|
105
|
+
jobId,
|
|
106
|
+
);
|
|
107
|
+
}),
|
|
108
|
+
);
|
|
109
|
+
|
|
110
|
+
pending = nextRound.filter(isDefined);
|
|
111
|
+
}
|
|
112
|
+
|
|
113
|
+
return allLogs;
|
|
114
|
+
}
|
|
115
|
+
|
|
116
|
+
/** Reads stored indexes for each secret and computes the initial index range to query. */
|
|
117
|
+
function getIndexRangesForSecrets(
|
|
118
|
+
secrets: AppTaggingSecret[],
|
|
119
|
+
taggingStore: RecipientTaggingStore,
|
|
120
|
+
jobId: string,
|
|
121
|
+
): Promise<PendingSecret[]> {
|
|
122
|
+
return Promise.all(
|
|
123
|
+
secrets.map(async secret => {
|
|
124
|
+
const [currentHighestAgedIndex, currentHighestFinalizedIndex] = await Promise.all([
|
|
125
|
+
taggingStore.getHighestAgedIndex(secret, jobId),
|
|
126
|
+
taggingStore.getHighestFinalizedIndex(secret, jobId),
|
|
127
|
+
]);
|
|
128
|
+
|
|
129
|
+
const start = currentHighestAgedIndex === undefined ? 0 : currentHighestAgedIndex + 1;
|
|
130
|
+
const end = (currentHighestFinalizedIndex ?? 0) + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1;
|
|
131
|
+
|
|
132
|
+
return { secret, start, end };
|
|
133
|
+
}),
|
|
134
|
+
);
|
|
135
|
+
}
|
|
136
|
+
|
|
137
|
+
/**
|
|
138
|
+
* Computes siloed tags for all pending secrets' index ranges, fetches logs in one batched RPC call,
|
|
139
|
+
* and returns the results grouped back per secret.
|
|
140
|
+
*/
|
|
141
|
+
async function fetchLogsForSecrets(
|
|
142
|
+
pending: PendingSecret[],
|
|
143
|
+
aztecNode: AztecNode,
|
|
144
|
+
anchorBlockNumber: BlockNumber,
|
|
145
|
+
anchorBlockHash: BlockHash,
|
|
146
|
+
): Promise<LogWithIndex[][]> {
|
|
147
|
+
// Determine the index range for each secret
|
|
148
|
+
const indexesPerSecret = pending.map(({ start, end }) => Array.from({ length: end - start }, (_, i) => start + i));
|
|
149
|
+
|
|
150
|
+
// Compute siloed tags for all indexes
|
|
151
|
+
const tagsPerSecret = await Promise.all(
|
|
152
|
+
pending.map(({ secret }, i) =>
|
|
153
|
+
Promise.all(indexesPerSecret[i].map(index => SiloedTag.compute({ extendedSecret: secret, index }))),
|
|
154
|
+
),
|
|
155
|
+
);
|
|
156
|
+
|
|
157
|
+
const allTags = tagsPerSecret.flat();
|
|
158
|
+
|
|
159
|
+
// getAllPrivateLogsByTags handles MAX_RPC_LEN chunking internally. Recipient sync builds `PendingTaggedLog` from
|
|
160
|
+
// each log's note hashes and first nullifier, so we opt into effects. The `toBlock` cap (anchor block + 1,
|
|
161
|
+
// exclusive) tells the node to skip any logs in blocks past the anchor — the same guard previously enforced
|
|
162
|
+
// by an in-memory filter on the response.
|
|
163
|
+
const allResults = await getAllPrivateLogsByTags(aztecNode, allTags, anchorBlockHash, {
|
|
164
|
+
includeEffects: true,
|
|
165
|
+
toBlock: BlockNumber(anchorBlockNumber + 1),
|
|
166
|
+
});
|
|
167
|
+
|
|
168
|
+
// Split flat results back per secret using the known lengths
|
|
169
|
+
const logsPerSecret: LogWithIndex[][] = [];
|
|
170
|
+
let offset = 0;
|
|
171
|
+
for (const indexes of indexesPerSecret) {
|
|
172
|
+
const logsForSecret: LogWithIndex[] = [];
|
|
173
|
+
for (let i = 0; i < indexes.length; i++) {
|
|
174
|
+
for (const log of allResults[offset + i]) {
|
|
175
|
+
logsForSecret.push({ log, taggingIndex: indexes[i] });
|
|
176
|
+
}
|
|
177
|
+
}
|
|
178
|
+
logsPerSecret.push(logsForSecret);
|
|
179
|
+
offset += indexes.length;
|
|
180
|
+
}
|
|
181
|
+
|
|
182
|
+
return logsPerSecret;
|
|
183
|
+
}
|
|
184
|
+
|
|
185
|
+
/**
|
|
186
|
+
* Processes a single secret's fetched logs: updates stored indexes and returns a new PendingSecret
|
|
187
|
+
* if the window needs to advance, or undefined if this secret is done.
|
|
188
|
+
*/
|
|
189
|
+
async function updateIndexesAndAdvanceWindow(
|
|
190
|
+
pending: PendingSecret,
|
|
191
|
+
logsWithIndexes: LogWithIndex[],
|
|
192
|
+
taggingStore: RecipientTaggingStore,
|
|
193
|
+
currentTimestamp: bigint,
|
|
194
|
+
finalizedBlockNumber: BlockNumber,
|
|
195
|
+
jobId: string,
|
|
196
|
+
): Promise<PendingSecret | undefined> {
|
|
197
|
+
const { highestAgedIndex, highestFinalizedIndex } = findHighestIndexes(
|
|
198
|
+
logsWithIndexes,
|
|
199
|
+
currentTimestamp,
|
|
200
|
+
finalizedBlockNumber,
|
|
201
|
+
);
|
|
202
|
+
|
|
203
|
+
// Store updates in data provider and update local variables
|
|
204
|
+
if (highestAgedIndex !== undefined) {
|
|
205
|
+
await taggingStore.updateHighestAgedIndex(pending.secret, highestAgedIndex, jobId);
|
|
206
|
+
}
|
|
207
|
+
|
|
208
|
+
if (highestFinalizedIndex === undefined) {
|
|
209
|
+
// We have not found a new highest finalized index, so there is no need to move the window forward.
|
|
210
|
+
return undefined;
|
|
211
|
+
}
|
|
212
|
+
|
|
213
|
+
if (highestAgedIndex !== undefined && highestAgedIndex > highestFinalizedIndex) {
|
|
214
|
+
// This is just a sanity check as this should never happen.
|
|
215
|
+
throw new Error(
|
|
216
|
+
`Highest aged index (${highestAgedIndex}) must not exceed highest finalized index (${highestFinalizedIndex})`,
|
|
217
|
+
);
|
|
218
|
+
}
|
|
219
|
+
|
|
220
|
+
await taggingStore.updateHighestFinalizedIndex(pending.secret, highestFinalizedIndex, jobId);
|
|
221
|
+
|
|
222
|
+
// For the next iteration we want to look only at indexes for which we have not yet fetched logs while
|
|
223
|
+
// ensuring that we do not look further than WINDOW_LEN ahead of the highest finalized index.
|
|
224
|
+
return {
|
|
225
|
+
secret: pending.secret,
|
|
226
|
+
start: pending.end,
|
|
227
|
+
end: highestFinalizedIndex + UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN + 1,
|
|
228
|
+
};
|
|
229
|
+
}
|
|
230
|
+
|
|
231
|
+
type PendingSecret = {
|
|
232
|
+
secret: AppTaggingSecret;
|
|
233
|
+
start: number;
|
|
234
|
+
end: number;
|
|
235
|
+
};
|
|
236
|
+
|
|
237
|
+
type LogWithIndex = {
|
|
238
|
+
log: LogResult;
|
|
239
|
+
taggingIndex: number;
|
|
240
|
+
};
|
|
@@ -1,11 +1,11 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import type {
|
|
1
|
+
import { MAX_TX_LIFETIME } from '@aztec/constants';
|
|
2
|
+
import type { LogResult } from '@aztec/stdlib/logs';
|
|
3
3
|
|
|
4
4
|
/**
|
|
5
5
|
* Finds the highest aged and the highest finalized tagging indexes.
|
|
6
6
|
*/
|
|
7
7
|
export function findHighestIndexes(
|
|
8
|
-
privateLogsWithIndexes: Array<{ log:
|
|
8
|
+
privateLogsWithIndexes: Array<{ log: LogResult; taggingIndex: number }>,
|
|
9
9
|
currentTimestamp: bigint,
|
|
10
10
|
finalizedBlockNumber: number,
|
|
11
11
|
): { highestAgedIndex: number | undefined; highestFinalizedIndex: number | undefined } {
|
|
@@ -16,7 +16,7 @@ export function findHighestIndexes(
|
|
|
16
16
|
const ageInSeconds = currentTimestamp - log.blockTimestamp;
|
|
17
17
|
|
|
18
18
|
if (
|
|
19
|
-
ageInSeconds >= BigInt(
|
|
19
|
+
ageInSeconds >= BigInt(MAX_TX_LIFETIME) &&
|
|
20
20
|
(highestAgedIndex === undefined || taggingIndex > highestAgedIndex)
|
|
21
21
|
) {
|
|
22
22
|
highestAgedIndex = taggingIndex;
|
|
@@ -0,0 +1,102 @@
|
|
|
1
|
+
import { type AppTaggingSecret, SiloedTag, type TaggingIndexRange } from '@aztec/stdlib/logs';
|
|
2
|
+
|
|
3
|
+
/**
|
|
4
|
+
* Reconciles tagging index ranges recorded by the PXE during private execution against the set of siloed tags whose
|
|
5
|
+
* private logs survived to the final kernel output.
|
|
6
|
+
*
|
|
7
|
+
* Each input range is the contiguous `[lowestIndex, highestIndex]` set of indexes that the tagging index cache
|
|
8
|
+
* reserved for a given tagging secret while a tx was being executed. The kernel may then squash some of those logs
|
|
9
|
+
* (e.g. when a note is created and nullified within the same tx, taking its log with it), so the actual on-chain
|
|
10
|
+
* footprint can be a strict subset of what was reserved.
|
|
11
|
+
*
|
|
12
|
+
* For each input range, this function shrinks `[lowestIndex, highestIndex]` so that both bounds correspond to indexes
|
|
13
|
+
* that actually survived, trimming any dropped indices at the front or the back. It is possible that some interior
|
|
14
|
+
* indexes were also dropped, leaving gaps between the lowest and highest indices, but we ignore those and accept the
|
|
15
|
+
* resulting inefficiency rather than complicate the tagging model with one in which transactions may use interleaved
|
|
16
|
+
* indices.
|
|
17
|
+
*
|
|
18
|
+
* Trimming tailing indices (e.g. `highestIndex`) is highly useful as it lets us reuse those indices in future
|
|
19
|
+
* transactions. Trimming indices at the front (e.g. `lowestIndex`) is not as impactful since we will not ever use a
|
|
20
|
+
* tagging index if a larger one exists (same as with gaps), but it does help in both making the consistency check
|
|
21
|
+
* between database and transaction effects cheaper (as there's fewer logs to test) and making the database more
|
|
22
|
+
* accurately reflect reality.
|
|
23
|
+
*
|
|
24
|
+
* Ranges with no surviving indexes are dropped from the output entirely.
|
|
25
|
+
*
|
|
26
|
+
* Example scenario:
|
|
27
|
+
* - used indexes 3 to 7, kerel squashed indexes 3, 5, and 7:
|
|
28
|
+
* - range: [3, 7]
|
|
29
|
+
* - survived: set(3, 5, 7)
|
|
30
|
+
* - output: [4, 6] (trimmed from both ends, gap at 5 is tolerated)
|
|
31
|
+
*
|
|
32
|
+
* @param ranges - The tagging index ranges as recorded during private execution (pre-squash).
|
|
33
|
+
* @param survivingTags - The set of siloed tag values (as strings) of private logs that survived kernel squashing.
|
|
34
|
+
* @returns The reconciled ranges, with bounds tightened to surviving indexes and fully-squashed ranges removed.
|
|
35
|
+
*/
|
|
36
|
+
export async function reconcileTaggingIndexRangesAgainstSurvivingTags(
|
|
37
|
+
ranges: TaggingIndexRange[],
|
|
38
|
+
survivingTags: Set<string>,
|
|
39
|
+
): Promise<TaggingIndexRange[]> {
|
|
40
|
+
const reconciled: TaggingIndexRange[] = [];
|
|
41
|
+
|
|
42
|
+
for (const range of ranges) {
|
|
43
|
+
const newLowestIndex = await findFirstSurvivingIndex(
|
|
44
|
+
range.extendedSecret,
|
|
45
|
+
range.lowestIndex,
|
|
46
|
+
range.highestIndex,
|
|
47
|
+
survivingTags,
|
|
48
|
+
);
|
|
49
|
+
if (newLowestIndex === undefined) {
|
|
50
|
+
// No index in this range corresponds to a surviving log: the entire range was squashed.
|
|
51
|
+
continue;
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
// newLowestIndex is itself a survivor, so the backward scan is guaranteed to find at least that index.
|
|
55
|
+
const newHighestIndex = await findLastSurvivingIndex(
|
|
56
|
+
range.extendedSecret,
|
|
57
|
+
newLowestIndex,
|
|
58
|
+
range.highestIndex,
|
|
59
|
+
survivingTags,
|
|
60
|
+
);
|
|
61
|
+
|
|
62
|
+
reconciled.push({
|
|
63
|
+
extendedSecret: range.extendedSecret,
|
|
64
|
+
lowestIndex: newLowestIndex,
|
|
65
|
+
highestIndex: newHighestIndex!,
|
|
66
|
+
});
|
|
67
|
+
}
|
|
68
|
+
|
|
69
|
+
return reconciled;
|
|
70
|
+
}
|
|
71
|
+
|
|
72
|
+
/** Scans `[start, end]` ascending and returns the first index whose siloed tag is in `survivingTags`. */
|
|
73
|
+
async function findFirstSurvivingIndex(
|
|
74
|
+
secret: AppTaggingSecret,
|
|
75
|
+
start: number,
|
|
76
|
+
end: number,
|
|
77
|
+
survivingTags: Set<string>,
|
|
78
|
+
): Promise<number | undefined> {
|
|
79
|
+
for (let index = start; index <= end; index++) {
|
|
80
|
+
const tag = await SiloedTag.compute({ extendedSecret: secret, index });
|
|
81
|
+
if (survivingTags.has(tag.value.toString())) {
|
|
82
|
+
return index;
|
|
83
|
+
}
|
|
84
|
+
}
|
|
85
|
+
return undefined;
|
|
86
|
+
}
|
|
87
|
+
|
|
88
|
+
/** Scans `[start, end]` descending and returns the first index whose siloed tag is in `survivingTags`. */
|
|
89
|
+
async function findLastSurvivingIndex(
|
|
90
|
+
secret: AppTaggingSecret,
|
|
91
|
+
start: number,
|
|
92
|
+
end: number,
|
|
93
|
+
survivingTags: Set<string>,
|
|
94
|
+
): Promise<number | undefined> {
|
|
95
|
+
for (let index = end; index >= start; index--) {
|
|
96
|
+
const tag = await SiloedTag.compute({ extendedSecret: secret, index });
|
|
97
|
+
if (survivingTags.has(tag.value.toString())) {
|
|
98
|
+
return index;
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
return undefined;
|
|
102
|
+
}
|
|
@@ -1,21 +1,20 @@
|
|
|
1
|
-
import type { AztecAddress } from '@aztec/stdlib/aztec-address';
|
|
2
1
|
import type { BlockHash } from '@aztec/stdlib/block';
|
|
3
2
|
import type { AztecNode } from '@aztec/stdlib/interfaces/server';
|
|
4
|
-
import type {
|
|
3
|
+
import type { AppTaggingSecret } from '@aztec/stdlib/logs';
|
|
5
4
|
|
|
6
5
|
import type { SenderTaggingStore } from '../../storage/tagging_store/sender_tagging_store.js';
|
|
7
6
|
import { UNFINALIZED_TAGGING_INDEXES_WINDOW_LEN } from '../constants.js';
|
|
8
|
-
import {
|
|
7
|
+
import {
|
|
8
|
+
EMPTY_STATUS_CHANGE,
|
|
9
|
+
getStatusChangeOfPending,
|
|
10
|
+
mergeStatusChanges,
|
|
11
|
+
} from './utils/get_status_change_of_pending.js';
|
|
9
12
|
import { loadAndStoreNewTaggingIndexes } from './utils/load_and_store_new_tagging_indexes.js';
|
|
10
13
|
|
|
11
14
|
/**
|
|
12
15
|
* Syncs tagging indexes. This function needs to be called whenever a private log is being sent.
|
|
13
16
|
*
|
|
14
|
-
* @param secret - The
|
|
15
|
-
* sender -> recipient matters.
|
|
16
|
-
* @param app - The address of the contract that the logs are tagged for. Needs to be provided because we perform
|
|
17
|
-
* second round of siloing in this function which is necessary because kernels do it as well (they silo first field
|
|
18
|
-
* of the private log which corresponds to the tag).
|
|
17
|
+
* @param secret - The sender-side tagging `AppTaggingSecret`.
|
|
19
18
|
* @remarks When syncing the indexes as sender we don't care about the log contents - we only care about the highest
|
|
20
19
|
* pending and highest finalized indexes as that guides the next index choice when sending a log. The next index choice
|
|
21
20
|
* is simply the highest pending index plus one (or finalized if pending is undefined).
|
|
@@ -23,8 +22,7 @@ import { loadAndStoreNewTaggingIndexes } from './utils/load_and_store_new_taggin
|
|
|
23
22
|
* updates its status accordingly.
|
|
24
23
|
*/
|
|
25
24
|
export async function syncSenderTaggingIndexes(
|
|
26
|
-
secret:
|
|
27
|
-
app: AztecAddress,
|
|
25
|
+
secret: AppTaggingSecret,
|
|
28
26
|
aztecNode: AztecNode,
|
|
29
27
|
taggingStore: SenderTaggingStore,
|
|
30
28
|
anchorBlockHash: BlockHash,
|
|
@@ -57,21 +55,58 @@ export async function syncSenderTaggingIndexes(
|
|
|
57
55
|
let newFinalizedIndex = undefined;
|
|
58
56
|
|
|
59
57
|
while (true) {
|
|
60
|
-
//
|
|
61
|
-
//
|
|
62
|
-
await
|
|
58
|
+
// Pending tx hashes already in the store for this window (from prior syncs or txs this PXE itself sent).
|
|
59
|
+
// Reading these before issuing any RPC lets us fetch their receipts in parallel with the logs query below.
|
|
60
|
+
const knownPendingTxHashes = await taggingStore.getTxHashesOfPendingIndexes(secret, start, end, jobId);
|
|
63
61
|
|
|
64
|
-
//
|
|
65
|
-
const
|
|
66
|
-
|
|
62
|
+
// Fire the logs query and the known-pending receipts query in parallel
|
|
63
|
+
const [, statusOfKnown] = await Promise.all([
|
|
64
|
+
loadAndStoreNewTaggingIndexes(secret, start, end, aztecNode, taggingStore, anchorBlockHash, jobId),
|
|
65
|
+
knownPendingTxHashes.length > 0
|
|
66
|
+
? getStatusChangeOfPending(knownPendingTxHashes, aztecNode)
|
|
67
|
+
: Promise.resolve(EMPTY_STATUS_CHANGE),
|
|
68
|
+
]);
|
|
69
|
+
|
|
70
|
+
// Re-read pending tx hashes after the logs query writes any newly-discovered ones to the store.
|
|
71
|
+
const allPendingTxHashes = await taggingStore.getTxHashesOfPendingIndexes(secret, start, end, jobId);
|
|
72
|
+
if (allPendingTxHashes.length === 0) {
|
|
67
73
|
break;
|
|
68
74
|
}
|
|
69
75
|
|
|
70
|
-
|
|
76
|
+
// Receipts for pending tx hashes that the logs query just surfaced still need a sequential follow-up call.
|
|
77
|
+
// `storePendingIndexes` is idempotent on (secret, txHash), so a re-discovered hash stays classified as known
|
|
78
|
+
// and is not re-fetched here.
|
|
79
|
+
const knownSet = new Set(knownPendingTxHashes.map(h => h.toString()));
|
|
80
|
+
const newPendingTxHashes = allPendingTxHashes.filter(h => !knownSet.has(h.toString()));
|
|
81
|
+
|
|
82
|
+
const statusOfNew =
|
|
83
|
+
newPendingTxHashes.length > 0
|
|
84
|
+
? await getStatusChangeOfPending(newPendingTxHashes, aztecNode)
|
|
85
|
+
: EMPTY_STATUS_CHANGE;
|
|
86
|
+
|
|
87
|
+
const { txHashesToFinalize, txHashesToDrop, txHashesWithExecutionReverted } = mergeStatusChanges(
|
|
88
|
+
statusOfKnown,
|
|
89
|
+
statusOfNew,
|
|
90
|
+
);
|
|
71
91
|
|
|
72
92
|
await taggingStore.dropPendingIndexes(txHashesToDrop, jobId);
|
|
73
93
|
await taggingStore.finalizePendingIndexes(txHashesToFinalize, jobId);
|
|
74
94
|
|
|
95
|
+
if (txHashesWithExecutionReverted.length > 0) {
|
|
96
|
+
const receipts = await Promise.all(
|
|
97
|
+
txHashesWithExecutionReverted.map(txHash => aztecNode.getTxReceipt(txHash, { includeTxEffect: true })),
|
|
98
|
+
);
|
|
99
|
+
for (const receipt of receipts) {
|
|
100
|
+
if (!receipt.isMined() || !receipt.txEffect) {
|
|
101
|
+
throw new Error(
|
|
102
|
+
'TxEffect not found for execution-reverted tx. This is either a bug or a reorg has occurred.',
|
|
103
|
+
);
|
|
104
|
+
}
|
|
105
|
+
|
|
106
|
+
await taggingStore.finalizePendingIndexesOfAPartiallyRevertedTx(receipt.txEffect, jobId);
|
|
107
|
+
}
|
|
108
|
+
}
|
|
109
|
+
|
|
75
110
|
// We check if the finalized index has been updated.
|
|
76
111
|
newFinalizedIndex = await taggingStore.getLastFinalizedIndex(secret, jobId);
|
|
77
112
|
if (previousFinalizedIndex !== newFinalizedIndex) {
|
|
@@ -1,36 +1,66 @@
|
|
|
1
1
|
import type { AztecNode } from '@aztec/stdlib/interfaces/server';
|
|
2
2
|
import { TxHash, TxStatus } from '@aztec/stdlib/tx';
|
|
3
3
|
|
|
4
|
+
/** Classification of a batch of pending tx hashes by the status change implied by their receipts. */
|
|
5
|
+
export type StatusChange = {
|
|
6
|
+
txHashesToFinalize: TxHash[];
|
|
7
|
+
txHashesToDrop: TxHash[];
|
|
8
|
+
txHashesWithExecutionReverted: TxHash[];
|
|
9
|
+
};
|
|
10
|
+
|
|
11
|
+
export const EMPTY_STATUS_CHANGE: StatusChange = {
|
|
12
|
+
txHashesToFinalize: [],
|
|
13
|
+
txHashesToDrop: [],
|
|
14
|
+
txHashesWithExecutionReverted: [],
|
|
15
|
+
};
|
|
16
|
+
|
|
17
|
+
/** Concatenates two status changes field-by-field. */
|
|
18
|
+
export function mergeStatusChanges(a: StatusChange, b: StatusChange): StatusChange {
|
|
19
|
+
return {
|
|
20
|
+
txHashesToFinalize: [...a.txHashesToFinalize, ...b.txHashesToFinalize],
|
|
21
|
+
txHashesToDrop: [...a.txHashesToDrop, ...b.txHashesToDrop],
|
|
22
|
+
txHashesWithExecutionReverted: [...a.txHashesWithExecutionReverted, ...b.txHashesWithExecutionReverted],
|
|
23
|
+
};
|
|
24
|
+
}
|
|
25
|
+
|
|
4
26
|
/**
|
|
5
|
-
* Based on receipts obtained from `aztecNode` returns which pending transactions changed their status to finalized
|
|
6
|
-
* dropped.
|
|
27
|
+
* Based on receipts obtained from `aztecNode` returns which pending transactions changed their status to finalized,
|
|
28
|
+
* dropped, or execution-reverted (but mined).
|
|
7
29
|
*/
|
|
8
|
-
export async function getStatusChangeOfPending(
|
|
9
|
-
pending: TxHash[],
|
|
10
|
-
aztecNode: AztecNode,
|
|
11
|
-
): Promise<{ txHashesToFinalize: TxHash[]; txHashesToDrop: TxHash[] }> {
|
|
30
|
+
export async function getStatusChangeOfPending(pending: TxHash[], aztecNode: AztecNode): Promise<StatusChange> {
|
|
12
31
|
// Get receipts for all pending tx hashes.
|
|
13
32
|
const receipts = await Promise.all(pending.map(pendingTxHash => aztecNode.getTxReceipt(pendingTxHash)));
|
|
14
33
|
|
|
15
34
|
const txHashesToFinalize: TxHash[] = [];
|
|
16
35
|
const txHashesToDrop: TxHash[] = [];
|
|
36
|
+
const txHashesWithExecutionReverted: TxHash[] = [];
|
|
17
37
|
|
|
18
38
|
for (let i = 0; i < receipts.length; i++) {
|
|
19
39
|
const receipt = receipts[i];
|
|
20
40
|
const txHash = pending[i];
|
|
21
41
|
|
|
22
|
-
if (receipt.status === TxStatus.FINALIZED
|
|
23
|
-
// Tx has been included in a block and the corresponding block is finalized
|
|
24
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
28
|
-
|
|
42
|
+
if (receipt.status === TxStatus.FINALIZED) {
|
|
43
|
+
// Tx has been included in a block and the corresponding block is finalized
|
|
44
|
+
if (receipt.hasExecutionSucceeded()) {
|
|
45
|
+
// No part of execution reverted - we just finalize all the indexes.
|
|
46
|
+
txHashesToFinalize.push(txHash);
|
|
47
|
+
} else if (receipt.hasExecutionReverted()) {
|
|
48
|
+
// Tx was mined but execution reverted (app logic, teardown, or both). Some logs from the non-revertible
|
|
49
|
+
// phase may still be onchain. We check which tags made it onchain and finalize those; drop the rest.
|
|
50
|
+
txHashesWithExecutionReverted.push(txHash);
|
|
51
|
+
} else {
|
|
52
|
+
// Defensive check - this branch should never be triggered
|
|
53
|
+
throw new Error(
|
|
54
|
+
'Both hasExecutionSucceeded and hasExecutionReverted on the receipt returned false. This should never happen and it implies a bug. Please open an issue.',
|
|
55
|
+
);
|
|
56
|
+
}
|
|
57
|
+
} else if (receipt.isDropped()) {
|
|
58
|
+
// Tx was dropped from the mempool --> we drop the corresponding pending indexes.
|
|
29
59
|
txHashesToDrop.push(txHash);
|
|
30
60
|
} else {
|
|
31
61
|
// Tx is still pending, not yet finalized, or was mined successfully but not yet finalized --> we don't do anything.
|
|
32
62
|
}
|
|
33
63
|
}
|
|
34
64
|
|
|
35
|
-
return { txHashesToFinalize, txHashesToDrop };
|
|
65
|
+
return { txHashesToFinalize, txHashesToDrop, txHashesWithExecutionReverted };
|
|
36
66
|
}
|