Indexing Kaia with Goldsky
Streamlining on-chain data engineering for builders
Every application on Kaia needs access to on-chain data. Most start with basic RPC queries like reading a single value or checking a balance, but production features like activity feeds, dashboards, or cross-contract filtering require something more robust.
Goldsky solves this problem for Kaia builders. The platform provides managed indexing infrastructure, so you don't need to run your own indexers or build complex ETL (Extract, Transform, Load) pipelines from scratch.
Goldsky supports Kaia through two primary products: Subgraphs for instant GraphQL APIs and Mirror for real-time data replication.
Subgraphs: Instant GraphQL APIs
Goldsky's subgraph hosting gives you a high-performance environment that's fully compatible with The Graph's standard subgraph specifications. You define which blockchain events and entities matter to your application using a schema file and mapping code. Goldsky handles the indexing, hosting, and maintenance, then serves your data through a GraphQL endpoint that your application can query directly.
If you already have a subgraph layout with your schema and mapping code, you can deploy the subgraph via the CLI with minimal configuration changes.
Use subgraphs when you need:
- Event-centric features: Dashboards, activity feeds, and user histories
- Stable query patterns: Consistent data views for your front-end applications
- Rapid prototyping: "Instant Subgraphs" generate APIs directly from a contract ABI, no custom mapping code required
Mirror: Real-Time Data Replication
GraphQL APIs aren't the right fit for every use case. Sometimes you need raw data in your own infrastructure for analytics, backend processing, or machine learning models.
Mirror streams Kaia data directly into your own datastore (e.g. PostgreSQL, a data warehouse, or message queues) in near real time. Instead of querying an external API, the data replicates into your stack. The pipeline handles extraction, transformation, and loading: capturing blocks, logs, transactions, and traces as new blocks are produced.
Use Mirror when you need:
- Complex analytics: SQL joins between on-chain data and your off-chain user data
- High-volume processing: Bypass API rate limits by owning the data layer
- Internal tooling: Feed business intelligence platforms or backend workers directly
Getting Started
Developers building on Kaia Mainnet or the Kairos Testnet can start indexing right away. Install the Goldsky CLI and generate an API key to authenticate your project.
Quick start:
- Choose your approach - Historical aggregation (use Subgraphs) or raw data access (use Mirror)?
- Install the CLI - Set up the Goldsky CLI to log in and manage your project
- Deploy - Push your local subgraph configuration or define a replication pipeline with a definition file
For setup instructions, see the Indexing with Goldsky guide.