Add investor-side reconciliation hook get_holder_statement returning full ledger view

[thlpkee20-wq]

Description

Holders today must aggregate state across several view functions to reconcile. Add get_holder_statement(offering_id, holder) returning (shares_bps, total_accrued, total_claimed, vesting_pending, lockup_end) in a single structured response.

Requirements and context

• Must be secure, tested, and documented
• Should be efficient and easy to review
• Relevant code: Revora-Contracts/src/lib.rs
• Response struct must be additively versioned for future fields

Suggested execution

• Fork the repo and create a branch
• git checkout -b feat/holder-statement-view
• Implement changes
  • Define HolderStatementV1 { ... } and helper aggregator
  • Read from existing storage without mutation
  • Document field semantics in README integrator section
• Validate security and correctness assumptions

Test and commit

• Run tests
  • cargo test --all
• Cover edge cases
  • Holder with zero shares must return a fully zeroed statement, not an error
• Include test output and security notes

Example commit message

feat: add get_holder_statement consolidated investor view

Guidelines

• Minimum 95 percent test coverage
• Clear documentation
• Timeframe: 96 hours

[Wetshakat]

@Wetshakat has applied to work on this issue as part of the Stellar Wave Program's 6th wave.

Hi maintainer I will like to work on this issue
ETA 2hrs

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Wetshakat to this issue.