arno/bitcoinbook
1
0
Fork 0
mirror of https://github.com/bitcoinbook/bitcoinbook synced 2025-05-30 04:38:48 +00:00
Code Issues Releases Wiki Activity

CH12-14: edits for Murchandamus feedback

Browse Source 
- Describe topological order to help readers understand how that solves
  the double spend problem

- Mention that transactions can be safely relayed one block before their
  locktime allows them to be included in a block because they'll be
  valid next block.

- Be a bit clearer about when subsidy becomes zero due to rounding and
  when BIP42 makes it zero unconditionally.

- Describe the creation of the witness merkle root before the block
  header merkle root

- Move up note about the retarget off-by-one bug

- Make "best blockchain" an inherent property and not an alias for a
  current chain.  When a new block arrives that triggers a reorg, we
  don't switch best blockchains---the new chain is the best blockchain
  and we switch to using it.

- Combine two sections about forks that were repetitive

- Mention that pool miners also need to prove they paid the pool's
  preferred coinbase transaction template

- Add a todo to clarify terminology around the 51% attack.  The existing
  text used this in a way that's consistent with how it was used in
  early Bitcoin history, but it's potentially confusing because it
  doesn't actually require a majority of hashrate to make the attack and
  it confuses it with a censorship attack that does require a majority
  (or at least a selfishing mining minority) to maintain.

- Reduce the situations we describe as "double spends". Consensus
  prevents double spending within a valid chain; the other situations
  are about unconfirmed transactions, which might better be described
  using other terms that won't confuse readers into thinking Bitcoin's
  double spend protection doesn't work.

- Add warning about backing up more than your seed when multisig or
  complex contracts are in use.

- Add a todo to fix "millibits" situation, which might involve image
  changes.

- Note that the first commitment transaction (the refund) needs to be
  signed before the funding transaction in LN channels.

- Pluralize "bitcoin" as necessary (somehow missed this before).

- Drop mention of tumblebit and teechan, which nobody is working on
  AFAIK.
This commit is contained in:
David A. Harding 2023-08-04 15:16:06 -10:00
parent b8933271ff
commit d9f6cf53c7
4 changed files with 259 additions and 270 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

380
ch10.asciidoc
View File

