Skip to content

Conversation

@ritik4ever
Copy link

@ritik4ever ritik4ever commented Jul 3, 2025

Integrate Goldsky for Blockchain Data Querying with GraphRAG Engine close #30

Summary

Adds Goldsky integration enabling AI agents to access real-time Flare blockchain data and correlate it with GraphRAG insights.

Key Features

  • Real-time Data Pipelines: Create Mirror pipelines for blocks, logs, transactions, traces
  • GraphQL Query Interface: Direct querying of indexed blockchain data
  • Multiple Sink Types: PostgreSQL, BigQuery, Webhooks, S3
  • GraphRAG Correlation: Combine blockchain data with graph insights
  • Type Safety: Full type hints and Pydantic v2 models

Files Added

  • src/flare_ai_kit/ecosystem/tooling/goldsky.py - Main implementation
  • tests/ecosystem/tooling/test_goldsky.py - 16 test cases (all passing)
  • docs/ecosystem/goldsky-integration.md - Documentation
  • examples/goldsky_integration_example.py - Usage examples

Usage

from flare_ai_kit.ecosystem.tooling.goldsky import Goldsky, GoldskyConfig

config = GoldskyConfig(api_key="key", project_name="project")
async with Goldsky(config) as goldsky:
    blocks = await goldsky.get_flare_blocks(1000000, 1000010)

…GraphRAG

- Add Goldsky client with pipeline management capabilities
- Support for chain-level data replication (blocks, logs, transactions, traces)
- GraphQL query interface for indexed data
- Integration with GraphRAG engine for correlated insights
- Multiple sink types: PostgreSQL, BigQuery, Webhooks, S3
- Comprehensive test suite and documentation
- Example usage and integration tests

Closes flare-foundation#30
…GraphRAG

- Add Goldsky client with pipeline management capabilities
- Support for chain-level data replication (blocks, logs, transactions, traces)
- GraphQL query interface for indexed data
- Integration with GraphRAG engine for correlated insights
- Multiple sink types: PostgreSQL, BigQuery, Webhooks, S3
- Comprehensive test suite and documentation
- Example usage and integration tests

Closes flare-foundation#30
@ritik4ever
Copy link
Author

please review @dineshpinto

@dineshpinto dineshpinto changed the title Feature/goldsky integration feat(ecosystem): integrate Goldsky for Blockchain Data Querying with GraphRAG Engine Jul 7, 2025
@dineshpinto
Copy link
Member

Thanks @ritik4ever , the solution overall looks good. I've added some review points about config handling.

@dineshpinto
Copy link
Member

Hi @ritik4ever , can you fix the merge conflicts and failings CI.

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.

[Ecosystem Engine] Integrate Goldsky for Blockchain Data Querying with GraphRAG Engine

2 participants