From 137dfac4322df003880860b2cc9c60bdf9e626ab Mon Sep 17 00:00:00 2001 From: Dee <130502840+HodlDee@users.noreply.github.com> Date: Mon, 7 Sep 2026 19:59:32 -0400 Subject: [PATCH] Strip trailing whitespace from generated pages at write time Follow-up review round three: "the combined rebuild still produces three whitespace-only lines flagged by `git diff --check` in `docs/guides.html`. Rebuilding alone does not remove them as the response anticipated. Fix the generating template if cleaning them up." Correct on both counts. I said a rebuild would clear them and it does not, because they are not stale output. Template literals indent their blank lines along with everything else, so the generator emits them every time. The site carried 329 such lines. Harmless to a browser. Not harmless to review: `git diff --check` flags each one as it enters a diff, so any change that shifts those lines puts noise in front of the next reviewer. `tidy()` strips trailing spaces and tabs at the two points where site pages and guide pages are written. 329 lines to 6, and the remaining six are deliberate. ## What is deliberately not tidied `docs/entropy-offline.html` keeps its three, and so does the `docs/entropy.html` page built from the same Workshop source. The artifact's bytes are published as a SHA-256 and signed by build attestations that the reviewer verified in the last round. "Harmless formatting" is precisely the class of change that must not reach a file whose exact bytes are a published claim, and the site page is kept byte-identical to it for the same reason the Workshop guard checks the two together. The digest is unchanged: `61f8ed3babf359618961254c4ae9eb6fff18c33033b7dd2d9afe4def86d39987`. ## Verification `git diff -w` against the generated tree is empty, so every one of the 323 changed lines is whitespace only. A second build produces no further change, so the output is still reproducible. Co-Authored-By: Claude Opus 5 --- build/render.mjs | 17 ++- docs/coinkite.html | 16 +-- docs/devices.html | 26 ++-- docs/exchanges.html | 8 +- docs/glossary.html | 6 +- docs/guides.html | 136 +++++++++--------- docs/guides/address-types.html | 6 +- docs/guides/air-gapped-psbt-workflow.html | 4 +- docs/guides/bip85-child-seeds.html | 18 +-- docs/guides/bitbox02-setup.html | 6 +- docs/guides/bitcoin-privacy.html | 14 +- docs/guides/bitkey-setup.html | 6 +- docs/guides/bluewallet-watch-only.html | 6 +- docs/guides/bring-your-own-entropy.html | 8 +- docs/guides/chain-analysis-heuristics.html | 4 +- docs/guides/choosing-your-first-setup.html | 6 +- docs/guides/coldcard-advanced-features.html | 4 +- docs/guides/coldcard-setup.html | 8 +- docs/guides/cove-setup.html | 6 +- docs/guides/dice-entropy.html | 12 +- docs/guides/double-spend-problem.html | 10 +- docs/guides/duress-and-coercion.html | 4 +- docs/guides/electrum-setup.html | 6 +- docs/guides/exchange-account-security.html | 6 +- docs/guides/exchange-withdrawal.html | 6 +- docs/guides/how-custody-fails.html | 6 +- docs/guides/how-fees-work.html | 6 +- docs/guides/how-wallets-find-coins.html | 6 +- docs/guides/human-randomness.html | 4 +- docs/guides/inheritance-plan.html | 4 +- docs/guides/inside-the-device.html | 6 +- docs/guides/jade-setup.html | 6 +- docs/guides/keys-addresses-utxos.html | 6 +- docs/guides/krux-setup.html | 6 +- docs/guides/ledger-setup.html | 6 +- docs/guides/life-of-a-transaction.html | 20 +-- docs/guides/multisig-2of3.html | 24 ++-- docs/guides/multisig-key-geography.html | 6 +- docs/guides/nunchuk-setup.html | 6 +- docs/guides/own-node-connection.html | 4 +- docs/guides/owning-your-bitcoin.html | 6 +- docs/guides/passphrase-setup.html | 6 +- docs/guides/passport-setup.html | 6 +- docs/guides/quickstart.html | 18 +-- docs/guides/recovery-test-drill.html | 8 +- docs/guides/satscard-setup.html | 4 +- docs/guides/scripts-and-miniscript.html | 6 +- docs/guides/seed-backup-metal.html | 6 +- docs/guides/seed-to-key.html | 6 +- docs/guides/seedsigner-setup.html | 6 +- docs/guides/sparrow-coin-control.html | 6 +- docs/guides/sparrow-first-wallet.html | 6 +- docs/guides/specter-multisig-coordinator.html | 4 +- docs/guides/stuck-transaction.html | 6 +- docs/guides/supply-chain-and-vendor-risk.html | 4 +- docs/guides/tapsigner-setup.html | 6 +- docs/guides/test-transaction.html | 8 +- docs/guides/three-dice-seed.html | 2 +- docs/guides/trezor-safe-setup.html | 6 +- docs/guides/twenty-one-million.html | 6 +- docs/guides/verify-a-download.html | 6 +- docs/guides/wasabi-coinjoin-basics.html | 2 +- docs/guides/what-is-money.html | 10 +- docs/guides/what-not-to-normalize.html | 8 +- docs/guides/who-decides-the-rules.html | 6 +- docs/guides/why-run-a-node.html | 6 +- docs/index.html | 12 +- docs/software.html | 22 +-- 68 files changed, 339 insertions(+), 324 deletions(-) diff --git a/build/render.mjs b/build/render.mjs index 8c3a074..fb158c3 100644 --- a/build/render.mjs +++ b/build/render.mjs @@ -125,6 +125,20 @@ const ASSET_QUERY = /(assets\/(?:vendor\/bootstrap-icons\/bootstrap-icons\.css|c A non-greedy match on would work on the empty shell but not on an already-built file, where the header contains nested divs of its own -- so the build has to be greedy here to stay idempotent. */ +/* Trailing whitespace on generated lines, removed at the point of writing. + + Template literals indent their blank lines along with everything else, so + the rendered pages carry a few hundred lines that are nothing but spaces. + Harmless to a browser, and `git diff --check` flags each one as it enters a + diff, which puts noise in front of every reviewer of every change that + happens to shift those lines. + + Applied to the site's own pages only. The offline Workshop artifact is + written separately and deliberately untouched: its bytes are published as a + SHA-256 and signed by an attestation, so "harmless formatting" is exactly + the kind of change that must not reach it. */ +const tidy = html => html.replace(/[ \t]+$/gm, ''); + const SHELL = /
- +
- +
- +
Coinkite product family @@ -93,7 +93,7 @@

