Skip to content

Rephrased some sections in the unit tests chapter #118

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
timothyparez wants to merge 4 commits into
base: master
Choose a base branch
from
+28 −13
Open

Rephrased some sections in the unit tests chapter #118

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
9282124
Rephrased some sections in the unit tests chapter
timothyparez Sep 29, 2018
6b132a5
Updates bitcoin_transfer/spend_your_coin.md
timothyparez Sep 29, 2018
367155e
Updates bitcoin_transfer/spend_your_coin.md
timothyparez Sep 29, 2018
b2ad729
Removed the extra characters the Gitbook editor added
timothyparez Sep 29, 2018
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
35 changes: 24 additions & 11 deletions bitcoin_transfer/spend_your_coin.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
## Spend your coin {#spend-your-coin}
## Spend your coin {\#spend-your-coin}

So now that you know what a **bitcoin address**, a **ScriptPubKey**, a **private key** and a **miner** are, you will make your first **transaction** by hand.

Expand All @@ -24,7 +24,7 @@ Console.WriteLine(address);

Note that we use the TestNet first, but you will probably do this on the MainNet as well, so you are going to spend real money! In any case, write down the **bitcoinPrivateKey** and the address! Send a few dollars of coins there and save the transaction ID \(you can find it in your wallet software or with a blockexplorer, like SmartBit for [MainNet](http://smartbit.com.au/) and [TestNet](https://testnet.smartbit.com.au/)).

Copy link
Copy Markdown
Collaborator

@NicolasDorier NicolasDorier Sep 29, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

\) ?

Copy link
Copy Markdown
Contributor Author

@timothyparez timothyparez Sep 29, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

So strange, if I edit the book using Gitbook editor it adds all kinds of characters to the document.
I did my previous edits with Visual studio code

Copy link
Copy Markdown
Contributor Author

@timothyparez timothyparez Sep 29, 2018

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let me fix it first :)

Import your private key (replace the "cN5Y...K2RS" string with yours):
Import your private key \(replace the "cN5Y...K2RS" string with yours\):

```cs
var bitcoinPrivateKey = new BitcoinSecret("cN5YQMWV8y19ntovbsZSaeBxXaVPaK4n7vapp4V56CKx5LhrK2RS");
Expand All @@ -35,7 +35,7 @@ Console.WriteLine(bitcoinPrivateKey); // cN5YQMWV8y19ntovbsZSaeBxXaVPaK4n7vapp4V
Console.WriteLine(address); // mkZzCmjAarnB31n5Ke6EZPbH64Cxexp3Jp
```

And finally get the transaction info (replace the "0acb...b78a" with the one you got from your wallet software or blockchain explorer after you sent the coins):
And finally get the transaction info \(replace the "0acb...b78a" with the one you got from your wallet software or blockchain explorer after you sent the coins\):

```cs
var client = new QBitNinjaClient(network);
Expand Down Expand Up @@ -84,10 +84,11 @@ Constructing the **TxIn** and adding it to the transaction is the answer to the
Constructing the **TxOut** and adding it to the transaction is the answer to the remaining ones.

> The donation address of this book is: [1KF8kUVHK42XzgcmJF4Lxz4wcL5WDL97PB](https://www.smartbit.com.au/address/1KF8kUVHK42XzgcmJF4Lxz4wcL5WDL97PB)
This money goes into Nicolas' "Coffee and Sushi Wallet" that will keep him fed and compliant while writing the rest of the book.
If you succeed in completing this challenge on the MainNet you will be able to find your contribution among the **Hall of the Makers** on [http://n.bitcoin.ninja/](http://n.bitcoin.ninja/) \(ordered by generosity\).
> This money goes into Nicolas' "Coffee and Sushi Wallet" that will keep him fed and compliant while writing the rest of the book.
> If you succeed in completing this challenge on the MainNet you will be able to find your contribution among the **Hall of the Makers** on [http://n.bitcoin.ninja/](http://n.bitcoin.ninja/) \(ordered by generosity\).

To get our MainNet address:

```cs
var hallOfTheMakersAddress = new BitcoinPubKeyAddress("1KF8kUVHK42XzgcmJF4Lxz4wcL5WDL97PB");
```
Expand All @@ -100,9 +101,9 @@ var hallOfTheMakersAddress = BitcoinAddress.Create("mzp4No5cmCXjZUpf112B1XWsvWBf

### How much?

Bitcoin has [several units to use](https://en.bitcoin.it/wiki/Units), but there are three you should know about: bitcoins, bits and satoshis. 1 bitcoin (BTC) is 1,000,000 bits and 100 satoshis are 1 bit. 1 satoshi (sat) is the smallest unit on the Bitcoin network.
Bitcoin has [several units to use](https://en.bitcoin.it/wiki/Units), but there are three you should know about: bitcoins, bits and satoshis. 1 bitcoin \(BTC\) is 1,000,000 bits and 100 satoshis are 1 bit. 1 satoshi \(sat\) is the smallest unit on the Bitcoin network.

If you want to send **0.0004 BTC** (a few dollars) from an **unspent output**, which holds **0.001 BTC**, you actually have to spend it all!
If you want to send **0.0004 BTC** \(a few dollars\) from an **unspent output**, which holds **0.001 BTC**, you actually have to spend it all!
As the diagram shows below, your **transaction output** specifies **0.0004 BTC** to [Hall of The Makers](http://n.bitcoin.ninja/) and **0.00053 BTC** back to you.
What happens to the remaining **0.00007 BTC**? This is the _miner fee_.
The miner fee incentivizes the miners to add this transaction into their next block. The higher the miner fee the more motivated the miner is to include your transaction in the next block, meaning that your transaction will be confirmed faster. If you set the miner fee to zero, your transaction might never be confirmed.
Expand All @@ -126,7 +127,7 @@ transaction.Outputs.Add(hallOfTheMakersTxOut);
transaction.Outputs.Add(changeBackTxOut);
```

