Feature/contract bridge status aggregation

README.md

@@ -53,6 +53,32 @@ To become the standard monitoring infrastructure for bridged assets on Stellar,
 
 Continuous tracking of bridged asset supplies across chains with automated verification against official reserve data. This includes monitoring mint and burn events, detecting supply mismatches, and maintaining historical records of bridge performance and uptime.
 
+### On-Chain Bridge Status Aggregation (Soroban)
+
+The Soroban contract maintains **pre-aggregated rollups** for fast reads (no scanning across all assets/bridges at query time). Rollups are normalized into severity tiers:
+
+`StatusTier`: `Ok` | `Low` | `Medium` | `High`
+
+Stored rollup views:
+
+- **Per-asset**: `AssetStatusRollup` (health score + price deviation alerts + paused/active flags)
+- **Per-bridge**: `BridgeStatusRollup` (latest supply mismatch severity)
+- **Contract-level**: `ContractStatusRollup` (counts by tier across assets and bridges, plus an overall tier)
+
+Read functions (Soroban):
+
+- `get_asset_status_rollup(asset_code)`
+- `get_bridge_status_rollup(bridge_id)`
+- `get_contract_status_rollup()`
+
+Rollups are updated deterministically when new signals are submitted (for example, `submit_health`, `check_price_deviation`, and `record_supply_mismatch`).
+
+Events:
+
+- `asset_st` — asset tier updated
+- `bridge_st` — bridge tier updated
+- `ctr_st` — contract-level tier updated
+
 ### Liquidity Analytics
 
 Aggregated liquidity depth across StellarX AMM, Phoenix DEX, LumenSwap, SDEX, and Soroswap. The platform provides real-time total value locked per asset pair, best route suggestions for optimal trade execution, and volume-weighted average pricing across all venues.

contracts/soroban/src/analytics_aggregator.rs

@@ -316,10 +316,7 @@ impl AnalyticsAggregatorContract {
 #[cfg(test)]
 mod tests {
     use super::*;
-    use soroban_sdk::{
-        testutils::{Address as _, Ledger as _},
-        Env,
-    };
+    use soroban_sdk::{testutils::Address as _, testutils::Ledger, Env};
 
     #[test]
     fn test_analytics_register_metric_and_history() {
@@ -344,6 +341,8 @@ mod tests {
 
         assert_eq!(history.len(), 3);
         assert_eq!(history.get(0).unwrap().value, 1500);
+        assert_eq!(history.get(1).unwrap().value, 0);
+        assert_eq!(history.get(2).unwrap().value, 0);
     }
 
     #[test]