1
0
mirror of https://github.com/bitcoinbook/bitcoinbook synced 2024-12-03 21:38:44 +00:00
Commit Graph

4210 Commits

Author SHA1 Message Date
David A. Harding
562304b4cf CH02::pluralization: update to follow standard conventions
Existing text used "bitcoin" as both the singular and plural unit, which
was not an uncommon practice when the first edition was written.
However, my edits to the first chapter and this update adopt the
practice of using the same pluralization rules used for other
currencies, like the dollar, plus most numbered things in general.
This produces more natural text.

Reference: https://www.chicagomanualofstyle.org/qanda/data/faq/topics/Numbers/faq0058.html
2023-02-04 21:15:32 -10:00
David A. Harding
9435ad7d66 CH02::block explorers: modernize list and add warning
Replace older block explorers with modern alternatives and warn readers
that looking up info on explorers may disclose their interest to third
parties.
2023-02-04 06:11:19 -10:00
David A. Harding
be0ab0c6c5 CH02::intro: remove statements that Bitcoin requires trust
Users operating a full node don't need to trust anyone else for certain
guarantees about the system, although they do need at least one honest
peer to obtain some other guarantees.  Clarify this in the text by
revising text about text and emergent properties.
2023-02-03 20:58:39 -10:00
David A. Harding
ef06e4294b CH02: reflow text so that future diffs will be more readable 2023-02-03 20:49:51 -10:00
David A. Harding
bada9cbe41 CH01: minor edits for consistency, voice, and correctness 2023-02-03 20:26:17 -10:00
David A. Harding
7a0f5f49e4 CH01::Receving: remove misleading claim about address identity association
Original text claimed that there is no association between a user's
identity and their addresses prior to using that address in most
wallets, but many lightweight wallets send even their not-yet-used
addresses to remote servers to scan for incoming payments.  This is
often done over IPv4 or IPv6, which creates a link between the user's
connection and their addresses.  Update text by simply dropping this
claim.
2023-02-03 20:26:17 -10:00
David A. Harding
e9392b7ac4 CH01::Lightweight clients: direct connection to P2P network not required
SPV verification doesn't require connecting to a full node over the P2P
network.  Many clients connect to specially designed tranasctions
servers (e.g. an Electrum server) which provides them with transactions,
SPV proofs, and headers--and provide relay for outgoing transactions.
Update text to remove claims about direct P2P connection.
2023-02-03 20:26:17 -10:00
David A. Harding
b839919066 CH01::First Time: make more futureproof by removing specific prices
Also other changes to more generically describe wallet interfaces so
that screenshots can be updated in the future without changing text.
2023-02-03 20:26:16 -10:00
David A. Harding
849d49035f CH01::Addresses: mention invoices also; mention privacy concerns about address sharing
- The previous text only refers to onchain addresses, but BIP22 URIs,
  QR-encoded BIP22 URIs, and offchain invoices (like BOLT11) are the way
  many users will now exchange payment information, so the tipbox is
  generalized to refer to both addresses and invoices.

- A few words are added to clarify why sharing an address or invoice
  doesn't create security risks: Bitcoin is push-only.

- We mention the privacy downsides of sharing addresses or invoices and
  encourage generating new addresses for each payment.
2023-02-03 20:26:16 -10:00
David A. Harding
84fd8b5953 CH01::Backups: s/mnemonic/recovery code/, add detail and warnings
- Use "recovery code" instead of "mnemonic phrase" or "seed phrase".  A
  new tipbox describes that mnemonic implies memorization but that's bad
  practice.  The phrase recovery code is generic enough to apply to a
  variety of schemes, including Electrum seed words, BIP38 seed words,
  aezeed, and non-phrase schemes like that used in Muun.

- Be clearer about the difference between "wallet" and "wallet
  software".

- Mention that restoring from a code doesn't restore labels or
  offchain transaction info.

- Warn about re-entering your code into malware / phishing attacks.
2023-02-03 20:26:16 -10:00
David A. Harding
89c40241e2 CH01::Full node: clarify requirements; update "client" language to include "peer"
- Full nodes don't need to store transactions long-term or serve data to
  other software, so mention those as option

