gitwtfhub

wtf is lnbook?

adamjonas/lnbook — explained in plain English

Analysis updated 2026-07-18 · repo last pushed 2020-08-16

Audience · researcherComplexity · 3/5DormantLicenseSetup · easy

TL;DR

An open-source O'Reilly textbook that teaches how the Bitcoin Lightning Network works and how to use it for instant, low-fee payments.

Mindmap

mindmap
  root((repo))
    What it does
      Lightning Network textbook
      Open source book
      O'Reilly publication
    Topics
      Payment channels
      Network routing
      Running a node
    Use cases
      Learn Lightning internals
      Set up wallets and nodes
      Contribute to the book
    Audience
      Developers
      Node operators
      Bitcoin researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Learn how Lightning payment channels and network routing work under the hood.

REASON 2

Follow step-by-step guidance to set up a Lightning wallet or run your own Lightning node.

REASON 3

Contribute fixes, clarifications, or new content to an in-progress open-source technical book.

REASON 4

Use as a reference manual for building or operating Lightning-based applications.

What's in the stack?

BitcoinLightning Network

How it stacks up

adamjonas/lnbook0verflowme/alarm-clock0verflowme/seclists
Language—CSS—
Last pushed2020-08-162022-10-032020-05-03
MaintenanceDormantDormantDormant
Setup difficultyeasyeasyeasy
Complexity3/52/51/5
Audienceresearchervibe coderops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

The book itself is still in progress, about two-thirds complete, so some chapters remain rough outlines.

Free to read and share for personal use under Creative Commons, derivative works restricted until after official publication.

Yoink these prompts

Prompt 1
Explain how Lightning Network payment channels work based on the concepts covered in the lnbook textbook.
Prompt 2
Walk me through setting up my own Lightning node using the guidance from Mastering the Lightning Network.
Prompt 3
I want to contribute a chapter edit to the lnbook GitHub repo. How is the book structured and what's the contribution process?
Prompt 4
Summarize how Lightning routes payments between users compared to a normal Bitcoin transaction.

Frequently asked questions

wtf is lnbook?

An open-source O'Reilly textbook that teaches how the Bitcoin Lightning Network works and how to use it for instant, low-fee payments.

Is lnbook actively maintained?

Dormant — no commits in 2+ years (last push 2020-08-16).

What license does lnbook use?

Free to read and share for personal use under Creative Commons, derivative works restricted until after official publication.

How hard is lnbook to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is lnbook for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane