brk/README.md

Description

kibō (hope in japanese) is primarily an open source Bitcoin Core data extractor and visualizer (similar to Glassnode) which goal is to empower anybody with data about Bitcoin for free.

The project is split in 3 parts:

• First you have the extractor (parser), which parses the block data files from your Bitcoin Core node and computes a very wide range of datasets which are stored in compressed binary files

  For the curious, it takes at the very least 24 hours to parse all the blocks and compute all datasets. After that it will wait for a new block and take between 1 and 3 minutes to be up to date

• Then there is the website on which you can view, among other things, all datasets in various charts
• Finally there is the server which serves the website and the generated data via an API

Whether you're an enthusiast, a researcher, a miner, an analyst, a trader, a skeptic or just curious, there is something for everyone !

This project was created out of frustration by all the alternatives that were either very expensive and thus discriminatory and against bitcoin values or just very limited and none were open-source and verifiable. So while it's not the first tool trying to solve these problems, it's the first that is completely free, open-source and self-hostable.

If you are a user of mempool.space, you'll find this to be very complimentary, as it offers a macro view of the chain over time instead of a detailed one.

Instances

URL	Type	Version	Status	Last Height	Up Time Ratio
kibo.money	Main
backup.kibo.money	Backup
preview.kibo.money	Dev

Please open an issue if you want to add another instance

Endpoints

If you running locally, you can replace https://kibo.money by http://localhost:3110

• /: Website
• /api: A JSON with all available datasets, with their respective id and endpoint, better viewed in a Firefox based browser
• /api/TIMESCALE-to-ID: TIMESCALE can be date or height, and ID is the id with _ replaced by -, let's take date-to-close (price at the end of each day) as an example
  • /api/date-to-close: current year's values in a json format
  • /api/date-to-close?chunk=2009: values from the year 2009 in a json format
  • /api/date-to-close?all=true: all values in a json format
  • You can also specify the extension to download a file, either .json or .csv to get the dataset in a CSV format; like so:
    • /api/date-to-close.csv
    • /api/date-to-close.csv?chunk=2009
    • /api/date-to-close.csv?all=true

Roadmap

• More Datasets/Charts
• Simulations
• Nostr integration
• API Documentation
• Descriptions
• Docker support
• Start9 support

Setup

Requirements

• At least 16 GB of RAM
• A disk with 1 TB of free space (will use between 40% to 80% depending on several things)
  • Recommended: Rated at 3 GB/s (Thunderbolt 4 speed)
• A running instance of bitcoin-core
  • Example: bitcoind -datadir="$HOME/.bitcoin" -blocksonly
• Git
• Unix based operating system (Mac OS or Linux)
  • Ubuntu users need to install open-ssl via sudo apt install libssl-dev pkg-config
  • Mac OS:
    • Disable Spotlight or exclude the --kibodir folder from it
    • Don't use Time Machine or exclude the --kibodir folder (especially needed for local snapshots)

Build

First we need to install Rust (https://www.rust-lang.org/tools/install)

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

If you already had Rust installed you could update it

rustup update

Then you need to choose a path where the project will reside and then clone it

cd ???
git clone https://github.com/kibo-money/kibo.git
cd kibo

If it's your first time running kibo, it will need several information such as:

• --bitcoindir PATH: path to bitcoin core data directory, ???/bitcoin
• --kibodir PATH: path to kibo outputs, if you have enough space on your main disk ~/.kibo is fine

Everything will be saved at ~/.kibo/config.toml, which will allow you to simply run cargo run -r next time

If you need more options please run cargo run -r --help to see what parameters are available.

Here's an example

cargo run -r -- --bitcoindir=~/Developer/bitcoin --kibodir=~/.kibo

Then the easiest to let others access your server is to use cloudflared which will also cache requests. For more information go to: https://developers.cloudflare.com/cloudflare-one/connections/connect-networks/

Donate

bc1q950q4ukpxxm6wjjkv6cpq8jzpazaxrrwftctkt

lnurl1dp68gurn8ghj7ampd3kx2ar0veekzar0wd5xjtnrdakj7tnhv4kxctttdehhwm30d3h82unvwqhkxmmww3jkuar8d35kgetj8yuq363hv4

Geyser Fund