Moderate complexity requiring understanding of multiple components.

[Levi-Ojukwu]

Description:

The SDK needs a method to file an appeal against a defaulted invoice. This involves:

1. Validating the invoice exists and is in Defaulted status
2. Checking the appeal window (30 days from default) has not expired
3. Calling the contract's appeal_default function with the invoice ID and evidence hash
4. Handling the AlreadyAppealed, AppealWindowClosed, and NotDefaulted error codes

The appeal flow is: payer files appeal → governance reviews → appeal upheld or rejected.

Why it matters: Appeals are a critical fairness mechanism. Without SDK support, frontends cannot implement appeal features.

Acceptance Criteria:

• Create appealInvoice(client, invoiceId, evidenceHash) method
• Validate invoice status before calling contract
• Map all error codes to typed SDK errors
• Add comprehensive tests covering all error paths

Relevant Files: contracts/invoice_liquidity/src/lib.rs (appeal functions), sdk/src/index.ts

---

[Sheebazz]

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

Hi Maintainer! I'd love to work on this. I'll implement the SDK appeal flow with the necessary status and appeal window validation, handle the contract error cases cleanly, and add thorough test coverage to ensure the SDK behaves as expected.

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

[circleboyslimited]

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

Please assign me this issue

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

[drips-wave]

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

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

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign | FWC26 campaign!

@circleboyslimited's PR #511 was approved and merged by @Levi-Ojukwu.

🏆 @circleboyslimited: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (261 total points). Track your full progress on GrantFox.

👏 Great work, @circleboyslimited! Keep contributing to Invoice-Liquidity-Network.

[drips-wave]

This issue has been completed by @circleboyslimited as part of the Stellar Wave Program's 7th Wave 🥳

😎 @circleboyslimited: You earned 200 Points for completing this issue! After the current Wave ends, 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.