Feedback
Sign in./start

Site navigation

Theme

Learn

  • Roadmaps

Build

  • Projects
  • Developer Tools

Contribute

  • Open Source Projects
  • Issues
  • Reviews
  • First Contribution
  • BountiesSoon
  • Feedback

Prove

  • Builders

Ecosystem

  • Partners
  • Get Funded↗
  • HackathonsSoon
Sign in./start-building

Become an Open Source Builder. Learn. Build. Contribute. Prove.

Feedback welcome — open a GitHub issue.

Learn

RoadmapsStart Building

Build

ProjectsDeveloper Tools

Contribute

Open Source ProjectsIssuesReviewsFirst ContributionSupportFeedback

Prove

Builders Directory

Account

Sign in

Legal

PrivacyTermsCredits

© 2026 Pull // code MIT · curriculum CC BY-SA 4.0

PrivacyTermsCredits

lesson // bitcoin

Bitcoin Economics

Supply schedule, fee markets, mining incentives, and security assumptions.

beginner4 days

Public lesson — sign in to track progress on this roadmap.

./sign-in

On this page

Learning objectives

  • Explain the fixed supply schedule and halvings
  • Describe how fees bid for limited block space
  • Connect miner incentives to network security

study // plan

Lessons are primers. Start with Step 1 (required reading) when present, then follow the numbered steps in the article. Depth comes from primary sources, labs, reflection, and evidence.

Research on Bitcoin Search
Bitcoin supplyhalvingfee marketblock subsidy

Step 1 // Required reading

Complete these before the numbered steps in the lesson body. Links are listed here once — not repeated below.

  • bookMastering Bitcoin

    Ch. 1: Introduction

  • bookMastering Bitcoin

    Ch. 2: Overview

  • articleBitcoin Optech: Transaction fees

Reflection prompts

  1. Explain Bitcoin Economics to a teammate without jargon - what problem does it solve?
  2. What would break in production if you misunderstood Bitcoin Economics?
  3. Which BIP, book chapter, or Core doc is authoritative here, and what did you verify?

Lab // Fee and subsidy check

Complete Steps 2–3. On regtest, observe a mining reward / balance change, then compute a simple sat/vB example from a lab send or decoded fee fields.

evidence required

  • ·Regtest command output or screenshot showing a mined block / wallet balance after generatetoaddress
  • ·One sat/vB (or fee) calculation with the numbers you used
  • ·Link to the Mastering Bitcoin or Optech section you relied on
  1. 01

    Worked mental model

    Re-read the diagrams in this lesson once out loud in plain language. If you cannot explain the flow to a friend without jargon, pause and revisit the Mastering Bitcoin / Mastering Lightning chapters linked in Resources. Chapter references are intentional, not decorative.

  2. 02

    Hands-on habit

    Every protocol idea should be paired with one local experiment. That habit turns reading into builder instinct.

    1. Reproduce the happy path on regtest (or Polar for Lightning)
    2. Break it on purpose (wrong fee, expired invoice, offline peer)
    3. Write down what error you saw and which layer produced it (wallet, node, mempool, peer)
  3. 03

    Glossary check

    Pick three terms from this lesson and define them in one sentence each without opening notes. Weak definitions mean the lesson is not finished yet.

  4. 04

    Resource order

    Use Resources in order: narrative book chapter first, then BIP/BOLT for precision, then implementation docs for commands. Jumping straight to RPC flags without the mental model creates brittle knowledge.

Bitcoin is software and an incentive system. If you only memorize data structures, you will still be surprised when fees spike or blocks fill.

Complete Step 1 // Required reading in the study plan above, then continue here. Use your Foundations regtest node for the hands-on step.

Step 2 — Core idea: supply, fees, security

TermMeaningBuilder impact
Block subsidyNew bitcoin paid to the minerShrinks over halvings
HalvingSubsidy cut ~every 210,000 blocksSecurity shifts toward fees
Fee / sat/vBWhat users bid for block spaceWallet urgency
MempoolWaiting room for unconfirmed txsFee market venue

Analogy: Block space is seats on a fixed-size bus every ~10 minutes. High demand → higher fares. Miners earn fare box + subsidy.

const feeSats = inputSumSats - outputSumSats;
const satPerVb = feeSats / virtualSize;

Loading diagram…

Users bid for inclusion; miners earn subsidy and fees; hashpower secures the ledger.

Security assumption

Attacking the chain should cost more than it is worth. Fees and subsidy fund the hashpower that makes that true.

Design for fee spikes (RBF/CPFP), dust UTXOs, and different confirmation targets.

Done when: You can point to subsidy and fees in the Mermaid flow.

Step 3 — Try it on regtest (lab)

ADDR=$(bitcoin-cli -regtest getnewaddress)
bitcoin-cli -regtest generatetoaddress 1 "$ADDR"
bitcoin-cli -regtest getbalance

Remember: coinbase needs 100 confirmations before spend — mining many blocks or observing immature balance is fine.

Then compute fee / approximate sat/vB for any lab send or decoded example. One sentence: what breaks if a wallet hard-codes 10 sat/vB forever?

Common mistakes

  • Hard-coding fees forever
  • Treating the 21M cap as UX fluff
  • Assuming Lightning removes on-chain fee literacy

Done when: Lab evidence (balance output + fee calc + source link) is complete.

Next lesson

Start UTXO Model — the accounting system every wallet actually uses. Basics labs assume your local regtest chain.

review // club

Chapter review picks

Practice on real Bitcoin OSS changes tied to this chapter. Read the diff, use the checklist, and optionally paste your review comment URL in your lab notes.

  • Bitcoin Optech fee bumping topics

    Study Optech's fee-bumping overview and connect it to wallet UX when mempools are congested.

    spec review
    RBFCPFPfee markets
    40 min·intermediateopen on GitHub
  • Bitcoin Core CONTRIBUTING guide

    Read Core's contribution guidelines and note how PR scope, review culture, and CI differ from typical web repos.

    spec review
    workflowtestingscope
    35 min·beginneropen on GitHub
review checklist
  1. Does the change solve the stated problem?
  2. Are edge cases and rollout behavior covered?
  3. Are tests or test vectors included?
  4. Is the diff minimal and clearly explained?

More repos and GFIs on /discover and /issues.

discussion

Discussion

prevCryptography PrimernextUTXO Model

On this page

Press Shift + ? for keyboard shortcuts.

Press R to research on Bitcoin Search.

No questions yet — be the first to ask.