agorise/hidden-rpc
Watch
1
0
Fork
You've already forked hidden-rpc
 0
Code Issues Pull requests Projects Releases 10 Packages Wiki Activity Actions
10 releases 10 tags
  • v0.1.1 ae0073dd36

    hidden-rpc v0.1.1 Stable

    agorise released this 2026-08-14 03:01:04 +00:00 | 8 commits to main since this release

    Signed by agorise
    GPG key ID: 53524E1F1017EB9C

    hidden-rpc v0.1.1

    A small hardening and correctness release. If you're already running v0.1.0, just run the
    installer again — it applies the changes with a gentle restart and never touches your chain data.

    hidden-rpc turns an ordinary computer — an old laptop is plenty — into a
    censorship-resistant Blurt RPC node, reachable privately over Tor (.onion v3) and
    I2P (.b32.i2p). No public IP, no port-forwarding, no DNS, no registrar, no hosting
    company.

    What's new in v0.1.1

    • Extra privacy safeguard. The RPC's loopback binding is now enforced on the node's
      command line as well as in its config file, so it stays private (127.0.0.1 only) even if a
      future upstream image were to change its default. Command line wins over config.
    • follow_api confirmed and documented correctly. Earlier notes carried a stale warning
      about follow_api. It has now been verified end-to-end on a live, fully-synced node (it
      serves follower data and the node stays healthy), so it remains enabled to match the official
      snapshot. The contradictory warning has been removed from the docs.
    • Two-node validation. The full one-command setup was reproduced on a second, different
      laptop, and a node has synced all the way to the live head — confirming the process is
      genuinely repeatable, not a one-off.

    One-step setup

    From the repository folder:

    ./installer/hidden-rpc-setup.sh

    It downloads everything it needs (including the ~27 GB presynced chain, with a live progress
    bar and time estimates), starts the node bound to localhost, turns on the Tor and I2P hidden
    services, and prints your two addresses. Safe to run again anytime.

    Everyday commands:

    ./installer/hidden-rpc-setup.sh --watch           # calm, live sync progress
./installer/hidden-rpc-setup.sh --status          # quick summary
./installer/hidden-rpc-setup.sh --show-addresses  # reprint .onion / .b32.i2p

    Requirements

    • 64-bit Linux (Debian / Ubuntu / Mint family), amd64.
    • About 100 GB of free disk space. Docker, Tor, and i2pd are installed automatically if missing.

    Good to know

    • After setup the node keeps catching up to the current block in the background; this is normal.
      Watch it calmly with --watch. Your I2P address takes a couple of minutes to appear on the
      first run.
    • If you ever look at the raw node logs, lines like Error when pushing block ... too old during
      catch-up are normal and harmless — duplicate blocks from multiple peers being rejected.

    Important: what this does and does not do

    Tor and I2P hide where you read, not whether what you read is true. Reaching a node does
    not make its data trustworthy — cross-checking answers across independent nodes is the reader's
    job. This release is RPC-only (no witness / block production).

    Links

    Downloads