Repository navigation
PREWAVE-BE-046 — Replace Generic Claim Lifecycle Errors With Typed Domain Results #642
Description
Problem context
Post-Wave-9 source audit identified this as a distinct production-readiness boundary not fully owned by the existing candidate backlog.
Technical scope
- Replace generic
Errorpaths for missing claims and invalid transitions with stable typed errors/HTTP mappings. - Preserve canonical state/phase and idempotent retry semantics.
Required tests
- Missing, forbidden, wrong phase, duplicate, stale projection, reorged, and invalid transition tests.
Acceptance criteria
- Clients can distinguish not-found, denied, conflict, stale, and unavailable.
- Error codes are versioned and documented.
- Internal details are not leaked.
- State transitions remain contract-derived.
Architecture and security constraints
- Canonical contracts/finalized events remain authoritative.
- Bind chain-derived data to chain ID, release ID, deployment block, and artifact checksum.
- Fail closed on stale, ambiguous, missing, or unauthorized state.
- Do not weaken CI, strict typing, privacy, or auditability.
Dependencies
- PREWAVE-BE-005 — Publish Versioned Claim List and Claim Detail Read Models #600
- V2-BE-070 — Centralize Request Validation and Numeric Bounds #421
Non-goals
- Unrelated feature work or mainnet deployment.
- Applying
Stellar Wavebefore maintainer activation.
Complexity and points
- Medium — 150 points
Candidate only; activation remains maintainer-controlled.
Activity
Priest-Codes commentedon Oct 15, 2026
@Priest-Codes has applied to work on this issue as part of the Stellar Wave Program's 10th wave.
ℹ️ Repo Maintainers: To accept this application, review their application or assign @Priest-Codes to this issue.
Olajcodes commentedon Oct 15, 2026
@Olajcodes has applied to work on this issue as part of the Stellar Wave Program's 10th wave.
ℹ️ Repo Maintainers: To accept this application, review their application or assign @Olajcodes to this issue.
Olabsy19 commentedon Oct 15, 2026
@Olabsy19 has applied to work on this issue as part of the Stellar Wave Program's 10th wave.
ℹ️ Repo Maintainers: To accept this application, review their application or assign @Olabsy19 to this issue.
drips-wave commentedon Oct 16, 2026
Congratulations, @Olabsy19! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on October 22, 2026.
🧑💻 @Olabsy19: Please resolve the issue such that the repo's maintainers have enough time to review your contribution before the due date. You'll earn Points for completing the issue on-time, which will make you eligible for a share of the Stellar Wave Program's reward pool.
Warning
When opening a PR, please link it to this issue to ensure it gets tracked accurately. Points are awarded when this issue is marked as completed by the maintainer.
🤠 Repo maintainers: Please keep an eye on the contributor's progress and review their work before the due date. You can manage this issue, including adjusting its complexity and points, here.
🌊 Happy Wave 🌊
security: PREWAVE-BE-046 — Replace Generic Claim Lifecycle Errors With (
drips-wave commentedon Oct 20, 2026
This issue has been completed by @Olabsy19 as part of the Stellar Wave Program's 10th Wave 🥳
😎 @Olabsy19: You earned 150 Points for completing this issue! Once the Wave's rewards are finalized, you'll be eligible for a percentage of the Wave's reward pool based on the percentage of total points you've earned. Learn more here. You can also Leave a review to share your experience working on this issue.
🧑💻 Repo maintainers: How'd the contributor do? Leave a review to share your experience working with them.