Canadian-built tools for
keys, signing, and physical bitcoin.
The key distinction

Signer, card, or bearer instrument?

Start with the role—not the form factor.

- +
@@ -104,7 +104,7 @@

COLDCARD Q / Mk5

- +
@@ -115,7 +115,7 @@

TAPSIGNER

- +
@@ -126,7 +126,7 @@

SATSCARD

- +
@@ -213,7 +213,7 @@

Do not mistake it for

  • A debit card, Ligh

Supply-chain rule

Coinkite recommends buying from its store or an authorized reseller and inspecting security products for tampering. A discount is not worth uncertainty about who handled a signing device.

- +

Product details checked against Coinkite, COLDCARD, TAPSIGNER, SATSCARD. Features, availability, and pricing can change. diff --git a/docs/devices.html b/docs/devices.html index 8e02b87..e4a6fa5 100755 --- a/docs/devices.html +++ b/docs/devices.html @@ -68,14 +68,14 @@

- +
- +
- +
Hardware signers

The many paths
to sovereignty.

@@ -112,7 +112,7 @@

Don't blindly trust device randomness

Shortlist

Nine useful reference points

This is not a winner-takes-all ranking. Each device represents a different balance of transparency, convenience, connectivity, and operator skill.

- +
- +
- +
- +