- Stop calling full nodes "clients".  Add a tipbox describing that full
  nodes are the peers on Bitcoin's P2P network.
2023-02-03 20:26:16 -10:00
David A. Harding
1db8772e86 CH01::Wallet Types: mention privacy; s/HWW/hardware signing device/
- Mention that mobile wallets and web wallets almost universally use
  remote servers for scanning, reducing privacy.

- Rename "hardware wallets" to "hardware signing devices".  In general,
  all these devices do is display info about an unsigned transaction to
  a user and then sign it if the user approves.  They need to be paired
  with other software that implements all of the other wallet behavior.
  We rename them accordingly and mention that the security and privacy
  of the wallet they pair with plays a role in the user's security and
  privacy.
2023-02-03 20:26:16 -10:00
David A. Harding
9ea0eee92a CH01::BGP: clarify problem; drop "widde applicability"
- A key element of the problem is *leaderless* selection; mention this.

- Drop the list of other things PoW helps with.  Some of them are very
  wrong, e.g. "proving the fairness of elections".
2023-02-03 20:26:16 -10:00
David A. Harding
934f08678e CH01::History: clarify Nakamoto & PoW facts
- Bitcoin was invented in 2007 (not 2008) per Nakamoto saying he'd
  worked on it for about a year and a half prior to publication.  Update
  text to just say "first described in 2008"

- Of the inventions Bitcoin combined, b-money wasn't one of them.  We
  know that Nakamoto sent his original paper to Adam Back, Back told
  Nakamoto about Wei Dai's b-mony, and Nakamoto contacted Dai in order
  to add the b-money reference to his paper as an example of a previous
  related idea.  Nakamoto was aparently unaware of b-money before then
  and so couldn't have combined it with other ideas in the creation of
  bitcoin.  Updated text from "b-money" to say "digital signatures",
  which is a critical technology that was obviously part of Bitcoin's
  original combination.

- The text describes "the" critical invention of Bitcoin as using PoW to
  conduct an global election.  Although that was critical, other factors
  may also have been critical (e.g. difficulty adjustments to keep the
  rate of issuance relatively constant).  Updated text to say "a"
  critical invention.

- Changed Bitcoin from exceeding the combined processing power of top
  super computers to exceeding the number of computing operations.
  It's not really fair to compare ASICs to general purpose CPU chips;
  it's like comparing a wrench to your hand.

- Updated the dollar value of the largest transaction to "over a billion
  dollars"; dropped the amount of the transaction fee.  I think this
  will better future-proof the text.
2023-02-03 20:26:16 -10:00
David A. Harding
f8a2340cb2 CH01::Mining: clarify that 99% of all bitcoins will be mined within a decade
Previous text mentioned all bitcoins would be mined by 2140, which is
correct but easily confuses people who don't understand exponential
decay into thinking a substantial number of bitcoins will continue to be
mined for a century.
2023-02-03 20:26:16 -10:00
David A. Harding
b2626aeb39 CH01::Mining: Clarify that miners add security to transactions
Previous text said they "verify" transactions, but that's not always the
case (e.g. validationless mining) and it may give readers the impression
that the entities primarily responsible for verifying transactions are
miners---when it's actually users who are ultimately responsible for
verifying the transactions they care about.
2023-02-03 20:26:16 -10:00
David A. Harding
bc703ce9ce CH01: minor edits 2023-02-03 20:26:16 -10:00
David A. Harding
4b08bdf3d6 CH01::Bitcoin vs Bitcoin: be less prescriptive 2023-02-03 20:25:12 -10:00
David A. Harding
21550eecd4 CH01: Reflow text to make later diffs more readable 2023-02-03 20:24:50 -10:00
David A. Harding
2f0d7d8c3a Revert CC-BY-SA material added since the second edition
The commit ab5ae32bae is the last commit
for the second edition, so all changes since then are dropped except for
several commits for the third edition authored by Andreas Antonopoulos.

