Add runnable indexer entrypoints for streams and distributions

[pragmaticAweds]

Context

The indexer packages currently expose library modules and dev scripts that watch src/index.ts, but there is no concrete runtime entrypoint that loads config, builds the RPC client, registers handlers, starts polling, and shuts down cleanly. Contributors need a runnable path for local indexing after the poller and repositories are wired.

Scope

• Add stream indexer runtime entrypoint
• Add distribution indexer runtime entrypoint
• Load validated indexer config with loadIndexerConfig
• Register domain handlers based on configured contract IDs
• Start the poller from the configured start ledger and interval
• Handle SIGINT/SIGTERM with graceful shutdown logs
• Add root/package scripts for running each indexer locally
• Document local run commands and required environment variables

Out of Scope

• GraphQL API server
• Production deployment manifests
• New database schema design beyond dependencies

Acceptance Criteria

• bun run indexer:streams or equivalent starts the streams indexer
• bun run indexer:distributions or equivalent starts the distributions indexer
• Missing required config fails fast with a clear error
• Runtime startup is covered by tests or a small composition test with mocked dependencies
• README documents the commands and required env values
• bun run indexer:type-check passes
• bun run indexer:test passes
• bun run indexer:lint passes

Dependencies

• Create core ledger cursor table #24
• Implement cursor repository #26
• Implement event polling loop #29
• Wire stream event handlers to persistence #52

Suggested Files or Packages

• indexer/streams/src/
• indexer/distributions/src/
• indexer/common/src/config/
• package.json
• indexer/README.md

[Kayce10]

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

I would like to work on this.

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

[6akola]

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

Please, I would love to work on this issue.
Thank you.

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

[D-Lord-15]

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

Hello maintainer, i would like to work on this issue

ℹ️ Repo Maintainers: To accept this application, review their application or assign @D-Lord-15 to this issue.

[GreatShinro]

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

Hi, can I work on this please?

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

[intelliDean]

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

I'd like to work on this issue

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

[Okorie2000-code]

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

Hi maintainer, can i work on this ? i can submit a clean PR before the deadline.

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

[Caneryy]

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

Hello, I'd like to work on this issue.

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

[femiolutayo]

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

Good evening Maintainer. I would love to work on this issue quickly. Please assign to me. Thank you

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

[shogun444]

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

Hi! I'd like to work on this issue.
I've contributed to Rust, TypeScript, backend, frontend, and smart contract projects, with a focus on delivering focused, well-tested changes. I'll keep the implementation within the requested scope, preserve existing behavior unless the issue requires otherwise, include the necessary tests and documentation, and submit a PR that's straightforward to review.
Portfolio: https://portfolio-amber-one-v8ggyhsjyr.vercel.app/ • ETA: ~2–4 hours.

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

[drips-wave]

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

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