blockbook/README.md

47 lines
2.1 KiB
Markdown
Raw Normal View History

2018-10-22 02:49:57 -06:00
[![Go Report Card](https://goreportcard.com/badge/trezor/blockbook)](https://goreportcard.com/report/trezor/blockbook)
# Blockbook
2017-08-28 11:10:33 -06:00
2018-10-10 06:52:15 -06:00
> **WARNING: Blockbook is currently in the state of heavy development. We may implement at any time backwards incompatible changes that require full reindexation of the database. Also, do not expect this documentation to be always up to date.**
**Blockbook** is back-end service for Trezor wallet. Main features of **Blockbook** are:
- index of addresses and address balances of the connected block chain
- fast searches in the indexes
- simple blockchain explorer
- websocket, API and legacy Bitcore Insight compatible socket.io interfaces
- support of multiple coins (Bitcoin and Ethereum type), with easy extensibility for other coins
- scripts for easy creation of debian packages for backend and blockbook
2018-05-30 09:15:22 -06:00
## Build and installation instructions
2018-05-30 09:15:22 -06:00
2018-10-22 02:49:57 -06:00
Officially supported platform is **Debian Linux** and **AMD64** architecture.
Memory and disk requirements for initial synchronization of **Bitcoin mainnet** are around 32 GB RAM and over 160 GB of disk space. After initial synchronization, fully synchronized instance uses about 10 GB RAM.
Other coins should have lower requirements, depending on the size of their block chain. Note that fast SSD disks are highly
2018-08-29 08:07:02 -06:00
recommended.
2018-08-29 02:13:17 -06:00
2018-08-29 08:07:02 -06:00
User installation guide is [here](https://wiki.trezor.io/User_manual:Running_a_local_instance_of_Trezor_Wallet_backend_(Blockbook)).
2018-02-07 14:51:19 -07:00
2018-08-29 08:07:02 -06:00
Developer build guide is [here](/docs/build.md).
2018-02-28 04:54:09 -07:00
Contribution guide is [here](CONTRIBUTING.md).
2018-06-12 09:26:46 -06:00
# Implemented coins
2018-02-28 04:54:09 -07:00
Blockbook currently supports over 20 coins, among them:
- Bitcoin, Litecoin, Bitcoin Cash, Bgold, ZCash, Dash, Ethereum, Ethereum Classic
Testnets for some coins are also supported, for example:
- Bitcoin Testnet, Bitcoin Cash Testnet, ZCash Testnet, Ethereum Testnet Ropsten
List of all implemented coins is in [the registry of ports](/docs/ports.md).
2018-01-25 10:04:35 -07:00
# Data storage in RocksDB
2018-01-27 16:30:55 -07:00
Blockbook stores data the key-value store RocksDB. Database format is described [here](/docs/rocksdb.md).
2018-02-02 09:25:14 -07:00
2019-03-20 11:06:30 -06:00
# API
Blockbook API is described [here](/docs/api.md).