• n0-space/btcresearch — CABRA Bitcoin Research Archive
  • Metadata
  • Purpose
  • Why It Exists
  • Architecture
    • Data Model (JSON Schema)
    • Source Structure
    • Build Pipeline
  • Contents
  • Relevance to Kapnet
    • As Research Ingest Pipeline
    • For Querant Soul
    • For Kapnet Documentation
  • Action Items

§n0-space/btcresearch — CABRA Bitcoin Research Archive

§Metadata

• Source: https://github.com/n0-space/btcresearch (fork of cdecker/btcresearch)
• License: MIT (Copyright 2016 Christian Decker)
• Language: Python + JSON + Makefile
• Size: 8.2MB
• Files: 1,748
• Origin: https://github.com/cdecker/btcresearch

§Purpose

CABRA = Comprehensive Academic Bitcoin Research Archive. Collects and organizes metadata about ongoing Bitcoin research.

§Why It Exists

• Hard to keep up with latest Bitcoin research
• Google Sheets (Brett Scott’s list) was good but uncontrolled
• Source repo with controlled contribution process is better
• JSON format enables annotation, search, derived formats (bibtex)

§Architecture

§Data Model (JSON Schema)

{
  "id": "unique-entry-id",
  "title": "Paper title",
  "authors": [{"name": "...", "affiliation": "..."}],
  "year": 2025,
  "peer-reviewed": true,
  "venue": "Conference/Journal name",
  "abstract": "...",
  "url": "https://...",
  "tags": ["privacy", "scaling", "consensus"]
}

§Source Structure

btcresearch/
  ├── btcresearch-schema.json  — JSON Schema for bibliography entries
  ├── publications/            — JSON files per paper (1,600+ entries)
  ├── gensite.py               — Python static site generator
  ├── templates/               — HTML templates
  ├── Makefile                 — Build + deploy to GitHub Pages
  ├── requirements.txt         — Python dependencies
  └── travis-key.enc           — Encrypted CI key

§Build Pipeline

1. make check — Validate all JSON files against schema
2. make site — Generate static site from JSON + templates
3. Deploy to GitHub Pages via Travis CI

§Contents

• 1,600+ academic papers on Bitcoin/Blockchain
• Peer-reviewed and non-peer-reviewed
• Tagged by topic (privacy, scaling, consensus, etc.)
• Searchable via generated static site

§Relevance to Kapnet

§As Research Ingest Pipeline

Btcresearch is a ready-made research archive system:

• JSON schema for papers
• Python static site generator
• CI/CD pipeline
• 1,600+ papers already indexed

§For Querant Soul

Querant could use this as a base:

• Ingest new papers from arXiv, etc.
• Generate categorized archive
• Export to wiki
• Search across all Kapnet research

§For Kapnet Documentation

The archive could include:

• Kapnet protocol papers
• KAP specifications
• Implementation notes
• Research on related protocols (Nostr, Lightning, CoinJoin)

§Action Items

1. Read btcresearch-schema.json for data model
2. Evaluate gensite.py for adaptation to Kapnet wiki
3. Design Querant research ingest pipeline based on this
4. Add Kapnet papers to the archive
5. Set up CI/CD for Kapnet research site