We can do some fine tuning here, let's calculate the change based on the miner fee.
We can do some fine tuning here, let's calculate the change based on the miner fee.

```cs
// How much you want to spend
Expand Down Expand Up @@ -170,7 +171,7 @@ transaction.Outputs.Add(changeTxOut);
### Message on The Blockchain

Now add your personal feedback! This must be less than or equal to 80 bytes or your transaction will get rejected.
This message along with your transaction will appear \(after your transaction is confirmed\) in the [Hall of The Makers](http://n.bitcoin.ninja/)! :)
This message along with your transaction will appear \(after your transaction is confirmed\) in the [Hall of The Makers](http://n.bitcoin.ninja/)! :\)

```cs
var message = "Long live NBitcoin and its makers!";
Expand All @@ -183,6 +184,7 @@ transaction.Outputs.Add(new TxOut()
```

### Summary

To sum up, let's take a look at the whole transaction before we sign it:
We have 3 **TxOut**, 2 with **value**, 1 without **value** \(which contains the message\). You can notice the differences between the **scriptPubKey**s of the "normal" **TxOut**s and the **scriptPubKey** of the **TxOut** within the message:

Expand Down Expand Up @@ -225,7 +227,7 @@ Take a closer look at **TxIn**. We have **prev\_out** and **scriptSig** there.

Let's check out the **hash** of **prev\_out** in a TestNet blockexplorer: [prev\_out tx details](https://testnet.smartbit.com.au/tx/0acb6e97b228b838049ffbd528571c5e3edd003f0ca8ef61940166dc3081b78a). You can see that 0.001 BTC was transferred to our address.

In **prev\_out** **n** is 0. Since we are indexing from 0, this means that we want to spend the first output of the transaction (the second one is the 1.0989548 BTC change from the transaction).
In **prev\_out** **n** is 0. Since we are indexing from 0, this means that we want to spend the first output of the transaction \(the second one is the 1.0989548 BTC change from the transaction\).

### Sign your transaction

Expand All @@ -250,7 +252,18 @@ Then you need to provide your private key in order to sign the transaction:
```cs
transaction.Sign(bitcoinPrivateKey, false);
```
After this command the ScriptSig property of the input will be replaced by the signature, making the transaction signed.

---

_The IDE or compiler will most likely show you the following warning:_

> 'Transaction.Sign\(Key, bool\)' is obsolete: 'Use Sign\(Key,ICoin\[\]\) instead\)'

_For learning purposes it is ok to ignore the warning at this point. Later on in the book a better alternative will be shown._

---

After this command the ScriptSig property of the input will be replaced by the signature, making the transaction signed.

You can check out our TestNet transaction on the blockchain explorer [here](https://testnet.smartbit.com.au/tx/eeffd48b317e7afa626145dffc5a6e851f320aa8bb090b5cd78a9d2440245067).

Expand Down
6 changes: 4 additions & 2 deletions other_types_of_asset/unit_tests.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,11 @@
You can see that previously I hard coded the properties of **ColoredCoin**.
The reason is that I only wanted to show you how to construct a **Transaction** out of **ColoredCoin** coins.

In real life, you would either depend on a third party API to fetch the colored coins of a transaction or a balance. Which might not be a good idea, because it add a trust dependency to your program with the API provider.
In real life you could use a third party API to fetch the colored coins of a transaction or balance.
Keep in mind though that this adds a trust depenency with the API provider to your program.

**NBitcoin** allows you either to depend on a web service, either to provide your own implementation for fetching the color of a **Transaction**. This allows you to have a flexible way to unit test your code, use another implementation or your own.
**NBitcoin** allows you to either depend on a webservice or provide your own implementation to fetch the color of a transaction.
Providing your own implementation is useful to unit test your code.

Let’s introduce two issuers: Silver and Gold. And three participants: Bob, Alice and Satoshi.
Let’s create a fake transaction that gives some bitcoins to Silver, Gold and Satoshi.
Expand Down