Changelog
Follow @goldskyio on Twitter to stay updated on everything we ship.
Transform subsets of your data pipeline
You can now send just a subset of your data to external handler transforms using the Payload columns
field. This lets you specify which columns to send to the handler instead of the entire row, reducing unnecessary data transfer and improving efficiency.
Restart pipelines with ease
A little QoL update. We've added a button to the Flow visual editor so you can restart pipelines more easily.
Added success/failure icons next to subgraph webhooks for better observability
Removed "Validate" button in Flow as it was redundant
Fixed a bug involving Flow drafts that would result in an error page
Pausing or resuming a pipeline will display the latest pipeline version to avoid confusion
Added subgraphs: Basecamp, XRPL EVM Testnet, Plume Mainnet
Added Mirror datasets: Sonic, unified Arweave dataset
Introducing Goldsky Flow: the visual drag-and-drop pipeline builder
Goldsky Flow, our new visual drag-and-drop interface for building Mirror pipelines, is now available to everyone! Now you can create powerful data pipelines in minutes without touching a line of YAML or using the CLI (but no need to ditch the CLI if that's your jam). Here's what you need to know about this new way to ship data.
Build with your eyes
Drag and drop components onto the canvas, configure them with a few clicks, and deploy.
Data sources aplenty
Pull in data from a variety of data source types, with optional configurations.
- Access data from 150+ blockchain networks (and growing weekly)
- Onchain direct indexing datasets
- raw data (e.g. blocks, logs, etc.)
- curated datasets (e.g. ERC-20 transfers)
- Subgraphs
- your existing subgraphs – own the data and bypass GraphQL API limitations
- community subgraphs
- Off-chain data from your Kafka data store or other databases – for easily aggregating on-chain data with off-chain data
You can also combine multiple data sources in the same pipeline into a single unified schema – perfect for multi-chain applications.
Twist, turn, transform
Shape your data with optional transforms, filters, and aggregations to get it exactly how you want it. Two types of transforms are available:
- SQL transforms: Write standard SQL to manipulate the shape of your data and preview results – all directly within the Goldsky Flow UI.
- External HTTP handler transforms: Send data from your pipeline to external services via HTTP (e.g. AWS Lambda) for processing and return results back into the pipeline. Ideal for using your preferred language or enriching data with third-party APIs (e.g. fetching token prices from Coingecko).
Sink anywhere
Send your data where it needs to go, whether it’s transactional databases like Postgres, real-time analytical databases like ClickHouse, or specialized options like Elasticsearch and Timescale. Use webhooks and Goldsky Channels for flexible routing to AWS S3, SQS, Kafka, and beyond.
Goldsky is sink-agnostic, so you’re not limited to just our directly supported sinks. Don’t see your preferred sink? Just ask – we can likely make it happen.
A few more things:
- Preview pipeline outputs: See samples of your pipeline data within Goldsky Flow. Super handy when you’re working with multiple sources + transforms and you want to quickly iterate on the logic without redeploying the pipeline every time.
- Reorg-aware pipelines: Pipelines are reorg-aware and will automatically update your sinks whenever they occur to keep data consistent. Channel sinks have some nuances, so check the docs for details.
- Secure sink configuration: Goldsky Secrets securely store your database credentials in your Goldsky account so you can manage access without exposing sensitive information in your pipelines or config files.
- Lightning-fast processing: Standard pipelines handle 2,000 rows per second and can be scaled up to process over 100,000 rows per second.
- Extremely low latency: Actual latency depends on how much write speed your database can handle!
Start using Goldsky Flow
Just head to your dashboard and click "New Pipeline" to start building. Dive into the Goldsky Flow documentation for more detailed guides, but we hope that the interface is intuitive enough that you don’t need it.
Whether you’re a visual builder or CLI diehard, we're constantly working on making data pipeline creation even more accessible and powerful, so jump in, test it out, and let us know if you have feedback!
Custom ABI JSON definitions + easier network selection
Reintroduced an optional contract ABI field when deploying instant subgraphs. If left empty, we'll try auto-fetching the ABI when you deploy your subgraph.
You can also now type and find your subgraph network when building your subgraphs from a dropdown, saving you time. The previous way of going to our docs to find the slug name was unintuitive and a hassle.
Dynamic preview status icons
Added preview status icons to Goldsky Flow, giving you live feedback as you build your pipelines.
eth_call subgraph metrics
The subgraph detail page now shows eth_call metrics (total count and query response times). This makes it easier to identify performance improvements (inefficient queries, unecessary calls).
Unichain now available on Goldsky
Unichain Mainnet and Sepolia are now available in Goldsky Subgraphs and Mirror 🦄 We've partnered with Unichain to provide dedicated support for Unichain data indexing and a discount to builders in the ecosystem. Check out the Unichain docs for details on the partner-exclusive benefits.
Berachain joins the party
Beras! Berachain Mainnet and Bartio are also available in Goldsky 🐻 Just like Unichain, we're providing Berachain data indexing as smooth as honey and a sweet discount to builders – 100% for Subgraphs and 10% for Mirror 🍯 Check out the Berachain docs for more details.
Set the Canvas visual view as the default for drafts and live pipelines in Goldsky Flow
Added missing datasets to Goldsky Flow
Removed backfilling ETA from pipeline UI which wasn't always accurate - we've removed it entirely to avoid confusion
Added subgraphs: Story Aeneid, Continuous Testnet, Up Mainnet
Added Mirror datasets: Berachain Mainnet
Abstract Chain now live on Goldsky
Abstract Mainnet went live with support in Goldsky Subgraphs and Mirror. We've partnered with them to provide dedicated support for Abstract data indexing and a discount for builders. Check out the Abstract docs for all the deets.
New CLI commands for pipelines
We shipped new pipeline CLI commands to give you more visibility and control over pipeline snapshots:
goldsky pipeline snapshot list <nameOrConfigPath>
to list all existing snapshots in a pipelinegoldsky pipeline snapshot create <nameOrConfigPath>
to create a snapshot of your pipeline- Check out our CLI reference docs for a full list of commands
Support for ETH storage access
You can now read Ethereum contract data (e.g. token balances, contract variables) directly, unlocking the range of onchain data you can work with.
Webhook as sinks
You can now use webhooks as a sink in Goldsky Mirror. This lets you send pipeline data to an HTTP endpoint, giving you flexibility to forward pipeline results to destinations like your application server, third-party APIs, or bots.
Subgraph description messages
You can now add a description field to subgraphs that can be used as a commit message. This is useful context for team members to have when looking at deployed subgraphs.
External handler transforms
With external handler transforms, you can send data from your Mirror pipeline to an external service via HTTP and return the processed results back into a Mirror pipeline. Read more about external handlers.
View monthly invoices and download them as PDFs
You can now view all your monthly invoices in the billing page and download them as a PDF. The invoice will include breakdowns of your monthly usage by pipelines and subgraphs.
Create multiple pipelines from the same dataset
Goldsky Mirror now supports using the same dataset as a source for multiple pipelines. This provides new flexibility and simplifies data processing workflows. Here's a few examples of how you can utilize this:
Simplify edge and backfill processing: Instead of maintaining separate pipelines for edge and backfill processing, you can now use a single pipeline to do both, avoiding the need to delete redundant pipelines later. This is especially useful for accessing live data without waiting for historical data to backfill.
Flexible data transformation: You can create multiple pipelines from the same dataset, each applying different transform expressions. This lets you shape and filter the same dataset in different ways without duplicating datasets, allowing more tailored and versatile data processing within a single pipeline.
Current indexed block and timestamp now shown in pipeline logs
You can now view the latest block read by each pipeline source, providing greater transparency into pipeline data freshness. In our next update, we'll display lag time next to each pipeline source, letting you easily identify any delays in reading blockchain data.
CLI v9.1.0 - Adds confirmation prompts when deleting pipelines, secrets, subgraphs, subgraph tags, or subgraph webhooks
CLI v9.1.0 - Adds a
goldsky pipeline export
command to export one or more pipeline configurationsAdded ability to manage your subscription in the web app without having to go to your Stripe dashboard
Added subgraphs: Mint Sepolia
Added Mirror datasets: Treasure Ruby Testnet, Mint, zkSync Era, Rari Superseed, Camp Testnet V2
Deploy subgraphs from the web UI
You can now deploy Subgraphs instantly from the web UI.
- Navigate to the Subgraphs page and click on "Launch instantly"
- Name your subgraph and provide a contract address
- Choose your network and click to deploy it
Deploy subgraphs with GitHub Actions
We've also built a GitHub Action you can add to your workflow so that you can deploy subgraphs directly from your GitHub repository.
How to set up Goldsky Deploy
- Build your subgraph or link to a subgraph's directory
- Add the Goldsky Deploy Action to your Github workflow file
Introducing Mirror pipeline YAML V3: simplified and powerful
We're excited to release Version 3 of our Mirror pipeline YAML configuration file. This updated version introduces a more simplified and intuitive format for defining your pipelines.
What's new?
- Reorganized configuration: The
definition
property has been removed from the root level, andsources
,transforms
,sinks
have been elevated to the top-level definition for easier access and modification. - Improved data structure: We've transitioned from using arrays to maps for
sources
,transforms
,sinks
, which eliminates the need for thereferenceName
property and simplifies the overall structure. - Standardized property names: All properties are now consistently formatted in snake_case to enhance readability and maintain consistency across configurations.
Read more about the new configuration format and how to apply it in your projects here.
Billing summary quickview
Access an immediate overview of your current billing cycle directly from your project dashboard by clicking on "Billing Summary" at the top right corner. This enhancement is part of our ongoing efforts to ensure transparency and ease in monitoring your spending as you engage with Goldsky products, helping you stay informed and in control of your costs.
CLI v8.9.0 - The
pipeline info
command now provides detailed runtime information about pipelines. This functionality was previously part of thepipeline get
command, which is now streamlined to handle configuration details and cloning of pipeline configurations more efficiently.Added subgraphs: Rootstock
CLI wizard for creating subgraphs
A guided CLI experience that walks you through creating and deploying subgraphs. Fire up the command line and type goldsky subgraph init --experimental
. Follow the steps to build and deploy subgraphs with ease.
Read more here.
CLI v8.8.0 released. Added support for
pipeline stop
andpipeline resize
commands.Upgraded RPC gateway which results in increased stability and data consistency.
Updated docs to reflect all supported Mirror and Subgraph chains. Check out the list here.
Added subgraphs: Frax Testnet, Cyber, Morph Testnet, Flare, Cheesy Testsnet, Core DAO
Added Mirror datasets: Eclipse Testnet, Gnosis and Celo balances
Mirror pipeline builder
We added a web interface to create Mirror pipelines. You can pick a dataset from the sources page and start streaming data directly to your database of choice.
Private subgraph endpoints
We added support for private subgraph endpoints. These endpoints require authentication, which means that you can control who has access to your subgraph data. Private endpoints can be toggled on and off for each subgraph and tag, and you can enable a mix of public and private endpoints for your subgraphs.
Read more about subgraph endpoints here.
Subgraph performance metrics
We've added two new charts to subgraph pages: average handler time and handler call count. These are useful for debugging subgraph bottlenecks and pinpointing subgraph handlers that may be causing performance issues.
Dataset explorer
We added an easy way to browse datasets on Goldsky. You can use these datasets as a pipeline source and stream live blockchain data into your sink of choice.
CLI Release v8.0.0
We've released an update to our CLI to improve the pipeline creation experience. Pipeline updates are now async to to account for long-running snapshots. We also added a pipeline cancel-update
command and a new flag for --use-latest-snapshot
to streamline deployment workflows.
Interactive goldsky secret create
workflow
Secrets can now be validated and added to a project with an interactive CLI walkthrough (previously only accessible in the end-to-end pipeline builder).This makes it easier to add and manage secrets without building full pipelines.
v1 release of Quick Ingest™
Mirror pipelines typically require a full scan - if you want to write logs only from block X
onward, Mirror would still need to scan and discard all the blocks 0
from to X
. With the launch of Quick Ingest we bypass this by leveraging a hybrid storage backend, allowing for blazingly fast backfills (100M+ records/minute). Available on Ethereum now, with other networks coming soon.
Define custom webhook secret values
We've added functionality for users to define custom webhook secret values instead of using randomly generated secrets. This makes it easier to work across webhooks and integrate Goldsky into your data stack programmatically.
Improved metrics for Mirror pipelines
Bar charts reflecting records received and records written are now stacked bar charts split out by source, allowing for a more granular understanding of any given pipeline at a glance.
Improved metrics for subgraphs
Added charts summarizing new & total entity counts on subgraph details page, providing visibility to the approximate cost of a subgraph (and how that cost may grow over time).
Role-based access controls
Brand new RBAC options have been added to the Team
page for the web-app, helping you restrict what actions can be taken by different members of the team. There are four roles: Viewer, Editor, Admin, and Owner; read the docs for the specific permissions of each.
Create pipeline from a single payload
We've added the ability to create a new pipeline from the CLI using a single payload file. You can now develop a full pipeline (beyond sources/transforms/sinks, including eg. pipeline resource size) in an editor and use the command goldsky pipeline apply ~/path/to/payload.yaml
to deploy.
Improved custom ABI fetching function to support non-block-explorer URLs
Improved robustness of RBAC / user invitations
Improved transformation type validation
Fixed issue with Postgres stream errors caused by null values
Fixed bug where
--version
CLI command would not return the version numberUpated chain head monitoring to flag lag with more sensitivity
Added subgraph support for X1, Tenet, Thundercore, Fantom, and Kava
Added Mirror support for Optimism Sepolia
Dataset version explorer in CLI
We've added a dataset version explorer in the CLI, making it easier to access and browse various dataset versions and easily identify the latest. You can use goldsky dataset list
to explore available datasets in Goldsky Mirror.
Brand new documentation
We've re-written our documentation from scratch to deliver a more intuitive developer experience and make it easier to get going. With an all-new "Guides" section, dedicated pages for Subgraphs vs. Mirror, and a clear Reference section, it's now easier than ever to get building with Goldsky.
Email notification infrastructure
We've added email notifications infrastructure and a preferences panel to the web-app, allowing you to customize which events you receive notifications for. This allows you to stay informed about the status of your infrastructure directly in your inbox.
Improved input validation and pipeline configuration workflows to be more error-proof
Added ability to view pending invitations to current project in web-app and CLI
Added support for Public Goods Network (PGN) on indexed.xyz
Added subgraph support for Manta and Polygon zkEVM
Added Mirror support for Immutable, Frame, and Base Goerli
New, more scalable pricing
We've updated our pricing to provide more functionality for free - ie. self-serve access to Goldsky Mirror. The developer plan is deprecated in favor of a new "Scale" tier that allows for much more intensive usage without needing to contat us for an Enterprise plan.
New goldsky pipeline validate
command
You can now run a command to validate that a .yaml
pipeline file is correctly configured prior to running goldsky pipeline create
. This lightweight validation improves workflow by making it easier to catch bugs and typos in your pipeline definition.
Support for YAML configurations when creating & updating pipelines
Pipeline definitions can now be written in YAML (in addition to the existing option - JSON). This allows for more concise, error-resistant, and human-readable configurations, simplifying the process of creating and updating Mirror pipelines.
Upgraded RPC endpoints for several chains to improve indexing performance
Added feedback widget to documentation pages
Added subgraph support for zkSync Era and Telos
Added Mirror support for Mode
Improved handling of transient startup issues to increase resilience
Upgraded login flow in CLI to unify with other CLI experiences
Pause and resume pipelines
Pipelines can now be paused and restarted using pipeline pause <name>
and pipeline start <name>
, allowing for easier iteration. When an active pipeline is paused, Goldsky will snapshot the progress and resume from where the pipeline left off.
Added support for custom subgraphs as Mirror sources
User-created subgraphs are now available as a source for Mirror pipelines, allowing you to replicate your own custom subgraphs in real time to your own data ifnrastructure. This unlocks more robust access to your data, enabling more flexible querying and use of your subgraph data in general.
Upgraded API key management
You now have the ability to create multiple API keys and name them, allowing for significantly better key management - across users, use cases, or however your workflow is set up. Soon™, we'll be adding permissioning on a per-key basis for further workflow control.
Shareable pipeline definitions
With get-definition
, the Goldsky CLI will print out a shareable pipeline definition - this can be copy+pasted as is to share with team members or Goldsky support, or to clone the pipeline easily. An example of the command in use would be goldsky pipeline get-definition <name>
.
Decode raw blockchain data in-stream
Custom _gs_fetch_abi
and _gs_evm_decode
functions that allow you to decode raw contract data in a Mirror pipeline transformation. Visit the docs page for more details and a step-by-step tutorial. This feature is in technical preview so if you run into unexpected behaviour, please contact us.
Improved error handling for Postgres and Rockset sink connections
Optimized retry mechanisms for sink connections
Signficantly improved load times on
goldsky pipeline create
initial promptEnabled multi-select for Mirror pipeline source selection
Improved auto-mapping for Postgres source/transform
Added subgraph support for Polygon zkEVM and Metis
Launched Base Mainnet and deprecated Base Testnet on indexed.xyz
Raw and decoded traces in Mirror CLI
Decoded and raw traces are now available for selection in the interactive CLI (and via config file). With Mirror pipelines on trace data, you can get a low-level view of contract execution, contract calls, and external interactions - all in real-time.
Brand new web interface for pipelines
We've added a brand new section to the web app where you can view existing Mirror pipelines, deploy new ones, and see core source/sink/health stats. You can now view, monitor, and manage pipelines without jumping into the CLI for easier access.
Support for ClickHouse as a destination sink
ClickHouse is an open source, high-performance OLAP database with industry-leading performance for analytics use cases, and is now suported as a destination sink by Goldsky Mirror! You can now create pipelines using the interactive CLI or via json configuration file to stream data to ClickHouse to power large-scale analytics use cases.
Base Mainnet on indexed.xyz
indexed.xyz now supports Base Mainnet data, allowing you to sync blocks, transactions, and raw/decoded log data to your machine, for free & without any restriction.
Parallel downloads on indexed.xyz datasets
indexed.xyz data streams now intelligently sync with parallel workers based on the volume of data being downloaded, minimzing the time-to-insight for local analytics. This allows you to get the data you want in a queryable state on your machine up to 8x faster.
Upgraded CLI experience for
goldky indexed sync *
commandsImproved table component for pipeline monitors for better reliability
Added ability to resize pipelines without losing state
End-to-end improvements on indexing infrastructure to improve performance
Added Subgraph support for Mantle
Traces support with instant subgraphs
We've added an --enable-traces
option to the CLI that allows you to get trace data with Instant Subgraphs. Simply use this option with an ABI and config file to create a subgraph and understand how a smart contract is being executed.
Fixed a bug where adding team members to a project was case-sensitive and led to errors
Fixed a bug where Rockset sink fails when encountering rate limit exceptions for more graceful degradation
Increased memory available to Ethereum logs stream for indexed.xyz to improve performance
Added Mirror support for Arbitrum, Celo, Base, Linea, Scroll, and Zora
Changed CLI update check to weekly vs. daily to reduce disruption
Infrastructure improvements on emails, usage monitoring, and indexing to enable new features coming soon™
Improved data quality checks for block existence on Ethereum and other EVM chains for Mirror pipelines
Reduced columns visible in pipeline monitor for more readability
Fixed a bug where monitor header would re-print on refresh
Analytics dashboard in web app
First version of an analytics dashboard for users showcasing some core metrics about your subgraphs. Behind what's visible now (API requests and latency) is a much more robust metrics framework that will allow us to continue adding analytics graphs over time.