Problem
Offset pagination becomes expensive and unstable as transfers arrive while a user is paging through history.
Objective
Deliver a production-quality improvement to transfer and audit history APIs that creates measurable value for correctness, security, reliability, performance, or maintainability.
Implementation scope
- Use indexed cursor pagination with deterministic tie-breakers, maximum page sizes, and filter-bound cursors.
Acceptance criteria
- Pages have no duplicates or gaps under inserts; cursors cannot cross actor scope; oversized queries are bounded.
Required validation
- Pagination contract, concurrent-insert, scope, filter, and large-fixture performance tests.
- Existing tests and CI remain passing.
- Add regression coverage for the original failure mode.
- Do not weaken, delete, or skip unrelated tests to obtain a green build.
PR quality bar
- Keep the PR focused and explain design tradeoffs, compatibility impact, and test evidence.
- Avoid typo-only, documentation-only, cosmetic-only, or unrelated refactor submissions.
Out of scope
- Broad rewrites not required by the acceptance criteria.
- Changes to unrelated services, contracts, or user flows.
Problem
Offset pagination becomes expensive and unstable as transfers arrive while a user is paging through history.
Objective
Deliver a production-quality improvement to transfer and audit history APIs that creates measurable value for correctness, security, reliability, performance, or maintainability.
Implementation scope
Acceptance criteria
Required validation
PR quality bar
Out of scope