1
0
mirror of https://github.com/bitcoinbook/bitcoinbook synced 2024-12-23 15:18:11 +00:00
Commit Graph

330 Commits

Author SHA1 Message Date
David A. Harding
fd0aed78e9 CH01-03: edits for feedback from arufino (thanks!) 2023-02-09 20:58:47 -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
33bb090291 ch1 edits complete
ch1 edits
2021-12-07 13:57:06 +01:00
Andreas M. Antonopoulos
a3229bbbc0 bitcoin/Bitcoin capitalization changed everywhere 2021-10-25 23:51:17 +02:00
Will Binns
a0282fe65e
Merge pull request #927 from chrisd95/patch-1
grammatical error
2021-05-29 22:40:41 +01:00
Will Binns
776dd89e4c
Merge branch 'develop' into bluewalletreceivescreen 2021-05-29 13:01:42 +01:00
Will Binns
37a9e205a2
Merge pull request #913 from rating89us/new-mbc_0102
ch01: update Bluewallet send screen
2021-05-29 12:58:46 +01:00
Will Binns
51fa953766
ch01: Drop additional sentence regarding tx fee
Yield to this being explained more comprehensively elsewhere.
2021-05-29 13:19:09 +02:00
chrisd95
f15b34ce91
grammatical error 2021-05-03 10:19:29 -04:00
rating89us
7bdc8d385a ch01: update bluewallet receive screen 2021-04-09 18:25:53 +02:00
rating89us
f7f1d14cc7
ch01: fix text to match new bluewallet screenshot 2021-04-09 16:03:52 +02:00
krupawan5618
d6ae9a9fde
Update ch01.asciidoc
changed electrum wording to bluewallet
2021-04-08 06:35:18 -04:00
krupawan5618
eea63c8ad0
Merge branch 'develop' into patch-4 2021-04-08 06:29:00 -04:00
Will Binns
636606f371
Merge pull request #893 from rating89us/patch-72
ch01: update joe transaction image and text
2021-04-08 11:43:30 +02:00
Will Binns
19eb8ca6d6
Merge pull request #892 from rating89us/patch-71
ch01: add AML and KYC terms
2021-04-08 11:41:50 +02:00
rating89us
04e7f2529f ch01: update joe's transaction image and text 2021-03-28 21:39:54 +02:00
rating89us
8a9d2500c4 ch01: explain mnemonic risks 2021-03-28 21:30:06 +02:00
rating89us
529a42a74f
ch01: add AML and KYC terms 2021-03-26 16:18:40 +01:00
krupawan5618
464708e210
Update ch01.asciidoc 2021-03-15 01:13:56 -04:00
krupawan5618
add7dcdc56
Update ch01.asciidoc 2021-03-15 00:37:39 -04:00
krupawan5618
b12dd237ee
Update ch01.asciidoc
Changed Airbitz to Electrum
2021-03-15 00:29:46 -04:00
Will Binns
9947af8d2b
ch01: Bring in upstream changes 2021-03-11 10:20:32 +01:00
Will Binns
59bb109f48
ch01: Additional price reference tweaks 2021-03-11 10:14:01 +01:00
krupawan5618
3a6ba5ee0a
Update ch01.asciidoc 2021-03-11 04:02:28 -05:00
krupawan5618
ede3b74bbd
Merge branch 'develop' into patch-3 2021-03-11 04:01:01 -05:00
Will Binns
a9e3eb4823
Merge pull request #874 from krupawan5618/patch-5
Update ch01.asciidoc - paragraph flow
2021-03-11 09:57:06 +01:00
krupawan5618
1bae7c30a6
Update ch01.asciidoc
double space removed
2021-03-11 03:56:18 -05:00
krupawan5618
a744a66168
Update ch01.asciidoc 2021-03-11 03:53:04 -05:00
Will Binns
f7dfcccd55
Merge pull request #873 from krupawan5618/patch-4
Ch 01: Added a Tip box regarding Satoshis
2021-03-11 09:52:21 +01:00
krupawan5618
6fd4c9212c
Update ch01.asciidoc 2021-03-11 03:47:53 -05:00
krupawan5618
fff54066f5
Update ch01.asciidoc 2021-03-11 03:45:21 -05:00
krupawan5618
aedbc2cda1
Update ch01.asciidoc 2021-03-11 03:43:35 -05:00
krupawan5618
8762686eff
Update ch01.asciidoc
paragraph flow
2021-03-11 03:37:32 -05:00
Will Binns
2ed7fd044e
Merge branch 'develop' into patch-1 2021-03-11 09:34:44 +01:00
Will Binns
87aa533b7e
ch01: Drop additional redundant use (alluded to previously) 2021-03-11 09:05:26 +01:00