Add Aegis SDK RWA asset metadata parser

[El-swaggerito]

Description

Difficulty: Expert

Type: Feature

Summary

Add an RWA asset metadata parser for SDK consumers.

Current Behaviour

RWA metadata may be parsed inconsistently across admin, investor, and dashboard flows.

Expected Behaviour

The SDK should provide a typed parser and validator for asset metadata.

Suggested Implementation

Create metadata schema, parser, validation errors, fixtures, tests, and docs.

Files or Areas Likely Affected

• src/assets/
• src/rwa/
• src/types/
• src/errors/
• tests/
• docs/

Acceptance Criteria

• RWA metadata parser is implemented.
• Required and optional fields are validated.
• Invalid metadata returns typed errors.
• Fixtures cover valid and invalid metadata.
• Tests cover parser behaviour.
• Docs explain metadata assumptions.

Additional Notes

This supports safe dashboard integration.

[Gipzy8]

Hi! I'd like to work on this issue. I have experience with [TypeScript/JavaScript, schema validation libraries like Zod or Yup, SDK development]. My plan: define a typed metadata schema, implement the parser with clear validation errors for required/optional fields, add fixtures covering valid and invalid metadata, write unit tests, and document the metadata assumptions. Looking forward to contributing.