Release 0.1.0-beta.1

Author: afilini

.gitignore

@@ -0,0 +1,4 @@
+/target
+Cargo.lock
+
+*.swp

.travis.yml

@@ -0,0 +1,23 @@
+language: rust
+rust:
+  - stable
+#  - 1.31.0 TODO: support the first 2018-edition toolchain
+before_script:
+  - rustup component add rustfmt
+# Run tests and check a few combinations of features
+script:
+  - cargo fmt -- --check --verbose
+  - cargo test --verbose --all
+  - cargo check --verbose --features=use-openssl
+  - cargo check --verbose --no-default-features --features=proxy
+  - cargo check --verbose --no-default-features --features=minimal
+  - cargo check --verbose --no-default-features --features=minimal,debug-calls
+  - cargo check --verbose --no-default-features --features=proxy,use-openssl
+  - cargo check --verbose --no-default-features --features=proxy,use-rustls
+
+before_cache:
+  - rm -rf "$TRAVIS_HOME/.cargo/registry/src"
+cache: cargo
+
+notifications:
+  email: false

Cargo.toml

@@ -0,0 +1,41 @@
+[package]
+name = "electrum-client"
+version = "0.1.0-beta.1"
+authors = ["Alekos Filini <[email protected]>"]
+license = "MIT"
+homepage = "https://github.com/MagicalBitcoin/rust-electrum-client"
+repository = "https://github.com/MagicalBitcoin/rust-electrum-client"
+documentation = "https://docs.rs/electrum-client/"
+description = "Bitcoin Electrum client library. Supports plaintext, TLS and Onion servers."
+keywords = ["bitcoin", "electrum"]
+readme = "README.md"
+exclude = [
+    "test_data/*",
+]
+
+# loosely based on https://github.com/evgeniy-scherbina/rust-electrumx-client
+
+[lib]
+name = "electrum_client"
+path = "src/lib.rs"
+
+[dependencies]
+log = "^0.4"
+bitcoin = { version = "0.23", features = ["use-serde"] }
+serde = { version = "^1.0", features = ["derive"] }
+serde_json = { version = "^1.0" }
+
+# Optional dependencies
+socks = { version = "^0.3", optional = true }
+openssl = { version = "^0.10", optional = true }
+rustls = { version = "0.16.0", optional = true, features = ["dangerous_configuration"] }
+webpki = { version = "0.21.0", optional = true }
+webpki-roots = { version = "^0.19", optional = true }
+
+[features]
+default = ["socks", "webpki", "webpki-roots", "rustls"]
+minimal = []
+debug-calls = []
+proxy = ["socks"]
+use-rustls = ["webpki", "webpki-roots", "rustls"]
+use-openssl = ["openssl"]

README.md

@@ -0,0 +1,3 @@
+# rust-electrum-client
+
+Bitcoin Electrum client library. Supports plaintext, TLS and Onion servers.

examples/plaintext.rs

@@ -0,0 +1,9 @@
+extern crate electrum_client;
+
+use electrum_client::Client;
+
+fn main() {
+    let mut client = Client::new("kirsche.emzy.de:50001").unwrap();
+    let res = client.server_features();
+    println!("{:#?}", res);
+}

examples/ssl.rs

@@ -0,0 +1,13 @@
+extern crate electrum_client;
+
+use electrum_client::Client;
+
+fn main() {
+    let mut client = Client::new_ssl(
+        "electrum2.hodlister.co:50002",
+        Some("electrum2.hodlister.co"),
+    )
+    .unwrap();
+    let res = client.server_features();
+    println!("{:#?}", res);
+}

examples/tor.rs

@@ -0,0 +1,21 @@
+extern crate electrum_client;
+
+use electrum_client::Client;
+
+fn main() {
+    // NOTE: This assumes Tor is running localy, with an unauthenticated Socks5 listening at
+    // localhost:9050
+
+    let mut client = Client::new_proxy("ozahtqwp25chjdjd.onion:50001", "127.0.0.1:9050").unwrap();
+    let res = client.server_features();
+    println!("{:#?}", res);
+
+    // works both with onion v2/v3 (if your Tor supports them)
+    let mut client = Client::new_proxy(
+        "v7gtzf7nua6hdmb2wtqaqioqmesdb4xrlly4zwr7bvayxv2bpg665pqd.onion:50001",
+        "127.0.0.1:9050",
+    )
+    .unwrap();
+    let res = client.server_features();
+    println!("{:#?}", res);
+}

src/batch.rs

@@ -0,0 +1,49 @@
+use bitcoin::hashes::hex::ToHex;
+use bitcoin::{Script, Txid};
+
+use types::{Param, ToElectrumScriptHash};
+
+pub struct Batch {
+    calls: Vec<(String, Vec<Param>)>,
+}
+
+impl Batch {
+    pub fn script_list_unspent(&mut self, script: &Script) {
+        let params = vec![Param::String(script.to_electrum_scripthash().to_hex())];
+        self.calls
+            .push((String::from("blockchain.scripthash.listunspent"), params));
+    }
+
+    pub fn script_get_history(&mut self, script: &Script) {
+        let params = vec![Param::String(script.to_electrum_scripthash().to_hex())];
+        self.calls
+            .push((String::from("blockchain.scripthash.get_history"), params));
+    }
+
+    pub fn script_get_balance(&mut self, script: &Script) {
+        let params = vec![Param::String(script.to_electrum_scripthash().to_hex())];
+        self.calls
+            .push((String::from("blockchain.scripthash.get_balance"), params));
+    }
+
+    pub fn transaction_get(&mut self, tx_hash: &Txid) {
+        let params = vec![Param::String(tx_hash.to_hex())];
+        self.calls
+            .push((String::from("blockchain.transaction.get"), params));
+    }
+}
+
+impl std::iter::IntoIterator for Batch {
+    type Item = (String, Vec<Param>);
+    type IntoIter = std::vec::IntoIter<Self::Item>;
+
+    fn into_iter(self) -> Self::IntoIter {
+        self.calls.into_iter()
+    }
+}
+
+impl std::default::Default for Batch {
+    fn default() -> Self {
+        Batch { calls: Vec::new() }
+    }
+}