For the complete documentation index, see llms.txt. This page is also available as Markdown.

Hosted Services

Overview of the Substreams services StreamingFast hosts for you

Hosted Services are managed Substreams deployments that StreamingFast runs for you on The Graph Market. You configure a service in the portal; StreamingFast provisions the runners, keeps them online, and scales them. You do not operate the sink process or the store server yourself.

There are two kinds of hosted service. Both are created from Hosted Services in The Graph Market — create a new service or list the ones you already have.

Kind
What StreamingFast runs
What you bring

Hosted Sink

A Substreams sink that writes package output into a SQL database

A Postgres or ClickHouse database you already operate

Hosted Store

A block-aware key/value store, queryable over gRPC and from Substreams modules

Values to store — either you push them, or a Substreams package reads the chain and fills the store

Hosted Sink

A hosted sink continuously reads a Substreams package and writes the output into your Postgres or ClickHouse database. StreamingFast hosts the sink runner only. It does not create, host, or manage the database.

Use a hosted sink when you want SQL in a database you already run (or a managed one such as Supabase, Neon, or ClickHouse Cloud) without operating substreams-sink-sql yourself.

Supported engines are PostgreSQL and ClickHouse, in Database Changes Mode or Relational Mappings Mode. See Substreams:SQL.

The database must be reachable from StreamingFast's network (a public hostname, not localhost or a private Docker name).

How-to: Hosted Sinks — create a sink, connect Postgres or ClickHouse, then manage it. Walkthroughs: Supabase, Neon, ClickHouse Cloud.

If you would rather run the sink on your own infrastructure, see Consuming Substreams.

Hosted Store

A hosted store is a managed, block-aware key/value map. Keys are raw bytes; values are protobuf messages. Reads target a block height, so a Substreams module that queries the store stays in sync with the stream.

The create wizard offers two feed modes:

Mode
Who writes
When to use
How-to

Remote feed

You (or another service) push and delete entries over gRPC with Feed.Set / Feed.Delete

Off-chain or application-owned data that Substreams should look up

Substreams feed

A Substreams package reads the chain and populates the store

On-chain lookups other modules should reuse (the same idea as a foundational store)

Once deployed, the store is reachable at <deployment-id>.hs.streamingfast.io:443 and is referenced from a Substreams manifest as foundational-store: <deployment-id>@<version>.

To run a foundational store yourself instead of using a StreamingFast-managed one, see Hosting a Foundational Store.

Create a service

  1. Sign in to The Graph Market with an organization.

  2. Open Hosted Services and click New Service.

  3. Choose Sink or Hosted Store, then follow the wizard.

An API key is created automatically for each deployment. Manage keys at https://thegraph.market/api-keys.

Last updated

Was this helpful?