RoadmapsProjects
Sign in./start

Learn

RoadmapsProjects

Contribute

DiscoverIssues

Account

Sign in./start-building

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

Learn

RoadmapsProjectsStart Building

Contribute

DiscoverIssues

Account

Sign inDashboardSettings

Legal

PrivacyTerms

© 2026 Pull // all rights reserved

PrivacyTerms

lesson // bitcoin

Bitcoin Core & RPC

Operate bitcoind and drive wallets, chain queries, and tests over RPC.

intermediate5 days

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

./sign-in

On this page

Learning objectives

  • Configure bitcoind safely for development
  • Use JSON-RPC for wallet and chain operations
  • Separate RPC auth from public interfaces

study // plan

Lessons are primers. Depth comes from required reading, interactive labs, reflection, and a hands-on check with evidence — the BOSS study pattern.

Research on Bitcoin Search

Required reading

  • bookMastering Bitcoin

    Ch. 3: Bitcoin Core

Reflection prompts

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

Lab // Regtest check

After reading, run one hands-on check related to Bitcoin Core & RPC. Prefer local regtest or Polar over mainnet.

evidence required

  • ·Command output or screenshot from your local lab
  • ·One sentence on what you observed vs expected
  • ·Link to the required reading section you used

Bitcoin Core (bitcoind + bitcoin-cli) is the reference full node. Most serious backends either run it or carefully justify an alternative.

Why this matters

RPC is how you mine regtest blocks, fund addresses, inspect mempools, and import descriptors. Misconfigured RPC is also how servers get drained.

Analogy

bitcoind is the engine; RPC is the instrument cluster and ignition keyed to authorized operators. Never bolt the ignition onto the public internet.

Essential workflow

bitcoind -regtest -daemon
bitcoin-cli -regtest getblockchaininfo
bitcoin-cli -regtest createwallet "dev"
bitcoin-cli -regtest getnewaddress
bitcoin-cli -regtest generatetoaddress 101 <address>

Loading diagram…

Authenticated RPC controls node and wallet operations.

RPC exposure

Bind RPC to localhost. Use cookie auth or strong credentials. Never put rpcallowip=0.0.0.0/0 on a valued node.

Useful call families

  • Blockchain: getblock, getrawtransaction
  • Mempool: getmempoolentry, estimatesmartfee
  • Wallet: sendtoaddress, importdescriptors, PSBT RPCs

Common mistakes

  • Using one wallet for experiments and savings
  • Forgetting -regtest and talking to the wrong chain
  • Parsing RPC errors poorly and retrying unsafe sends

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 Mastering Bitcoin / Mastering Lightning chapters linked in Resources. Chapter references are intentional, not decorative.

Hands-on habit

Every protocol idea should be paired with one local experiment:

  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)

That habit turns reading into builder instinct.

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.

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.

Next steps

Automate regtest in Docker and CI so protocol tests become routine.

further reading

  • docsBitcoin Core RPC reference
  • docsbitcoin.conf options

progress // sign in

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

./sign-in-to-track
prevDescriptors & MiniscriptnextRegtest Development

On this page

Press Shift + ? for keyboard shortcuts.

Press R to research on Bitcoin Search.