Skip to main content

​
Overview

Goldsky is the modern back-end for crypto-enabled products; the infrastructure layer between your application and the blockchain. We handle the complex, undifferentiated work of building on crypto rails: streaming real-time data, maintaining reliable chain connectivity, and executing onchain logic. Teams use Goldsky to ship faster and stay focused on their core product.

​
Partnership

Goldsky has partnered with to make our product available to the ecosystem and provide dedicated support for . Below in the overview of each product, the “Partner Sponsored” tag indicates that usage of that product is fully covered by the chain, if approved by the team. Where this perk is available, please reach out to the developer relations team for an access code to the private signup form.

​
Getting started

To use Goldsky, you’ll need to create an account, install the CLI, and log in. If you want to use Turbo or Compose, you’ll also need to install their respective CLI extensions.
  1. Install the Goldsky CLI: For macOS/Linux: 
    curl https://goldsky.com | sh
    For Windows: 
    npm install -g @goldskycom/cli
    Windows users need to have Node.js and npm installed first. Download from nodejs.org if not already installed.
  2. Go to your Project Settings page and create an API key.
  3. Back in your Goldsky CLI, log into your Project by running the command goldsky login and paste your API key.
  4. Now that you are logged in, run goldsky to get started: 
    goldsky
If you already have the Goldsky CLI installed, install the Turbo extension by running:
goldsky turbo
This will automatically install the Turbo extension. Verify the installation:
goldsky turbo list
Make sure to update the CLI to the latest version before running Turbo commands: curl https://goldsky.com | sh
For a complete reference of all Turbo CLI commands, see the CLI Reference guide.
Compose is currently in private beta and access is invite-only. The following commands will not work unless you have been explicitly whitelisted by the Goldsky team. Enterprise customers can contact their Account Manager for expedited early access.
If you already have the Goldsky CLI installed, install the Compose extension by running:
goldsky compose install
To update to the latest version:
goldsky compose update
For more details, see the Compose quickstart guide.

​
Subgraphs

MAINNET SUPPORTEDTESTNET SUPPORTEDMegaETH subgraphs can be deployed on Goldsky in 2 ways:
  • Via CLI from a local subgraph configuration file. If you are familiar with developing subgraphs already, you'll be familiar with this approach; after defining a subgraph locally (with a subgraph.yaml file, a schema.graphql file, and the necessary mappings to translate raw event data into the entities defined in the schema), you can deploy subgraphs to Goldsky (once the Goldsky CLI is installed) using goldsky subgraph deploy <name>/<version> --path . For more, read the step-by-step guide.
  • Via instant subgraphs, where you can pass through a contract address and the ABI for that contract. This is a quick-start option that automatically generates the underlying subgraph configuration files on your behalf, making it easy to extract blockchain event data and serve it as an API endpoint without complex setup. Use the --from-abi flag in the command above instead of --path. For more, read the low-code subgraphs guide.

​
Mirror

MAINNET SUPPORTEDTESTNET SUPPORTEDMirror pipelines allow users to replicate data into their own infrastructure (any of the supported sinks) in real time, including both subgraphs as well as chain-level datasets (ie. blocks, logs, transactions, traces). Pipelines can be deployed on Goldsky in 3 ways:
  • Using Goldsky Flow on the dashboard, see walkthrough video here
  • Using the interactive CLI, by entering the command goldsky pipeline create <pipeline-name>. This will kick off a guided flow with the first step to choose the dataset type (project subgraph, community subgraph, or chain-level dataset). You'll then be guided through adding some simple filters to this data and where to persist the results.
  • Using a definition file, by entering the command goldsky pipeline create <pipeline-name> --definition-path <path-to-file>. This makes it easier to set up complex pipelines involving multiple sources, multiple sinks, and more complex, SQL-based transformations. For the full reference documentation on, click here.

​
Turbo

NOT YET AVAILABLETurbo provides high-performance streaming data pipelines with sub-second latency for real-time blockchain data. Learn more about what you can build with Turbo in the Turbo documentation. Turbo is not currently enabled for MegaETH, but we'd love to change that.From the MegaETH team? Book a call to explore enabling Turbo for your ecosystem.
Building on MegaETH? Contact us about dedicated infrastructure options.

​
RPC Edge

NOT YET AVAILABLERPC Edge provides reliable, high-performance RPC access with low latency via multi-region CDN, intelligent caching, automatic failover, and built-in observability—optimized for both indexing backends and frontend applications. Learn more in the RPC Edge documentation.RPC Edge is not currently enabled for MegaETH, but we'd love to change that.From the MegaETH team? Book a call to explore enabling RPC Edge for your ecosystem.
Building on MegaETH? Contact us about dedicated infrastructure options.

​
Compose

NOT YET AVAILABLECompose lets you build offchain-to-onchain systems that durably move data and execute logic between your application and the blockchain. Learn more about what you can build with Compose in the Compose documentation. Compose is not currently enabled for MegaETH, but we'd love to change that. From the MegaETH team? Book a call to explore enabling Compose for your ecosystem.
Building on MegaETH? Contact us about dedicated infrastructure options.

​
Turbo Pipelines

Turbo Pipelines allow you to replicate MegaETH data into your own infrastructure in real time. Turbo pipelines are defined using YAML configuration files and deployed via the Goldsky CLI.

​
Deploying MegaETH pipelines with Turbo

Here’s the workflow for deploying a Turbo pipeline:
  1. Create a pipeline configuration file - Define your sources, transforms, and sinks in a YAML file
  2. Validate your configuration - Run goldsky turbo validate megaeth-pipeline.yaml to check for errors
  3. Deploy the pipeline - Run goldsky turbo apply megaeth-pipeline.yaml to deploy
  4. Monitor your pipeline - Use goldsky turbo logs megaeth-pipeline.yaml to view logs and goldsky turbo inspect megaeth-pipeline.yaml to see live data
For a complete walkthrough, see the Turbo Pipelines Quickstart.
Remember to first create a Secret in order for Turbo Pipelines to be able to write the data into the database of your choice.

​
Example Turbo pipeline configuration

Here’s an example configuration that streams ERC-20 transfer events from MegaETH to a Postgres database:
megaeth-erc20-transfers.yaml
name: megaeth-erc20-transfers
resource_size: s

sources:
 megaeth_erc20_transfers:
    type: dataset
    dataset_name: megaeth.erc20_transfers
    version: 1.0.0
    start_at: latest

transforms:
  decoded_transfers:
    type: sql
    primary_key: id
    sql: |
      SELECT
        id,
        sender,
        recipient,
        amount,
        to_timestamp(block_timestamp) as block_time
      FROM megaeth_erc20_transfers

sinks:
  postgres_output:
    type: postgres
    from: decoded_transfers
    schema: public
    table: megaeth_erc20_transfers
    secret_name: YOUR_POSTGRES_SECRET
    primary_key: id
This pipeline:
  1. Sources - Pulls all ERC-20 Transfer events from MegaETH mainnet using the evm.logs source type with a filter for the Transfer event signature
  2. Transforms - Uses SQL to select and rename the relevant fields from the raw log data, including block info, transaction hash, token address, and transfer details
  3. Sinks - Writes the decoded transfer data to a Postgres table called megaeth_erc20_transfers
Deploy the pipeline by running: 
goldsky turbo apply megaeth-erc20-transfers.yaml

​
Getting support

Can’t find what you’re looking for? Reach out to us at support@goldsky.com for help.