[P2] Add Stellar event indexing service

[Obiajulu-gif]

Priority

P2

Difficulty

Advanced

Task

Create a Stellar event indexing service that can sync Stellar activity into MongoDB for dashboards.

Suggested file

lib/stellar/indexer.ts

Expected behavior

The service should:

• read from Stellar network sources through the client helper
• support cursor or checkpoint storage
• store idempotency keys
• map events to ChainMove records
• avoid duplicate processing

Acceptance criteria

• Indexer has mock mode.
• Indexer stores last processed cursor or checkpoint.
• Indexer handles duplicate events safely.
• Indexer maps event types to app-level records.
• Tests use mocked Stellar responses.

Test requirement

Add tests for first sync, repeated sync with same cursor, duplicate event handling, failed upstream request, and mock event mapping.

Evidence required

• Screenshot of tests passing.
• Screenshot of mock indexing logs.
• Screenshot of MongoDB/mock output if available.

Commands

npm run lint
npm run typecheck --if-present
npm run build

[IdokoMarcelina]

Hello, please assign me this issue. i have experience with frontend blockchain integration and smart-contract

[devfoma]

Gm Chief, I would love to take on this issue. I'm a software engineer with over 4 years experience. and i'm confident I can resolve this issue

[grantfox-oss]

🦊 GrantFox — @devfoma has been assigned to this issue as part of the Official Campaign campaign!

Next steps:

1. Open a Pull Request referencing this issue (e.g., Closes #13)
2. Your PR will be reviewed by the Chainmove maintainers

Good luck! Track your progress on GrantFox.

[grantfox-oss]

🎉 This issue has been marked as completed on GrantFox as part of the Official Campaign campaign!

@devfoma's PR #34 was approved and merged by @Obiajulu-gif.

🏆 @devfoma: You earned 35 FoxPoints for this contribution! Your current tier: Explorer (363 total points). Track your full progress on GrantFox.

👏 Great work, @devfoma! Keep contributing to Chainmove.