1
0
mirror of https://github.com/bitcoinbook/bitcoinbook synced 2024-11-16 04:59:35 +00:00
Commit Graph

4267 Commits

Author SHA1 Message Date
tjones
bd612e685e Edited theme/epub/epub.xsl with Atlas code editor 2023-09-12 01:39:08 +00:00
tjones
6cbd33a35a Edited theme/epub/epub.xsl with Atlas code editor 2023-09-12 01:38:03 +00:00
tjones
8a88379b7d Created theme/epub/epub.xsl 2023-09-12 01:37:41 +00:00
theresa jones
63e61a7c7f removing old files; 2023-09-11 18:22:58 -07:00
theresa jones
df462b1a1c added numbers to ch. files 2023-09-11 18:22:28 -07:00
theresa jones
ea547997bd removed the last of the 2e index tags 2023-09-08 19:29:11 -07:00
theresa jones
8de4c3fe1e removing more index tags 2023-09-08 19:26:43 -07:00
theresa jones
bc53bf0e08 removing additional line breaks from index tags 2023-09-08 19:25:18 -07:00
theresa jones
1764c43a9e removing remaining index tags 2023-09-08 19:22:34 -07:00
theresa jones
d3c0914c8b removing line breaks from inside index tags 2023-09-08 19:19:59 -07:00
theresa jones
140ba650e8 removing 2e index tags 2023-09-08 18:47:20 -07:00
David A. Harding
02f8c485c1 Whitepaper: use MathML instead of screenshots
MathML created using LaTeX from
https://github.com/dhimmel/bitcoin-whitepaper/, a version of the paper
formatted by Daniel Himmelstein
2023-09-06 10:03:37 +02:00
David A. Harding
61c365b5e2 Images: remove currently unused files. 2023-09-01 13:24:36 +02:00
David A. Harding
3d924b461a Add tools/image-report 2023-09-01 13:24:35 +02:00
David A. Harding
ab1803246f All: harding edits for complete readthrough 2023-09-01 13:24:35 +02:00
David A. Harding
7da725a096 Move chapters to top level directory to fix Atlas build issue
They use "safe" build mode which doesn't let me reference arbitrary
diroctories in include files.
2023-09-01 13:24:35 +02:00
David A. Harding
67a69200f7 Tools: new "check" command for quick testing
Will be upgraded later
2023-09-01 13:24:35 +02:00
David A. Harding
7576570348 Intro: fix broken links 2023-09-01 13:24:35 +02:00
David A. Harding
3d9b186355 Restore list of github contributors from latest update 2023-09-01 13:24:35 +02:00
David A. Harding
dae7f90976 All: remove bit.ly link redirects 2023-09-01 13:24:35 +02:00
Arthur O'Dwyer
fe8c70871d Spelling nit: s/Berkley/Berkeley/ 2023-09-01 13:24:35 +02:00
David A. Harding
d1a8b0704a Meta: move second edition changes to meta dir 2023-09-01 13:24:35 +02:00
David A. Harding
e2048c4206 Images: move sources to new directory 2023-09-01 13:24:35 +02:00
David A. Harding
61cfeeed13 All: update links from HTTP to HTTPS
(Except the whitepaper)
2023-09-01 13:24:35 +02:00
David A. Harding
064b6a7da7 Remove unused code examples 2023-09-01 13:24:35 +02:00
David A. Harding
727d74d4ba Move files for consistency and easier QA tooling
Drop unused glossary
2023-09-01 13:23:06 +02:00
David A. Harding
02106a1147 All: harding edits for first complete readthrough 2023-09-01 13:23:06 +02:00
David A. Harding
2832a7d0c5 CH14: conclusion: formatting 2023-09-01 13:23:06 +02:00
David A. Harding
0e4c076c0e CH12: conclusion: formatting 2023-09-01 13:23:06 +02:00
David A. Harding
21fbd2cf8e CH14: add conclusion 2023-09-01 13:23:06 +02:00
David A. Harding
b6a0d2f263 Dedication: formatting 2023-09-01 13:23:06 +02:00
harding
5f4acf6a4c Updated atlas.json 2023-09-01 13:23:06 +02:00
David A. Harding
fdf77a87cb Preface: update for third edition 2023-09-01 13:23:06 +02:00
David A. Harding
dcaf97aae7 All: edits for renepickhardt feedback (thanks!) 2023-09-01 13:22:08 +02:00
David A. Harding
ea1ebdfb36 Errata: remove numbers from headings 2023-09-01 13:22:08 +02:00
David A. Harding
75e1277545 All: edits for follow-up feedback from Murchandamus (thanks!) 2023-09-01 13:22:08 +02:00
David A. Harding
0cab0c9d2a Meta: edit notes for the future 2023-09-01 13:22:04 +02:00
David A. Harding
399e004211 CH05: fix script nesting (from Murchandamus feedback, thanks!) 2023-09-01 13:21:39 +02:00
David A. Harding
aba9e2258c CH14: remove introduction (from arufino feedback, thanks!) 2023-09-01 13:21:39 +02:00
David A. Harding
aefffbc5d3 CH12: clarify comment about time between blocks
Comment explained why one 10-minute block doesn't give more security
than ten 1-minute blocks but didn't also warn about the problems with
1-minute blocks.
2023-09-01 13:21:39 +02:00
David A. Harding
43ae026233 CH12: simplify PoW example
Previous example used python to describe how PoW works.  Replace
the first example with a bash one-liner and remove the unnecessary
details.

