Practical overview
When it fits
Use Chainstorage when a blockchain data workflow needs an ingestion and storage layer with documented CLI operations for retrieval, development backfills and event streaming.
Who it is for
- Teams building blockchain indexers or data-processing workflows.
- Developers operating self-hosted infrastructure to ingest and retain blockchain block data.
- Downstream consumers that need to fetch blocks or process a stream of block events.
Documented uses
- Fetch a block for a selected blockchain, network and height.
- Backfill a block range in a development environment.
- Stream block events starting from a specified event sequence ID.
- Store raw on-chain data so consumers can parse it downstream.
Requirements & limits
The repository is public and identifies the project as Apache-2.0 licensed. The README quick start specifies Go 1.22 and Protocol Buffers 25.2.
- The README names Temporal, AWS S3, DynamoDB and SQS as ingestion and storage dependencies; local development uses LocalStack.
- Blockchain RPC endpoint groups and environment-specific configuration are part of setup.
- The project separates raw data ingestion from consumer-side parsing through its SDK.
- The documented backfill command is marked for development.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Fetch a blockchain block with the admin CLI
Use the documented block command to request a block by height.
Before you start
- A local Go 1.22 setup and Protocol Buffers 25.2, as specified in the README quick start.
- The repository initialized with make bootstrap.
- A configured Chainstorage environment for the selected blockchain and network.
Steps
Run the documented bootstrap step: make bootstrap.
Use the admin block command with blockchain, network, environment and height values; the README example uses Ethereum mainnet at height 46147.
Optionally provide --out to specify an output file; the CLI documents JSON as the default format and .pb for protobuf.
Expected outcome
The CLI is instructed to fetch the selected block; output format and file destination can be specified with the documented flag.
Guide limitations
- All subcommands require blockchain, environment and network flags.
- The guide describes the documented command, not a verified execution or a guarantee that a particular endpoint is configured.
Backfill a block range in development
Use the documented development backfill command for a specified block range.
Before you start
- The Chainstorage repository and its admin CLI setup.
- A development configuration and endpoint settings for the selected blockchain and network.
Steps
Select the blockchain, network and development environment.
Run the admin backfill command with --start-height and --end-height; the README example uses BSC mainnet heights 10408613 through 10408614.
Expected outcome
The CLI is instructed to backfill the specified block range in the development environment.
Guide limitations
- The README labels this backfill command as development.
- The steps do not establish that a particular deployment or endpoint is available.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 15 October 2026
- Original website title
- coinbase/chainstorage · Official homepage title · retained in its source language