444 feat include tvlstrategies breakdown for historical avs data

[uditdc]

Summary

Adds optional strategy-wise TVL breakdown to the endpoint, allowing clients to get detailed insights into how TVL is distributed across different strategies (stETH, cbETH, rETH, etc.) for any AVS over time.

Features

• Conditional Parameter: withStrategyTvl query parameter (defaults to false)
• User-Friendly Keys: Uses strategy names (e.g., "stETH", "cbETH") instead of addresses
• Performance Optimized: Only processes strategy breakdown when explicitly requested
• Backward Compatible: Existing API calls remain unchanged

API Usage

Default Behavior (No Breakdown)

GET /historical/avs/0x123...?frequency=1d&startAt=2024-01-01&endAt=2024-01-31

With Strategy Breakdown

GET /historical/avs/0x123...?withStrategyTvl=true&frequency=1d&startAt=2024-01-01&endAt=2024-01-31

Response Format

Without Breakdown (withStrategyTvl=false)

{
  "data": [
    {
      "timestamp": "2024-01-01T00:00:00.000Z",
      "tvlEth": 1000.5,
      "totalStakers": 150,
      "totalOperators": 25
    }
  ]
}

With Breakdown (withStrategyTvl=true)

{
  "data": [
    {
      "timestamp": "2024-01-01T00:00:00.000Z",
      "tvlEth": 1000.5,
      "totalStakers": 150,
      "totalOperators": 25,
      "tvlStrategies": {
        "stETH": 400.2,
        "cbETH": 300.1,
        "rETH": 300.2
      }
    }
  ]
}

Resolves #444