Document API_BASE_URL troubleshooting for the agent client

[emrekayat]

Goal

Help contributors quickly diagnose agent-client failures caused by a wrong API_BASE_URL or a stopped API server.

Scope

• Add a short troubleshooting section to the README or agent-client docs.
• Include how to confirm the API server is running.
• Include an example of setting API_BASE_URL for local development.
• Mention the actionable network error from the agent client.
• Do not change runtime code.

Acceptance criteria

• Documentation explains the local API URL expected by the agent client.
• Documentation includes one copy-pasteable command for starting the API and one for running the agent demo.
• Documentation avoids secrets or real private keys.
• npm run format:check passes.

Notes

This is documentation-only and should stay concise.

[fwseyi]

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

I will add a concise troubleshooting section to the documentation outlining how to diagnose API_BASE_URL mismatches and stopped server issues. The update will feature copy-pasteable commands to verify the local API server status, configure the correct local fallback URL, and launch the agent client demo safely. I will also detail the actionable network errors thrown during a failure and verify formatting using npm run format:check.

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

[AGWAM001]

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

Please assign, I can work on it

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

[drips-wave]

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

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