From 2f9dd47cc2ddf04853b7dc56cc793a44d50a1302 Mon Sep 17 00:00:00 2001 From: nym21 Date: Mon, 16 Feb 2026 19:25:18 +0100 Subject: [PATCH] docs: updated --- docs/{HOSTING.md => PROFESSIONAL_HOSTING.md} | 8 +-- docs/README.md | 51 +++++++++++++++---- docs/SUPPORT.md | 12 ----- docs/qr.png | Bin 0 -> 71548 bytes 4 files changed, 42 insertions(+), 29 deletions(-) rename docs/{HOSTING.md => PROFESSIONAL_HOSTING.md} (64%) delete mode 100644 docs/SUPPORT.md create mode 100644 docs/qr.png diff --git a/docs/HOSTING.md b/docs/PROFESSIONAL_HOSTING.md similarity index 64% rename from docs/HOSTING.md rename to docs/PROFESSIONAL_HOSTING.md index a1664d9d7..67aa1b72e 100644 --- a/docs/HOSTING.md +++ b/docs/PROFESSIONAL_HOSTING.md @@ -1,10 +1,4 @@ -# Hosting - -## Self-Hosting - -BRK is designed to be self-hosted. See the [brk_cli documentation](https://github.com/bitcoinresearchkit/brk/blob/main/crates/brk_cli/README.md#brk_cli) for installation, requirements, and configuration options. - -## Professional Hosting +# Professional Hosting Need a managed instance? We offer professional hosting services. diff --git a/docs/README.md b/docs/README.md index 8ca64bfdc..50f84825b 100644 --- a/docs/README.md +++ b/docs/README.md @@ -4,57 +4,88 @@ [![Crates.io](https://img.shields.io/crates/v/brk.svg)](https://crates.io/crates/brk) [![docs.rs](https://img.shields.io/docsrs/brk)](https://docs.rs/brk) [![Supported by OpenSats](https://img.shields.io/badge/supported%20by-opensats-ff7b00)](https://opensats.org/) +[![Discord](https://img.shields.io/discord/1350431684562124850?label=Discord&logo=discord&color=5865F2)](https://discord.gg/WACpShCB7M) +[![X](https://img.shields.io/badge/@_nym21_-000000?logo=x)](https://x.com/_nym21_) +[![Nostr](https://img.shields.io/badge/Nostr-purple?logo=nostr)](https://primal.net/p/nprofile1qqsfw5dacngjlahye34krvgz7u0yghhjgk7gxzl5ptm9v6n2y3sn03sqxu2e6) > "Shout out to Bitcoin Research Kit and researchbitcoin.net. Two data sources for On-Chain Data. Couldn't recommend them highly enough." > — James Check (CheckOnChain), [What Bitcoin Did #1000](https://www.whatbitcoindid.com/episodes/wbd1000-checkmate) -Open-source on-chain analytics for Bitcoin. Combines functionality of [Glassnode](https://glassnode.com) (on-chain metrics), [mempool.space](https://mempool.space) (block explorer), and [electrs](https://github.com/romanz/electrs) (address index) into a single self-hostable package. Runs entirely off a Bitcoin node, no exchange feeds or external APIs required. [Bitview](https://bitview.space) is a hosted instance of BRK. +Open-source, self-hostable on-chain analytics for Bitcoin. Block explorer, address index, and thousands of metrics, all from your own node. No external APIs required. + +Similar to [Glassnode](https://glassnode.com) + [mempool.space](https://mempool.space) + [electrs](https://github.com/romanz/electrs) + [UTXO Oracle](https://utxo.live/oracle/) in a single package. + +[Bitview](https://bitview.space) is a free hosted instance of BRK. ## Data -**Blockchain** — Blocks, transactions, addresses, UTXOs. +**Blockchain:** Blocks, transactions, addresses, UTXOs. -**Metrics** — Supply distributions, holder cohorts, network activity, fee markets, mining, and market indicators (realized cap, MVRV, SOPR, NVT). +**Metrics:** Supply distributions, holder cohorts, network activity, fee markets, mining, and market indicators (realized cap, MVRV, SOPR, NVT). -**Indexes** — Date, height, halving epoch, address type, UTXO age. +**Indexes:** Date, height, halving epoch, address type, UTXO age. -**Mempool** — Fee estimation, projected blocks, unconfirmed transactions. +**Mempool:** Fee estimation, projected blocks, unconfirmed transactions. ## Usage ### Website -Browse metrics and charts visually. Use it free at [Bitview](https://bitview.space), no signup required. +Browse metrics and charts at [bitview.space](https://bitview.space), no signup required. ### API -Query thousands of metrics and blockchain data in JSON or CSV. Freely accessible at [Bitview](https://bitview.space/api). +```bash +curl https://bitview.space/api/blocks/count/height +``` + +Query metrics and blockchain data in JSON or CSV. [Documentation](https://bitview.space/api) · [JavaScript](https://www.npmjs.com/package/brk-client) · [Python](https://pypi.org/project/brk-client) · [Rust](https://crates.io/crates/brk_client) · [LLM-friendly schema](https://bitview.space/api#tag/server/GET/api.json) ### Self-host +```bash +cargo install --locked brk_cli && brk +``` + Run your own website and API. Private, verifiable, self-sovereign. Runs alongside Bitcoin Core. -[Guide](./HOSTING.md) +[Guide](https://github.com/bitcoinresearchkit/brk/blob/main/crates/brk_cli/README.md) · [Professional hosting](./PROFESSIONAL_HOSTING.md) ### Library +```bash +cargo add brk +``` + Build custom applications in Rust. Use the full stack or individual components (parser, indexer, computer, server). [Reference](https://docs.rs/brk) · [Architecture](./ARCHITECTURE.md) ## Supporters -- [OpenSats](https://opensats.org/) (December 2024 – June 2026) +- [OpenSats](https://opensats.org/) (December 2024 - June 2026) [Become a supporter](mailto:support@bitcoinresearchkit.org) +## Donations + +Checkmate +Johan +ClearMined + +Bitcoin donate QR code + +[`bc1q09 8zsm89 m7kgyz e338vf ejhpdt 92ua9p 3peuve`](bitcoin:bc1q098zsm89m7kgyze338vfejhpdt92ua9p3peuve) + ## Links - [Changelog](./CHANGELOG.md) -- [Support](./SUPPORT.md) - [Contributing](https://github.com/bitcoinresearchkit/brk/issues) + +## Community + - [Discord](https://discord.gg/WACpShCB7M) - [X](https://x.com/_nym21_) - [Nostr](https://primal.net/p/nprofile1qqsfw5dacngjlahye34krvgz7u0yghhjgk7gxzl5ptm9v6n2y3sn03sqxu2e6) diff --git a/docs/SUPPORT.md b/docs/SUPPORT.md deleted file mode 100644 index 36d873a9b..000000000 --- a/docs/SUPPORT.md +++ /dev/null @@ -1,12 +0,0 @@ -# Support - -## Donate - -**Bitcoin:** [`bc1q09 8zsm89 m7kgyz e338vf ejhpdt 92ua9p 3peuve`](bitcoin:bc1q098zsm89m7kgyze338vfejhpdt92ua9p3peuve) - -## Other Ways - -- Star the [repository](https://github.com/bitcoinresearchkit/brk) -- Share BRK with your network -- Contribute code or documentation -- Join the community on [Discord](https://discord.gg/WACpShCB7M) or [Nostr](https://primal.net/p/nprofile1qqsfw5dacngjlahye34krvgz7u0yghhjgk7gxzl5ptm9v6n2y3sn03sqxu2e6) diff --git a/docs/qr.png b/docs/qr.png new file mode 100644 index 0000000000000000000000000000000000000000..274dba533520388c7b1727e367dc41e51d4a43a3 GIT binary patch literal 71548 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 q(Tn2^KJpHpUyR7q#m8b