@ -37,6 +37,21 @@ new owners of bitcoin to know that irrevocable effort was expended
securing the bitcoin they received in those securing the bitcoin they received in those
transactions. transactions.
Additionally, transactions in the blockchain have a _topological order_
defined by their position in the block chain. One transaction is
earlier than another if it appears in an earlier block or if it appears
earlier in the same block. In the Bitcoin protocol, a transaction is
only valid if it spends the outputs of transactions that appeared
earlier in the blockchain (whether they are earlier in the same block or
in an earlier block), and only if no previous transaction spent any of
those same outputs. Within a single chain of blocks, the enforcement of
topological ordering ensure no two valid transactions can spend the same
output, eliminating the problem of _double spending_.
In some protocols built on top of Bitcoin, the topological order of
Bitcoin transactions is also used to establish a sequence of events;
we'll discuss that idea further in <<single_use_seals>>.
((("fees", "mining rewards")))((("mining and consensus", "mining rewards ((("fees", "mining rewards")))((("mining and consensus", "mining rewards
and fees")))((("Proof-of-Work algorithm")))((("mining and consensus", and fees")))((("Proof-of-Work algorithm")))((("mining and consensus",
"Proof-of-Work algorithm")))Miners receive two types of rewards in "Proof-of-Work algorithm")))Miners receive two types of rewards in
@ -54,8 +69,8 @@ Bitcoin's money supply is created in a process that's similar to how
a central bank issues new money by printing bank notes. The maximum a central bank issues new money by printing bank notes. The maximum
amount of newly created bitcoin a miner can add to a block decreases amount of newly created bitcoin a miner can add to a block decreases
approximately every four years (or precisely every 210,000 blocks). It approximately every four years (or precisely every 210,000 blocks). It
started at 50 bitcoin per block in January of 2009 and halved to 25 started at 50 bitcoins per block in January of 2009 and halved to 25
bitcoin per block in November of 2012. It halved again to 12.5 bitcoin bitcoins per block in November of 2012. It halved again to 12.5 bitcoins
in July 2016, and again to 6.25 in May 2020. Based on this formula, bitcoin mining rewards decrease in July 2016, and again to 6.25 in May 2020. Based on this formula, bitcoin mining rewards decrease
exponentially until approximately the year 2140, when all bitcoin exponentially until approximately the year 2140, when all bitcoin
will have been issued. After 2140, no new bitcoin will have been issued. After 2140, no new bitcoin
@ -169,7 +184,7 @@ deflationary spiral.
Bitcoin experts argue that deflation is not bad per se. Rather, Bitcoin experts argue that deflation is not bad per se. Rather,
deflation is associated with a collapse in demand because that is the deflation is associated with a collapse in demand because that is the
only example of deflation we have to study. In a fiat currency with the most obvious example of deflation we have to study. In a fiat currency with the
possibility of unlimited printing, it is very difficult to enter a possibility of unlimited printing, it is very difficult to enter a
deflationary spiral unless there is a complete collapse in demand and an deflationary spiral unless there is a complete collapse in demand and an
unwillingness to print money. Deflation in bitcoin is not caused by a unwillingness to print money. Deflation in bitcoin is not caused by a
@ -185,7 +200,7 @@ at the expense of savers.
It remains to be seen whether the deflationary aspect of the currency is It remains to be seen whether the deflationary aspect of the currency is
a problem when it is not driven by rapid economic retraction, or an a problem when it is not driven by rapid economic retraction, or an
advantage because the protection from inflation and debasement far advantage because the protection from inflation and debasement
outweighs the risks of deflation. outweighs the risks of deflation.
**** ****
@ -193,9 +208,9 @@ outweighs the risks of deflation.
((("mining and consensus", "decentralized consensus")))((("decentralized ((("mining and consensus", "decentralized consensus")))((("decentralized
systems", "consensus in")))In the previous chapter we looked at the systems", "consensus in")))In the previous chapter we looked at the
blockchain, the global public ledger (list) of all transactions, which blockchain, the global list of all transactions, which
everyone in the Bitcoin network accepts as the authoritative record of everyone in the Bitcoin network accepts as the authoritative record of
ownership. ownership transfers.
But how can everyone in the network agree on a single universal "truth" But how can everyone in the network agree on a single universal "truth"
about who owns what, without having to trust anyone? All traditional about who owns what, without having to trust anyone? All traditional
@ -249,7 +264,7 @@ trusted, public, global ledger.
((("mining and consensus", "independent transaction ((("mining and consensus", "independent transaction
verification")))((("transactions", "independent verification of")))In verification")))((("transactions", "independent verification of")))In
<<c_transactions>>, we saw how wallet software creates transactions by <<c_transactions>>, we saw how wallet software creates transactions by
collecting UTXO, providing the appropriate authentication data, and then collecting UTXOs, providing the appropriate authentication data, and then
constructing new outputs assigned to a new owner. The resulting constructing new outputs assigned to a new owner. The resulting
transaction is then sent to the neighboring nodes in the Bitcoin network transaction is then sent to the neighboring nodes in the Bitcoin network
so that it can be propagated across the entire Bitcoin network. so that it can be propagated across the entire Bitcoin network.
@ -267,8 +282,7 @@ criteria:
- Neither lists of inputs or outputs are empty. - Neither lists of inputs or outputs are empty.
- The transaction weight is less than the maximum block weight - The transaction weight is low enough to allow it to fit in a block.
limit.
- Each output value, as well as the total, must be within the allowed - Each output value, as well as the total, must be within the allowed
range of values (zero or more, but less than 21m coins). range of values (zero or more, but less than 21m coins).
@ -284,6 +298,9 @@ criteria:
- For each input, if the referenced output transaction is a coinbase - For each input, if the referenced output transaction is a coinbase
output, it must have at least +COINBASE_MATURITY+ (100) confirmations. output, it must have at least +COINBASE_MATURITY+ (100) confirmations.
Any absolute or relative locktime must also be satisified. Nodes may
relay transactions a block before they mature since they will be
mature if included in the next block.
- Reject if the sum of input values is less than sum of output values. - Reject if the sum of input values is less than sum of output values.
@ -302,12 +319,11 @@ _mempool_.
((("mining and consensus", "mining nodes")))((("Bitcoin nodes", "mining ((("mining and consensus", "mining nodes")))((("Bitcoin nodes", "mining
nodes")))Some of the nodes on the Bitcoin network are specialized nodes nodes")))Some of the nodes on the Bitcoin network are specialized nodes
called _miners_. In <<ch01_intro_what_is_bitcoin>> we introduced ((("use called _miners_. Jing is a computer
cases", "mining for bitcoin", id="jingten")))Jing, a computer
engineering student in Shanghai, China, who is a Bitcoin miner. Jing engineering student in Shanghai, China, who is a Bitcoin miner. Jing
earns bitcoin by running a "mining rig," which is a specialized earns bitcoin by running a "mining rig," which is a specialized
computer-hardware system designed to mine bitcoin. Jing's specialized computer-hardware system designed to mine bitcoin. Jing's specialized
mining hardware is connected to a server running a full Bitcoin node. mining hardware is connected to a server running a full node.
Unlike Jing, some miners mine without a full node, as we will see in Unlike Jing, some miners mine without a full node, as we will see in
<<mining_pools>>. Like every other full node, Jing's node receives and <<mining_pools>>. Like every other full node, Jing's node receives and
propagates unconfirmed transactions on the Bitcoin network. Jing's node, propagates unconfirmed transactions on the Bitcoin network. Jing's node,
@ -315,15 +331,15 @@ however, also aggregates these transactions into new blocks.
Jing's node is listening for new blocks, propagated on the Bitcoin Jing's node is listening for new blocks, propagated on the Bitcoin
network, as do all nodes. However, the arrival of a new block has network, as do all nodes. However, the arrival of a new block has
special significance for a mining node. Each round of competition among miners special significance for a mining node. Each round of mining
effectively ends with the propagation of a new block that acts as an effectively ends with the propagation of a new block that acts as an
announcement of a winner. To miners, receiving a valid new block means announcement of a winner. To miners, receiving a valid new block means
someone else won the competition and they lost. However, the end of one someone else won. However, the end of one
round of a competition is also the beginning of the next round. The new round is also the beginning of the next round. The new
block is block is
also the start of the competition for the next block. also the start of the search for the next block.
=== Aggregating Transactions into Blocks === Aggregating Unconfirmed Transactions into Blocks
((("mining and consensus", "aggregating transactions into blocks", ((("mining and consensus", "aggregating transactions into blocks",
id="MACaggreg10")))((("transactions", "aggregating into blocks", id="MACaggreg10")))((("transactions", "aggregating into blocks",
@ -334,24 +350,25 @@ validating transactions, a Bitcoin node will add them to the mempool
where transactions wait until they can be where transactions wait until they can be
included (mined) into a block. Jing's node collects, validates, and included (mined) into a block. Jing's node collects, validates, and
relays new transactions just like any other node. Unlike other nodes, relays new transactions just like any other node. Unlike other nodes,
however, Jing's node will then aggregate these transactions into a however, Jing's node will then aggregate these unconfirmed transactions into a
_candidate block_. _candidate block_.
Let's follow the blocks that were created during the time Alice made a Let's follow the blocks that were created during the time Alice made a
purchase from Bob (see <<spending_bitcoin>>). Alice's purchase from Bob (see <<spending_bitcoin>>). Alice's
transaction was included in a block. For the purpose of transaction was included in a block. For the purpose of
demonstrating the concepts in this chapter, let's assume that block was demonstrating the concepts in this chapter, let's assume that block was
mined by Jing's mining system and follows Alice's transaction as it mined by Jing's mining system and follow Alice's transaction as it
becomes part of this new block. becomes part of this new block.
Jing's mining node maintains a local copy of the blockchain. By the time Jing's mining node maintains a local copy of the blockchain. By the time
((("use cases", "buying coffee")))Alice buys the cup of coffee, Jing's ((("use cases", "buying coffee")))Alice buys something, Jing's
node has assembled the chain of blocks with the most proof-of-work. Jing's node is listening node is caught up with the chain of blocks with the most proof-of-work.
Jing's node is listening
for transactions, trying to mine a new block and also listening for for transactions, trying to mine a new block and also listening for
blocks discovered by other nodes. As Jing's node is mining, it receives blocks discovered by other nodes. As Jing's node is mining, it receives
a new block through the Bitcoin network. The arrival of this block a new block through the Bitcoin network. The arrival of this block
signifies the end of the competition for that block and the beginning signifies the end of the search for that block and the beginning
of the competition to create the next block. of the search to create the next block.
During the previous several minutes, while Jing's node was searching for a During the previous several minutes, while Jing's node was searching for a
solution to the previous block, it was also collecting transactions in solution to the previous block, it was also collecting transactions in
@ -370,16 +387,15 @@ proof-of-work. The block becomes valid only if the miner succeeds in
finding a solution according to the proof-of-work algorithm. finding a solution according to the proof-of-work algorithm.
When Jing's node aggregates all the transactions from the memory pool, When Jing's node aggregates all the transactions from the memory pool,
the new candidate block has several thousand transactions that pays him the new candidate block has several thousand transactions that each pay
their total transaction fees. transaction fees he'll attempt to claim.
==== The Coinbase Transaction ==== The Coinbase Transaction
((("coinbase transactions", id="coinbtrans10")))((("transactions", ((("coinbase transactions", id="coinbtrans10")))((("transactions",
"coinbase transactions", id="Tcoinb10")))The first transaction in any "coinbase transactions", id="Tcoinb10")))The first transaction in any
block is a special transaction, called a _coinbase transaction_. This block is a special transaction, called a _coinbase transaction_. This
transaction is constructed by Jing's node and contains his _reward_ for transaction is constructed by Jing's node and pays out his _reward_ for
the mining effort. the mining effort.
Jing's node creates the coinbase transaction as a payment to his own Jing's node creates the coinbase transaction as a payment to his own
@ -389,8 +405,8 @@ reward (6.25 new bitcoin in 2023) and the transaction fees from all
the transactions included in the block. the transactions included in the block.
Unlike regular transactions, the coinbase transaction does not consume Unlike regular transactions, the coinbase transaction does not consume
(spend) UTXO as inputs. Instead, it has only one input, called the (spend) UTXOs as inputs. Instead, it has only one input, called the
_coinbase_, which creates bitcoin from nothing. The coinbase transaction _coinbase input_, which creates bitcoin from nothing. The coinbase transaction
must have at least one output and may have as many outputs as will fit must have at least one output and may have as many outputs as will fit
in the block. It's common for coinbase transactions in 2023 to have two in the block. It's common for coinbase transactions in 2023 to have two
outputs: one of these is a zero-value output that uses +OP_RETURN+ to outputs: one of these is a zero-value output that uses +OP_RETURN+ to
@ -403,8 +419,7 @@ reward.
((("coinbase transactions", "rewards and fees")))((("fees", "transaction ((("coinbase transactions", "rewards and fees")))((("fees", "transaction
fees")))((("mining and consensus", "rewards and fees")))To construct the fees")))((("mining and consensus", "rewards and fees")))To construct the
coinbase transaction, Jing's node first calculates the total amount of coinbase transaction, Jing's node first calculates the total amount of
transaction fees by adding all the inputs and outputs of the transaction fees:
transactions that were added to the block. The fees are calculated as:
---- ----
Total Fees = Sum(Inputs) - Sum(Outputs) Total Fees = Sum(Inputs) - Sum(Outputs)
@ -446,14 +461,12 @@ The initial subsidy is calculated in satoshis by multiplying 50 with the
that have occurred by dividing the current block height by the halving that have occurred by dividing the current block height by the halving
interval (+SubsidyHalvingInterval+). interval (+SubsidyHalvingInterval+).
The maximum number of halvings allowed is 64, so the code imposes a zero
reward (returns only the fees) if the 64 halvings is exceeded.
Next, the function uses the binary-right-shift operator to divide the Next, the function uses the binary-right-shift operator to divide the
reward (+nSubsidy+) by two for each round of halving. In the case of reward (+nSubsidy+) by two for each round of halving. In the case of
block 277,316, this would binary-right-shift the reward of 5 billion block 277,316, this would binary-right-shift the reward of 5 billion
satoshis once (one halving) and result in 2.5 billion satoshis, or 25 satoshis once (one halving) and result in 2.5 billion satoshis, or 25
bitcoins. The binary-right-shift operator is used because it is more bitcoins. After the 33rd halving, the subsidy will be rounded down to
zero. The binary-right-shift operator is used because it is more
efficient than multiple repeated divisions. To avoid a potential bug, efficient than multiple repeated divisions. To avoid a potential bug,
the shift operation is skipped after 63 halvings, and the subsidy is set the shift operation is skipped after 63 halvings, and the subsidy is set
to 0. to 0.
@ -465,7 +478,7 @@ fees (+nFees+), and the sum is returned.
==== ====
If Jing's mining node writes the coinbase transaction, what stops Jing If Jing's mining node writes the coinbase transaction, what stops Jing
from "rewarding" himself 100 or 1000 bitcoin? The answer is that an from "rewarding" himself 100 or 1000 bitcoin? The answer is that an
incorrect reward would result in the block being deemed invalid by inflated reward would result in the block being deemed invalid by
everyone else, wasting Jing's electricity used for Proof-of-Work. Jing everyone else, wasting Jing's electricity used for Proof-of-Work. Jing
only gets to spend the reward if the block is accepted by everyone. only gets to spend the reward if the block is accepted by everyone.
==== ====
@ -491,8 +504,8 @@ structure of the coinbase transaction's input.
|Size| Field | Description |Size| Field | Description
| 32 bytes | Transaction Hash | Pointer to the transaction containing the UTXO to be spent | 32 bytes | Transaction Hash | Pointer to the transaction containing the UTXO to be spent
| 4 bytes | Output Index | The index number of the UTXO to be spent, first one is 0 | 4 bytes | Output Index | The index number of the UTXO to be spent, first one is 0
| 1&#x2013;9 bytes (VarInt) | Script Size | Script length in bytes, to follow | 1&#x2013;9 bytes (compactSize) | Script Size | Script length in bytes, to follow
| Variable | Input script | A script that fulfills the conditions of the UTXO output script | Variable | Input Script | A script that fulfills the conditions of the UTXO output script
| 4 bytes | Sequence Number | Multipurpose field used for BIP68 time locks and transaction replacement signaling | 4 bytes | Sequence Number | Multipurpose field used for BIP68 time locks and transaction replacement signaling
|======= |=======
@ -528,13 +541,14 @@ be used by miners in any way they want; it is arbitrary data.
(the)", "genesis block")))((("genesis block")))In the genesis block, for (the)", "genesis block")))((("genesis block")))In the genesis block, for
example, Satoshi Nakamoto added the text "The Times 03/Jan/2009 example, Satoshi Nakamoto added the text "The Times 03/Jan/2009
Chancellor on brink of second bailout for banks" in the coinbase data, Chancellor on brink of second bailout for banks" in the coinbase data,
using it as a proof of the date and to convey a message. Currently, using it as a proof of the earliest date this block chould have been
created and to convey a message. Currently,
miners often use the coinbase data to include extra nonce values and strings miners often use the coinbase data to include extra nonce values and strings
identifying the mining pool. identifying the mining pool.
The first few bytes of the coinbase used to be arbitrary, but that is no The first few bytes of the coinbase used to be arbitrary, but that is no
longer the case. As per BIP34, version-2 blocks (blocks with the longer the case. As per BIP34, version-2 blocks (blocks with the
version field set to 2 or higher) must contain the block height index as a script version field set to 2 or higher) must contain the block height as a script
"push" operation in the beginning of the coinbase field. "push" operation in the beginning of the coinbase field.
<<satoshi_words>> uses the libbitcoin library introduced in <<satoshi_words>> uses the libbitcoin library introduced in
@ -585,7 +599,7 @@ as listed in <<block_header_structure_ch10>>.
|Size| Field | Description |Size| Field | Description
| 4 bytes | Version | A multipurpose bitfield | 4 bytes | Version | A multipurpose bitfield
| 32 bytes | Previous Block Hash | A reference to the hash of the previous (parent) block in the chain | 32 bytes | Previous Block Hash | A reference to the hash of the previous (parent) block in the chain
| 32 bytes | Merkle Root | A hash of the root of the merkle tree of this block's transactions | 32 bytes | Merkle Root | A hash that is the root of the merkle tree of this block's transactions
| 4 bytes | Timestamp | The approximate creation time of this block (seconds from Unix Epoch) | 4 bytes | Timestamp | The approximate creation time of this block (seconds from Unix Epoch)
| 4 bytes | Target | The Proof-of-Work algorithm target for this block | 4 bytes | Target | The Proof-of-Work algorithm target for this block
| 4 bytes | Nonce | A counter used for the Proof-of-Work algorithm | 4 bytes | Nonce | A counter used for the Proof-of-Work algorithm
@ -621,30 +635,35 @@ selected as the _parent_ of his candidate block.
==== ====
By selecting the specific _parent_ block, indicated by the Previous By selecting the specific _parent_ block, indicated by the Previous
Block Hash field in the candidate block header, Jing is committing his Block Hash field in the candidate block header, Jing is committing his
mining power to extending the chain that ends in that specific block. In mining power to extending the chain that ends in that specific block.
essence, this is how Jing "votes" with his mining power for the
longest-difficulty valid chain.
==== ====
((("merkle trees")))((("blockchain (the)", "merkle trees")))The next ((("merkle trees")))((("blockchain (the)", "merkle trees")))The next
step is to summarize all the transactions with a merkle tree, in order step is to commit to all the transactions using merkle trees. Each
to add the merkle root to the block header. The coinbase transaction is transaction is listed using its witness transaction identifier (_wtxid_)
listed as the first transaction in the block. Then, the user-generated in topographical order, with 32 0x00 bytes standing in for the wtxid of
transactions are added after it. the first transaction (the coinbase). As we saw in the <<merkle_trees>>
As we saw in the <<merkle_trees>>, there must be an even number the last wtxid is duplicated if there are an odd number of wtxids,
of "leaf" nodes in the tree, so the last transaction is duplicated if creating nodes that each containing the hash of one transaction. The
necessary, creating nodes that each containing the hash of one transaction. The
transaction hashes are then combined, in pairs, creating each level of transaction hashes are then combined, in pairs, creating each level of
the tree, until all the transactions are summarized into one node at the the tree, until all the transactions are summarized into one node at the
"root" of the tree. The root of the merkle tree summarizes all the "root" of the tree. The root of the merkle tree summarizes all the
transactions into a single 32-byte value, which is the transactions into a single 32-byte value, which is the _witness root
"merkle root". hash_.
The witness root hash is added to an output of the coinbase transaction.
This step may be skipped in none of the transactions in the blook are
required to contain a witness structure. Each transaction (including
the coinbase transaction) is then listed using its transaction
identifier (_txid_) and used to build a second merkle tree, the root of
which becomes the merkle root to which the block header commits.
Jing's mining node will then add a 4-byte timestamp, encoded as a Unix Jing's mining node will then add a 4-byte timestamp, encoded as a Unix
"epoch" timestamp, which is based on the number of seconds elapsed from "epoch" timestamp, which is based on the number of seconds elapsed from
January 1, 1970, midnight UTC/GMT. January 1, 1970, midnight UTC/GMT.
Jing's node then fills in the target, which defines the required Jing's node then fills in the nBits target, which must be set to a
compact representation of the required
Proof-of-Work to make this a valid block. The target is stored in the Proof-of-Work to make this a valid block. The target is stored in the
block as a "target bits" metric, which is a mantissa-exponent encoding block as a "target bits" metric, which is a mantissa-exponent encoding
of the target. The encoding has a 1-byte exponent, followed by a 3-byte of the target. The encoding has a 1-byte exponent, followed by a 3-byte
@ -656,11 +675,11 @@ is explained in <<target_bits>>.
The final field is the nonce, which is initialized to zero. The final field is the nonce, which is initialized to zero.
With all the other fields filled, the block header is now complete and With all the other fields filled, the header of the candidate block is now complete and
the process of mining can begin. The goal is now to find a value for the the process of mining can begin. The goal is now to find a header
nonce that results in a block header hash that is less than the target. that results in its hash that is less than the target.
The mining node will need to test billions or trillions of nonce values The mining node will need to test billions or trillions of variations of
before a nonce is found that satisfies the requirement. the header before a version is found that satisfies the requirement.
=== Mining the Block === Mining the Block
@ -673,7 +692,7 @@ various aspects of the Bitcoin system. The hash function SHA256 is the
function used in Bitcoin's mining process.((("", startref="jingten"))) function used in Bitcoin's mining process.((("", startref="jingten")))
((("mining and consensus", "defined")))In the simplest terms, mining is ((("mining and consensus", "defined")))In the simplest terms, mining is
the process of hashing the block header repeatedly, changing one the process of hashing the candidate block header repeatedly, changing one
parameter, until the resulting hash matches a specific target. The hash parameter, until the resulting hash matches a specific target. The hash
function's result cannot be determined in advance, nor can a pattern be function's result cannot be determined in advance, nor can a pattern be
created that will produce a specific hash value. This feature of hash created that will produce a specific hash value. This feature of hash
@ -750,7 +769,7 @@ again an easy task. Let's say a few rounds later the target is down to
5. Now, more than half the dice throws will exceed the target and 5. Now, more than half the dice throws will exceed the target and
therefore be invalid. It takes exponentially more dice throws to win, therefore be invalid. It takes exponentially more dice throws to win,
the lower the target gets. Eventually, when the target is 2 (the minimum the lower the target gets. Eventually, when the target is 2 (the minimum
possible), only one throw out of every 36, or 2% of them, will produce a possible), only one throw out of every 36, or about 3% of them, will produce a
winning result. winning result.
From the perspective of an observer who knows that the target of the From the perspective of an observer who knows that the target of the
@ -892,6 +911,8 @@ second, it still requires 10 minutes on a laptop to find this solution.
[[target_bits]] [[target_bits]]
==== Target Representation ==== Target Representation
//TODO:use visual representation like I did on bitcoin.org
((("mining and consensus", "mining the block", "target ((("mining and consensus", "mining the block", "target
representation")))((("targets", id="targets10"))) representation")))((("targets", id="targets10")))
Block headers contain the target in a notation called "target Block headers contain the target in a notation called "target
@ -970,10 +991,8 @@ current mining power will result in a 10-minute block interval.
How, then, is such an adjustment made in a completely decentralized How, then, is such an adjustment made in a completely decentralized
network? Retargeting occurs automatically and on every node network? Retargeting occurs automatically and on every node
independently. Every 2,016 blocks, all nodes retarget the Proof-of-Work. independently. Every 2,016 blocks, all nodes retarget the Proof-of-Work.
The equation for retargeting measures the time it took to find the last The ratio between the actual timespan and desired timespan of ten
2,016 blocks and compares that to the expected time of 20,160 minutes minutes per block is calculated and a
(2,016 blocks times the desired 10-minute block interval). The ratio
between the actual timespan and desired timespan is calculated and a
proportionate adjustment (up or down) is made to the target. In simple proportionate adjustment (up or down) is made to the target. In simple
terms: If the network is finding blocks faster than every 10 minutes, terms: If the network is finding blocks faster than every 10 minutes,
the difficulty increases (target decreases). If block discovery is the difficulty increases (target decreases). If block discovery is
@ -982,9 +1001,17 @@ slower than expected, the difficulty decreases (target increases).
The equation can be summarized as: The equation can be summarized as:
---- ----
New Target = Old Target * (Actual Time of Last 2016 Blocks / 20160 minutes) New Target = Old Target * (20,160 minutes / Actual Time of Last 2015 Blocks)
---- ----
[NOTE]
====
While the target calibration happens every 2,016 blocks, because of an
off-by-one error in the original Bitcoin software it is based on the
total time of the previous 2,015 blocks (not 2,016 as it should be),
resulting in a retargeting bias toward higher difficulty by 0.05%.
====
<<retarget_code>> shows the code used in the Bitcoin Core client. <<retarget_code>> shows the code used in the Bitcoin Core client.
[[retarget_code]] [[retarget_code]]
@ -1016,14 +1043,6 @@ New Target = Old Target * (Actual Time of Last 2016 Blocks / 20160 minutes)
---- ----
==== ====
[NOTE]
====
While the target calibration happens every 2,016 blocks, because of an
off-by-one error in the original Bitcoin Core client it is based on the
total time of the previous 2,015 blocks (not 2,016 as it should be),
resulting in a retargeting bias toward higher difficulty by 0.05%.
====
The parameters +Interval+ (2,016 blocks) and +TargetTimespan+ (two weeks The parameters +Interval+ (2,016 blocks) and +TargetTimespan+ (two weeks
as 1,209,600 seconds) are defined in _chainparams.cpp_. as 1,209,600 seconds) are defined in _chainparams.cpp_.
@ -1050,7 +1069,7 @@ therefore electricity expended to secure bitcoin is also entirely
independent of the number of transactions. Bitcoin can scale up independent of the number of transactions. Bitcoin can scale up
and remain secure without any increase in hashing and remain secure without any increase in hashing
power from today's level. The increase in hashing power represents power from today's level. The increase in hashing power represents
market forces as new miners enter the market to compete for the reward. market forces as new miners enter the market.
As long as enough hashing power is under the control of miners acting As long as enough hashing power is under the control of miners acting
honestly in pursuit of the reward, it is enough to prevent "takeover" honestly in pursuit of the reward, it is enough to prevent "takeover"
attacks and, therefore, it is enough to secure bitcoin. attacks and, therefore, it is enough to secure bitcoin.
@ -1126,11 +1145,12 @@ completion")))((("use cases", "mining for bitcoin", id="jingtentwo")))As
we saw earlier, Jing's node has constructed a candidate block and we saw earlier, Jing's node has constructed a candidate block and
prepared it for mining. Jing has several hardware mining rigs with prepared it for mining. Jing has several hardware mining rigs with
application-specific integrated circuits, where hundreds of thousands of application-specific integrated circuits, where hundreds of thousands of
integrated circuits run the SHA256 algorithm in parallel at incredible integrated circuits run Bitcoin's double SHA256 algorithm in parallel at incredible
speeds. Many of these specialized machines are connected to his mining speeds. Many of these specialized machines are connected to his mining
node over USB or a local area network. Next, the mining node running on node over USB or a local area network. Next, the mining node running on
Jing's desktop transmits the block header to his mining hardware, which Jing's desktop transmits the block header to his mining hardware, which
starts testing trillions of nonces per second. Because the nonce is only starts testing trillions of variations of the header per second. Because
the nonce is only
32 bits, after exhausting all the nonce possibilities (about 4 billion), 32 bits, after exhausting all the nonce possibilities (about 4 billion),
the mining hardware changes the block header (adjusting the coinbase the mining hardware changes the block header (adjusting the coinbase
extra nonce space, versionbits, or timestamp) and resets the nonce counter, testing extra nonce space, versionbits, or timestamp) and resets the nonce counter, testing
@ -1139,8 +1159,6 @@ new combinations.
Almost 11 minutes after starting to mine a particular block, one of the Almost 11 minutes after starting to mine a particular block, one of the
hardware mining machines finds a solution and sends it back to the hardware mining machines finds a solution and sends it back to the
mining node. mining node.
When inserted into the block header, the nonce produces a block hash
which is less than the target.
Immediately, Jing's mining node transmits the block to all its peers. Immediately, Jing's mining node transmits the block to all its peers.
They receive, validate, and then propagate the new block. As the block They receive, validate, and then propagate the new block. As the block
@ -1150,11 +1168,11 @@ nodes receive and validate the block, they abandon their efforts to find
a block at the same height and immediately start computing the next a block at the same height and immediately start computing the next
block in the chain, using Jing's block as the "parent." By building on block in the chain, using Jing's block as the "parent." By building on
top of Jing's newly discovered block, the other miners are essentially top of Jing's newly discovered block, the other miners are essentially
"voting" with their mining power and endorsing Jing's block and the using their mining power to endorse Jing's block and the
chain it extends. chain it extends.
In the next section, we'll look at the process each node uses to In the next section, we'll look at the process each node uses to
validate a block and select the longest chain, creating the consensus validate a block and select the most-work chain, creating the consensus
that forms the decentralized blockchain.((("", that forms the decentralized blockchain.((("",
startref="MACmining10")))((("", startref="jingtentwo"))) startref="MACmining10")))((("", startref="jingtentwo")))
@ -1165,12 +1183,12 @@ block validation")))((("validation")))The third step in Bitcoin's
consensus mechanism is independent validation of each new block by every consensus mechanism is independent validation of each new block by every
node on the network. As the newly solved block moves across the network, node on the network. As the newly solved block moves across the network,
each node performs a series of tests to validate it. each node performs a series of tests to validate it.
The independent validation also ensures that miners who act The independent validation also ensures that only blocks that follow the
honestly get their blocks incorporated in the blockchain, thus earning consensus rules are incorporated in the blockchain, thus earning
the reward. Those miners who act dishonestly have their blocks rejected their miners the reward. Blocks that violate the rules are rejected
and not only lose the reward, but also waste the effort expended to find and not only lose their miners the reward, but also waste the effort expended to find
a Proof-of-Work solution, thus incurring all of the costs of creating a a Proof-of-Work solution, thus incurring upon those miners all of the costs of creating a
block but receiving none of the rewards. block but giving them none of the rewards.
When a node receives a new block, it will validate the block by checking When a node receives a new block, it will validate the block by checking
it against a long list of criteria that must all be met; otherwise, the it against a long list of criteria that must all be met; otherwise, the
@ -1182,10 +1200,10 @@ in the functions +CheckBlock+ and +CheckBlockHeader+ and include:
- The block header hash is less than the target (enforces the - The block header hash is less than the target (enforces the
Proof-of-Work) Proof-of-Work)
- The block timestamp is less than two hours in the future (allowing for - The block timestamp is between the Median Time Past (MTP) and two
time errors) hours in the future (allowing for time errors)
- The block size is within acceptable limits - The block weight is within acceptable limits
- The first transaction (and only the first) is a coinbase transaction - The first transaction (and only the first) is a coinbase transaction
@ -1201,36 +1219,30 @@ instead of the correct reward? Because every node validates blocks
according to the same rules. An invalid coinbase transaction would make according to the same rules. An invalid coinbase transaction would make
the entire block invalid, which would result in the block being rejected the entire block invalid, which would result in the block being rejected
and, therefore, that transaction would never become part of the ledger. and, therefore, that transaction would never become part of the ledger.
The miners have to construct a perfect block, based on the shared rules The miners have to construct a block, based on the shared rules
that all nodes follow, and mine it with a correct solution to the that all nodes follow, and mine it with a correct solution to the
Proof-of-Work. To do so, they expend a lot of electricity in mining, and Proof-of-Work. To do so, they expend a lot of electricity in mining, and
if they cheat, all the electricity and effort is wasted. This is why if they cheat, all the electricity and effort is wasted. This is why
independent validation is a key component of decentralized consensus. independent validation is a key component of decentralized consensus.
//FIXME:normalize terminology between "block-finding race", "mining
//race", and "forks"
[[forks]]
=== Assembling and Selecting Chains of Blocks === Assembling and Selecting Chains of Blocks
((("mining and consensus", "assembling and selecting chains of blocks", ((("mining and consensus", "assembling and selecting chains of blocks",
id="MACassembling10")))((("blocks", "assembling and selecting chains id="MACassembling10")))((("blocks", "assembling and selecting chains
of", id="Bassemble10")))The final step in Bitcoin's decentralized of", id="Bassemble10")))The final part in Bitcoin's decentralized
consensus mechanism is the assembly of blocks into chains and the consensus mechanism is the assembly of blocks into chains and the
selection of the chain with the most Proof-of-Work. Once a node has selection of the chain with the most Proof-of-Work.
validated a new block, it will then attempt to assemble a chain by
connecting the block to the existing blockchain.
Nodes maintain three sets of blocks: those connected to the best A _best blockchain_ is whichever valid chain of blocks has
blockchain and those that form branches off the best blockchain (stale the most cumulative Proof-of-Work associated with it.
blocks). Invalid blocks are rejected as soon as any one The
of the validation criteria fails and are therefore not included in any
chain.
The "best blockchain" at any time is whichever _valid_ chain of blocks has
the most cumulative Proof-of-Work associated with it. Under most
circumstances this is also the chain with the most blocks in it, unless
there are two equal-length chains and one has more Proof-of-Work. The
best chain will also have branches with blocks that are "siblings" to best chain will also have branches with blocks that are "siblings" to
the blocks on the best chain. These blocks are valid but not part of the the blocks on the best chain. These blocks are valid but not part of the
best chain. They are kept for future reference, in case one of those best chain. They are kept for future reference, in case one of those
chains is extended to exceed the best chain in work. In the next section chains is extended and becomes the new best chain. In the next section
(<<forks>>), we will see how secondary chains occur as a result of an (<<forks>>), we will see how secondary chains occur as a result of an
almost simultaneous mining of blocks at the same height. almost simultaneous mining of blocks at the same height.
@ -1241,47 +1253,18 @@ node will attempt to find that parent in the existing blockchain. Most
of the time, the parent will be the "tip" of the best chain, meaning of the time, the parent will be the "tip" of the best chain, meaning
this new block extends the best chain. this new block extends the best chain.
Sometimes, as we will see in <<forks>>, the new block extends a chain Sometimes, as we will see in <<forks>>, the new block does not extend
that is not the best chain. In that case, the node will attach the new the best chain. In that case, the node will attach the new block to a
block to the secondary chain it extends and then compare the work of the secondary chain and then compare the work of the secondary chain to the
secondary chain to the best chain. If the secondary chain has more previous best chain. If the secondary chain is now the best chain, the
cumulative work than the best chain, the node will _reorganize_ its node will accordingly _reorganize_ its view of confirmed transactions
chain to use the secondary chain, meaning it will select the secondary chain as its new and available UTXOs. If the node is a miner, it will now construct a
best chain, making the old best chain a secondary chain. If the node is candidate block extending this new, more-Proof of Work, chain.
a miner, it will now construct a candidate block extending this new, more-Proof of Work,
chain.
By selecting the greatest-cumulative-work valid chain, all nodes By selecting the greatest-cumulative-work valid chain, all nodes
eventually achieve network-wide consensus. Temporary discrepancies eventually achieve network-wide consensus. Temporary discrepancies
between chains are resolved eventually as more work is added, extending between chains are resolved eventually as more work is added, extending
one of the possible chains. Mining nodes "vote" with their mining power one of the possible chains.
by choosing which chain to extend by mining the next block. When they
mine a new block and extend the chain, the new block itself represents
their vote.
In the next section we will look at how discrepancies between competing
chains (forks) are resolved by the independent selection of the
greatest-cumulative-work chain.
[[forks]]
==== Blockchain Forks
((("mining and consensus", "assembling and selecting chains of blocks",
"blockchain forks")))((("blockchain (the)", "blockchain forks",
id="BCTfork10")))((("forks", "blockchain fork events",
id="forks10")))Because the blockchain is a decentralized data structure,
different copies of it are not always consistent. Blocks might arrive at
different nodes at different times, causing the nodes to have different
perspectives of the blockchain. To resolve this, each node always
selects and attempts to extend the valid chain of blocks that contains the
most Proof-of-Work, also known as the _best blockchain_.
By summing the work recorded in each block in a
chain, a node can calculate the total amount of work that has been
expended to create that chain. As long as all nodes select the
greatest-cumulative-work chain, the global Bitcoin network eventually
converges to a consistent state. Forks occur as temporary
inconsistencies between versions of the blockchain, which are resolved
by eventual reorganization as more blocks are added to one of the forks.
[TIP] [TIP]
==== ====
@ -1297,9 +1280,7 @@ as different shapes (star, triangle, upside-down triangle, rhombus),
spreading across the network. Each node in the network is represented as spreading across the network. Each node in the network is represented as
a circle. a circle.
Each node has its own perspective of the global blockchain. As each node For
receives blocks from its neighbors, it updates its own copy of the
blockchain, selecting the greatest-cumulative-work chain. For
illustration purposes, each node contains a shape that represents the illustration purposes, each node contains a shape that represents the
block that it believes is currently the tip of the best chain. So, if block that it believes is currently the tip of the best chain. So, if
you see a star shape in the node, that means that the star block is the you see a star shape in the node, that means that the star block is the
@ -1313,20 +1294,6 @@ of the blockchain, with the star block as the tip of the best chain.
.Before the fork&#x2014;all nodes have the same perspective .Before the fork&#x2014;all nodes have the same perspective
image::images/mbc2_1002.png["Before the fork - all nodes have the same perspective"] image::images/mbc2_1002.png["Before the fork - all nodes have the same perspective"]
A "fork" occurs whenever there are two valid blocks competing to
form the longest blockchain. This occurs under normal conditions
whenever two miners solve the Proof-of-Work algorithm within a short
period of time from each other. As both miners discover a solution for
their respective candidate blocks, they immediately broadcast their own
"winning" block to their immediate neighbors who begin propagating the
block across the network. Each node that receives a valid block will
incorporate it into its blockchain, extending the blockchain by one
block. If that node later sees another candidate block extending the
same parent, it connects the second candidate on a secondary chain. As a
result, some nodes will "see" one candidate block first, while other
nodes will see the other candidate block and two competing versions of
the blockchain will emerge.
In <<fork2>>, we see two miners (Node X and Node Y) who mine two In <<fork2>>, we see two miners (Node X and Node Y) who mine two
different blocks almost simultaneously. Both of these blocks are different blocks almost simultaneously. Both of these blocks are
children of the star block, and extend the chain by building on top of children of the star block, and extend the chain by building on top of
@ -1357,6 +1324,8 @@ and some receive block "upside-down triangle" first. As shown in
blockchain; one side topped with a triangle block, the other with the blockchain; one side topped with a triangle block, the other with the
upside-down-triangle block. upside-down-triangle block.
//FIXME:node X won't receive upside down triangle because it's not
//connected to a peer with that block. Same problem for Node Y
[[fork3]] [[fork3]]
[role="smallersixty"] [role="smallersixty"]
.Visualization of a blockchain fork event: two blocks propagate, splitting the network .Visualization of a blockchain fork event: two blocks propagate, splitting the network
@ -1386,8 +1355,7 @@ these two competing chains are extended by additional work.
Mining nodes whose perspective resembles Node X will immediately begin Mining nodes whose perspective resembles Node X will immediately begin
mining a candidate block that extends the chain with "triangle" as its mining a candidate block that extends the chain with "triangle" as its
tip. By linking "triangle" as the parent of their candidate block, they tip. By linking "triangle" as the parent of their candidate block, they
are voting with their hashing power. Their vote supports the chain that are using their hashing power to build on that chain.
they have elected as the best chain.
Any mining node whose perspective resembles Node Y will start building a Any mining node whose perspective resembles Node Y will start building a
candidate node with "upside-down triangle" as its parent, extending the candidate node with "upside-down triangle" as its parent, extending the
@ -1414,7 +1382,7 @@ All nodes that had chosen "triangle" as the winner in the previous round
will simply extend the chain one more block. The nodes that chose will simply extend the chain one more block. The nodes that chose
"upside-down triangle" as the winner, however, will now see two chains: "upside-down triangle" as the winner, however, will now see two chains:
star-triangle-rhombus and star-upside-down-triangle. The chain star-triangle-rhombus and star-upside-down-triangle. The chain
star-triangle-rhombus is now longer (more cumulative work) than the star-triangle-rhombus now has more cumulative work than the
other chain. As a result, those nodes will set the chain other chain. As a result, those nodes will set the chain
star-triangle-rhombus as the best chain and change the star-triangle-rhombus as the best chain and change the
star-upside-down-triangle chain to a secondary chain, as shown in star-upside-down-triangle chain to a secondary chain, as shown in
@ -1422,7 +1390,7 @@ star-upside-down-triangle chain to a secondary chain, as shown in
to revise their view of the blockchain to incorporate the new evidence to revise their view of the blockchain to incorporate the new evidence
of a longer chain. Any miners working on extending the chain of a longer chain. Any miners working on extending the chain
star-upside-down-triangle will now stop that work because their star-upside-down-triangle will now stop that work because their
candidate block is "stale," as its parent "upside-down-triangle" is block is "stale," as its parent "upside-down-triangle" is
no longer on the best chain. The transactions within no longer on the best chain. The transactions within
"upside-down-triangle" that are not within "triangle" are re-inserted in "upside-down-triangle" that are not within "triangle" are re-inserted in
the mempool for inclusion in the next block to become a part of the best the mempool for inclusion in the next block to become a part of the best
@ -1468,7 +1436,7 @@ wait for three blocks, over a system with 10-minute blocks.
startref="Bassemble10")))((("", startref="MACassembling10")))((("", startref="Bassemble10")))((("", startref="MACassembling10")))((("",
startref="forks10")))((("", startref="BCTfork10"))) startref="forks10")))((("", startref="BCTfork10")))
=== Mining and the Hashing Competition === Mining and the Hash Lottery
((("mining and consensus", "hashing power race", ((("mining and consensus", "hashing power race",
id="MAChash10")))Bitcoin mining is an extremely competitive industry. id="MAChash10")))Bitcoin mining is an extremely competitive industry.
@ -1477,7 +1445,7 @@ existence. Some years the growth has reflected a complete change of
technology, such as in 2010 and 2011 when many miners switched from technology, such as in 2010 and 2011 when many miners switched from
using CPU mining to GPU mining and field programmable gate array (FPGA) using CPU mining to GPU mining and field programmable gate array (FPGA)
mining. In 2013 the introduction of ASIC mining lead to another giant mining. In 2013 the introduction of ASIC mining lead to another giant
leap in mining power, by placing the SHA256 function directly on silicon leap in mining power, by placing the double-SHA256 function directly on silicon
chips specialized for the purpose of mining. The first such chips could chips specialized for the purpose of mining. The first such chips could
deliver more mining power in a single box than the entire Bitcoin deliver more mining power in a single box than the entire Bitcoin
network in 2010. network in 2010.
@ -1487,9 +1455,7 @@ leaps left in Bitcoin mining equipment,
because the industry has reached the forefront of Moore's Law, which because the industry has reached the forefront of Moore's Law, which
stipulates that computing density will double approximately every 18 stipulates that computing density will double approximately every 18
months. Still, the mining power of the network continues to advance at months. Still, the mining power of the network continues to advance at
a rapid pace as the race for higher density chips is matched with a rapid pace.
a race for locations with lower electrical costs where these chips
can be deployed.
[[extra_nonce]] [[extra_nonce]]
==== The Extra Nonce Solution ==== The Extra Nonce Solution
@ -1529,7 +1495,8 @@ piece of mining equipment has its own coinbase transaction, this allows
an individual piece of mining equipment to perform up to 281 TH/s by an individual piece of mining equipment to perform up to 281 TH/s by
only making changes to the block header. This keeps mining equipment only making changes to the block header. This keeps mining equipment
and protocols simpler than incrementing the extranonce in the coinbase and protocols simpler than incrementing the extranonce in the coinbase
transaction every 4 billion hashes. transaction every 4 billion hashes, which requires recalculating the
entire left flank of the merkle tree up to the root.
[[mining_pools]] [[mining_pools]]
==== Mining Pools ==== Mining Pools
@ -1598,7 +1565,13 @@ contribute to the pool. By setting a lower difficulty for earning
shares, the pool measures the amount of work done by each miner. Each shares, the pool measures the amount of work done by each miner. Each
time a pool miner finds a block header hash that is less than the pool time a pool miner finds a block header hash that is less than the pool
target, she proves she has done the hashing work to find that result. target, she proves she has done the hashing work to find that result.
More importantly, the work to find shares contributes, in a That header ultimately commits to the coinbase transaction and so it can
be used to prove the miner used a coinbase transaction that would have
paid the block reward to pool. Each pool miner is given a
slightly different coinbase transaction template so each of them hashes
different candidate block headers, preventing duplication of effort.
The work to find shares contributes, in a
statistically measurable way, to the overall effort to find a hash lower statistically measurable way, to the overall effort to find a hash lower
than the bitcoin network's target. Thousands of miners trying to find than the bitcoin network's target. Thousands of miners trying to find
low-value hashes will eventually find one low enough to satisfy the low-value hashes will eventually find one low enough to satisfy the
@ -1691,7 +1664,7 @@ Bitcoin's blockchain consensus mechanism.
P2Pool mining is more complex than pool mining because it requires that P2Pool mining is more complex than pool mining because it requires that
the pool miners run a dedicated computer with enough disk space, memory, the pool miners run a dedicated computer with enough disk space, memory,
and internet bandwidth to support a full Bitcoin node and the P2Pool and internet bandwidth to support a Bitcoin full node and the P2Pool
node software. P2Pool miners connect their mining hardware to their node software. P2Pool miners connect their mining hardware to their
local P2Pool node, which simulates the functions of a pool server by local P2Pool node, which simulates the functions of a pool server by
sending block templates to the mining hardware. On P2Pool, individual sending block templates to the mining hardware. On P2Pool, individual
@ -1726,16 +1699,16 @@ consensus mechanism so as to disrupt the security and availability of
the Bitcoin network. the Bitcoin network.
It is important to note that consensus attacks have the greatest effect on future It is important to note that consensus attacks have the greatest effect on future
consensus. Bitcoin's consensus. Confirmed transactions ont he best blockchain
ledger becomes more and more immutable as time passes. While in theory, become more and more immutable as time passes. While in theory,
a fork can be achieved at any depth, in practice, the computing power a fork can be achieved at any depth, in practice, the computing power
needed to force a very deep fork is immense, making old blocks needed to force a very deep fork is immense, making old blocks
very hard to change. Consensus attacks also do not affect the security very hard to change. Consensus attacks also do not affect the security
of the private keys and signing algorithms. of the private keys and signing algorithms.
One attack scenario against the consensus mechanism is called the "51% One attack scenario against the consensus mechanism is called the _majority
attack." In this scenario a group of miners, controlling a majority attack_ or _51% attack._ In this scenario a group of miners, controlling a majority
(51%) of the total network's hashing power, collude to attack bitcoin. of the total network's hashing power (such as 51%), collude to attack bitcoin.
With the ability to mine the majority of the blocks, the attacking With the ability to mine the majority of the blocks, the attacking
miners can cause deliberate "forks" in the blockchain and double-spend miners can cause deliberate "forks" in the blockchain and double-spend
transactions or execute denial-of-service attacks against specific transactions or execute denial-of-service attacks against specific
@ -1746,8 +1719,8 @@ power, an attacker can invalidate six or more blocks in a row, causing
transactions that were considered immutable (six confirmations) to be transactions that were considered immutable (six confirmations) to be
invalidated. Note that a double-spend can only be done on the attacker's invalidated. Note that a double-spend can only be done on the attacker's
own transactions, for which the attacker can produce a valid signature. own transactions, for which the attacker can produce a valid signature.
Double-spending one's own transactions is profitable if by invalidating Double-spending one's own transactions can be profitable if invalidating
a transaction the attacker can get an irreversible exchange payment or a transaction allows the attacker can get an irreversible exchange payment or
product without paying for it. product without paying for it.
Let's examine a practical example of a 51% attack. In the first chapter, Let's examine a practical example of a 51% attack. In the first chapter,
@ -1762,13 +1735,15 @@ because the risk of a credit-card chargeback is low while the cost of
delaying the transaction to obtain a signature is comparatively larger. delaying the transaction to obtain a signature is comparatively larger.
In contrast, selling a more expensive item for bitcoin runs the risk of In contrast, selling a more expensive item for bitcoin runs the risk of
a double-spend attack, where the buyer broadcasts a competing a double-spend attack, where the buyer broadcasts a competing
transaction that spends the same inputs (UTXO) and cancels the payment transaction that spends one of the same inputs (UTXOs) and cancels the payment
to the merchant. A double-spend attack can happen in two ways: either to the merchant.
before a transaction is confirmed, or if the attacker takes advantage of A 51% attack allows attackers
a blockchain fork to undo several blocks. A 51% attack allows attackers
to double-spend their own transactions in the new chain, thus undoing to double-spend their own transactions in the new chain, thus undoing
the corresponding transaction in the old chain. the corresponding transaction in the old chain.
//TODO:distinguish between majority attack and sub-majority "reorg"
//attack. Consensus attack
In our example, malicious attacker Mallory goes to ((("use cases", In our example, malicious attacker Mallory goes to ((("use cases",
"retail sales", id="carolten")))Carol's gallery and purchases a "retail sales", id="carolten")))Carol's gallery and purchases a
set of beautiful triptych paintings depicting Satoshi Nakamoto as Prometheus. set of beautiful triptych paintings depicting Satoshi Nakamoto as Prometheus.
@ -1776,7 +1751,7 @@ Carol sells "The Great Fire" paintings for $250,000 in bitcoin to
Mallory. Instead of waiting for six or more confirmations on the Mallory. Instead of waiting for six or more confirmations on the
transaction, Carol wraps and hands the paintings to Mallory after only transaction, Carol wraps and hands the paintings to Mallory after only
one confirmation. Mallory works with an accomplice, Paul, who operates a one confirmation. Mallory works with an accomplice, Paul, who operates a
large mining pool, and the accomplice launches a 51% attack as soon as large mining pool, and the accomplice launches an attack as soon as
Mallory's transaction is included in a block. Paul directs the mining Mallory's transaction is included in a block. Paul directs the mining
pool to remine the same block height as the block containing Mallory's pool to remine the same block height as the block containing Mallory's
transaction, replacing Mallory's payment to Carol with a transaction transaction, replacing Mallory's payment to Carol with a transaction
@ -1797,24 +1772,28 @@ every transaction or block.((("", startref="carolten")))
((("confirmations", "of large-value transactions", ((("confirmations", "of large-value transactions",
secondary-sortas="large-value transactions")))To protect against this secondary-sortas="large-value transactions")))To protect against this
kind of attack, a merchant selling large-value items must wait at least kind of attack, a merchant selling large-value items must wait at least
six confirmations before giving the product to the buyer. Alternatively, six confirmations before giving the product to the buyer. Waiting for
more than six confirmations may sometimes be warranted. Alternatively,
the merchant should use an escrow multisignature account, again waiting the merchant should use an escrow multisignature account, again waiting
for several confirmations after the escrow account is funded. The more for several confirmations after the escrow account is funded. The more
confirmations elapse, the harder it becomes to invalidate a transaction confirmations elapse, the harder it becomes to invalidate a transaction
with a 51% attack. For high-value items, payment by bitcoin will still by reorganizing the blockchain. For high-value items, payment by bitcoin will still
be convenient and efficient even if the buyer has to wait 24 hours for be convenient and efficient even if the buyer has to wait 24 hours for
delivery, which would correspond to approximately 144 confirmations. delivery, which would correspond to approximately 144 confirmations.
In addition to a double-spend attack, the other scenario for a consensus In addition to a double-spend attack, the other scenario for a consensus
attack is to deny service to specific bitcoin participants (specific attack is to deny service to specific bitcoin participants (specific
Bitcoin addresses). An attacker with a majority of the mining power can Bitcoin addresses). An attacker with a majority of the mining power can
simply ignore specific transactions. If they are included in a block censor transactions. If they are included in a block
mined by another miner, the attacker can deliberately fork and remine mined by another miner, the attacker can deliberately fork and remine
that block, again excluding the specific transactions. This type of that block, again excluding the specific transactions. This type of
attack can result in a sustained denial-of-service against a specific attack can result in a sustained denial-of-service against a specific
address or set of addresses for as long as the attacker controls the address or set of addresses for as long as the attacker controls the
majority of the mining power. majority of the mining power.
//TODO: update to not use 51% attack name (see other TODO in this
//chapter)
Despite its name, the 51% attack scenario doesn't actually require 51% Despite its name, the 51% attack scenario doesn't actually require 51%
of the hashing power. In fact, such an attack can be attempted with a of the hashing power. In fact, such an attack can be attempted with a
smaller percentage of the hashing power. The 51% threshold is simply the smaller percentage of the hashing power. The 51% threshold is simply the
@ -1851,7 +1830,7 @@ other pools with denial-of-service. All of these scenarios are
theoretically possible. theoretically possible.
Undoubtedly, a serious consensus attack would erode confidence in Undoubtedly, a serious consensus attack would erode confidence in
bitcoin in the short term, possibly causing a significant price decline. Bitcoin in the short term, possibly causing a significant price decline.
However, the Bitcoin network and software are constantly evolving, so However, the Bitcoin network and software are constantly evolving, so
consensus attacks would be met with immediate countermeasures by the consensus attacks would be met with immediate countermeasures by the
Bitcoin community, making Bitcoin more robust.((("", Bitcoin community, making Bitcoin more robust.((("",
@ -1902,7 +1881,7 @@ that do not upgrade to the new consensus rules are unable to participate
in the consensus mechanism and are forced onto a separate chain at the in the consensus mechanism and are forced onto a separate chain at the
moment of the hard fork. Thus, a change introduced by a hard fork can be moment of the hard fork. Thus, a change introduced by a hard fork can be
thought of as not "forward compatible," in that nonupgraded systems can thought of as not "forward compatible," in that nonupgraded systems can
no longer process the new consensus rules. no longer process blocks because of the new consensus rules.
Let's examine the mechanics of a hard fork with a specific example. Let's examine the mechanics of a hard fork with a specific example.
@ -1911,11 +1890,15 @@ height 4, a one-block fork occurs. This is the type of spontaneous fork
we saw in <<forks>>. With the mining of block 5, the network converges we saw in <<forks>>. With the mining of block 5, the network converges
on one chain and the fork is resolved. on one chain and the fork is resolved.
//FIXME:"The blocks following the new rules should have a unique color. I would have expected the "b-fork" to follow the old rules based on the colors."
// I was looking here where the other block was created, because I assumed that the enumeration would start with a) and then progress to b).
//
// Perhaps call this chain "7F–11F" to indicate the new Foocoin rules?
[[blockchainwithforks]] [[blockchainwithforks]]
.A blockchain with forks .A blockchain with forks
image::images/mbc2_1009.png[A blockchain with forks] image::images/mbc2_1009.png[A blockchain with forks]
Later, however, at block height 6, a hard fork occurs. Let's assume that Later, however, at block height 6,
a new implementation of the client is released with a change in the a new implementation of the client is released with a change in the
consensus rules. Starting on block height 7, miners running this new consensus rules. Starting on block height 7, miners running this new
implementation will accept a new type of bitcoin, let's call implementation will accept a new type of bitcoin, let's call
@ -2001,8 +1984,7 @@ connected to old nodes and new nodes will only be connected to new
nodes. A single block based on the new rules will ripple nodes. A single block based on the new rules will ripple
through the network and result in the partition into two networks. through the network and result in the partition into two networks.
Once a miner using the new rules mines a block, the mining power and New miners may mine on top of the new block,
chain will also fork. New miners may mine on top of the new block,
while old miners will mine a separate chain based on the old rules. The while old miners will mine a separate chain based on the old rules. The
partitioned network will make it so that the miners operating on partitioned network will make it so that the miners operating on
separate consensus rules won't likely receive each other's blocks, as separate consensus rules won't likely receive each other's blocks, as
@ -2166,9 +2148,7 @@ mechanism for "activating" a soft fork is through miners signaling that
they are ready and willing to enforce the new consensus rules. If they are ready and willing to enforce the new consensus rules. If
all miners enforce the new rules, there's no risk of unmodified all miners enforce the new rules, there's no risk of unmodified
nodes accepting a block that upgraded nodes would reject. nodes accepting a block that upgraded nodes would reject.
This mechanism was introduced with the This mechanism was introduced by BIP34.
activation of BIP34 in March 2013 and replaced by the activation of
BIP9 in July 2016.
==== BIP34 Signaling and Activation ==== BIP34 Signaling and Activation
@ -2185,7 +2165,7 @@ chose to include. After activation of BIP34, valid blocks had to
contain a specific block-height at the beginning of the coinbase and be contain a specific block-height at the beginning of the coinbase and be
identified with a version number greater than or equal to "2." identified with a version number greater than or equal to "2."
To signal the change and activation of BIP34, miners set the block To signal their readiness to enforce the rules of BIP34, miners set the block
version to "2," instead of "1." This did not immediately make version version to "2," instead of "1." This did not immediately make version
"1" blocks invalid. Once activated, version "1" blocks would become "1" blocks invalid. Once activated, version "1" blocks would become
invalid and all version "2" blocks would be required to contain the invalid and all version "2" blocks would be required to contain the
@ -2228,10 +2208,6 @@ After the activation of BIP65, the signaling and activation mechanism
of BIP34 was retired and replaced with the BIP9 signaling mechanism of BIP34 was retired and replaced with the BIP9 signaling mechanism
described next. described next.
The standard is defined in
https://github.com/bitcoin/bips/blob/master/bip-0034.mediawiki[BIP34
(Block v2, Height in Coinbase)].
[[bip9]] [[bip9]]
==== BIP9 Signaling and Activation ==== BIP9 Signaling and Activation
@ -2394,7 +2370,7 @@ many protocol developers that BIP9 was itself a failure. As mentioned,
the failure of miners to initially signal support for segwit may have the failure of miners to initially signal support for segwit may have
been largely the result of a one-time conflict of interest that wouldn't been largely the result of a one-time conflict of interest that wouldn't
apply in the future. To some, it seemed worth trying BIP9 again. apply in the future. To some, it seemed worth trying BIP9 again.
Others disagree and wanted to use BIP8. Others disagreed and wanted to use BIP8.
After months of discussions between those who were the most interested After months of discussions between those who were the most interested
in specific activation ideas, a compromise was suggested in order to in specific activation ideas, a compromise was suggested in order to
@ -2431,7 +2407,7 @@ majority (51%), they are constrained by the consent of the other
constituencies. If they act unilaterally, the rest of the participants constituencies. If they act unilaterally, the rest of the participants
may refuse to accept their blocks, keeping the economic activity on a may refuse to accept their blocks, keeping the economic activity on a
minority chain. Without economic activity (transactions, merchants, minority chain. Without economic activity (transactions, merchants,
wallets, exchanges), the miners will be mining a worthless coin with wallets, exchanges), the miners will be mining a worthless currency with
empty blocks. This diffusion of power means that all the participants empty blocks. This diffusion of power means that all the participants
must coordinate, or no changes can be made. Status quo is the stable must coordinate, or no changes can be made. Status quo is the stable
state of this system with only a few changes possible if there is strong state of this system with only a few changes possible if there is strong

36
ch11.asciidoc
View File

@ -8,8 +8,8 @@ much like digital cash or gold. You've probably heard the expression,
ten-tenths of the law. Possession of the keys to spend certain bitcoins is ten-tenths of the law. Possession of the keys to spend certain bitcoins is
equivalent to possession of cash or a chunk of precious metal. You can equivalent to possession of cash or a chunk of precious metal. You can
lose it, misplace it, have it stolen, or accidentally give the wrong lose it, misplace it, have it stolen, or accidentally give the wrong
amount to someone. In every one of these cases, users have no recourse, amount to someone. In every one of these cases, users have no recourse
just as if they dropped cash on a public sidewalk. within the protocol, just as if they dropped cash on a public sidewalk.
However, the Bitcoin system has capabilities that cash, gold, and bank accounts do However, the Bitcoin system has capabilities that cash, gold, and bank accounts do
not. A Bitcoin wallet, containing your keys, can be backed up like any not. A Bitcoin wallet, containing your keys, can be backed up like any
@ -89,7 +89,7 @@ replicates the fragile model of traditional financial networks, plagued
by identity theft, corruption, and embezzlement. To take advantage of by identity theft, corruption, and embezzlement. To take advantage of
Bitcoin's unique decentralized security model, you have to avoid the Bitcoin's unique decentralized security model, you have to avoid the
temptation of centralized architectures that might feel familiar but temptation of centralized architectures that might feel familiar but
ultimately subvert bitcoin's security. ultimately subvert Bitcoin's security.
==== The Root of Trust ==== The Root of Trust
@ -105,7 +105,7 @@ more likely to contain bugs, which make them vulnerable to security
compromise. As a result, the more complex a software system becomes, the compromise. As a result, the more complex a software system becomes, the
harder it is to secure. The root of trust concept ensures that most of harder it is to secure. The root of trust concept ensures that most of
the trust is placed within the least complex part of the system, and the trust is placed within the least complex part of the system, and
therefore least vulnerable, parts of the system, while more complex therefore the least vulnerable parts of the system, while more complex
software is layered around it. This security architecture is repeated at software is layered around it. This security architecture is repeated at
different scales, first establishing a root of trust within the hardware different scales, first establishing a root of trust within the hardware
of a single system, then extending that root of trust through the of a single system, then extending that root of trust through the
@ -172,8 +172,8 @@ hackers had to convert identity information or account tokens—such as
credit cards and bank accounts—into value after compromising them. credit cards and bank accounts—into value after compromising them.
Despite the difficulty of fencing and laundering financial information, Despite the difficulty of fencing and laundering financial information,
we have seen ever-escalating thefts. Bitcoin escalates this problem we have seen ever-escalating thefts. Bitcoin escalates this problem
because it doesn't need to be fenced or laundered; it is intrinsic value because it doesn't need to be fenced or laundered; bitcoins are valuable
within a digital asset. by themselves.
Bitcoin also creates the incentives to improve computer Bitcoin also creates the incentives to improve computer
security. Whereas previously the risk of computer compromise was vague security. Whereas previously the risk of computer compromise was vague
@ -187,7 +187,7 @@ clear incentive to defend themselves.
Over the past three years, as a direct result of Bitcoin adoption, we Over the past three years, as a direct result of Bitcoin adoption, we
have seen tremendous innovation in the realm of information security in have seen tremendous innovation in the realm of information security in
the form of hardware encryption, key storage and hardware wallets, the form of hardware encryption, key storage and hardware signing devices,
multisignature technology, and digital escrow. In the following sections multisignature technology, and digital escrow. In the following sections
we will examine various best practices for practical user security. we will examine various best practices for practical user security.
@ -200,7 +200,7 @@ comfortable with physical security than information security, a very
effective method for protecting bitcoin is to convert them into physical effective method for protecting bitcoin is to convert them into physical
form. Bitcoin keys, and the seeds used to create them, are nothing more than long numbers. This means that form. Bitcoin keys, and the seeds used to create them, are nothing more than long numbers. This means that
they can be stored in a physical form, such as printed on paper or they can be stored in a physical form, such as printed on paper or
etched on a metal coin. Securing the keys then becomes as simple as etched on a metal plate. Securing the keys then becomes as simple as
physically securing a printed copy of the key seed. A seed physically securing a printed copy of the key seed. A seed
that is printed on paper is called a "paper backup," and that is printed on paper is called a "paper backup," and
many wallets can create them. many wallets can create them.
@ -216,13 +216,14 @@ stick.
((("hardware ((("hardware
signing devices")))In the long term, Bitcoin security may increasingly take the signing devices")))In the long term, Bitcoin security may increasingly take the
form of tamper-proof hardware signing devices. Unlike a smartphone or desktop form of tamper-proof hardware signing devices. Unlike a smartphone or desktop
computer, a Bitcoin hardware signing device has just one purpose: to hold computer, a Bitcoin hardware signing device only needs hold keys and
keys securely. Without general-purpose software to compromise and use them to generate signatures. Without general-purpose software to
compromise and
with limited interfaces, hardware signing devices can deliver an almost with limited interfaces, hardware signing devices can deliver an almost
foolproof level of security to nonexpert users. Hardware foolproof level of security to nonexpert users. Hardware
signing devices may become the predominant method of bitcoin storage. signing devices may become the predominant method of bitcoin storage.
==== Balancing Risk ==== Ensuring Your Access
((("risk, balancing and diversifying", seealso="security")))Although ((("risk, balancing and diversifying", seealso="security")))Although
most users are rightly concerned about theft of thir bitcoins, there is an even most users are rightly concerned about theft of thir bitcoins, there is an even
@ -236,6 +237,18 @@ they accidentally lost the encryption keys, making the backups worthless
and losing a fortune. Like hiding money by burying it in the desert, if and losing a fortune. Like hiding money by burying it in the desert, if
you secure your bitcoins too well you might not be able to find it again. you secure your bitcoins too well you might not be able to find it again.
[WARNING]
====
To spend bitcoins, you may need to backup more than just your private
keys or the BIP32 seed used to derive them. This is especially the case
when multisignatures or complex scripts are being used. Most output
scripts commit to the actual conditions that must be fulfilled to spend
the bitcoins in that output, and it's not possible to fulfill that
commitment unless your wallet software can reveal those conditions to
the network. Wallet recovery codes must include this information. For
more details, see <<ch05_wallets>>.
====
==== Diversifying Risk ==== Diversifying Risk
Would you carry your entire net worth in cash in your wallet? Most Would you carry your entire net worth in cash in your wallet? Most
@ -261,6 +274,7 @@ single person can compromise the funds. Multisignature addresses can
also offer redundancy, where a single person holds several keys that are also offer redundancy, where a single person holds several keys that are
stored in different locations. stored in different locations.
==== Survivability ==== Survivability
((("survivability")))((("digital asset executors")))((("passwords", ((("survivability")))((("digital asset executors")))((("passwords",

111
ch12.asciidoc
View File

@ -134,14 +134,14 @@ today and the building blocks they use:
Proof-of-Existence (Digital Notary):: ((("digital notary Proof-of-Existence (Digital Notary):: ((("digital notary
services")))((("Proof of Existence")))Immutability + Timestamp + Durability. services")))((("Proof of Existence")))Immutability + Timestamp + Durability.
A transaction on the blockchain can commit to a value, A transaction on the blockchain can commit to a value,
proving that a piece of data existed (Timestamp) at the time proving that a piece of data existed at the time
it was recorded. The commitment cannot be modified ex-post-facto it was recorded (Timestamp). The commitment cannot be modified ex-post-facto
(Immutability) and the proof will be stored permanently (Durability). (Immutability) and the proof will be stored permanently (Durability).
Kickstarter (Lighthouse):: Consistency + Atomicity + Integrity. If you Kickstarter (Lighthouse):: Consistency + Atomicity + Integrity. If you
sign one input and the output (Integrity) of a fundraiser transaction, sign one input and the output (Integrity) of a fundraiser transaction,
others can contribute to the fundraiser but it cannot be spent others can contribute to the fundraiser but it cannot be spent
(Atomicity) until the goal (output value) is funded (Consistency). (Atomicity) until the goal (output amount) is funded (Consistency).
Payment Channels:: ((("payment (state) channels", "building blocks Payment Channels:: ((("payment (state) channels", "building blocks
(primitives) used in")))Quorum of Control + Timelock + No Double Spend + Nonexpiration (primitives) used in")))Quorum of Control + Timelock + No Double Spend + Nonexpiration
@ -149,7 +149,7 @@ Payment Channels:: ((("payment (state) channels", "building blocks
(Quorum) with a timelock (Timelock) used as the "settlement" transaction (Quorum) with a timelock (Timelock) used as the "settlement" transaction
of a payment channel can be held (Nonexpiration) and spent at any time of a payment channel can be held (Nonexpiration) and spent at any time
(Censorship Resistance) by either party (Authorization). The two parties (Censorship Resistance) by either party (Authorization). The two parties
can then create commitment transactions that double-spend (No can then create commitment transactions that supersede (No
Double-Spend) the settlement on a shorter timelock (Timelock). Double-Spend) the settlement on a shorter timelock (Timelock).
=== Colored Coins === Colored Coins
@ -177,7 +177,7 @@ colored coins can represent certificates of ownership of commodities
((("Enhanced Padded-Order-Based Coloring (EPOBC)")))The term derives ((("Enhanced Padded-Order-Based Coloring (EPOBC)")))The term derives
from the idea of "coloring" or marking a nominal amount of bitcoin, for from the idea of "coloring" or marking a nominal amount of bitcoin, for
example, a single satoshi, to represent something other than the bitcoin example, a single satoshi, to represent something other than the bitcoin
value itself. As an analogy, consider stamping a $1 note with a message amount itself. As an analogy, consider stamping a $1 note with a message
saying, "this is a stock certificate of ACME" or "this note can be saying, "this is a stock certificate of ACME" or "this note can be
redeemed for 1 oz of silver" and then trading the $1 note as a redeemed for 1 oz of silver" and then trading the $1 note as a
certificate of ownership of this other asset. The first implementation certificate of ownership of this other asset. The first implementation
@ -192,6 +192,7 @@ data stores that associate the metadata to specific assets. The three
main mechanisms used as of this writing are single-use seals, main mechanisms used as of this writing are single-use seals,
pay-to-contract, and client-side validation. pay-to-contract, and client-side validation.
[[single_use_seals]]
==== Single-use seals ==== Single-use seals
Single-use seals originate in physical security. Someone shipping an Single-use seals originate in physical security. Someone shipping an
@ -388,7 +389,7 @@ blockchain, are held off-chain instead, waiting for
eventual batch settlement. Because the transactions are not settled, eventual batch settlement. Because the transactions are not settled,
they can be exchanged without the usual settlement latency, allowing they can be exchanged without the usual settlement latency, allowing
extremely high transaction throughput, low latency, and extremely high transaction throughput, low latency, and
fine (satoshi-level) granularity. fine granularity.
Actually, the term _channel_ is a metaphor. State channels are virtual Actually, the term _channel_ is a metaphor. State channels are virtual
constructs represented by the exchange of state between two parties, constructs represented by the exchange of state between two parties,
@ -426,8 +427,8 @@ the state being altered is the balance of a virtual currency.
((("payment (state) channels", "terminology")))A state channel is ((("payment (state) channels", "terminology")))A state channel is
established between two parties, through a transaction that locks a established between two parties, through a transaction that locks a
shared state on the blockchain. This is called the _funding transaction_ shared state on the blockchain. This is called the _funding transaction_.
or _anchor transaction_. This single transaction must be transmitted to This single transaction must be transmitted to
the network and mined to establish the channel. In the example of a the network and mined to establish the channel. In the example of a
payment channel, the locked state is the initial balance (in currency) payment channel, the locked state is the initial balance (in currency)
of the channel. of the channel.
@ -479,6 +480,10 @@ is trying to cheat, to keep things simple. Once we have the basic
channel idea explained, we will then look at what it takes to make it channel idea explained, we will then look at what it takes to make it
trustless so that neither party _can_ cheat, even if they are trying to. trustless so that neither party _can_ cheat, even if they are trying to.
//TODO:change to using sats rather than millibits. Or maybe drop
//specific amounts so that the example doesn't become outdated as price
//changes.
For this example we will assume two participants: Emma and Fabian. For this example we will assume two participants: Emma and Fabian.
Fabian offers a video streaming service that is billed by the second Fabian offers a video streaming service that is billed by the second
using a micropayment channel. Fabian charges 0.01 millibit (0.00001 BTC) using a micropayment channel. Fabian charges 0.01 millibit (0.00001 BTC)
@ -514,7 +519,7 @@ amount that can be transmitted in this channel, setting the _channel
capacity_. capacity_.
The funding transaction consumes one or more inputs from Emma's wallet, The funding transaction consumes one or more inputs from Emma's wallet,
sourcing the funds. It creates one output with a value of 36 millibits sourcing the funds. It creates one output with an amount of 36 millibits
paid to the multisignature 2-of-2 address controlled jointly between paid to the multisignature 2-of-2 address controlled jointly between
Emma and Fabian. It may have additional outputs for change back to Emma and Fabian. It may have additional outputs for change back to
Emma's wallet. Emma's wallet.
@ -578,7 +583,7 @@ to fix those:
- Once the funding transaction happens, Emma needs Fabian's signature to - Once the funding transaction happens, Emma needs Fabian's signature to
get any money back. If Fabian disappears, Emma's funds are locked in a get any money back. If Fabian disappears, Emma's funds are locked in a
2-of-2 and effectively lost. This channel, as constructed, leads to a 2-of-2 and effectively lost. This channel, as constructed, leads to a
loss of funds if one of the parties disconnects before there is at loss of funds if one of the parties becomes unavailable before there is at
least one commitment transaction signed by both parties. least one commitment transaction signed by both parties.
- While the channel is running, Emma can take any of the commitment - While the channel is running, Emma can take any of the commitment
@ -629,6 +634,7 @@ blocks before commitment transaction #1 becomes valid.
shorter timelock, allowing it to be spent before the previous shorter timelock, allowing it to be spent before the previous
commitments become valid. commitments become valid.
//FIXME: s/3720/3721/
[[timelocked_commitments]] [[timelocked_commitments]]
.Each commitment sets a shorter timelock, allowing it to be spent before the previous commitments become valid .Each commitment sets a shorter timelock, allowing it to be spent before the previous commitments become valid
image::images/mbc2_1207.png["Each commitment sets a shorter timelock, allowing it to be spent before the previous commitments become valid"] image::images/mbc2_1207.png["Each commitment sets a shorter timelock, allowing it to be spent before the previous commitments become valid"]
@ -721,8 +727,8 @@ id="PSCaymetric12")))Another way to handle the prior commitment states
is to explicitly revoke them. However, this is not easy to achieve. A is to explicitly revoke them. However, this is not easy to achieve. A
key characteristic of Bitcoin is that once a transaction is valid, it key characteristic of Bitcoin is that once a transaction is valid, it
remains valid and does not expire. The only way to cancel a transaction remains valid and does not expire. The only way to cancel a transaction
is by double-spending its inputs with another transaction before it is is to get a conflicting transactionn confirmed.
mined. That's why we used timelocks in the simple payment channel That's why we used timelocks in the simple payment channel
example above to ensure that more recent commitments could be spent example above to ensure that more recent commitments could be spent
before older commitments were valid. However, sequencing commitments in before older commitments were valid. However, sequencing commitments in
time creates a number of constraints that make payment channels time creates a number of constraints that make payment channels
@ -746,8 +752,10 @@ exchanges will significantly reduce the cost and accelerate the
transaction flow. transaction flow.
Hitesh and Irene start the channel by collaboratively constructing a Hitesh and Irene start the channel by collaboratively constructing a
funding transaction, each funding the channel with 5 bitcoin. The funding transaction, each funding the channel with 5 bitcoin. Before
initial balance is 5 bitcoin for Hitesh and 5 bitcoin for Irene. The they sign the funding transaction, they must sign the first set of
commitments (called the _refund_) that assigns the
initial balance of 5 bitcoin for Hitesh and 5 bitcoin for Irene. The
funding transaction locks the channel state in a 2-of-2 multisig, just funding transaction locks the channel state in a 2-of-2 multisig, just
like in the example of a simple channel. like in the example of a simple channel.
@ -808,7 +816,7 @@ This way, each party has a commitment transaction, spending the 2-of-2
funding output. This input is signed by the _other_ party. At any time funding output. This input is signed by the _other_ party. At any time
the party holding the transaction can also sign (completing the 2-of-2) the party holding the transaction can also sign (completing the 2-of-2)
and broadcast. However, if they broadcast the commitment transaction, it and broadcast. However, if they broadcast the commitment transaction, it
pays the other party immediately whereas they have to wait for a short pays the other party immediately whereas they have to wait for a
timelock to expire. By imposing a delay on the redemption of one of the timelock to expire. By imposing a delay on the redemption of one of the
outputs, we put each party at a slight disadvantage when they choose to outputs, we put each party at a slight disadvantage when they choose to
unilaterally broadcast a commitment transaction. But a time delay alone unilaterally broadcast a commitment transaction. But a time delay alone
@ -873,11 +881,11 @@ will immediately pay her what she is owed. Hitesh holds the transaction,
but knows that if he transmits it in a unilateral channel closing, he but knows that if he transmits it in a unilateral channel closing, he
will have to wait 1000 blocks to get paid. will have to wait 1000 blocks to get paid.
When the channel is advanced to the next state, Hitesh has to _revoke_ After the channel is advanced to the next state, Hitesh has to _revoke_
this commitment transaction before Irene agrees to sign the next this commitment transaction before Irene will agree to sign any further
commitment transaction. To do that, all he has to do is send his half of commitment transactions. To do that, all he has to do is send his half of
the _revocation key_ to Irene. Once Irene has both halves of the the _revocation key_ to Irene. Once Irene has both halves of the
revocation secret key for this commitment, she can sign the next revocation secret key for this commitment, she can sign a future
commitment with confidence. She knows that if Hitesh tries to cheat by commitment with confidence. She knows that if Hitesh tries to cheat by
publishing the prior commitment, she can use the revocation key to publishing the prior commitment, she can use the revocation key to
redeem Hitesh's delayed output. _If Hitesh cheats, Irene gets BOTH redeem Hitesh's delayed output. _If Hitesh cheats, Irene gets BOTH
@ -894,17 +902,17 @@ make the prior state impossible to use, by giving each other the
necessary revocation secrets to punish any cheating. necessary revocation secrets to punish any cheating.
Let's look at an example of how it works. One of Irene's customers wants Let's look at an example of how it works. One of Irene's customers wants
to send 2 bitcoin to one of Hitesh's customers. To transmit 2 bitcoin to send 2 bitcoins to one of Hitesh's customers. To transmit 2 bitcoins
across the channel, Hitesh and Irene must advance the channel state to across the channel, Hitesh and Irene must advance the channel state to
reflect the new balance. They will commit to a new state (state number reflect the new balance. They will commit to a new state (state number
2) where the channel's 10 bitcoin are split, 7 bitcoin to Hitesh and 3 2) where the channel's 10 bitcoins are split, 7 bitcoins to Hitesh and 3
bitcoin to Irene. To advance the state of the channel, they will each bitcoins to Irene. To advance the state of the channel, they will each
create new commitment transactions reflecting the new channel balance. create new commitment transactions reflecting the new channel balance.
As before, these commitment transactions are asymmetric so that the As before, these commitment transactions are asymmetric so that the
commitment transaction each party holds forces them to wait if they commitment transaction each party holds forces them to wait if they
redeem it. Crucially, before signing new commitment transactions, they redeem it. Crucially, before signing new commitment transactions, they
must first exchange revocation keys to invalidate the prior commitment. must first exchange revocation keys to invalidate any outdated commitments.
In this particular case, Hitesh's interests are aligned with the real In this particular case, Hitesh's interests are aligned with the real
state of the channel and therefore he has no reason to broadcast a prior state of the channel and therefore he has no reason to broadcast a prior
state. However, for Irene, state number 1 leaves her with a higher state. However, for Irene, state number 1 leaves her with a higher
@ -921,7 +929,7 @@ has the ability to punish Irene for cheating, he has to watch the
blockchain diligently for signs of cheating. If he sees a prior blockchain diligently for signs of cheating. If he sees a prior
commitment transaction broadcast, he has 1000 blocks to take action and commitment transaction broadcast, he has 1000 blocks to take action and
use the revocation key to thwart Irene's cheating and punish her by use the revocation key to thwart Irene's cheating and punish her by
taking the entire balance, all 10 bitcoin. taking the entire balance, all 10 bitcoins.
Asymmetric revocable commitments with relative time locks (+CSV+) are a Asymmetric revocable commitments with relative time locks (+CSV+) are a
much better way to implement payment channels and a very significant much better way to implement payment channels and a very significant
@ -965,6 +973,7 @@ The script implementing an HTLC might look like this:
IF IF
# Payment if you have the secret R # Payment if you have the secret R
HASH160 <H> EQUALVERIFY HASH160 <H> EQUALVERIFY
<Receiver Public Key> CHECKSIG
ELSE ELSE
# Refund after timeout. # Refund after timeout.
<lock time> CHECKLOCKTIMEVERIFY DROP <lock time> CHECKLOCKTIMEVERIFY DROP
@ -1007,9 +1016,6 @@ different open source teams. ((("Basics of Lightning Technology
interoperability standards described in the interoperability standards described in the
http://bit.ly/2rBHeoL[_Basics of Lightning Technology (BOLT)_ repository]. http://bit.ly/2rBHeoL[_Basics of Lightning Technology (BOLT)_ repository].
Implementations of the Lightning Network have been released by
several teams.
==== Basic Lightning Network Example ==== Basic Lightning Network Example
((("Lightning Network", "basic example")))Let's see how this works. ((("Lightning Network", "basic example")))Let's see how this works.
@ -1018,8 +1024,8 @@ In this example, we have five participants: Alice, Bob, Carol, Diana,
and Eric. These five participants have opened payment channels with each and Eric. These five participants have opened payment channels with each
other, in pairs. Alice has a payment channel with Bob. Bob is connected other, in pairs. Alice has a payment channel with Bob. Bob is connected
to Carol, Carol to Diana, and Diana to Eric. For simplicity let's assume to Carol, Carol to Diana, and Diana to Eric. For simplicity let's assume
each channel is funded with 2 bitcoin by each participant, for a total each channel is funded with 2 bitcoins by each participant, for a total
capacity of 4 bitcoin in each channel. capacity of 4 bitcoins in each channel.
<<lightning_network_fig>> shows five participants in a Lightning <<lightning_network_fig>> shows five participants in a Lightning
Network, connected by bidirectional payment channels that can be linked Network, connected by bidirectional payment channels that can be linked
@ -1049,36 +1055,36 @@ between payment channels. Alice's LN node also has the ability to
connect over the internet to Eric's LN node. Eric's LN node creates a connect over the internet to Eric's LN node. Eric's LN node creates a
secret +R+ using a random number generator. Eric's node does not reveal secret +R+ using a random number generator. Eric's node does not reveal
this secret to anyone. Instead, Eric's node calculates a hash +H+ of the this secret to anyone. Instead, Eric's node calculates a hash +H+ of the
secret +R+ and transmits this hash to Alice's node (see secret +R+ and transmits this hash to Alice's node in the form of an
<<ln_payment_process>> step 1). invoice (see <<ln_payment_process>> step 1).
Now Alice's LN node constructs a route between Alice's LN node and Now Alice's LN node constructs a route between Alice's LN node and
Eric's LN node. The routing algorithm used will be examined in more Eric's LN node. The pathfinding algorithm used will be examined in more
detail later, but for now let's assume that Alice's node can find an detail later, but for now let's assume that Alice's node can find an
efficient route. efficient route.
Alice's node then constructs an HTLC, payable to the hash +H+, with a Alice's node then constructs an HTLC, payable to the hash +H+, with a
10-block refund timeout (current block + 10), for an amount of 1.003 10-block refund timeout (current block + 10), for an amount of 1.003
bitcoin (see <<ln_payment_process>> step 2). The extra 0.003 will be bitcoins (see <<ln_payment_process>> step 2). The extra 0.003 will be
used to compensate the intermediate nodes for their participation in used to compensate the intermediate nodes for their participation in
this payment route. Alice offers this HTLC to Bob, deducting 1.003 this payment route. Alice offers this HTLC to Bob, deducting 1.003
bitcoin from her channel balance with Bob and committing it to the HTLC. bitcoins from her channel balance with Bob and committing it to the HTLC.
The HTLC has the following meaning: _"Alice is committing 1.003 of her The HTLC has the following meaning: _"Alice is committing 1.003 of her
channel balance to be paid to Bob if Bob knows the secret, or refunded channel balance to be paid to Bob if Bob knows the secret, or refunded
back to Alice's balance if 10 blocks elapse."_ The channel balance back to Alice's balance if 10 blocks elapse."_ The channel balance
between Alice and Bob is now expressed by commitment transactions with between Alice and Bob is now expressed by commitment transactions with
three outputs: 2 bitcoin balance to Bob, 0.997 bitcoin balance to Alice, three outputs: 2 bitcoins balance to Bob, 0.997 bitcoins balance to Alice,
1.003 bitcoin committed in Alice's HTLC. Alice's balance is reduced by 1.003 bitcoins committed in Alice's HTLC. Alice's balance is reduced by
the amount committed to the HTLC. the amount committed to the HTLC.
Bob now has a commitment that if he is able to get the secret +R+ within Bob now has a commitment that if he is able to get the secret +R+ within
the next 10 blocks, he can claim the 1.003 locked by Alice. With this the next 10 blocks, he can claim the 1.003 locked by Alice. With this
commitment in hand, Bob's node constructs an HTLC on his payment channel commitment in hand, Bob's node constructs an HTLC on his payment channel
with Carol. Bob's HTLC commits 1.002 bitcoin to hash +H+ for 9 blocks, with Carol. Bob's HTLC commits 1.002 bitcoins to hash +H+ for 9 blocks,
which Carol can redeem if she has secret +R+ (see <<ln_payment_process>> which Carol can redeem if she has secret +R+ (see <<ln_payment_process>>
step 3). Bob knows that if Carol can claim his HTLC, she has to produce step 3). Bob knows that if Carol can claim his HTLC, she has to produce
+R+. If Bob has +R+ in nine blocks, he can use it to claim Alice's HTLC +R+. If Bob has +R+ in nine blocks, he can use it to claim Alice's HTLC
to him. He also makes 0.001 bitcoin for committing his channel balance to him. He also makes 0.001 bitcoins for committing his channel balance
for nine blocks. If Carol is unable to claim his HTLC and he is unable for nine blocks. If Carol is unable to claim his HTLC and he is unable
to claim Alice's HTLC, everything reverts back to the prior channel to claim Alice's HTLC, everything reverts back to the prior channel
balances and no one is at a loss. The channel balance between Bob and balances and no one is at a loss. The channel balance between Bob and
@ -1086,11 +1092,11 @@ Carol is now: 2 to Carol, 0.998 to Bob, 1.002 committed by Bob to the
HTLC. HTLC.
Carol now has a commitment that if she gets +R+ within the next nine Carol now has a commitment that if she gets +R+ within the next nine
blocks, she can claim 1.002 bitcoin locked by Bob. Now she can make an blocks, she can claim 1.002 bitcoins locked by Bob. Now she can make an
HTLC commitment on her channel with Diana. She commits an HTLC of 1.001 HTLC commitment on her channel with Diana. She commits an HTLC of 1.001
bitcoin to hash +H+, for eight blocks, which Diana can redeem if she has bitcoins to hash +H+, for eight blocks, which Diana can redeem if she has
secret +R+ (see <<ln_payment_process>> step 4). From Carol's secret +R+ (see <<ln_payment_process>> step 4). From Carol's
perspective, if this works she is 0.001 bitcoin better off and if it perspective, if this works she is 0.001 bitcoins better off and if it
doesn't she loses nothing. Her HTLC to Diana is only viable if +R+ is doesn't she loses nothing. Her HTLC to Diana is only viable if +R+ is
revealed, at which point she can claim the HTLC from Bob. The channel revealed, at which point she can claim the HTLC from Bob. The channel
balance between Carol and Diana is now: 2 to Diana, 0.999 to Carol, balance between Carol and Diana is now: 2 to Diana, 0.999 to Carol,
@ -1108,7 +1114,7 @@ claims the 1 bitcoin, adding it to his channel balance (see
3 to Eric. 3 to Eric.
Now, Diana has secret +R+. Therefore, she can now claim the HTLC from Now, Diana has secret +R+. Therefore, she can now claim the HTLC from
Carol. Diana transmits +R+ to Carol and adds the 1.001 bitcoin to her Carol. Diana transmits +R+ to Carol and adds the 1.001 bitcoins to her
channel balance (see <<ln_payment_process>> step 7). Now the channel channel balance (see <<ln_payment_process>> step 7). Now the channel
balance between Carol and Diana is: 0.999 to Carol, 3.001 to Diana. balance between Carol and Diana is: 0.999 to Carol, 3.001 to Diana.
Diana has "earned" 0.001 for participating in this payment route. Diana has "earned" 0.001 for participating in this payment route.
@ -1126,9 +1132,9 @@ For the short-term commitment of their funds in the channel they are
able to earn a small fee, with the only risk being a small delay in able to earn a small fee, with the only risk being a small delay in
refund if the channel was closed or the routed payment failed. refund if the channel was closed or the routed payment failed.
==== Lightning Network Transport and Routing ==== Lightning Network Transport and Pathfinding
((("Lightning Network", "transport and routing")))All communications ((("Lightning Network", "transport and pathfinding")))All communications
between LN nodes are encrypted point-to-point. In addition, nodes have a between LN nodes are encrypted point-to-point. In addition, nodes have a
long-term public key that they http://bit.ly/2r5TACm[use as an long-term public key that they http://bit.ly/2r5TACm[use as an
identifier and to authenticate each other]. identifier and to authenticate each other].
@ -1138,7 +1144,7 @@ construct a _path_ through the network by connecting payment channels
with sufficient capacity. Nodes advertise routing information, including with sufficient capacity. Nodes advertise routing information, including
what channels they have open, how much capacity each channel has, and what channels they have open, how much capacity each channel has, and
what fees they charge to route payments. The routing information can be what fees they charge to route payments. The routing information can be
shared in a variety of ways and different routing protocols have shared in a variety of ways and different pathfinding protocols have
emerged as Lightning Network technology has advanced. emerged as Lightning Network technology has advanced.
Current implementations of Current implementations of
route discovery use a P2P model where nodes propagate channel route discovery use a P2P model where nodes propagate channel
@ -1210,10 +1216,10 @@ At this point, you might be wondering how it is possible that the nodes
do not know the length of the path and their position in that path. do not know the length of the path and their position in that path.
After all, they receive a message and forward it to the next hop. After all, they receive a message and forward it to the next hop.
Doesn't it get shorter, allowing them to deduce the path size and their Doesn't it get shorter, allowing them to deduce the path size and their
position? To prevent this, the path is always fixed at 20 hops and position? To prevent this, the packet size is fixed and
padded with random data. Each node sees the next hop and a fixed-length padded with random data. Each node sees the next hop and a fixed-length
encrypted message to forward. Only the final recipient sees that there encrypted message to forward. Only the final recipient sees that there
is no next hop. To everyone else it seems as if there are always 20 more is no next hop. To everyone else it seems as if there are always more
hops to go. hops to go.
==== Lightning Network Benefits ==== Lightning Network Benefits
@ -1238,12 +1244,11 @@ surveillance and blacklists on Bitcoin, increasing the fungibility of
the currency. the currency.
Speed:: Bitcoin transactions using Lightning Network are settled in Speed:: Bitcoin transactions using Lightning Network are settled in
milliseconds, rather than minutes, as HTLCs are cleared without milliseconds, rather than minutes or hours, as HTLCs are cleared without
committing transactions to a block. committing transactions to a block.
Granularity:: A Lightning Network can enable payments at least as small Granularity:: A Lightning Network can enable payments at least as small
as the Bitcoin "dust" limit, perhaps even smaller. Some proposals allow as the Bitcoin "dust" limit, perhaps even smaller.
for subsatoshi increments.
Capacity:: A Lightning Network increases the capacity of the Bitcoin Capacity:: A Lightning Network increases the capacity of the Bitcoin
system by several orders of magnitude. There is no practical upper bound system by several orders of magnitude. There is no practical upper bound
@ -1255,12 +1260,6 @@ between nodes that operate as peers without trusting each other. Thus, a
Lightning Network preserves the principles of the Bitcoin system, while Lightning Network preserves the principles of the Bitcoin system, while
expanding its operating parameters significantly. expanding its operating parameters significantly.
Of course, as mentioned previously, the Lightning Network protocol is
not the only way to implement routed payment channels. Other proposed
systems include Tumblebit and Teechan. At this time, however, the
Lightning Network has already been deployed and has tens of thousands of
users.
We have examined just a few of the emerging applications that can be We have examined just a few of the emerging applications that can be
built using the Bitcoin blockchain as a trust platform. These built using the Bitcoin blockchain as a trust platform. These
applications expand the scope of bitcoin beyond payments and beyond applications expand the scope of bitcoin beyond payments and beyond

2
chapters/errata.adoc
View File

@ -18,7 +18,7 @@ witnessed, but proof that it came from the largest pool of CPU power.
____ ____
* *Implementation detail:* If each link in the chain (called "blocks" * *Implementation detail:* If each link in the chain (called "blocks"
in Bitcoin) was built using the same amount of Proof Of Work (POW), the in Bitcoin) was built using the same amount of Proof-of-Work (POW), the
longest chain would be the one backed by the largest pool of longest chain would be the one backed by the largest pool of
computational power. However, Bitcoin was implemented in such a way that computational power. However, Bitcoin was implemented in such a way that
the amount of POW can vary between blocks, so it became important not to the amount of POW can vary between blocks, so it became important not to