- +
- +
- +
- +
- +
- +

Product details checked against COLDCARD, Trezor, Krux, Blockstream, Bitkey, BitBox, SeedSigner, Foundation, Ledger. Features, availability, and pricing can change. diff --git a/docs/exchanges.html b/docs/exchanges.html index 855ef8e..748fdae 100755 --- a/docs/exchanges.html +++ b/docs/exchanges.html @@ -68,14 +68,14 @@

- +
- +
- +
Canadian exchanges

From FIAT IOUs
to true BITCOIN ownership.

@@ -240,7 +240,7 @@

Six Canadian routes

Bitbuy

A Canadian crypto marketplace offering Express and Pro trading, Interac and bank funding, external withdrawals, and multiple assets. It operates under Coinsquare Capital Markets.

Why people consider it

  • Canadian-focused onboarding and regulation.
  • Choice between simple quotes and a Pro interface.

Check

  • Express quotes include spread; Pro uses maker/taker pricing.
  • Crypto withdrawal fees can change with the asset and network.
Official site
- +

Product details checked against Bull Bitcoin, Bitcoin Well, Shakepay, Ndax, Kraken Canada, Bitbuy. Features, availability, and pricing can change. diff --git a/docs/glossary.html b/docs/glossary.html index de55a49..3e7c7ca 100644 --- a/docs/glossary.html +++ b/docs/glossary.html @@ -60,14 +60,14 @@

- +
- +
- +
Bitcoin reference

The BITCOIN Glossary.

diff --git a/docs/guides.html b/docs/guides.html index 577ae4d..9fa9f0b 100755 --- a/docs/guides.html +++ b/docs/guides.html @@ -68,14 +68,14 @@
- +
- +
- +
Library

A wealth of knowledge,
at your fingertips.

@@ -86,7 +86,7 @@

A wealth of knowledge,
at your fingertips.

- + - +
@@ -248,7 +248,7 @@

Guide finder

Understand the system before you move money

The vocabulary and the decisions everything else assumes you have already made.

These guides were last reviewed Aug 17, 2026 – Sep 6, 2026

- +
@@ -273,7 +273,7 @@

Intro to Self Custody

- +
diff --git a/docs/guides/address-types.html b/docs/guides/address-types.html index 72c1275..039049a 100644 --- a/docs/guides/address-types.html +++ b/docs/guides/address-types.html @@ -85,7 +85,7 @@

Why addresses look different

Updated Aug 18, 2026
AddressesSegWitTaproot
- +
@@ -134,7 +134,7 @@

Taproot, and hiding the complexity

That privacy property is not incidental — it is the whole point, and it is why complex spending conditions became practical to use without advertising to the world that you have them.

- +
@@ -195,7 +195,7 @@

Stuck on a step?

- + @@ -225,7 +225,7 @@

Stuck on a step?

- + @@ -98,7 +98,7 @@

BIP85: one backup, many wallets

That is a genuinely good trade for some people and a bad one for others, and the difference is not about how technical you are. It is about whether you will keep a record.

- +
@@ -114,7 +114,7 @@

1What it actually does

The number you choose is called the index. Index 0 produces one seed phrase. Index 1 produces a completely different one. Index 847 produces a third. The same master with the same index and the same word count always produces the same phrase, on any device that implements the standard.

- +
How BIP85 derives child seeds from one master seed @@ -123,7 +123,7 @@

1What it actually does

One seed, backed up once Every wallet below is derived from it on demand - + Master seed @@ -134,19 +134,19 @@

1What it actually does

- + Everyday wallet index 0' · 12 words - + Savings wallet index 1' · 24 words - + Handed to a niece @@ -219,7 +219,7 @@

5Uncle Jim

That does not make it a bad arrangement. It makes it a custodial one, and the trouble starts when it is described as self-custody to someone who then relies on it as though it were.

