Update RSKIP529 with base and super events storage specification

Author: marcos-iov

IPs/RSKIP529.md

@@ -1,6 +1,6 @@
 ---
 rskip: 529
-title: Super events
+title: New storage cells in Bridge native contract for base and super events info
 created: 26-AUG-25
 author: MI
 purpose: Sca
@@ -30,75 +30,106 @@ To be completed...
 
 ## Specification
 
-### 1. New storage entry for the serialized `super event`
+### 1. Base event
 
-A new storage entry is necessary to store the serialized `super event` sent by the Union Bridge contract.
+#### 1.1 New storage entry for the serialized `base event`
+
+A new storage entry is necessary to store the serialized `base event` sent by the Union Bridge contract.
 
 ```
-**Storage entry name:** `superEvent`
+**Storage entry name:** `baseEvent`
 
 **Data type:** `bytes`
 
-**Maximum size:** TBD
+**Maximum size:** 128 bytes
 ```
 
-The value is considered *unset* if `superEvent.length == 0`.
+#### 1.2. Method to get the serialized `base event`
 
-### 2. Method to get the serialized `super event`
-
-A method will be added to allow anyone to query the current `super event`. If no value is set, then it should return an empty array of bytes.
+A method will be added to allow anyone to query the current `base event`. If no value is set, then it should return an empty array of bytes.
 
 **Method signature:**
 
 ```
-function getSuperEvent() public view returns (bytes memory);
+function getBaseEvent() public view returns (bytes memory);
 ```
 
-### 3. Method to set the `super event` value in storage
+#### 1.3. Method to set the `base event` value in storage
 
-A method will be added to allow the Union Bridge contract address to set the current `super event` value in storage. 
+A method will be added to allow the Union Bridge contract address to set the current `base event` value in storage. 
 
 - If the caller is not the Union Bridge contract address then it should revert.
-- It should receive a non-empty array of bytes and store it under the `superEvent` storage key of the Bridge contract. 
-- If there is an already existing value under the `superEvent` storage key of the Bridge contract, it will be overriden by the new value.
+- It should receive a non-empty array of bytes whose length is at most 128 bytes, which it then stores under the `baseEvent` storage key of the Bridge contract. 
+- If there is an already existing value under the `baseEvent` storage key of the Bridge contract, it will be overriden by the new value.
 
 **Method signature:**
 
 ```
-function setSuperEvent(bytes memory superEvent) public;
+function setBaseEvent(bytes memory baseEvent) public;
 ```
 
-### 4. Method to clear the `super event` value in storage
+#### 1.4. Method to clear the `base event` value in storage
 
-A method will be added to allow the Union Bridge contract address to clear the current `super event` value in storage. 
+A method will be added to allow the Union Bridge contract address to clear the current `base event` value in storage. 
 
 - If the caller is not the Union Bridge contract address then it should revert.
-- It should store an empty byte array under the `superEvent` storage key of the Bridge, overriding whatever value was previously there.
+- It should store an empty byte array under the `baseEvent` storage key of the Bridge, overriding whatever value was previously there.
 
 **Method signature:**
 
 ```
-function clearSuperEvent() public;
+function clearBaseEvent() public;
+```
+
+### 2. Super event
+
+#### 2.1 New storage entry for the serialized `super event`
+
+A new storage entry is necessary to store the serialized `super event` sent by the Union Bridge contract.
+
+```
+**Storage entry name:** `superEvent`
+
+**Data type:** `bytes`
+
+**Maximum size:** 128 bytes
 ```
 
-### 5. Method to get the accumulated difficulty of the latest `super block`
+#### 2.2. Method to get the serialized `super event`
 
-A method will be added to allow anyone to query the latest `super block` accumulated difficulty.
+A method will be added to allow anyone to query the current `super event`. If no value is set, then it should return an empty array of bytes.
 
 **Method signature:**
 
 ```
-function getSuperBlockCumulativeDifficulty() public view returns(bytes);
+function getSuperEvent() public view returns (bytes memory);
 ```
 
-### 6. Method to get the latest `super block` chain height
+#### 2.3. Method to set the `super event` value in storage
 
-A method will be added to allow anyone to query the latest `super block` chain height.
+A method will be added to allow the Union Bridge contract address to set the current `super event` value in storage. 
+
+- If the caller is not the Union Bridge contract address then it should revert.
+- It should receive a non-empty array of bytes whose length is at most 128 bytes, which it then stores under the `superEvent` storage key of the Bridge contract. 
+- If there is an already existing value under the `superEvent` storage key of the Bridge contract, it will be overriden by the new value.
 
 **Method signature:**
 
 ```
-function getSuperBlockchainHeight() public view returns(uint32);
+function setSuperEvent(bytes memory superEvent) public;
+```
+
+#### 2.4. Method to clear the `super event` value in storage
+
+A method will be added to allow the Union Bridge contract address to clear the current `super event` value in storage. 
+
+- If the caller is not the Union Bridge contract address then it should revert.
+- It should store an empty byte array under the `superEvent` storage key of the Bridge, overriding whatever value was previously there.
+
+**Method signature:**
+
+```
+function clearSuperEvent() public;
 ```
 
 ## Rationale

README.md

@@ -246,7 +246,7 @@ You can find an easily browseable version of this information [here](https://ips
 | 516 |[Precompiled contracts for +/* on Secp256k1](IPs/RSKIP516.md)| 10-APR-2025 | SDL | Usa | Core | 2 | Draft |
 | 517 |[Block time-centric difficulty adjustment with uncle threshold](IPs/RSKIP517.md)| 29-MAY-2025 | PDG | Sec,Sca | Core | 1 | Draft |
 | 518 |[Network Upgrade: Reed](IPs/RSKIP518.md)| 13-JUN-2025 | AE | Usa, Sca | Core | 3 | Draft |
-| 519 |[Super events](IPs/RSKIP519.md)| 26-AUG-2025 | MI | Sca | Core | 1 | Draft |
+| 519 |[New storage cells in Bridge native contract for base and super events info](IPs/RSKIP519.md)| 26-AUG-2025 | MI | Sca | Core | 1 | Draft |
 
 (*) Under evaluation to be implemented in the next reference client release