Map stellar simulationErrors to localized tx failure messages

[king-aj-the-first]

GitHub labels: Stellar Wave

Drips complexity: Medium (100 points)

Area: Transactions

Description

lib/stellar/simulationErrors.ts parses Soroban failures, but TxSimulationPreview and transaction toasts often show raw error codes.

Requirements and Context

Investors need actionable copy for insufficient balance, wrong network, and contract revert reasons.

Suggested Execution

git checkout -b feat/simulation-errors-i18n

1. Create branch feat/simulation-errors-i18n
2. Add messages for known simulation error codes
3. Map errors in TxSimulationPreview and useTransaction
4. Fall back to generic message for unknown codes
5. Add unit tests for mapping table

Example commit message

feat(transactions): map simulationErrors to localized messages

File Paths

• lib/stellar/simulationErrors.ts
• components/invoice/TxSimulationPreview.tsx
• hooks/useTransaction.ts
• messages/en.json

Guidelines

• Assignment required before starting
• PR description must include: Closes #<issue_number>
• Run npm run lint, npm run type-check, npm run test, and npm run build before opening PR
• Add screenshots or recordings for UI changes
• Complexity: Medium (100 points) — focused feature work in an existing surface

Acceptance Criteria

• Known codes show translated messages
• Unknown codes use safe generic copy
• Preview dialog shows mapped message
• All four locales include keys
• Unit tests cover mapping branches

[shadrach68]

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

Hi Maintainer,
I'd like to take on this issue. I've reviewed the requirements, understand the scope, and can deliver a tested solution that aligns with the project's standards.

Thanks.

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

[kelvin1738-sys]

@kelvin1738-sys has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hello, I've carefully reviewed the issue description and have a solid understanding of the expected outcome. I'd be happy to work on this issue and deliver a solution that meets the project's requirements.

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

[Anichris-koded]

@Anichris-koded has applied to work on this issue as part of the Stellar Wave Program's 8th wave.

Hi, please assign me to this issue.

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

[Heazzy500]

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

I am a detail-oriented and reliable individual with strong skills in research, data entry, online tasks, and following instructions. I am committed to delivering accurate and high-quality work within deadlines and am available to start tasks immediately.

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

[jhayniffy]

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

Hi maintainer can i please work on this

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

[drips-wave]

Congratulations, @jhayniffy! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on August 31, 2026.

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