2 releases

0.1.1 May 21, 2019
0.1.0 May 21, 2019

#45 in #full

CC0 license

13KB
156 lines

btc-cli

A Bitcoin command line tool written in Rust that

  • interacts with a full node via the p2p protocol
  • interacts with a full node via the rpc interface
  • interacts with an electrum server
  • provides key management utilities

DISCLAIMER: this project is experimental and the code is not production ready. DO NOT USE IN PRODUCTION!!!!

Usage Examples:

The "key-management" subcommand:

This sub-command provides utilities for key management.

➜  btc-cli git:(development) ✗ cargo run key-management --action generate-xpub-from-seed --seed="000102030405060708090a0b0c0d0e0a" --network bitcoin --path "m/0/1"
    Finished dev [unoptimized + debuginfo] target(s) in 0.14s
     Running `target/debug/main key-management --action generate-xpub-from-seed --seed=000102030405060708090a0b0c0d0e0a --network bitcoin --path m/0/1`
xpub: xpub6BJNgwRThSd6DEqbxGYdYPuEWhKFtzEMPPxmDHLfWdWjHEWaeGvQukNtAjw2rFpYb4cUzvJF1VG8pwWcr7bv9oMJqHaJqLfYhUy4hknreS9
public key: 02fb62886536544edbd8d8c257ab7014f54988b386c867f9d6ec68b5305af1beb9
➜  btc-cli git:(development)

The "p2p" subcommand:

This sub-command enables the user to interact with a bitcoin node using the p2p protocol

➜  btc-cli git:(development) ✗ cargo run  p2p --action raw-message --node localhost:8333 --message "f9beb4d976657273696f6e000000000066000000be61b8277f1101000d04000000000000f00f4d5c00000000000000000000000000000000000000000000ffff5bf08c80b4bd0d04000000000000000000000000000000000000000000000000faa99559cc68a1c1102f5361746f7368693a302e31372e312f938c080001"
    Finished dev [unoptimized + debuginfo] target(s) in 0.14s
     Running `target/debug/main p2p --action raw-message --node 'localhost:8333' --message f9beb4d976657273696f6e000000000066000000be61b8277f1101000d04000000000000f00f4d5c00000000000000000000000000000000000000000000ffff5bf08c80b4bd0d04000000000000000000000000000000000000000000000000faa99559cc68a1c1102f5361746f7368693a302e31372e312f938c080001`
|f9beb4d9 76657273 696f6e00 00000000| ....version..... 00000000
|66000000 ed89e2e7 7f110100 0d040000| f............... 00000010
|00000000 b92de35c 00000000 00000000| .....-.\........ 00000020
|00000000 00000000 00000000 00000000| ................ 00000030
|00000000 00000d04 00000000 00000000| ................ 00000040
|00000000 00000000 00000000 00000000| ................ 00000050
|17409d72 31d05343 102f5361 746f7368| .@.r1.SC./Satosh 00000060
|693a302e 31382e30 2fdfcd08 0001|     i:0.18.0/.....   00000070
                                                       0000007e
➜  btc-cli git:(development)

The "rpc" subcommand:

This subcommand enables the user to talk to a bitcoin node via JSON RPC (only password auth implemented for now)

➜  btc-cli git:(development) ✗ cargo run rpc --node http://localhost:8332 --username user --action get-best-block-hash
    Finished dev [unoptimized + debuginfo] target(s) in 0.14s
     Running `target/debug/main rpc --node 'http://localhost:8332' --username user --action get-best-block-hash`
Type in the RPC password:

best block hash: 000000000000000000141688aac2f0da13de43612e683666593b6e6a1afe7faf
➜  btc-cli git:(development)

The "electrum" subcommand:

This subcommand enables the user to talk to an elecrtrum server. NOT IMPLEMENTED YET

Dependencies

~12MB
~232K SLoC