feat!: processing events in Aztec.nr

docs/docs/migration_notes.md

@@ -8,19 +8,30 @@ Aztec is in full-speed development. Literally every version breaks compatibility
 
 ## TBD
 
-## [aztec.js] AztecNode.findLeavesIndexes returns indexes with block metadata
+### [aztec.js] AztecNode.getPrivateEvents API change
+
+The `getPrivateEvents` method signature has changed to require an address of a contract that emitted the event and use recipient addresses instead of viewing public keys:
+
+```diff
+- const events = await wallet.getPrivateEvents<Transfer>(TokenContract.events.Transfer, 1, 1, [recipient.getCompleteAddress().publicKeys.masterIncomingViewingPublicKey()]);
++ const events = await wallet.getPrivateEvents<Transfer>(token.address, TokenContract.events.Transfer, 1, 1, [recipient.getAddress()]);
+```
+
+## 0.82.0
+
+### [aztec.js] AztecNode.findLeavesIndexes returns indexes with block metadata
 
 It's common that we need block metadata of a block in which leaves where inserted when querying indexes of these tree leaves.
 For this reason we now return that information along with the indexes.
 This allows us to reduce the number of individual AztecNode queries.
 
 Along this change `findNullifiersIndexesWithBlock` and `findBlockNumbersForIndexes` functions wer removed as all its uses can now be replaced with the newly modified `findLeavesIndexes` function.
 
-## [aztec.js] AztecNode.getPublicDataTreeWitness renamed as AztecNode.getPublicDataWitness
+### [aztec.js] AztecNode.getPublicDataTreeWitness renamed as AztecNode.getPublicDataWitness
 
 This change was done to have consistent naming across codebase.
 
-## [aztec.js] Wallet interface and Authwit management
+### [aztec.js] Wallet interface and Authwit management
 
 The `Wallet` interface in `aztec.js` is undergoing transformations, trying to be friendlier to wallet builders and reducing the surface of its API. This means `Wallet` no longer extends `PXE`, and instead just implements a subset of the methods of the former. This is NOT going to be its final form, but paves the way towards better interfaces and starts to clarify what the responsibilities of the wallet are:
 

noir-projects/aztec-nr/aztec/src/discovery/mod.nr

@@ -1,10 +1,10 @@
 use crate::encrypted_logs::log_encryption::PRIVATE_LOG_PLAINTEXT_SIZE_IN_FIELDS;
 use protocol_types::{address::AztecAddress, debug_log::debug_log};
 
+pub mod nonce_discovery;
+pub mod partial_notes;
 pub mod private_logs;
 pub mod private_notes;
-pub mod partial_notes;
-pub mod nonce_discovery;
 
 /// We reserve two fields in the note private log that are not part of the note content: one for the storage slot, and
 /// one for the combined log and note type ID.

noir-projects/aztec-nr/aztec/src/discovery/private_logs.nr

@@ -7,17 +7,21 @@ use crate::{
     encrypted_logs::{
         log_assembly_strategies::default_aes128::aes128::AES128,
         log_encryption::LogEncryption,
-        log_type::{PARTIAL_NOTE_PRIVATE_LOG_TYPE_ID, PRIVATE_NOTE_LOG_TYPE_ID},
+        log_type::{
+            PARTIAL_NOTE_PRIVATE_LOG_TYPE_ID, PRIVATE_EVENT_LOG_TYPE_ID, PRIVATE_NOTE_LOG_TYPE_ID,
+        },
         metadata_packing::from_expanded_metadata,
     },
-    oracle::message_discovery::sync_notes,
+    oracle::{logs::store_private_event_log, message_discovery::sync_notes},
     utils::array,
 };
 
 use protocol_types::{
+    abis::event_selector::EventSelector,
     address::AztecAddress,
     constants::{MAX_NOTE_HASHES_PER_TX, PRIVATE_LOG_SIZE_IN_FIELDS},
     debug_log::{debug_log, debug_log_format},
+    traits::FromField,
 };
 
 // TODO(#12750): don't make these values assume we're using AES.
@@ -52,14 +56,14 @@ pub unconstrained fn do_process_log<Env>(
     tx_hash: Field,
     unique_note_hashes_in_tx: BoundedVec<Field, MAX_NOTE_HASHES_PER_TX>,
     first_nullifier_in_tx: Field,
+    log_index_in_tx: Field,
     recipient: AztecAddress,
     compute_note_hash_and_nullifier: ComputeNoteHashAndNullifier<Env>,
 ) {
     debug_log_format("Processing log with tag {0}", [log.get(0)]);
 
-    // The tag is ignored for now.
+    // The first field of the log is the tag, which we don't need right now, and the rest is all ciphertext.
     let ciphertext = array::subbvec(log, 1);
-
     let log_plaintext = AES128::decrypt_log(ciphertext, recipient);
 
     // The first thing to do after decrypting the log is to determine what type of private log we're processing. We
@@ -84,6 +88,20 @@ pub unconstrained fn do_process_log<Env>(
         debug_log("Processing partial note private log");
 
         process_partial_note_private_log(contract_address, recipient, log_metadata, log_content);
+    } else if log_type_id == PRIVATE_EVENT_LOG_TYPE_ID {
+        debug_log("Processing private event log");
+
+        // In the case of event logs, the log metadata is the event selector.
+        let event_selector = EventSelector::from_field(log_metadata as Field);
+
+        store_private_event_log(
+            contract_address,
+            recipient,
+            event_selector,
+            log_content,
+            tx_hash,
+            log_index_in_tx,
+        );
     } else {
         // TODO(#11569): handle events
         debug_log_format(