1
0
mirror of https://github.com/romanz/electrs.git synced 2024-11-19 09:54:09 +01:00
An efficient re-implementation of Electrum Server in Rust
Go to file
Dr. Maxim Orlovsky 0ccdf44181 Completed migration to new bitcoin::hash_types
This commits contains fixes to merklization function arguments
and return types. New hash type system from bitcoin crate does
not cover all cases for merkle values; and the same function
may be applied to different hash types. Thus, I have used generic
types to abstract the logic.

`Txid` merklization operates with TxMerkleNode type;
`BlockHash` merklization does not introduce a new type: the same
design decision was made in the original work on new bitcoin
crate type system since it is used in a single case, and there is
no point in introducing a special designated hash type.

Script hashes (used in RPC queries) are left of Sha256dHash type
since there is no corresponding type defined in bitcoin crate;
this type is specific to Electrum X protocol. Corresponding
new type can be implemented in the project later with `hash_newtype!`
macro in the same way it was done in bitcoin crate.
2020-04-20 00:28:23 +02:00
.circleci Support Rust >=1.34 2019-09-07 12:00:24 +03:00
.github/workflows Remove --verbose from GitHub workflow 2019-12-02 10:20:11 +02:00
contrib Update contrib/ scripts to use latest PyCoin 2020-04-11 18:41:44 +03:00
doc Added a note about broken toolchains on RPi4 2020-04-14 00:23:57 +03:00
examples Add metrics to blocktxids cache 2019-07-04 08:18:54 +00:00
scripts Use stable Rust from ./scripts/run.sh 2018-08-02 15:51:21 +03:00
src Completed migration to new bitcoin::hash_types 2020-04-20 00:28:23 +02:00
.dockerignore Update Dockerfile to install libsnappy-dev and to use current source code 2019-03-03 22:34:39 +02:00
.gitignore Ignore _* directories 2018-12-23 10:05:05 +02:00
.travis.yml Revert "Test Travis CI on ARM" 2019-10-15 10:48:04 +03:00
build.rs Update configure_me as well as other packages 2019-10-18 17:14:53 +02:00
Cargo.lock WIP on migrating to new bitcoin::hash_types 2020-04-20 00:28:23 +02:00
Cargo.toml WIP on migrating to new bitcoin::hash_types 2020-04-20 00:28:23 +02:00
config_spec.toml Correct --network arg values in the doc 2019-12-15 13:51:13 +01:00
Dockerfile Pin Docker Rust base image to Debian Buster 2020-04-14 17:24:37 +03:00
LICENSE Add MIT license and small README 2018-04-08 23:54:29 +03:00
README.md Use GitHub workflows badge 2019-12-02 10:40:56 +02:00
RELEASE-NOTES.md Bump version 2020-01-30 21:56:24 +02:00
TODO.md Remove TLS-related TODO 2018-08-15 15:05:40 +03:00

Electrum Server in Rust

workflows PRs Welcome crates.io gitter.im

An efficient re-implementation of Electrum Server, inspired by ElectrumX, Electrum Personal Server and bitcoincore-indexd.

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. The server indexes the entire Bitcoin blockchain, and the resulting index enables fast queries for any given user wallet, allowing the user to keep real-time track of his balances and his transaction history using the Electrum wallet. 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.

Features

  • Supports Electrum protocol v1.4
  • Maintains an index over transaction inputs and outputs, allowing fast balance queries
  • Fast synchronization of the Bitcoin blockchain (~2 hours for ~187GB @ July 2018) on modest hardware
  • Low index storage overhead (~20%), relying on a local full node for transaction retrieval
  • Efficient mempool tracker (allowing better fee estimation)
  • Low CPU & memory usage (after initial indexing)
  • txindex is not required for the Bitcoin node
  • Uses a single RocksDB database, for better consistency and crash recovery

Usage

See here for installation, build and usage instructions.

Index database

The database schema is described here.