Add Aegis SDK investor portfolio normaliser

[El-swaggerito]

Description

Difficulty: Expert

Type: Feature

Summary

Add an investor portfolio normaliser for RWA holdings.

Current Behaviour

Investor portfolio data may be returned in inconsistent shapes across asset reads and dashboard views.

Expected Behaviour

The SDK should normalise holdings into a typed portfolio model.

Suggested Implementation

Create portfolio types, normaliser, display helpers, tests, fixtures, and docs.

Files or Areas Likely Affected

• src/investor/
• src/assets/
• src/types/
• tests/
• docs/

Acceptance Criteria

• Investor portfolio normaliser is implemented.
• Asset holdings are represented consistently.
• Unknown or unsupported assets are handled.
• Display helpers are included where appropriate.
• Tests cover portfolio states.
• Docs explain portfolio assumptions.

Additional Notes

This supports investor-facing dashboard work.

[Carlys17]

I'd like to work on this. I'll add a typed portfolio model and a normaliser that maps raw asset reads into a consistent
shape, handle unknown/unsupported assets, add display helpers, and cover portfolio states with tests and fixtures.

[devkryssie]

HI, MAINTAINER I WOULD LIKE TO WORK ON THIS ISSUE AND SUBMIT PR BEFORE 24HOURS

[Lekan101]

Hello! I’m a smart contract and full-stack developer experienced in Solidity, Cairo, Soroban, TypeScript, and Rust, with contributions across 30+ blockchain projects, including Stellar-based systems. I’m eager to contribute to this issue.