1
0
mirror of https://github.com/romanz/electrs.git synced 2024-11-19 01:43:29 +01:00
An efficient re-implementation of Electrum Server in Rust
Go to file
Roman Zeyde 38aa2a4cf4
Fail Electrum RPCs if daemon's RPC returns an error
It appears that bitcoind return "HTTP/1.1 500" in case of JSONRPC error:
63f8b0128b/src/httprpc.cpp (L72)
2018-08-14 22:33:17 +03:00
doc Separate default monitoring ports for testnet and regtest 2018-08-14 10:16:01 +03:00
examples Allow setting index batch size from command-line 2018-08-06 18:44:18 +03:00
scripts Use stable Rust from ./scripts/run.sh 2018-08-02 15:51:21 +03:00
src Fail Electrum RPCs if daemon's RPC returns an error 2018-08-14 22:33:17 +03:00
tools Support testnet mempool visualization 2018-08-14 10:08:11 +03:00
.gitignore Ignore *.pyc files 2018-08-14 11:41:37 +03:00
.travis.yml Update stable Rust to 1.28 2018-08-04 22:25:25 +03:00
Cargo.toml Bump version 2018-08-14 11:17:29 +03:00
LICENSE Add MIT license and small README 2018-04-08 23:54:29 +03:00
README.md Update README with latest performance metrics 2018-07-12 23:26:37 +03:00
RELEASE-NOTES.md Mention new monitoring ports' defaults 2018-08-14 11:36:32 +03:00
TODO.md Remove irrelevant TODO 2018-08-14 13:30:52 +03:00

Electrum Server in Rust

Build Status 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.2
  • 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.