- +
@@ -337,7 +337,7 @@

Stuck on a step?

- + - + @@ -108,7 +108,7 @@

2What one ordinary payment gives awayBefore any surveillance industry gets involved, look at what falls out of a completely normal transaction.

- +
What a single ordinary transaction reveals @@ -117,13 +117,13 @@

2What one ordinary payment gives awayOne perfectly ordinary payment Nothing here is a mistake. This is what a normal transaction looks like. - + 0.4 BTC withdrawn from an exchange - + 0.15 BTC @@ -140,13 +140,13 @@

2What one ordinary payment gives away - + 0.5 BTC — the payment to whoever you are paying - + 0.0499 BTC — change @@ -251,7 +251,7 @@

Stuck on a step?

- + - + - + @@ -96,7 +96,7 @@

This guide is about reading that tool. What each control changes, what comes out the other end, and how to check the page itself before you trust anything it tells you.

- +

2Pick the source you actually have

  • Cards. A shuffled deck, drawn without replacement, so each card is worth slightly less than the last — log2(52) = 5.70 bits for the first, then log2(51), and so on. Twenty-five cards carry enough for 12 words. Twenty-four needs fifty-eight, which is more than a deck holds: draw all 52, shuffle them back together, and draw six more. The Workshop counts it the same way — it greys out the cards already drawn, and once the deck is finished it tells you to shuffle and carry on.
  • - +
    Two white dice caught in mid-air above a navy felt runner on a scarred wooden table, beside a whisky glass, a brass oil lamp, a leather notebook and a scatter of coins
    The part the page cannot do for you. Everything downstream is arithmetic; this is the only step that produces anything unpredictable.
    @@ -247,7 +247,7 @@

    Stuck on a step?

    - + @@ -214,7 +214,7 @@

    Stuck on a step?

    - + @@ -96,7 +96,7 @@

    Choosing your first setup

    The choice is not really between products. It is between shapes: how many keys, on what kind of hardware, in how many places. Pick the shape first and the product question becomes small and easy.

    - +
    Three setups arranged left to right on a desk: a phone alone, a phone beside a hardware wallet, and three hardware wallets together
    A hot wallet, a single hardware wallet, and multisig. The goal isn't to end up at the right — it's to match the shape to what you're actually holding.
    @@ -212,7 +212,7 @@

    Stuck on a step?

    - + - + - + - + - + @@ -96,7 +96,7 @@

    The problem Bitcoin solved

    Understanding why that was so difficult is the fastest route to understanding why bitcoin behaves the way it does: why you wait for confirmations, why a payment cannot be reversed, and why running your own node is worth the trouble.

    - +
    @@ -158,7 +158,7 @@

    6Which is how the order gets settled

    Now return to our double-spender. They pay a merchant, and at the same time build a competing version of history where that same coin went back to their own wallet instead. Both versions are validly signed. Both are real candidates.

    - +
    A double-spend attempt as two competing chains @@ -211,7 +211,7 @@

    7Which is why you wait for confirmations
    • Zero confirmations is not settlement. It is a credible promise, which is fine for a coffee and not fine for a car.
    • One confirmation is enough for ordinary amounts. The coin is in the chain and reversing it now costs real money.
    • Six confirmations — around an hour — is the long-standing convention for amounts you would be upset to lose, and is why exchanges make you wait.
    • Waiting is the product, not a defect. Instant reversible payments already exist; you can get them from any bank. The hour buys you the property that no one can take it back.
    - +
    @@ -264,7 +264,7 @@

    Stuck on a step?

    - +

    @@ -195,7 +195,7 @@

    Stuck on a step?

    - + - + @@ -98,7 +98,7 @@

    Lock down the exchange account itself

    One thing to say plainly first: the strongest version of this advice is do not leave bitcoin on a platform you are not actively trading on. Everything below reduces risk. Withdrawing removes it. Treat this page as protection for the account and the balance that has to live there, not as an alternative to getting your bitcoin out.

    - +
    @@ -210,7 +210,7 @@

    Stuck on a step?

    - + - + @@ -96,7 +96,7 @@

    Four ways a platform loses your bitcoin

    They are worth reading together rather than separately, because the differences are the point. If they had all failed the same way you could learn one warning sign. They did not, and the only thing every customer had in common was that their bitcoin was an entry in someone else's database.

    - +
    @@ -209,7 +209,7 @@

    Stuck on a step?

    - + @@ -126,7 +126,7 @@

    3Why the price moves

    Nothing is broken when this happens. A congested mempool is an auction with more bidders, and the posted price is simply what other people are currently willing to pay.

    - +
    @@ -183,7 +183,7 @@

    Stuck on a step?

    - + @@ -118,7 +118,7 @@

    2Reading a derivation path

    Why the address-type number matters most

    The purpose field is the one that bites people, because different wallets default to different values. A wallet that defaults to 84' restoring a seed created by a wallet defaulting to 44' will show nothing at all — the coins are sitting on the 44' branch, untouched, perfectly safe, and completely invisible until someone tells the software to look there.

    - +
    @@ -191,7 +191,7 @@

    Stuck on a step?

    - + @@ -263,7 +263,7 @@

    Stuck on a step?

    - + - + @@ -115,7 +115,7 @@

    1Where the seed actually sits

    Those are three different answers to the same question, not three quality tiers, and the rest of this page is about what each one actually costs.

    - +
    @@ -227,7 +227,7 @@

    Stuck on a step?

    - + - + @@ -96,7 +96,7 @@

    Keys, addresses, and UTXOs

    This page builds the correct picture from the bottom up. It takes about fifteen minutes and it makes everything afterwards easier — why fees behave oddly, why your wallet keeps generating new addresses, why you can restore everything from twelve words, and why sending a small amount sometimes moves your entire balance.

    - +
    A clean overhead flat-lay: a key, a padlock, and a small pile of mismatched cash notes of odd denominations, arranged left to right
    The three ideas on this page, in order.
    @@ -199,7 +199,7 @@

    Stuck on a step?

    - + - + - + @@ -96,7 +96,7 @@

    The life of a transaction

    This page follows one payment from a private key to a confirmed block. Not as instructions — there is nothing here to do — but because knowing the shape of it explains most of the advice on the rest of this site.

    - +
    The five stages of a bitcoin transaction @@ -105,31 +105,31 @@

    The life of a transaction

    What happens after you press send Five states, and one line that matters more than the others - + Signed on your device - + Broadcast to your peers - + Mempool waiting, unsettled - + In a block 1 confirmation - + Buried @@ -183,7 +183,7 @@

    3Signing, and the number that must never

    What gets signed matters. By default a signature commits to the whole transaction: every input, every output, every amount. Change a single character of the destination address afterwards and the signature stops verifying. This is precisely why checking the address on the signing device's own screen is worth doing — the device shows you what it is about to commit to, and once committed, the details cannot be edited by malware on the computer.

    - +
    @@ -217,7 +217,7 @@

    5The mempool: a waiting room nobody owns

    And there is no such thing as the mempool. Every node keeps its own, they differ from each other, and none is authoritative. When a block explorer shows you "the mempool", it is showing you one particular node's view of the queue.

    - +
    @@ -296,7 +296,7 @@

    Stuck on a step?

    - + - +

    @@ -98,7 +98,7 @@

    Where the keys actually live

    The interesting question is not where to put keys. It is which of your locations are secretly the same location — because that is the failure this whole arrangement exists to prevent, and it is invisible until it happens.

    - +
    @@ -213,7 +213,7 @@

    Stuck on a step?

    - + - + @@ -190,7 +190,7 @@

    Stuck on a step?

    - + @@ -96,7 +96,7 @@

    With great power comes great responsibility

    Take custody of your own bitcoin and those tasks do not disappear. They transfer. This page is an inventory of exactly which ones, so you can decide with your eyes open rather than discovering them one at a time.

    - +
    A single key on a plain surface, shot from above, with a long hard shadow
    The whole proposition, and the whole problem, in one object.
    @@ -193,7 +193,7 @@

    Stuck on a step?

    - + @@ -98,7 +98,7 @@

    BIP39 passphrases, and when not to use one

    There is no correct passphrase and no incorrect one. There is only which of the near-infinite wallets you land in.

    - +
    @@ -200,7 +200,7 @@

    Stuck on a step?

    - + - + @@ -98,7 +98,7 @@

    Intro to Self Custody

    There is a version of this that takes an afternoon and a version that takes six months. The difference is not intelligence or technical skill. It is whether you moved money before you understood what you were doing with it.

    - +
    A desk laid out for a setup session: a boxed hardware wallet, a recovery-phrase card and pen, a closed laptop, and a cup of coffee
    Set aside a proper block of time. This is not a thing to do between meetings.
    @@ -184,7 +184,7 @@

    Where the seed comes from is the most important decision on this page

    The fix is not to suspect a particular manufacturer. It is to remove the question from the table: supply the randomness yourself, from something physical you can watch. Do that and the quality of the device's generator stops mattering, because it is no longer the thing deciding your wallet.

    - +
    Two white dice caught in mid-air above a green felt runner on a scarred wooden table, beside a whisky glass, a brass oil lamp and a leather notebook
    A physical process you can watch, in a room you control. That is the entire argument for doing it this way.
    @@ -198,7 +198,7 @@

    Where the seed comes from is the most important decision on this page

    • Do not use a website, a phone app, or a spreadsheet to generate the number. That is trading a black box you own for one you do not.
    • Do not invent the words yourself, or pick a phrase you find memorable. Human-chosen seeds are guessed at scale, automatically, and emptied within minutes.
    • Do not shorten the roll count because it is probably enough. It is one afternoon, once, for the life of the wallet.
    - +

    Pair it with wallet software, even if the keys are cold

    A vault with a glass front. You can count what is inside, watch deposits land, and hand out deposit slots all day. Opening it takes the key, and the key is in your other hand.

    - +
    What the seed splits into: keys that spend, and keys that only watch @@ -367,7 +367,7 @@

    2Back it up

    • Write the words offline, in order, by hand, on the card the device came with or on plain paper. Do not photograph them, email them, type them into a computer, or store them in a password manager.
    • Number every word. Order is part of the secret, and an unnumbered list is a puzzle you have set for your future self.
    • Complete the wallet's confirmation step when it prompts you. It catches transcription errors while they are still free to fix.
    • Check every word is legible to somebody who is not you and who is under stress. Your handwriting is the failure mode here, not your memory.
    - +
    A close-up of a hand writing a recovery word onto a numbered backup card, several words already filled in above it
    By hand, offline. This is the step with no undo.
    @@ -432,7 +432,7 @@

    Then pick the method that matches what you own

    That last point is the entire reason this stage sits before stage four rather than after it. Prefer a second device if you have one, the built-in check if you do not, and the full wipe-and-restore while there is still nothing to lose.

    - +
    Two hardware wallets side by side on a desk with a seed card between them
    A restore you have actually performed is worth more than any amount of care taken earlier.
    @@ -462,7 +462,7 @@

    4Receive bitcoinOutcome: a small amount of bitcoin has arrived in a wallet you created, backed up, and proved you can recover — and you have moved some of it out again.

    - +
    @@ -609,7 +609,7 @@

    Stuck on a step?

    - + @@ -96,13 +96,13 @@

    Test your recovery without risking your coins

    The good news is that this is a genuinely finishable task, usually under half an hour. The bad news is that the obvious way to do it — wipe the device and type the words back in — is also the one way to turn a bad backup into an immediate, permanent loss. So the first decision is which method you use.

    - +
    Two hardware wallets side by side on a desk with a seed card between them
    A restore performed deliberately, while everything still works, is the only version of this that is safe. (The card shown is a deliberately low-entropy demo phrase — never reuse a word twelve times on a real seed.)
    - +

    Before you start

    • Your written recovery words, and any passphrase you set.
    • The device the wallet lives on, or a second one you can wipe.
    • Somewhere private. This is the one routine task where the words are out on the table.
    • Your wallet's master fingerprint or first receive address, noted down beforehand — that is what you will be checking against.
    @@ -206,7 +206,7 @@

    Stuck on a step?

    - + - + @@ -114,7 +114,7 @@

    2Timelocks: conditions that arrive later

    Crucially, timelocks can sit on one branch of a condition while other branches remain available immediately. That is what turns them from a curiosity into the basis of real inheritance and recovery designs: the normal path works today, and a fallback path quietly becomes available if the normal one goes unused for long enough.

    - +
    @@ -191,7 +191,7 @@

    Stuck on a step?

    - + @@ -96,7 +96,7 @@

    Durable seed backups

    That is the awkward property of backups: the scenarios that make you reach for one are the same scenarios that destroy paper. This page is about closing that gap without turning it into a hobby.

    - +
    @@ -206,7 +206,7 @@

    Stuck on a step?

    - + @@ -129,7 +129,7 @@

    2What the checksum actually catches

    This is why the last word is not free

    In a 24-word phrase the final word carries the last three bits of your secret followed by all eight checksum bits. That is why you cannot simply pick a twenty-fourth word you like, and why rolling your own entropy ends with a device or a worksheet computing that word for you.

    - +
    @@ -272,7 +272,7 @@

    Stuck on a step?

    - + - + - + - + - + @@ -98,7 +98,7 @@

    Your transaction is stuck

    What follows is the order to work through it: how to tell whether it is genuinely stuck, the two ways to push it through, and the one category of “help” that turns an irritating wait into a permanent loss.

    - +
    A single envelope sitting alone in a wire out-tray on an empty desk, late light, nobody around to collect it
    Posted, not delivered, and still yours until somebody picks it up.
    @@ -187,7 +187,7 @@

    Stuck on a step?

    - + @@ -198,7 +198,7 @@

    Stuck on a step?

    - + - + @@ -96,7 +96,7 @@

    Send a test transaction first

    The method is unglamorous. Before moving the balance from your hot wallet to cold storage, send a token amount along exactly the same route, and watch it arrive at the other end. Twenty minutes, most of it waiting.

    - +
    @@ -116,7 +116,7 @@

    What the test proves, and what it does not

    • It does not prove you can spend from cold storage. Receiving needs only a public address. Spending needs the device, the PIN, and a signature — none of which were exercised here.
    • It does not prove your backup works. That is a separate drill with a separate failure mode. See testing your recovery.
    • It does not prove the next address is right. The proof attaches to this destination, on this day, from this wallet. Change any of those and you are testing something new.
    - +

    Before you start

    • The cold wallet already set up, with its recovery words written down and stored.
    • The hot wallet holding the coins, with enough to cover the test amount plus fees.
    • A way to see the cold wallet's balance — the wallet software paired to your signing device, or a watch-only wallet.
    • A current fee estimate. How fees work covers reading one.
    @@ -203,7 +203,7 @@

    Stuck on a step?

    - + - + - +
    @@ -144,7 +144,7 @@

    4Where we are now

    That means the famous scarcity is largely historical. The remaining million or so trickles out over the next hundred and fourteen years, with the final satoshi arriving somewhere around 2140. Anyone buying today is buying from existing holders far more than from new supply.

    - +
    @@ -209,7 +209,7 @@

    Stuck on a step?

    - + @@ -135,7 +135,7 @@

    3The three commands

    All three must pass. Any one of them alone proves very little — a signature check without the hash check tells you the project signed some list, and a hash check without the signature check tells you your file matches a list that anyone could have written.

    - +
    @@ -222,7 +222,7 @@

    Stuck on a step?

    - + - + @@ -116,7 +116,7 @@

    2Glass beads, and the cost of making mor

    What followed was not a trick played on fools. It was a large, sustained transfer of wealth conducted in the open, at prices both sides agreed to, using a money that only one side could manufacture. When enough beads had arrived they stopped being money at all — not because anyone banned them, but because everyone could see there were now far too many.

    - +
    A handful of Venetian millefiori trade beads spilled across dark wood under a low side light, close enough that the machine-made regularity of the patterns is unmistakable
    The beads never changed. The cost of making another one did.
    @@ -136,7 +136,7 @@

    3Rai stones, and a ledger nobody wrote d

    That is a public ledger maintained by consensus, holding title to an asset nobody can pick up. It is not a bad description of a blockchain, and it is a very much older idea than the internet.

    - +
    A rai stone standing in a village clearing on Yap: a limestone disc taller than the thatched houses behind it, the central hole framing the greenery, shot slightly from below so the scale reads immediately
    A rai stone. Ownership moved by announcement; the stone stayed put.
    @@ -187,7 +187,7 @@

    5Sound money

    Modern fiat currency removes the manufacturing step altogether. There is no ore, no glassworks, no voyage. Supply is a decision, and the constraint on it is institutional restraint rather than physics or cost. Restraint can hold for a long time and frequently has. It is simply a different kind of guarantee from an expensive one, and it is worth being clear about which kind you are relying on.

    - +
    A fan of Zimbabwean hyperinflation banknotes on a dark slate surface, the top note reading one hundred trillion dollars
    Every note here was legal tender. None of them failed a technical test.
    @@ -246,7 +246,7 @@

    Stuck on a step?

    - + @@ -96,7 +96,7 @@

    What not to normalize

    Each of the six habits below is normal enough that you will find people recommending it. Each one has a specific, well-documented way of taking everything. None of them require you to be hacked, targeted, or unlucky — only to be slightly busy on the wrong afternoon.

    - +
    A phone lying face-up on a desk showing a photo gallery, with a seed-phrase card visible as one of the thumbnails
    The most expensive photograph most people will ever take.
    @@ -136,7 +136,7 @@

    4Skipping the test send

    Send an amount you would shrug at losing. Wait for it to confirm and appear in your own wallet before sending more — sending a test transaction walks the whole loop, including what to do when it does not turn up. Then do it again after any change — a new device, new wallet software, a different address type, a restored backup. Bitcoin transactions do not reverse, and no support desk anywhere can recall one.

    - +
    @@ -191,7 +191,7 @@

    Stuck on a step?

    - + @@ -156,7 +156,7 @@

    4What happened in August 2026

    Whatever one thinks of the underlying grievance — and it is a real disagreement held sincerely on both sides — the episode is an unusually clean demonstration. A change with a low threshold, insufficient support, and no broad consensus did not force anything. It produced a two-block chain that stopped.

    - +
    @@ -209,7 +209,7 @@

    Stuck on a step?

    - + @@ -128,7 +128,7 @@

    4What changes when the node is yours

  • You verify instead of asking. Your balance is a conclusion your own machine reached, not a number a stranger sent you.
  • You enforce the rules yourself. A block breaking the supply schedule or any other rule is rejected by your node regardless of how much work is behind it. This is the mechanism, not a metaphor.
  • You stop leaking. Your wallet queries your own machine, so no third party learns your addresses, balances, or IP.
  • You broadcast privately. Your transactions enter the network from your own node rather than through a service that knows they are yours.
  • You are not asking permission. Nobody can rate-limit you, log you, or decline to serve you.
  • - +
    @@ -195,7 +195,7 @@

    Stuck on a step?

    - +