Add SDK investor transfer eligibility API #36

Description

Difficulty: Expert

Type: Feature

Summary

Implement or document investor transfer eligibility API for the Aegis SDK with typed behaviour, clear edge cases, tests, and contributor-ready documentation.

Current Behaviour

The SDK may not yet have a complete, reusable, and well-tested implementation for investor transfer eligibility API, which can create duplicated logic or unclear contributor expectations.

Expected Behaviour

The repository should provide a clear investor transfer eligibility API workflow that is safe for RWA/compliance use cases and consistent with the SDK, dashboard, and contract boundaries.

Suggested Implementation

Design the data model, add the implementation or documentation, connect it to relevant Aegis modules, add fixtures or tests, and update README/docs where applicable.

Files or Areas Likely Affected

• src/
• tests/
• docs/
• README.md

Acceptance Criteria

• Investor transfer eligibility api is implemented or clearly specified.
• Relevant edge cases and failure states are handled.
• Security and compliance-sensitive assumptions are documented.
• Tests, fixtures, or review checklists are added where practical.
• README or docs link to the new guidance.
• The change is compatible with the rest of the Aegis ecosystem.

Additional Notes

Keep wording precise: protocol-level compliance should not be presented as legal or financial advice.