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

Soft Forks & Activation

How Bitcoin upgrades consensus without splitting the network - BIP9, Speedy Trial, and UASF history.

intermediate6 days

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

./sign-in

On this page

Learning objectives

  • Distinguish soft forks from hard forks and why soft forks dominate Bitcoin upgrades
  • Explain BIP9 / Speedy Trial style signaling and what miner signaling does not prove
  • Summarize UASF (BIP148) as a social-technical activation path

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
soft forkBIP9

Step 1 // Required reading

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

  • docsSoftfork wiki
  • bipBIP-9 Version bits
  • articleBitcoin Optech: Soft fork activation

Reflection prompts

  1. In one paragraph, why can a soft fork remain backward-compatible for non-upgraded nodes while still changing what is valid for upgraded nodes?
  2. What does miner signaling measure, and what does it fail to measure about economic node preference?
  3. When would a flag-day or UASF-style activation be considered, and what failure modes should builders fear?

Lab // Activation timeline brief

Complete Steps 2–3. Pick one historical soft fork (CSV, SegWit, Taproot). Write a one-page brief covering proposal, signaling method, activation height/date, and who had to upgrade.

evidence required

  • ·One-page markdown brief with sources linked
  • ·Explicit list of software that had to upgrade (miners, full nodes, wallets)
  • ·Note one risk that almost happened or was debated
  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 evolves through soft forks more often than hard forks: tightened rules that upgraded nodes enforce, while old nodes still see the chain as valid under older rules.

Complete Step 1 // Required reading in the study plan above, then continue here.

Step 2 — Core idea: soft vs hard, signaling vs users

Builders who ship Script, Taproot, or Lightning features need to know how consensus changes actually land — and that “miners signaled” is not the whole story.

  • Soft fork: new rules are a subset of old rules (more restrictive). Non-upgraded nodes may not understand new features but still follow the chain if upgraded miners / economically relevant nodes enforce.
  • Hard fork: previously invalid blocks become valid (or incompatible validation). Risk of permanent split without coordinated migration.

Loading diagram…

Soft forks tighten rules; activation coordinates when upgraded enforcement locks in.

Modern activations often use version bits (BIP9 family) or variants like Speedy Trial: miners set bits to signal readiness during a window; thresholds and timeouts decide lock-in.

Signaling ≠ consent of users

Miner hashrate signaling is a coordination signal, not proof that users, exchanges, or economic nodes want the change. History (BIP148 UASF debates) shows social layers matter.

Builder checklist

  1. Read the BIP activation parameters (start, timeout, threshold)
  2. Know which software must upgrade (policy vs consensus)
  3. Test on signet/regtest forks before assuming mainnet behavior

Done when: You can explain why a soft fork is “backward compatible” for non-upgraded nodes in one sentence.

Step 3 — Activation timeline brief (lab)

Pick CSV, SegWit, or Taproot. Write a one-page brief: proposal, signaling method, activation height/date, who had to upgrade, and one risk that was debated.

Common mistakes

  • Treating soft forks as “just a software update” with no wallet/relay impact
  • Confusing policy (mempool standardness) with consensus validity
  • Ignoring that light clients may see different security assumptions during upgrades

Done when: Lab evidence (brief + upgrade list + risk note) is complete.

Next lesson

Mining & Consensus — proof-of-work, difficulty, and who actually enforces the rules.

further reading

  • articleForks, Signaling, and Activation

review // club

Review club

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 Core soft-fork related PRs

    Review a Core PR touching soft-fork activation or consensus rules and note rollout implications.

    pr review
    rolloutversion bitstests
    55 min·advancedopen 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.

progress // sign in

Reading is public. Sign in to mark lessons complete, sync across devices, and unlock your roadmap.

./sign-in-to-track

discussion

Discussion

prevSecurity Models & Light ClientsnextMining & Consensus

On this page

Press Shift + ? for keyboard shortcuts.

Press R to research on Bitcoin Search.

No questions yet — be the first to ask.