Skip to content

Latest commit

 

History

History
113 lines (71 loc) · 2.79 KB

README.rst

File metadata and controls

113 lines (71 loc) · 2.79 KB
Raw

SBDS (Steem Blockchain Data Service)

Notice

This is prerelease software, not yet suitable for production use. Proceed at your own risk.

Quickstart

*sbds* is available on Docker Hub as steemit/sbds.

e.g.

docker run -d steemit/sbds

Overview

Stack: Python 3, SQLAlchemy, bottle.

sbds is a set of tool for querying the data of the Steem Blockchain.

While providing direct interfaces to several pluggable storage architectures that may be used for querying the blockchain, sbds may also be used as a lower level API upon which other applications can be built.

Architecture

The system has three conceptual functions:

1. Interface with a steemd instance to provide access to blocks, ranges of blocks, or the continual stream of blocks as they are published on the blockchain.

  1. Ingest, prepare, store, and index blocks in one of two storage backends (S3, SQL Database).
  2. Querying indexed blocks.

Install

sbds is an installable python 3 package, though it is currently not published on pipy, and must be installed using git:

pip3 install -e [email protected]:steemit/sbds.git#egg=sbds

Installation will (during early development) require mysql and postgres development sources in order to build correctly. As an alternative to installing those libraries, a Dockerfile is available.

Usage

On initial use, blocks can be quickly loaded from "checkpoints" which are gzipped text files that are 1M blocks in length and currently hosted on S3 at s3://steemit-dev-sbds-checkpoints.

Once the storage is synced with all previous blocks, blocks can be streamed to storage backends as they are confirmed.

These blocks are not cryptographically assured in any way (and sbds does not provide any cryptographic guarantees or verify blockchain consensus state), so you may wish to regenerate these checkpoints.

sbds is designed to always be used in conjunction with a trusted instance of steemd to validate all block data before sbds ever receives it. This daemon does not implement any consensus rules.

CLI

The sbds package installs the sbds CLI.

More information:

$ sbds --help
Usage: sbds [OPTIONS] COMMAND [ARGS]...

  The *sbds* CLI manages storage, retrieval, and querying of the Steem
  blockchain.

  sbds has several commands, each of which has additional subcommands.

  For more detailed information on a command and its flags, run:
      sbds COMMAND --help

Options:
  --help  Show this message and exit.

Commands:
  chain        Query the Steem blockchain
  checkpoints  retrieve blocks from blockchain checkpoints
  db           Interact with an SQL storage backend
  s3           Interact with an S3 storage backend