WIP: Relates to #8221. Create template package for ethdb for Parity E…

…thereum interaction with DB on-demand

Cargo.toml

@@ -45,6 +45,7 @@ ethcore-network = { path = "util/network" }
 ethcore-private-tx = { path = "ethcore/private-tx" }
 ethcore-service = { path = "ethcore/service" }
 ethcore-sync = { path = "ethcore/sync" }
+ethdb = { path = "ethdb" }
 ethereum-types = "0.4"
 ethkey = { path = "accounts/ethkey" }
 ethstore = { path = "accounts/ethstore" }

README.md

@@ -134,6 +134,7 @@ In addition to the Parity Ethereum client, there are additional tools in this re
 
 - [evmbin](https://github.com/paritytech/parity-ethereum/blob/master/evmbin/) - EVM implementation for Parity Ethereum.
 - [ethabi](https://github.com/paritytech/ethabi) - Parity Ethereum function calls encoding.
+- [ethdb](https://github.com/paritytech/ethdb) - Parity Ethereum interaction with the DB on-demand.
 - [ethstore](https://github.com/paritytech/parity-ethereum/blob/master/accounts/ethstore) - Parity Ethereum key management.
 - [ethkey](https://github.com/paritytech/parity-ethereum/blob/master/accounts/ethkey) - Parity Ethereum keys generator.
 - [whisper](https://github.com/paritytech/parity-ethereum/blob/master/whisper/) - Implementation of Whisper-v2 PoC.

accounts/ethkey/README.md

@@ -216,6 +216,7 @@ _This project is a part of the Parity Ethereum toolchain._
 
 - [evmbin](https://github.com/paritytech/parity-ethereum/blob/master/evmbin/) - EVM implementation for Parity Ethereum.
 - [ethabi](https://github.com/paritytech/ethabi) - Parity Ethereum function calls encoding.
+- [ethdb](https://github.com/paritytech/ethdb) - Parity Ethereum interaction with the DB on-demand.
 - [ethstore](https://github.com/paritytech/parity-ethereum/blob/master/accounts/ethstore) - Parity Ethereum key management.
 - [ethkey](https://github.com/paritytech/parity-ethereum/blob/master/accounts/ethkey) - Parity Ethereum keys generator.
 - [whisper](https://github.com/paritytech/parity-ethereum/blob/master/whisper/) - Implementation of Whisper-v2 PoC.

accounts/ethstore/README.md

@@ -335,6 +335,7 @@ _This project is a part of the Parity Ethereum toolchain._
 
 - [evmbin](https://github.com/paritytech/parity-ethereum/blob/master/evmbin/) - EVM implementation for Parity Ethereum.
 - [ethabi](https://github.com/paritytech/ethabi) - Parity Ethereum function calls encoding.
+- [ethdb](https://github.com/paritytech/ethdb) - Parity Ethereum interaction with the DB on-demand.
 - [ethstore](https://github.com/paritytech/parity-ethereum/blob/master/accounts/ethstore) - Parity Ethereum key management.
 - [ethkey](https://github.com/paritytech/parity-ethereum/blob/master/accounts/ethkey) - Parity Ethereum keys generator.
 - [whisper](https://github.com/paritytech/parity-ethereum/blob/master/whisper/) - Implementation of Whisper-v2 PoC.

ethdb/Cargo.toml

@@ -0,0 +1,15 @@
+[package]
+name = "ethdb"
+description = "Parity Ethereum command-line tool for database interaction"
+version = "0.1.0"
+authors = ["Parity Technologies <[email protected]>"]
+
+[[bin]]
+name = "ethdb"
+path = "./src/main.rs"
+
+[dependencies]
+
+[dev-dependencies]
+
+[features]

ethdb/README.md

@@ -0,0 +1,42 @@
+## ethdb
+
+Parity Ethereum interaction with the DB on-demand.
+
+### Usage
+
+```
+Parity Ethereum interaction with the DB on-demand.
+  Copyright 2015-2019 Parity Technologies (UK) Ltd.
+
+Usage:
+    ethdb build-trace-db
+    ethdb [options]
+    ethdb [-h | --help]
+
+Commands:
+    build-trace-db     Build TraceDB on-demand and output to json file.
+
+Tracing options:
+    --chain CHAIN      Build only from specific chain.
+    --from BLOCK       Build only from a specific block.
+    --to BLOCK         Build only to a specific block.
+
+General options:
+    --json             Display verbose results in JSON.
+    --std-json         Display results in standardized JSON format.
+    --std-err-only     With --std-json redirect to err output only.
+    --std-out-only     With --std-json redirect to out output only.
+    --std-dump-json    Display results in standardized JSON format
+                       with additional state dump.
+    -h, --help         Display this message and exit.
+```
+
+## Parity Ethereum toolchain
+_This project is a part of the Parity Ethereum toolchain._
+
+- [evmbin](https://github.com/paritytech/parity-ethereum/blob/master/evmbin/) - EVM implementation for Parity Ethereum.
+- [ethabi](https://github.com/paritytech/ethabi) - Parity Ethereum function calls encoding.
+- [ethdb](https://github.com/paritytech/ethdb) - Parity Ethereum interaction with the DB on-demand.
+- [ethstore](https://github.com/paritytech/parity-ethereum/blob/master/accounts/ethstore) - Parity Ethereum key management.
+- [ethkey](https://github.com/paritytech/parity-ethereum/blob/master/accounts/ethkey) - Parity Ethereum keys generator.
+- [whisper](https://github.com/paritytech/parity-ethereum/blob/master/whisper/) - Implementation of Whisper-v2 PoC.

ethdb/src/main.rs

@@ -0,0 +1,23 @@
+// Copyright 2015-2019 Parity Technologies (UK) Ltd.
+// This file is part of Parity Ethereum.
+
+// Parity Ethereum is free software: you can redistribute it and/or modify
+// it under the terms of the GNU General Public License as published by
+// the Free Software Foundation, either version 3 of the License, or
+// (at your option) any later version.
+
+// Parity Ethereum is distributed in the hope that it will be useful,
+// but WITHOUT ANY WARRANTY; without even the implied warranty of
+// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+// GNU General Public License for more details.
+
+// You should have received a copy of the GNU General Public License
+// along with Parity Ethereum.  If not, see <http://www.gnu.org/licenses/>.
+
+//! Parity Ethereum command-line tool for database interaction.
+
+#![warn(missing_docs)]
+
+fn main() {
+  // TODO
+}

evmbin/README.md

@@ -50,6 +50,7 @@ _This project is a part of the Parity Ethereum toolchain._
 
 - [evmbin](https://github.com/paritytech/parity-ethereum/blob/master/evmbin/) - EVM implementation for Parity Ethereum.
 - [ethabi](https://github.com/paritytech/ethabi) - Parity Ethereum function calls encoding.
+- [ethdb](https://github.com/paritytech/ethdb) - Parity Ethereum interaction with the DB on-demand.
 - [ethstore](https://github.com/paritytech/parity-ethereum/blob/master/accounts/ethstore) - Parity Ethereum key management.
 - [ethkey](https://github.com/paritytech/parity-ethereum/blob/master/accounts/ethkey) - Parity Ethereum keys generator.
 - [whisper](https://github.com/paritytech/parity-ethereum/blob/master/whisper/) - Implementation of Whisper-v2 PoC.

whisper/README.md

@@ -17,8 +17,8 @@ Options:
 	-p, --port PORT                Specify which P2P port to use [default: random].
 	-a, --address ADDRESS          Specify which P2P address to use [default: 127.0.0.1].
 	-s, --secret KEYFILE           Specify which file contains the key to generate the enode.
-    -P, --rpc-port PORT            Specify which RPC port to use [default: 8545].
-    -A, --rpc-address ADDRESS      Specify which RPC address to use [default: 127.0.0.1].
+  -P, --rpc-port PORT            Specify which RPC port to use [default: 8545].
+  -A, --rpc-address ADDRESS      Specify which RPC address to use [default: 127.0.0.1].
 	-l, --log LEVEL                Specify the logging level. Must conform to the same format as RUST_LOG [default: Error].
 	-h, --help                     Display this message and exit.
 ```
@@ -28,6 +28,7 @@ _This project is a part of the Parity Ethereum toolchain._
 
 - [evmbin](https://github.com/paritytech/parity-ethereum/blob/master/evmbin/) - EVM implementation for Parity Ethereum.
 - [ethabi](https://github.com/paritytech/ethabi) - Parity Ethereum function calls encoding.
+- [ethdb](https://github.com/paritytech/ethdb) - Parity Ethereum interaction with the DB on-demand.
 - [ethstore](https://github.com/paritytech/parity-ethereum/blob/master/accounts/ethstore) - Parity Ethereum key management.
 - [ethkey](https://github.com/paritytech/parity-ethereum/blob/master/accounts/ethkey) - Parity Ethereum keys generator.
 - [whisper](https://github.com/paritytech/parity-ethereum/blob/master/whisper/) - Implementation of Whisper-v2 PoC.