Skip to content

feat(backend): implement Soroban event indexer with cursor tracking - #155

Merged
martinvibes merged 1 commit into
Web3Novalabs:mainfrom
vestor-dev:soroban_event_indexer
Aug 28, 2026
Merged

feat(backend): implement Soroban event indexer with cursor tracking#155
martinvibes merged 1 commit into
Web3Novalabs:mainfrom
vestor-dev:soroban_event_indexer

Conversation

@vestor-dev

Copy link
Copy Markdown
Contributor
  • Add Soroban RPC client for polling contract events from on-chain
  • Implement event decoder service to parse and structure contract events
  • Add indexer cursor service with database persistence for resumable indexing
  • Create indexer worker process for continuous event polling and ingestion
  • Add backfill CLI worker to reindex historical events from a specified ledger
  • Implement indexer health checks and error recovery with exponential backoff
  • Add database migration 005 to create indexer_cursor table with ledger tracking
  • Configure scval decoding utilities for Soroban contract data deserialization
  • Add comprehensive test suite with fixtures for event decoder, cursor, and migrations
  • Update package.json with indexer and backfill worker scripts
  • Add environment configuration for RPC URL, contract ID, polling intervals, and retry limits
  • Support cursor fallback and retention window management for RPC provider compatibility

closes #126

- Add Soroban RPC client for polling contract events from on-chain
- Implement event decoder service to parse and structure contract events
- Add indexer cursor service with database persistence for resumable indexing
- Create indexer worker process for continuous event polling and ingestion
- Add backfill CLI worker to reindex historical events from a specified ledger
- Implement indexer health checks and error recovery with exponential backoff
- Add database migration 005 to create indexer_cursor table with ledger tracking
- Configure scval decoding utilities for Soroban contract data deserialization
- Add comprehensive test suite with fixtures for event decoder, cursor, and migrations
- Update package.json with indexer and backfill worker scripts
- Add environment configuration for RPC URL, contract ID, polling intervals, and retry limits
- Support cursor fallback and retention window management for RPC provider compatibility

@martinvibes martinvibes left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@martinvibes
martinvibes merged commit 6d3be87 into Web3Novalabs:main Aug 28, 2026
0 of 2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

feat(backend): on-chain event indexer worker — cursor checkpointing, idempotent writes, gap handling, and a backfill CLI

2 participants