This is prerelease software, not yet suitable for production use. Proceed at your own risk.
docker-compose -f contrib/docker-compose.yml up
*sbds* is available on Docker Hub as steemit/sbds.
e.g.
docker run -d steemit/sbds
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.
The system has three conceptual functions:
1. Interfacing 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.
- Ingest, prepare, store, and index blocks in one of two storage backends (S3, SQL Database, and/or Elasticsearch).
- Querying indexed blocks.
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.
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.
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
server HTTP server for answering DB queries
The preferred method for checkpoints interaction at the moment is using the checkpoints in the gzipped folder s3://steemit-dev-sbds-checkpoints/gzipped. The idea is to have the access to the gzipped checkpoints dir either locally or on s3, and then you can use the sbds checkpoints get-blocks command, specifying at start and end blocknum and it will figure out which files to use and spit out the blocks.
Stream blocks 1 to 3450000 from our dev S3 bucket
sbds checkpoints get-blocks s3://steemit-dev-sbds-checkpoints/gzipped --start 1 --end 3450000
Stream blocks 8000000 to the last block from your local copy of our S3 bucket
sbds checkpoints get-blocks /home/ubuntu/checkpoints/gzipped --start 8000000
Stream all blocks from your local copy of our S3 bucket
sbds checkpoints get-blocks /home/ubuntu/checkpoints/gzipped