Add README section explaining the JS layer's role and how to run it

[fejilaup-cloud]

Labels: documentation
Priority: Medium
Estimated Time: 1 hour

Description:
README.md likely focuses on the Rust contracts/API server (scripts/build.sh, scripts/test.sh) and may not mention src/ at all, especially before #70 (package.json) lands.

Tasks:

• Add a "JS Batch & Analytics Layer" section to README.md
• Document how to install dependencies and run npm test
• Cross-link to the new docs/architecture.md section from feat: emit swap_cancelled event on successful cancel_swap #97

---

Security

[Komelove]

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

I’d be happy to take this issue. I’ve looked through the requirements and have a plan for approaching the implementation. I’ll investigate the existing code and dependencies, make the required changes, verify the behaviour with tests, and provide a concise PR explaining what was changed. I can start immediately and will communicate any blockers during development.

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

[khaylebfortune]

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

Hello Maintainer, I can fix this issue.
Please assign me.

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

[Malcolm-Wander]

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

Hello maintainer,I’d love to work on this issue please,I promise to do a good and swift job..thank you.

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

[uchechithelmaonye-cpu]

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

Please assign this issue to me, it's well within my skillset.

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

[drips-wave]

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

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

[drips-wave]

This issue has been completed by @uchechithelmaonye-cpu as part of the Stellar Wave Program's 8th Wave 🥳

😎 @uchechithelmaonye-cpu: 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.