Skip to content

Add taxation-bucket tagging on report_revenue (ordinary, capital, return-of-capital) #450

Description

@thlpkee20-wq

Description

Revenue-share distributions have different tax treatments (ordinary income, capital gains, return of capital). Add a TaxBucket field on report_revenue so downstream indexers and tax engines can categorize each disbursement without out-of-band annotation.

Requirements and context

  • Must be secure, tested, and documented
  • Should be efficient and easy to review
  • Relevant code: Revora-Contracts/src/lib.rs
  • Bucket must be encoded into the indexed event topic for filterable subscription

Suggested execution

  • Fork the repo and create a branch
  • git checkout -b feat/tax-bucket-tagging
  • Implement changes
    • Add enum TaxBucket { Ordinary, Capital, ReturnOfCapital, Custom(Symbol) }
    • Persist bucket in PeriodRevenue and surface it on claim events
    • Document mapping to common jurisdictions in README
  • Validate security and correctness assumptions

Test and commit

  • Run tests
    • cargo test --all
  • Cover edge cases
    • Override revenue must preserve original bucket unless explicitly overridden
  • Include test output and security notes

Example commit message

feat: tag report_revenue with TaxBucket for downstream tax engines

Guidelines

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

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Fields

    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions