Skip to content

Indexing Framework ​

The Aleph Cloud Indexer Framework is a node.js and moleculer based framework for building multithreaded indexers to be deployed on the Aleph Cloud network. It provides a scalable architecture for tracking and processing blockchain events across multiple networks simultaneously.

Overview ​

The Indexer Framework offers a comprehensive solution for blockchain data indexing with the following capabilities:

  • Multi-blockchain Support: Index data from multiple blockchains in a single application
  • Scalable Architecture: Horizontally scale microservices to meet demand
  • Real-time Processing: Track blockchain events as they occur
  • Historical Data Indexing: Fetch and process historical blockchain data
  • GraphQL API: Expose indexed data through a flexible query interface

Supported Blockchains ​

The framework currently supports indexing data from the following blockchains:

  • EVM-based chains:
    • Ethereum
    • Avalanche (C-Chain)
    • Binance Smart Chain (BSC)
    • Base
    • Oasys L1
    • Oasys L2 (Homeverse)
  • Solana

New blockchains can be added by implementing a blockchain adapter.

Framework Architecture ​

The indexer's architecture is designed for scalability and high availability, incorporating three key microservices:

  • Fetcher: Retrieves blockchain data
  • Parser: Transforms raw data into structured formats
  • Indexer: Processes and stores parsed data for efficient querying

These services communicate through an abstract transport layer, allowing for flexible deployment strategies.

Indexing Options ​

EVM Indexer ​

For EVM-based blockchains (Ethereum, BSC, Oasys), the framework provides capabilities to:

  • Track smart contract events across different networks
  • Process and store event data with custom business logic
  • Filter events based on specific criteria
  • Expose indexed data through a GraphQL API

The EVM indexer supports tracking events from multiple contracts and networks simultaneously.

Solana IDL Indexer Generator ​

For Solana programs, the framework offers an Indexer Generator that:

  • Automatically generates indexers from Anchor IDLs
  • Creates boilerplate code for account tracking and event parsing
  • Provides built-in statistics calculation
  • Exposes program data through a GraphQL API with predefined queries

The generator simplifies the process of creating Solana indexers by handling the complex parsing of program instructions and accounts.

Getting Started ​

To get started with the Indexer Framework, refer to the specific guides:

Documentation and Resources ​