LogoLogo
  • Firehose
  • Introduction
    • Firehose Overview
    • Prerequisites
  • Architecture
    • Components
      • Firehose-enabled Node
      • Reader
      • Merger
      • Relayer
      • gRPC Server
      • High Availability
    • Data Flow
    • Data Storage
  • Firehose Setup
    • Overview
    • Ethereum
      • Installation
      • Single-Machine Deployment
      • Reprocessing history
      • Synchronization
    • Injective
      • Single-Machine Deployment
    • NEAR
      • Single-Machine Deployment
    • Solana
      • Single-machine Deployment
    • System Requirements
  • Community Integrations
    • Starknet
      • Networks and nodes
      • Local deployment with Docker
      • Local deployment without Docker
  • Integrate New Chains
    • Benefits
    • Integration overview
    • Design Principles
    • Firehose Acme
  • References
    • Supported Protocols
    • Naming Conventions
    • Schemas
    • Indexing
    • FAQ
  • Release Notes
    • Change logs
      • Nov 8th 2023 Polygon Update
Powered by GitBook
On this page
  • Starknet networks
  • Public networks
  • Local development networks
  • Pre-instrumented nodes
  • pathfinder
  • juno
  • jsonrpc-to-firestark

Was this helpful?

Edit on GitHub
  1. Community Integrations
  2. Starknet

Networks and nodes

Starknet networks and nodes

PreviousStarknetNextLocal deployment with Docker

Last updated 1 year ago

Was this helpful?

Starknet networks

Public networks

A few public Starknet networks are live, and are uniquely identified as follows:

Identifier
Layer 1
Description

starknet-mainnet

Ethereum mainnet

The main canonical Starknet where valuable assets are stored

starknet-sepolia

Ethereum Sepolia testnet

The latest testnet which developers are encouraged to use

starknet-goerli

Ethereum Goerli testnet

The original testnet which will be deprecated soon

starknet-sepolia-integration

Ethereum Sepolia testnet

A canary network for SDK and node developers

starknet-goerli-integration

Ethereum Goerli testnet

A canary network for SDK and node developers

Tip: Firehose does not know or care about the assigned identifiers. These identifiers are useful only in and .

Local development networks

It's also possible to run a vastly simplified Starknet network for local development. The is a popular option.

Note that since these networks aren't real Starknet, it's not possible to synchronize a full node with such a network. However, this does not mean it's impossible to run a Firehose stack on such a network, as you can use the .

Pre-instrumented nodes

All instrumented nodes are available in 3 different distributions:

  • as a standalone Docker image (supports both AMD64 and ARM64) where the node binary is available as the entrypoint;

  • as a firehose-starknet Docker image (supports both AMD64 and ARM64) where firestark is the entrypoint, but the node binary is available on PATH;

  • and of course, as source code that you can directly compile from.

pathfinder

A Starknet node implemented in Rust.

Distribution
Link

Standalone Docker image (multi-arch)

firehose-starknet bundled Docker image (multi-arch)

Source code

juno

A Starknet node implemented in Go.

Distribution
Link

Standalone Docker image (multi-arch)

firehose-starknet bundled Docker image (multi-arch)

Source code

jsonrpc-to-firestark

A pseudo node that does not actually synchronize with the network. Instead, it relies on a trusted JSON-RPC endpoint on an existing synchronized full node to collect and emit the same data format expected by Firehose to the standard output.

This pseudo node exists because currently Starknet full nodes cannot synchronize through P2P, but instead only from a centralized sequencer API, which is heavily rate-limited. Having to synchronize from scratch via the sequencer could take an extended period of time. jsonrpc-to-firestark significantly speeds up the process if there's an already-synchronized node under the same network.

An additional use case for jsonrpc-to-firestark is to "synchronize" with local development networks where full nodes cannot be used.

Distribution
Link

Standalone Docker image (multi-arch)

firehose-starknet bundled Docker image (multi-arch)

Source code

Note: Precompiled binaries are not available at the moment. However, you can always for the entire stack.

use Docker images
graph-node
graph-cli
katana tool from dojo
jsonrpc-to-firestark pseudo node
starknet/pathfinder-firehose:0.10.2
starknet/firestark:0.2.1-pathfinder-0.10.2
starknet-graph/pathfinder
starknet/juno-firehose:0.8.1
starknet/firestark:0.2.1-juno-0.8.1
starknet-graph/juno
starknet/jsonrpc-to-firestark:0.4.0
starknet/firestark:0.2.1-jsonrpc-0.4.0
starknet-graph/jsonrpc-to-firestark