Skip to content

Commit 9d6e266

Browse files
authored
Merge pull request Blockstream#62 from mempool/junderw/fix-readme
Update README and rename lib to mempool-electrs
2 parents 18e041c + dceb659 commit 9d6e266

File tree

6 files changed

+66
-60
lines changed

6 files changed

+66
-60
lines changed

.github/workflows/ci.yml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -51,7 +51,7 @@ jobs:
5151
~/.cargo/git
5252
target
5353
key: ${{ runner.os }}-cargo-test-${{ steps.toolchain.outputs.cachekey }}-${{ hashFiles('**/Cargo.lock') }}
54-
- run: cargo test --package electrs --lib --all-features
54+
- run: cargo test --lib --all-features
5555

5656
clippy:
5757
name: Linter

Cargo.lock

Lines changed: 43 additions & 43 deletions
Some generated files are not rendered by default. Learn more about customizing how changed files appear on GitHub.

Cargo.toml

Lines changed: 11 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,16 +1,24 @@
11
[package]
2-
name = "electrs"
2+
name = "mempool-electrs"
33
version = "3.0.0-dev"
4-
authors = ["Roman Zeyde <[email protected]>"]
4+
authors = [
5+
"Roman Zeyde <[email protected]>",
6+
"Nadav Ivgi <[email protected]>",
7+
8+
"junderw <[email protected]>"
9+
]
510
description = "An efficient re-implementation of Electrum Server in Rust"
611
license = "MIT"
712
homepage = "https://github.com/mempool/electrs"
813
repository = "https://github.com/mempool/electrs"
14+
publish = false
915
keywords = ["bitcoin", "electrum", "server", "index", "database"]
10-
documentation = "https://docs.rs/electrs/"
1116
readme = "README.md"
1217
edition = "2018"
1318

19+
[lib]
20+
name = "electrs"
21+
1422
[features]
1523
default = []
1624
liquid = [ "elements" ]

README.md

Lines changed: 9 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
1-
# Esplora - Electrs backend API
1+
# Mempool - Electrs backend API
22

3-
A block chain index engine and HTTP API written in Rust based on [romanz/electrs](https://github.com/romanz/electrs).
3+
A block chain index engine and HTTP API written in Rust based on [romanz/electrs](https://github.com/romanz/electrs) and [Blockstream/electrs](https://github.com/Blockstream/electrs).
44

5-
Used as the backend for the [Esplora block explorer](https://github.com/Blockstream/esplora) powering [blockstream.info](https://blockstream.info/).
5+
Used as the backend for the [mempool block explorer](https://github.com/mempool/mempool) powering [mempool.space](https://mempool.space/).
66

7-
API documentation [is available here](https://github.com/blockstream/esplora/blob/master/API.md).
7+
API documentation [is available here](https://mempool.space/docs/api/rest).
88

99
Documentation for the database schema and indexing process [is available here](doc/schema.md).
1010

@@ -13,8 +13,8 @@ Documentation for the database schema and indexing process [is available here](d
1313
Install Rust, Bitcoin Core (no `txindex` needed) and the `clang` and `cmake` packages, then:
1414

1515
```bash
16-
$ git clone https://github.com/blockstream/electrs && cd electrs
17-
$ git checkout new-index
16+
$ git clone https://github.com/mempool/electrs && cd electrs
17+
$ git checkout mempool
1818
$ cargo run --release --bin electrs -- -vvvv --daemon-dir ~/.bitcoin
1919

2020
# Or for liquid:
@@ -24,11 +24,9 @@ $ cargo run --features liquid --release --bin electrs -- -vvvv --network liquid
2424
See [electrs's original documentation](https://github.com/romanz/electrs/blob/master/doc/usage.md) for more detailed instructions.
2525
Note that our indexes are incompatible with electrs's and has to be created separately.
2626

27-
The indexes require 610GB of storage after running compaction (as of June 2020), but you'll need to have
27+
The indexes require 1.3TB of storage after running compaction (as of October 2023), but you'll need to have
2828
free space of about double that available during the index compaction process.
29-
Creating the indexes should take a few hours on a beefy machine with SSD.
30-
31-
To deploy with Docker, follow the [instructions here](https://github.com/Blockstream/esplora#how-to-build-the-docker-image).
29+
Creating the indexes should take a few hours on a beefy machine with high speed NVMe SSD(s).
3230

3331
### Light mode
3432

@@ -78,7 +76,7 @@ Additional options with the `electrum-discovery` feature:
7876
- `--electrum-hosts <json>` - a json map of the public hosts where the electrum server is reachable, in the [`server.features` format](https://electrumx.readthedocs.io/en/latest/protocol-methods.html#server.features).
7977
- `--electrum-announce` - announce the electrum server on the electrum p2p server discovery network.
8078

81-
See `$ cargo run --release --bin electrs -- --help` for the full list of options.
79+
See `$ cargo run --bin electrs -- --help` for the full list of options.
8280

8381
## License
8482

scripts/checks.sh

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -59,4 +59,4 @@ cargo clippy $@ -q -F electrum-discovery,liquid
5959

6060
TESTNAME="Running cargo test with all features"
6161
echo "$TESTNAME"
62-
cargo test $@ -q --package electrs --lib --all-features
62+
cargo test $@ -q --lib --all-features

src/config.rs

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -85,7 +85,7 @@ impl Config {
8585
pub fn from_args() -> Config {
8686
let network_help = format!("Select network type ({})", Network::names().join(", "));
8787

88-
let args = App::new("Electrum Rust Server")
88+
let args = App::new("Mempool Electrum Rust Server")
8989
.version(crate_version!())
9090
.arg(
9191
Arg::with_name("version")

0 commit comments

Comments
 (0)