Skip to main content

Overview

Benefits of building with NEAR datasets

Building with NEAR datasets on Goldsky provides several key advantages:
  • Real-time data access - Stream NEAR data to your infrastructure with sub-second latency
  • Complete historical data - Access the full history of NEAR transactions, receipts, and execution outcomes
  • Flexible transformations - Use SQL to filter, aggregate, and transform data before it reaches your database
  • Sharding-aware - Work with NEAR’s unique sharded architecture through structured datasets
  • Cross-contract tracking - Follow execution flows across multiple contracts using receipts and execution outcomes
  • Scalable infrastructure - Handle high-throughput NEAR data without managing your own nodes

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

Mirror

NEAR datasets are available exclusively through Turbo pipelines. See the Turbo section below to get started.

Turbo

Watch this video walkthrough for a complete guide to using pipelines with NEAR.
For detailed dataset documentation, configuration options, and pipeline guides, see the NEAR Sources reference.

RPC Edge

Compose

Getting support

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