flywithu/Learning-Bitcoin-from-the-Command-Line
1
1
Fork 0
mirror of https://github.com/ChristopherA/Learning-Bitcoin-from-the-Command-Line.git synced 2025-06-07 07:56:31 +00:00
Code Issues Releases Wiki Activity

final edits

Browse Source
This commit is contained in:
Shannon Appelcline 2020-09-30 09:51:58 -10:00 committed by GitHub
parent 2be30fc78a
commit 750c05f9a6
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 10 additions and 15 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
17_5_Accessing_Bitcoind_with_Rust.md
View File

@ -93,7 +93,7 @@ fn main() {
}
```
As usual, make sure to insert your proper user name and password from `~/.bitcoin/bitcoin.conf`. Here, they're placed as the arguments for `Auth::UserPass`.
As usual, make sure to insert your proper user name and password from `~/.bitcoin/bitcoin.conf`. Here, they're used as the arguments for `Auth::UserPass`.
> :link: **TESTNET vs MAINNET:** And, as usual, use port 8332 for mainnet.
@ -106,7 +106,7 @@ When you're done, you should also close your connection:
### Making an RPC Call
RPC calls made made using the `rpc` `Client` that you created:
RPC calls are made using the `rpc` `Client` that you created:
```rust
let mining_info = rpc.get_mining_info().unwrap();
@ -114,12 +114,6 @@ println!("{:#?}", mining_info);
```
Generally, the words in the RPC call are separated by `_`s. A complete list is available at the [crate docs](https://crates.io/crates/bitcoincore-rpc).
If we wanted we could close the connection:
```rust
let _ = rpc.stop().unwrap();
```
### Making an RPC Call with Arguments
Sending an RPC call with arguments using Rust just requires knowing how the function is laid out. For example, the `get_block` function is defined as follows in the [docs](https://docs.rs/bitcoincore-rpc/0.11.0/bitcoincore_rpc/trait.RpcApi.html#method.get_block):
@ -127,7 +121,7 @@ Sending an RPC call with arguments using Rust just requires knowing how the func
```rust
fn get_block(&self, hash: &BlockHash) -> Result<Block>
```
We just need to allow it to borrow a blockhash, which can be retrieved (for example) by `get_best_block_hash` for the newest (and most reliable).
You just need to allow it to borrow a blockhash, which can be retrieved (for example) by `get_best_block_hash`.
Here's the complete code to retrieve a block hash, turn that into a block, and print it.
```
@ -141,7 +135,7 @@ Here's the complete code to retrieve a block hash, turn that into a block, and p
### Running Your Code
You can access the [src code](src/17_5_main-getinfo.rs) and run it. Unfortunately, the "Block" info will come out a bit ugly because we don't have a library to prettify it.
You can access the [src code](src/17_5_main-getinfo.rs) and run it. Unfortunately, the "Block" info will come out a bit ugly because this example doesn't include a library to prettify it.
```
$ cargo run
Compiling btc_test v0.1.0 (/home/standup/btc_test)
@ -231,10 +225,9 @@ use bitcoincore_rpc::bitcoin::{Address, Amount};
Note that you're passing `list_unspent` five variables. The first four (`minconf`, `maxconf`, `addresses`, and `include_unsafe`) aren't used here. The fifth is `query_options`, which we haven't used before, but has some powerful filtering options, including the ability to only look at UTXOs with a certain minimum (or maximum) value.
### 2. Populate Variables
First, you can create the input from the `txid` and the `vout` of the UTXO you selected:
To begin populating the variables that you'll need to create a new transaction, you create the input from the `txid` and the `vout` of the UTXO that you selected:
```rust
let selected_utxos = json::CreateRawTransactionInput {
txid: selected_tx.txid,
@ -242,13 +235,13 @@ let selected_utxos = json::CreateRawTransactionInput {
sequence: None,
};
```
Second, you can calculate the amount you're going to spend by subtracting a mining fee from the funds in the UTXO:
Next, you can calculate the amount you're going to spend by subtracting a mining fee from the funds in the UTXO:
```
// send all bitcoin in the UTXO except a minor value which will be paid to miners
let unspent_amount = selected_tx.amount;
let amount = unspent_amount - Amount::from_btc(0.00001).unwrap();
```
Third, you can create a hash map of the address and the amount:
Finally, you can create a hash map of the address and the amount to form the output:
```
let mut output = HashMap::new();
output.insert(
@ -284,7 +277,7 @@ println!("signed tx {:?}", signed_tx.transaction().unwrap());
### 5. Send Transaction
Finally, you can sign and broadcast the transaction:
Finally, you can broadcast the transaction:
```rust
let txid_sent = rpc
@ -294,6 +287,8 @@ let txid_sent = rpc
println!("{:?}", txid_sent);
```
### Running Your Code
You can now run the complete code from the [src](src/17_5_main-sendtx.rs).
```