Improvement: structured, queryable contract events with a documented EVENTS.md schema

[Psalmuel01]

Contracts emit events but the topic/data schema is only in code comments. Document it authoritatively and keep it stable for indexers.

Scope

• Write EVENTS.md documenting every event: contract, topics, data struct fields, and when it fires (submitted, revoked, paused, upgraded, metadata set, etc.).
• Add a test that asserts the emitted event shapes match the doc so they cannot drift.
• Reference it from the indexer and SDK.

Value

A stable event contract that indexers and integrators can rely on.

Acceptance

• EVENTS.md documents all events; a test guards the shapes against drift; referenced by indexer/SDK.

[sarah-obasi-analytics]

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

Hello, i reviewed the issue, and I'd love to work on it immediately!.

ℹ️ Repo Maintainers: To accept this application, review their application or assign @sarah-obasi-analytics to this issue.

[0xDamian-dev]

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

Hello dev, can you please assign this issue to me : )

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

[solidsole]

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

PLEASE maintainer... assign this issue to me ... I'm begging....

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

[ugoocreates-pixel]

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

i would like to work on this issue because am software engineer and am capable of completing this task effectively.

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

[felladaniel36-hash]

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

let me work on this

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

[dotmantissa]

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

Please, assign this issue to me.

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

[drips-wave]

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

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