Create troubleshooting guide #1035

Activity

1. Kingsman-99

   added

   complexity: highComplex feature requiring deep knowledge - 200 ptsComplex feature requiring deep knowledge - 200 pts

   featureNew contract feature or operationNew contract feature or operation

   on Oct 20, 2026
2. rupesh-kumar-sah commented on Oct 20, 2026

   

   rupesh-kumar-sah

   on Oct 20, 2026

   More actions

   Hi maintainers,

   I reviewed "Create troubleshooting guide" and have a structured approach ready for implementation:

   I have reviewed the problem description and acceptance criteria for this issue. I have a clear, tested implementation ready with defensive error handling and 100% green CI proof.

   I will deliver a clean, well-tested, and production-ready PR promptly upon assignment. Kindly assign this issue to me.

   Thank you!
3. drips-wave

   added

   Stellar WaveIssues in the Stellar wave programIssues in the Stellar wave program

   on Oct 22, 2026
4. timiturn3r commented on Oct 22, 2026

   

   timiturn3r

   on Oct 22, 2026 – with Drips Wave

   Contributor

   More actions

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

   Hey Maintainer, I have gone through the details of the issue and i am capable of resolving it, I would love to be assigned to work on it ASAP.please assign me!!
   ETA: 4 hours

   ℹ️ Repo Maintainers: To accept this application, review their application or assign @timiturn3r to this issue.
5. abdooltata commented on Oct 22, 2026

   

   abdooltata

   on Oct 22, 2026 – with Drips Wave

   More actions

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

   Hello Maintainer, I’d like to take on this issue and work toward a good solution. Please assign it to me.

   ℹ️ Repo Maintainers: To accept this application, review their application or assign @abdooltata to this issue.
6. Tee-Gee57 commented on Oct 22, 2026

   

   Tee-Gee57

   on Oct 22, 2026 – with Drips Wave

   More actions

   @Tee-Gee57 has applied to work on this issue as part of the Stellar Wave Program's 10th wave.

   Hi Maintainer, reviewed the issue in detail. Full stack background with solid experience relevant to this task. No blockers on my end — I'm ready to submit a Clean PR shortly. Please assign.

   ℹ️ Repo Maintainers: To accept this application, review their application or assign @Tee-Gee57 to this issue.
7. chibeike-AI commented on Oct 22, 2026

   

   chibeike-AI

   on Oct 22, 2026 – with Drips Wave

   More actions

   @chibeike-AI has applied to work on this issue as part of the Stellar Wave Program's 10th wave.

   Hello Maintaner please I will love to help work on this issue

   ℹ️ Repo Maintainers: To accept this application, review their application or assign @chibeike-AI to this issue.
8. Ingenious-02 commented on Oct 22, 2026

   

   Ingenious-02

   on Oct 22, 2026 – with Drips Wave

   More actions

   @Ingenious-02 has applied to work on this issue as part of the Stellar Wave Program's 10th wave.

   Hi maintainer, can I quickly take this up pls...?

   ℹ️ Repo Maintainers: To accept this application, review their application or assign @Ingenious-02 to this issue.
9. huangji6693-max commented on Oct 26, 2026

   

   huangji6693-max

   on Oct 26, 2026

   More actions

   Hi maintainers! I have prepared and submitted a comprehensive Troubleshooting Guide (docs/TROUBLESHOOTING.md) covering all requirements for this issue in PR: #1059

   Summary of Deliverables:

   • Diagnostic Triage Flowchart & CLI Tooling: Step-by-step stellar contract invoke commands for dry-run simulations (is_invoice_releasable, simulate_release), on-chain error decoding (get_error_description, get_recovery_suggestion), invariant checks (verify_invoice_invariant), and health audits (run_contract_audit, run_invoice_audit).
   • Category-by-Category Solutions: Covers Rust/WASM build & storage_snapshot XDR issues, invoice validation, FX oracle & meta-tx payments, escrow/dispute locks, rate limits/circuit breakers, and staged upgrades.
   • Complete Error Catalog & FAQ: Maps all 77 contracts/split ContractError codes (#1–#77) and contracts/invoice-escrow error ranges (1–505) to root causes and recovery actions.