[Docs] signing-flow.md claims a 503 status deposit/withdraw never actually return

[collinsezedike]

Description

docs/signing-flow.md:106-110 ("Error responses") states both /tx/deposit and /tx/withdraw return "400 ... 503 if the vault contract is not configured, and 500 ... otherwise."

packages/api-core/src/tx.ts's handleDepositRequest/handleWithdrawRequest wrap the whole build call in a single try/catch that always returns status: 500 on any thrown error, including when resolveVaultEntry (packages/stellar-sdk-helpers/src/orchestration.ts:19-23) throws for an unconfigured vault. There is no 503 path anywhere in these two handlers — 503 is only used elsewhere, in packages/api-core/src/positions.ts:19, for a different endpoint.

Expected Behavior

The error-responses table in docs/signing-flow.md should state that an unconfigured vault on /tx/deposit//tx/withdraw returns 500, not 503.

Actual Behavior

The doc claims a 503 path that doesn't exist for these two endpoints.

[Mhidesav]

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

hi
i would like to work on this issue please

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

[attyolu]

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

Please Maintainer. Few hours left and i just have 150 points. Pls assign this issue to me. I'm begging

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

[Chekuyermu]

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

Hello maintainer, I will like to work on this issues assign it to me

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

[funmilayo-ui]

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

hello maintainer
i can quickly update your docs. good first issue

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

[drips-wave]

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

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