Blocksync provides real-time indexing and querying of IXO blockchain data through GraphQL, enabling efficient access to historical transactions, state changes, and entity relationships. It serves as a critical infrastructure component for building scalable applications on the IXO Spatial Web.

Overview

Real-time Indexing

Continuously processes and indexes blockchain events, transactions, and state changes

GraphQL API

Type-safe querying interface with support for complex relationships and filtering

Historical Data

Access to complete transaction history and state changes with efficient retrieval

Entity Relationships

Track connections between digital twins, claims, and verifications

Architecture

Features

Data Indexing

Event Processing

  • Real-time event capture
  • State transition tracking
  • Relationship mapping
  • Data transformation

Storage Optimization

  • Efficient indexing
  • Query optimization
  • Cache management
  • Data compression

Historical Data

  • Complete history
  • State snapshots
  • Change tracking
  • Audit trails

Query Capabilities

Implementation Guide

  1. Setup Connection

    import { BlocksyncClient } from '@ixo/blocksync-client'
    
    const client = new BlocksyncClient({
      endpoint: 'https://blocksync.ixo.earth/graphql',
      headers: {
        'Authorization': `Bearer ${apiKey}`
      }
    })
    
  2. Define Queries

    const GET_ENTITY = gql`
      query GetEntity($id: ID!) {
        entity(id: $id) {
          id
          type
          data
          claims {
            id
            status
          }
        }
      }
    `
    
  3. Execute Queries

    const result = await client.query({
      query: GET_ENTITY,
      variables: { id: 'did:ixo:123' }
    })
    
  4. Handle Results

    const { data, errors } = result
    if (errors) {
      console.error('Query failed:', errors)
      return
    }
    
    const entity = data.entity
    // Process entity data
    

Best Practices

Available Environments

Production

https://blocksync.ixo.earth/graphql

Testnet

https://testnet-blocksync.ixo.earth/graphql

Development

https://devnet-blocksync.ixo.earth/graphql

Developer Resources

For technical support or questions about Blocksync, join our Developer Community or contact our Developer Relations Team.