Implement Aegis SDK contract event mapper

[El-swaggerito]

Description

Difficulty: Expert

Type: Feature

Summary

Implement a contract event mapper for Aegis protocol events.

Current Behaviour

Dashboard and SDK consumers may need to parse raw compliance, minting, transfer, role, and asset events.

Expected Behaviour

The SDK should map known contract events into typed objects and handle unknown events safely.

Suggested Implementation

Create event types, mapper utilities, fixtures, tests, and docs.

Files or Areas Likely Affected

• src/events/
• src/soroban/
• src/types/
• tests/
• docs/

Acceptance Criteria

• Contract event mapper is implemented.
• Compliance, minting, transfer, role, and asset events are supported where applicable.
• Unknown events are handled safely.
• Fixtures are added.
• Tests cover known and unknown events.
• Docs explain event compatibility.

Additional Notes

This supports audit trail features.

[edochieblessing09-max]

i would love to work on thiis issue will produce an excellent result

[grantfox-oss]

🦊 GrantFox — @edochieblessing09-max has been assigned to this issue as part of the Official Campaign | FWC26 campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #148)
2. Your PR will be reviewed by the Axionvera maintainers

Good luck! Track your progress on GrantFox.