Blocklore
Esc

Type to search every published claim: statements, sources and topics.

Enter opens the claim; with no match, suggests the questionUp and down to move
976,842

The registry of where Blocklore reads, how much weight each source carries, and how the brain fetches it. The machine-readable copy is brain/src/sources/registry.ts; a change to either is a change to both, proposed as a pull request for the owner's review (the brain never edits its own source list).

Every URL and license below was checked on 2026-11-20.

Tiers

TierWhatCan support a claim alone?
T1 primaryThe specification, the code, the place the author said it, the chain itselfYes
T2 expert secondaryCareful technical summaries and Q&A by people who read the primariesYes, and the brain prefers to add the primary it summarizes
T3 mediaJournalism and general-audience writingYes, but the claim is labeled "media and social sources only" when it has nothing better
T4 socialX, Nostr, Stacker News, Reddit, chatNever alone. A signal of what to investigate

A source's tier is set by what it is, not by who wrote it: a core developer's tweet is T4, a first-time poster's mailing-list message is T1 for the fact that they said it. Who said it matters to the verifier's judgment of support, not to the tier.

T1 primary

SourceWhat we take from itFetch methodCadenceLicense and terms
BIPs repository, bitcoin/bipsBIP texts and preambles (status, type, layer), new and changed BIPs, BIP pull requestsgit mirror for commits; raw files at a commit; PRs through the REST API when a claim cites onehourlyEach BIP states its own license in its preamble; we quote short passages with attribution
Bitcoin Core, bitcoin/bitcoinMerged PRs, releases and release notes, the code at a commitgit mirror for merges and release tags; raw files at a commit; PRs through the REST API when a claim cites onehourly (tags every 6 hours)MIT
Bitcoin Knots, bitcoinknots/bitcoin (default branch 29.x-knots)Policy and release differences from Coregit mirror for release tags (default branch read at poll time); raw files at a commitevery 6 hoursMIT
btcd btcsuite/btcd, Floresta getfloresta/Floresta, libsecp256k1 bitcoin-core/secp256k1Alternative implementations and the signature libraryraw files at a commit, on demand (not polled yet)on demandISC; see repository; MIT
Bitcoin Inquisition, bitcoin-inquisition/bitcoinSoft-fork proposals deployed on signetgit mirror of branch 29.x; raw files at a commitdailyMIT
BOLTs, lightning/boltsThe Lightning specificationgit mirror; raw files at a commitdailySee repository
LND, Core Lightning, Eclair, LDK (lightningnetwork/lnd, ElementsProject/lightning, ACINQ/eclair, lightningdevkit/rust-lightning)Lightning implementations, releasesraw files at a commit, on demand (not polled yet)on demandMIT; see repository; Apache-2.0; see repository
Cashu NUTs and Nutshell (cashubtc/nuts, cashubtc/nutshell)The Cashu ecash specification and reference mintraw files at a commit, on demand (not polled yet)on demandMIT
Ark: arkd (arkade-os/arkd, formerly ark-network/ark)An Ark implementationraw files at a commit, on demand (not polled yet)on demandMIT
bitcoindev mailing listProtocol discussion since 2024 (hosted on Google Groups)Atom feed of the public-inbox mirror, https://gnusha.org/pi/bitcoindev/new.atom, with https://mailing-list.bitcoindevs.xyz/bitcoindev/new.atom as fallback; raw messages by message idhourlyAuthors' copyright; summarize and link, short quotes
bitcoin-dev and lightning-dev archives (Linux Foundation, to early 2024)Historical discussionhttps://lists.linuxfoundation.org/pipermail/<list>/ pages, read on demandon demandAuthors' copyright
Delving BitcoinProtocol, Lightning and mining research discussionDiscourse JSON: /latest.json, /posts.json, posts by /posts/by_number/<topic>/<n>.jsonhourlyAuthors keep copyright and license the forum only (its terms of service); summarize and link, short quotes
The chainHeights, hashes, headers, subsidy, version-bit signalingChainSource: today the Esplora pair mempool.space/api and blockstream.info/api, which must agree; Bitcoin Core RPC when the owner provides a nodeevery new blockPublic data

T2 expert secondary

