2018-06-15 11:23:48 +02:00
# Electrum Server in Rust
2019-03-08 21:02:44 +01:00
[](https://circleci.com/gh/romanz/electrs/tree/master)
2018-07-03 14:32:25 +02:00
[](http://makeapullrequest.com)
2018-07-03 14:41:56 +02:00
[](https://crates.io/crates/electrs)
2018-07-08 13:11:48 +02:00
[](https://gitter.im/romanz/electrs)
2018-06-16 09:46:54 +02:00
2018-07-03 14:34:24 +02:00
An efficient re-implementation of Electrum Server, inspired by [ElectrumX ](https://github.com/kyuupichan/electrumx ), [Electrum Personal Server ](https://github.com/chris-belcher/electrum-personal-server ) and [bitcoincore-indexd ](https://github.com/jonasschnelli/bitcoincore-indexd ).
2018-06-15 11:23:48 +02:00
2018-06-17 09:34:39 +02:00
The motivation behind this project is to enable a user to run his own Electrum server,
with required hardware resources not much beyond those of a [full node ](https://en.bitcoin.it/wiki/Full_node#Why_should_you_use_a_full_node_wallet ).
2018-06-17 09:46:15 +02:00
The server indexes the entire Bitcoin blockchain, and the resulting index enables fast queries for any given user wallet,
2018-06-17 09:34:39 +02:00
allowing the user to keep real-time track of his balances and his transaction history using the [Electrum wallet ](https://electrum.org/ ).
Since it runs on the user's own machine, there is no need for the wallet to communicate with external Electrum servers,
thus preserving the privacy of the user's addresses and balances.
2018-06-16 21:37:51 +02:00
2018-06-16 10:08:25 +02:00
## Features
2019-03-08 21:03:16 +01:00
* Supports Electrum protocol [v1.4 ](https://electrumx.readthedocs.io/en/latest/protocol.html )
2018-06-16 10:08:25 +02:00
* Maintains an index over transaction inputs and outputs, allowing fast balance queries
2018-07-12 22:25:49 +02:00
* Fast synchronization of the Bitcoin blockchain (~2 hours for ~187GB @ July 2018) on [modest hardware ](https://gist.github.com/romanz/cd9324474de0c2f121198afe3d063548 )
2018-06-16 21:37:51 +02:00
* Low index storage overhead (~20%), relying on a local full node for transaction retrieval
2018-06-16 10:42:43 +02:00
* Efficient mempool tracker (allowing better fee [estimation ](https://github.com/spesmilo/electrum/blob/59c1d03f018026ac301c4e74facfc64da8ae4708/RELEASE-NOTES#L34-L46 ))
2018-06-16 21:37:51 +02:00
* Low CPU & memory usage (after initial indexing)
* [`txindex` ](https://github.com/bitcoinbook/bitcoinbook/blob/develop/ch03.asciidoc#txindex ) is not required for the Bitcoin node
* Uses a single [RocksDB ](https://github.com/spacejam/rust-rocksdb ) database, for better consistency and crash recovery
2018-06-15 11:23:48 +02:00
## Usage
2018-07-07 11:15:37 +02:00
See [here ](doc/usage.md ) for installation, build and usage instructions.
2018-07-02 12:54:06 +02:00
## Index database
The database schema is described [here ](doc/schema.md ).
