Skip to content
An efficient re-implementation of Electrum Server in Rust
Branch: bitcoin_e
Clone or download
Pull request Compare This branch is 2 commits ahead of sidhujag:bitcoin_e.
sidhujag
sidhujag fmt
Latest commit 7c43a31 Feb 5, 2019
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.hooks
contrib Add systemd service file example Oct 1, 2018
doc
scripts Use stable Rust from ./scripts/run.sh Aug 2, 2018
src
tools
.gitignore
.travis.yml
Cargo.lock
Cargo.toml
Dockerfile
LICENSE
README.md
RELEASE-NOTES.md
TODO.md

README.md

Esplora - Electrs backend API

A block chain index engine and HTTP API written in Rust based on romanz/electrs.

Used as the backend for the Esplora block explorer powering blockstream.info.

API documentation is available here.

Installing & indexing

Install Rust, Bitcoin Core and the clang and cmake packages, then:

$ git clone https://github.com/blockstream/electrs && cd electrs
$ git checkout bitcoin_e # or liquid_e
$ cargo run --release -- -vvvv --daemon-dir ~/.bitcoin

See electrs's original documentation for more detailed instructions. Note that our indexes are incompatible with electrs's and has to be created separately.

The indexes require 250GB-300GB of storage after running compaction, but you'll need to have at least 500GB of free space available for the initial (non-compacted) indexing process. Creating the indexes should take a few hours on a beefy machine with SSD.

For personal low-volume use, the storage requirements can be reduced with --light (see below under CLI options).

To deploy with Docker, follow the instructions here.

Notable changes from Electrs:

  • HTTP REST API instead of the Electrum JSON-RPC protocol, with extended transaction information (previous outputs, spending transactions, script asm and more).

  • Extended indexes and database storage for improved performance under high load:

    • A full transaction store mapping txids to raw transactions is kept in the database under the prefix t. This takes up ~200GB of extra storage.
    • A map of blockhash to txids is kept in the database under the prefix X.
    • Block stats metadata (number of transactions, size and weight) is kept in the database under the prefix M.
    • The index with T prefix mapping txids to block heights now also includes the block hash. This allows for quick reorg-aware transaction confirmation status lookups, by verifying the current block at the recorded height still matches the recorded block hash.

    With these new indexes, bitcoind is no longer queried to serve user requests and is only polled periodically for new blocks and for syncing the mempool.

  • Support for Liquid and other Elements-based networks, including CT, peg-in/out and multi-asset. (under the liquid_e branch)

CLI options

In addition to electrs's original configuration options, a few new options are also available:

  • --http-addr <addr:port> - HTTP server address/port to listen on (default: 127.0.0.1:3000).
  • --light - enable light resource mode, which disables the X, M and t indexes and queries this information from bitcoind instead. This significantly reduces storage requirements (at the time of writing, by about 250GB), at the cost of more expensive lookups and more reliance on bitcoind.
  • --disable-prevout - disable attaching previous output information to inputs. This significantly reduces the amount of transaction lookups (and IO/CPU/memory usage), at the cost of not knowing inputs amounts, their previous script/address, and the transaction fee. Consider setting this if you're using --light.
  • --parent-network <network> - the parent network this chain is pegged to (Elements/Liquid only).

See $ cargo run --release -- --help for the full list of options.

License

MIT

You can’t perform that action at this time.