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.Install Goldsky CLI and log in
Install Goldsky CLI and log in
-
Install the Goldsky CLI:
For macOS/Linux:
For Windows:Windows users need to have Node.js and npm installed first. Download from nodejs.org if not already installed.
- Go to your Project Settings page and create an API key.
-
Back in your Goldsky CLI, log into your Project by running the command
goldsky loginand paste your API key. -
Now that you are logged in, run
goldskyto get started:
Install Turbo CLI extension
Install Turbo CLI extension
If you already have the Goldsky CLI installed, install the Turbo extension by running:This will automatically install the Turbo extension. Verify the installation:For a complete reference of all Turbo CLI commands, see the CLI Reference guide.
Make sure to update the CLI to the latest version before running Turbo commands:
curl https://goldsky.com | shInstall Compose CLI extension
Install Compose CLI extension
If you already have the Goldsky CLI installed, install the Compose extension by running:To update to the latest version: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.