[Frontend] JSDoc on useDepositToPool/useWithdrawFromPool/useRepayLoan claims it performs the action, but the mutationFn only builds an unsigned XDR

[grantfox-oss]

Telegram (ask questions / claim the issue here first): https://t.me/+DOylgFv1jyJlNzM0

Why this matters

useDepositToPool is documented Deposits to the lending pool with optimistic UI update (useApi.ts:1564) but its mutationFn only POSTs /pool/build-deposit and returns { unsignedTxXdr, networkPassphrase } (useApi.ts:1580-1584) - no deposit happens until sign+submit via useDepositOperation. Same misleading framing on useWithdrawFromPool (1639) and the optimistic block of useRepayLoan. This doc gap directly feeds the already-known bug where optimistic balances bump on build success rather than signed submit.

Acceptance criteria

• Document that these hooks only build a transaction and must be paired with signTransaction + submitPoolTransaction/submitLoanTransaction (see useDepositOperation)
• Clarify when the optimistic update is intended to fire and that callers should not treat mutation success as confirmation
• Cross-link the build/sign/submit sequence in the hooks header doc

Files to touch

• frontend/src/app/hooks/useApi.ts

Out of scope

• Fixing the optimistic-timing bug itself (already filed)

[yangqingqu]

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

I would love to take on this issue, kindly assign to me.

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

[TheShnider]

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

Hi. I have reviewed this issue and would like to work on it.

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

[wheval]

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

Hello i would love to work on this.

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

[damzempire]

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

l would like to work this issue as a full stack developer and a web 3 analysis

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

[Bug-Hunter-X]

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

Hi! I'd love to work on this. I've gone through the description and I already know exactly what needs to be done. I'll deliver a clean, well-tested PR that meets every acceptance criterion. Can I get it assigned?

ℹ️ Repo Maintainers: To accept this application, review their application or assign @Bug-Hunter-X to this issue.

[Georgechisom]

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

Hi, I have reviewed this issue and am familiar and skilled to solve this issue, kindly assign it to me

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

[drips-wave]

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

🧑‍💻 @wheval: 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]

🦊 GrantFox — @wheval has been assigned to this issue!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #1224)
2. Your PR will be reviewed by the LabsCrypt maintainers

Good luck! Track your progress on GrantFox.