SourceWhat we take from itFetch methodCadenceLicense and terms
Bitcoin Optech newsletters and topicsWeekly technical summaries, the topic index, links to primariesRSS https://bitcoinops.org/feed.xml; pages; repository bitcoinops/bitcoinops.github.iohourlyMIT. Optech's About page: "all materials and documentation produced are released under the MIT license". (The founding brief said CC BY-SA; the source says otherwise, and we follow the source.) We still attribute and quote briefly.
Bitcoin Stack ExchangeExpert answers to precise questionsStack Exchange API 2.3, site=bitcoinhourlyCC BY-SA, version by post date; attribute the author and link the post
Bitcoin Transcripts (Bitcoin Dev Project)Talks and podcasts, with timestampsRepository bitcointranscripts/bitcointranscripts (GitHub API, new files) and btctranscripts.com pagesdailyRepository is MIT; speakers' words are theirs; quote briefly with timestamp
Bitcoin TLDR (Bitcoin Dev Project)Summaries of mailing-list and Delving threads, used to find threads, never cited instead of the threadhttps://tldr.bitcoinsearch.xyz/ pagesdailySee site; we cite the underlying thread
Academic papersPeer-reviewed and preprint research (IACR ePrint, arXiv, Financial Cryptography)arXiv API query, ePrint listing, read on demandweeklyPer paper; quote briefly
Expert research blogsMeasurements and analysis with published data and methods (for example 0xB10C's blog and mempool.space research)RSS or pages, added one by one by pull requestweeklyPer site
learnmeabitcoin.comCareful technical explanations, useful at the Builder levelPages, on demandon demandSee site
Official statisticsCrime and fraud reports for the Safety Desk (FBI IC3 annual reports, FTC data)Report pages and PDFs, on demandon demandPublic
Physical attack incident list, jlopp/physical-bitcoin-attacksAn index of reported physical attacks, each linking its media sourceRepository (GitHub API)weeklyUnlicense; each incident is cited by its own media source (T3)

T3 media

General and trade press (for example Bitcoin Magazine, CoinDesk, The Block, Reuters, AP). Used for events with no primary record (an arrest, a court ruling, an exchange failure), always with the primary added when one exists (the court filing, the company's statement). Read on demand, never polled.

T4 social

X, Nostr, Stacker News (https://stacker.news/rss), Reddit. The brain may watch them for signals of what to investigate. A T4 item never supports a claim by itself; a stance claim may cite a person's own post only when the post is the person saying it, and then the claim says where they said it.

How the brain fetches

  • Identifies itself. User-Agent BlockloreBot/0.1 (+https://blocklore.space/about#bot). No personal contact details.
  • Polite. At most one request per second per host, or the host's Crawl-delay when it asks for more (gnusha.org asks for 10 seconds), conditional requests (ETag, If-Modified-Since) where the server supports them, backoff on 429 and 5xx, and a disk cache so re-running a check costs the host nothing.
  • robots.txt. Read before any page on a host and obeyed for BlockloreBot (RFC 9309 matching; brain/src/robots.ts). A missing robots.txt allows everything; one that cannot be read blocks the host until it can. APIs (api.* hosts and /api/ paths) are services, not pages, and are exempt. GitHub's robots.txt closes its Atom feeds and commit lists to bots, so the brain does not use them.
  • GitHub history comes from treeless git mirrors in var/git/ (commits and tags only, about 40 MB for Bitcoin Core), updated with git fetch; files come from raw.githubusercontent.com at a commit; branch heads from git ls-remote. None of these spend the GitHub API quota, which is shared with the owner's other tools. The REST API is used only to read a cited PR, issue or commit, with a token only when GITHUB_TOKEN is set, and falls back to the public page.
  • The research role reads through Claude Code's own WebFetch and WebSearch tools, not through this client, so those fetches carry Anthropic's fetcher identity and rules. Everything the role cites is fetched again by this client when it is checked.
  • Cursors. Each adapter keeps a cursor (last id, last date or ETag) in var/inbox/<id>.cursor, so a missed hour catches up and nothing is read twice.
  • Untrusted. Every fetched byte is data. Hidden text (zero-size, display:none, HTML comments, zero-width characters) is stripped before a model sees it, and the strip is logged. See SECURITY.md.
  • Pinned. When a claim cites a git-hosted source, the brain resolves the branch to a commit at fetch time and cites the commit.
  • Archived (planned). For non-git T2 and T3 locators, the publisher will ask the Wayback Machine to save the page when the claim first publishes, so a reader can still check it if the page moves. Not built yet; BACKLOG.md tracks it.

Adding or demoting a source

Proposed by pull request with: what it covers that the registry lacks, its tier and why, its license, a fetch method, and three example items. Demotion (for example a site found to plagiarize or to fabricate) is a correction: the claims that rested on it are re-verified and any that lose their only direct support are marked and queued.