Beta

Developer Environment

Set up your toolchain, package manager, and local testing stack for Bitcoin development.

beginner3 days

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

./sign-in

Learning objectives

Install and verify Git, Node.js or Rust, and optional Docker
Understand the recommended Pull project layout
Confirm your local toolchain before moving to protocol lessons

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 development environment toolchain setup Git Node.js Rust

Step 1 // Required reading

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

docsGit Documentation
docsNode.js Downloads
Skip if Rust is your primary stack — still keep Git required.
docsRust Toolchain
Skip if Node is your primary stack — still keep Git required.

Reflection prompts

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

Lab // Toolchain verify

Complete Steps 2–4. Paste version outputs proving Git plus Node or Rust are installed, and note how you will run Bitcoin Core later (Docker, native, or Polar).

evidence required

Paste `git --version` and `node -v` or `rustc --version`
Confirm Docker or bitcoind availability (or note you will use Polar later)
One sentence on your chosen primary language for Bitcoin tooling

Every Bitcoin builder needs a reliable local environment before touching protocol code. Think of this lesson as preparing a workshop: if your tools are missing or half-configured, every later lesson becomes frustrating noise.

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

Step 2 — Key terms and required tools

Goal: Know what you are installing and why.

Term	What it means	Where you use it
Git	Version control for your code and for open source PRs	Every lesson and every contribution
Node.js / Rust	Language runtimes for wallets, CLIs, and scripts	App code and ecosystem tooling
Docker	Containers so Bitcoin Core installs the same way on every OS	Optional now; strongly recommended for `bitcoind`
Regtest	A private local Bitcoin chain you control	Next lesson and later labs — not mainnet
Bitcoin Core	Reference node software (`bitcoind` / `bitcoin-cli`)

Command	You should see
`git --version`	Something like `git version 2.x…`
`node --version`	`v20…` or newer (if Node is your primary stack)
`rustc --version`	`rustc 1.…` (if Rust is your primary stack)
`docker --version`	A Docker version string, or skip and note Polar for later

type ToolchainCheck = {
  name: string;
  command: string;
  required: boolean;
};
 
const checks: ToolchainCheck[] = [
  { name: "Git", command: "git --version", required: true },
  { name: "Node", command: "node --version", required: true },
  { name: "Rust", command: "rustc --version", required: false },
  { name: "Docker", command: "docker --version", required: false },
];

my-bitcoin-lab/
  docs/
  scripts/
  src/
  tests/

Developer Environment

Learning objectives

Step 1 // Required reading

Reflection prompts

Lab // Toolchain verify

How to study this lesson

Step 2 — Key terms and required tools

further reading

Step 3 — Setup and verification

Common mistakes

Step 4 — Hands-on check (lab)

Next lesson