FE-39: Contract Error UX Mapping

[Cedarich]

Complexity: 150 points
Summary
Map backend and Soroban error codes into clear frontend messages with actionable recovery guidance for users and contributors.
Tasks

• Define copy and UI patterns for top contract/backend error codes.
• Add a reusable error surface component for contract flows.
• Include retry/help actions where relevant.
• Add tests for at least the most common contract error states.
  Acceptance Criteria
• Users see actionable error messages instead of raw technical payloads.
• Error UX is consistent across pay, refund, and setup flows.
• Recovery actions are obvious and usable.

---

[yangqingqu]

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

I would love to work on this issue.

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

[Eyanus]

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

Hello Maintainers,

I’d like to work on this issue. I understand the requirements and I’m confident I can implement a clean and reliable solution following the project’s standards, including proper testing.

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

[drips-wave]

Congratulations, @Eyanus! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 30, 2026.

🧑‍💻 @Eyanus: 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 🌊

[Iyrah]

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

Hello maintainer I'll like to work on this issue please can you assign me

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

[akinboyewaSamson]

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

Hi! I’m a full-stack developer with a strong blockchain background. I’d love to handle this issue and can deliver a clean, reliable solution. Kindly assign it to me.

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