Inspired by review comments from Jorge Lesmes
2023-09-01 13:21:39 +02:00
David A. Harding
114d7bf25a Auth&Auth: explain differerence between MAST and Merklized Alt Script Trees
Inspired by a comment from Roasbeef about how we shouldn't described
MAST because that's not what taproot implements.
2023-09-01 13:21:39 +02:00
David A. Harding
89b548d5b5 All: update images for reviewer feedback
Special thanks to Murchandamus who provided most of the feedback
2023-09-01 13:21:39 +02:00
David A. Harding
8d6972d719 Libbitcoin bx: remove all mentions of vulnerable tool
- Remove appendix dedicated to `bx`.  They had already been slated for
  deletion, as I wrote to a reviewer on 2023-07-27: "I'm also probably
  going to delete the library/tool focused appendixes as I don't think
  they add anything".  After the disclosure of CVE-2023-39910 on August
  8th, it's clear that this appendix was worse than useless: it was
  harmful.

- Remove other mentions of `bx` in the book.  I had not previously
  intended this because it looked like a pain, but mentions of a tool
  often come across as endorsements to readers and no tool created by
  the team behind Libbitcoin is one I would ever want to endorse.  I
  regret that I didn't remove the mentions earlier in the process of
  updating the book.

- Remove appendix dedicated to pycoin.  I'm now aware of any problems
  with pycoin, but I don't think these sort of short detached tutorials
  add anything.  Programming Bitcoin is an entire book built on pycoin,
  and all of these tools have their own webpages that get updated more
  frequently than the book.
2023-09-01 13:21:39 +02:00
David A. Harding
d9f6cf53c7 CH12-14: edits for Murchandamus feedback
- 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.
2023-08-06 21:45:37 -10:00
David A. Harding
b8933271ff All: mostly replace "SPV client" with "lightweight client"
The description of SPV in the original paper assumed full nodes would
warn SPV clients about invalid blocks.  Such fraud proofs are not used
in production, so lightweight clients are (arguably) not SPV clients.
2023-08-06 21:08:04 -10:00
David A. Harding
672c3fdc07 All: edits for Roasbeef feedback
- Drop soon-to-be-outdated mention of current block reward amount

- Aezeed: mention internal and external version sumbers.  Instead of
  saying "global word list", clarify that both the backup and the
  recovery software need to support the same word list.

- Mention that compact block filters are something that blocks might
  commit to in the future in a consensus-enforced way.

- Add links to both RGB and Taproot Assets documentation.

- Mention that taproot assets can also support native forwarding.

- Minor edits and add some FIXMEs for later changes.
2023-08-06 21:08:04 -10:00
David A. Harding
528a7d3cbb Dedication: update for 3rd ed
- Attribute Andreas's dedication to him

- Add my dedication

Discussed with Andreas.
2023-08-06 21:08:04 -10:00
David A. Harding
54b84c9bdc CH11: small correction to relative size diff between header and block
Thanks Murchandamus
2023-08-02 15:02:37 -10:00
David A. Harding
2355a62a3f Preface: list changes since the previous edition
Suggested by Roasbeef
2023-08-02 12:39:48 -10:00