Skip to content
This repository has been archived by the owner on Feb 24, 2023. It is now read-only.

BitcoinUnlimited/ElectrsCash

Repository files navigation

ElectrsCash - Electrum Server in Rust

This project has been moved HERE with the new name Rostrum

An efficient implementation of Electrum Server.

ElectrsCash is an efficient implementation of Electrum Server and can be used as a drop-in replacement for ElectrumX. In addition to the TCP RPC interface, it also provides WebSocket support.

ElectrsCash fully implements the v1.4.3 Electrum Cash protocol and in addition to useful extensions, including CashAccounts.

The server indexes the entire Bitcoin Cash blockchain, and the resulting index enables fast queries for blockchain applications and any given user wallet, allowing the user to keep real-time track of his balances and his transaction history.

When run 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.3
  • Maintains an index over transaction inputs and outputs, allowing fast balance queries.
  • Fast synchronization of the Bitcoin Cash blockchain on modest hardware
  • Low index storage overhead (~20%), relying on a local full node for transaction retrieval.
  • txindex is not required for the Bitcoin node, however it does improve performance.
  • Uses a single RocksDB database for better consistency and crash recovery.

Notable features unique to ElectrsCash

Usage

See here for installation, build and usage instructions.

Index database

The database schema is described here.

Tests

Run unit tests with cargo test.

Integration tests are included in the Bitcoin Unlimited test set. Look for tests prefixed with electrum_.

To run the tests, you need to:

Bitcoin Unlimited builds ElectrsCash and runs the above tests as part of their continuous integration.

Linters

Code linting and formatting is enforced in the projects continuous integration. When contributing, please run cargo clippy to catch common mistakes and improve your code, as well as cargo fmt to format the code.