No attempt is made to remove CC-BY-SA or other licensed content present
in the already-published first or second editions.

This revert may itself be reverted for versions of the book published
under CC-BY-SA.
2023-02-01 06:31:10 -10:00
Andreas M. Antonopoulos
eeca5dee4a Merge branch 'mb3dev' into main 2022-06-26 15:33:05 +02:00
Andreas M. Antonopoulos
79e870d372 New illustrations for ECDSA and Schnorr signatures 2022-06-26 15:22:09 +02:00
Andreas M. Antonopoulos
7820286ca3 schnorr signature equation explained 2022-06-26 15:22:09 +02:00
Andreas M. Antonopoulos
2791c5a700 schnorr intro 2022-06-26 15:22:09 +02:00
Pamela Morgan
bdc40d6d6b initial changes on copyright page
needs more updates later
2022-06-26 15:22:09 +02:00
Pamela Morgan
7a7365fe6f changed Second to Third Edition 2022-06-26 15:22:09 +02:00
Andreas M. Antonopoulos
b99c906fb8 bips links 2022-06-26 15:22:09 +02:00
Pamela Morgan
bec8eec981 added links to bips 2022-06-26 15:22:09 +02:00
Andreas M. Antonopoulos
37f7452a79 bech32m skeleton 2022-06-26 15:22:09 +02:00
Andreas M. Antonopoulos
195d42f548 MAST Merkle Branches skeleton 2022-06-26 15:22:09 +02:00
Andreas M. Antonopoulos
25c06254c3 Tapscript skeleton 2022-06-26 15:22:09 +02:00
Andreas M. Antonopoulos
1ccdc396c3 SegWit v1 skeleton 2022-06-26 15:22:09 +02:00
Andreas M. Antonopoulos
6d473c715a Schnorr Signatures skeleton 2022-06-26 15:22:09 +02:00
Andreas M. Antonopoulos
c0177295e7 Third edition changelog 2022-06-26 15:22:09 +02:00
aantonop
c4640b6775 Updated atlas.json 2022-06-26 15:22:09 +02:00
aantonop
ce2d6580df Updated atlas.json 2022-06-26 15:22:09 +02:00
aantonop
8db329c1e8 Updated atlas.json 2022-06-26 15:22:09 +02:00
Andreas M. Antonopoulos
827d188829 ch2 edits part 1 2022-06-26 15:22:09 +02:00
Andreas M. Antonopoulos
45df5b3fc7 ch1 edits complete
ch1 edits
2022-06-26 15:22:09 +02:00
wbnns
173974f69e
github_contrib: Add Matt Lesley 2022-06-21 19:56:10 +00:00
wbnns
7b9bbda82f
Merge pull request #1009 from MatthewWesley/patch-1
Add missing curly bracket in example JSON-RPC response
2022-06-21 18:00:20 +00:00
Matt Wesley
e53500b367
Add missing curly bracket in example JSON-RPC response 2022-06-18 12:33:26 -06:00
wbnns
77b91b1949
Merge pull request #988 from rating89us/patch-72
ch05: use Trezor Suite to export xpub
2022-01-07 14:37:43 -01:00
rating89us
92f81f9000 ch05: use Trezor Suite to export xpub 2022-01-07 15:49:58 +01:00
wbnns
6f13274541
Merge pull request #987 from lilac-ss/lilac-ss-patch-1
Fix typo in chapter 5 ("intially" => "initially")
2022-01-02 12:03:34 -01:00
lilac-ss
b28ec7d769
Fix typo in chapter 5 ("intially" => "initially") 2022-01-02 00:17:54 +09:00
aantonop
b60443feaf Updated atlas.json 2021-12-07 05:01:39 -08:00
aantonop
cb7310f973 Updated atlas.json 2021-12-07 05:01:03 -08:00
aantonop
391d1d0737 Updated atlas.json 2021-12-07 05:00:52 -08:00
Andreas M. Antonopoulos
95e6bb3cba Merge branch 'alice_bob_changes' into main 2021-12-07 13:58:10 +01:00