Update Stellar SDK event fetching to query announcer buckets at RPC layer

[David-patrick-chuks]

Follow-up to #23.

Update the Stellar SDK/event ingestion path to use Soroban RPC topic filters for the v2 announcer schema.

Target fetch pattern:

• contract: v2 Stellar announcer
• topics: ("announce", 2, view_tag_bucket, *)

Scope:

• read from both v1 and v2 during the transition window
• use bucketed getEvents queries for v2
• keep cryptographic recipient validation client-side after fetch
• make the privacy trade-off explicit in SDK docs
• add tests for filter construction and mixed v1/v2 ingestion

Success means clients stop downloading the full Stellar announcement stream when they only need one view-tag bucket.

[Menjay7]

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

Hi! I’m a full-stack developer with a strong blockchain background. I’d love to handle this issue and can deliver a clean, reliable solution. Kindly assign it to me.

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

[Dydex]

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

Hi Maintainer, Pls I can work on this

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

[1sraeliteX]

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

I would like to work on this issue

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

[Arome8240]

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

Can I work this issue?

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

[Emmanuel-abiola]

@Emmanuel-abiola has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

Hi, I’d like to work on this issue. I will update the Stellar SDK event ingestion layer to support v2 announcer bucketed event queries using Soroban RPC topic filters.

I’ll implement support for fetching both v1 and v2 events during the transition period, and add proper v2 getEvents filtering using the "announce", 2, view_tag_bucket, * topic structure to reduce unnecessary event streaming.

I’ll also ensure cryptographic recipient validation remains client-side after fetch, clearly document the privacy and filtering trade-offs in the SDK docs, and add tests covering filter construction as well as mixed v1/v2 ingestion behavior to ensure compatibility during migration.

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

[ghost-cy829]

@ghost-cy829 has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

I would like to work on this. ETA: 4-6 hours. I have experience with similar implementations. Please assign.

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

[Danto1606]

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

I would like to work on this

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

[wheval]

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

Hello i would love to work on this

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

[ryzen-xp]

@ryzen-xp has applied to work on this issue as part of the Stellar Wave Program's 5th wave.

Hi maintainers 👋
I’m a blockchain developer with strong expertise in Stellar, Rust,TS and Stellar SDK integrations. I’ve worked on multiple Stellar-based smart contract and backend systems.

I understand the scope of this issue and can deliver a reliable, production-quality solution with proper tests and documentation.
Plz assign me !!

ETA: 12 hours

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

[drips-wave]

Congratulations, @wheval! 🎉 Your application was accepted by the repo's maintainers, and the issue is due on June 2, 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 🌊