Part 01 — Paradigm Shift

v0.0.1

Your keys, your data.
No middleman.

A decentralized file system that maps Unix semantics onto blockchain, encrypts everything by default, and enables trustless data commerce through atomic swaps.

Read Whitepaper Install View on GitHub →

Get Started

bitfs — install 
# Install from source
$ go install github.com/bitfsorg/bitfs/cmd/bitfs@latest

# Initialize wallet
$ bitfs wallet init

# Upload your first file
$ bitfs put ./hello.txt /my-files/

Part 02 — What is BitFS

/—

Metanet DAG

Unix filesystem on blockchain — inodes, directories, symbolic links, all as native transactions.

∴

Method 42 Encryption

Every file encrypted by default using deterministic ECDH. No key management headaches.

⊢

SPV Mode

Local transactions + Merkle proofs. Never queries the blockchain directly.

Part 03 — Architecture

Three layers, one filesystem

BitFS separates concerns into distinct layers — ownership lives on-chain, logic runs locally, and delivery scales through an incentivized network.

Layer 3

Metanet Chain

Decentralized CDN. A BSV-homomorphic chain that incentivizes data retrieval across a global network of nodes. Separate product at metanet.org.

Layer 2

BitFS Daemon

Local-first control plane. Manages encryption, transaction construction, SPV validation, and the Unix filesystem abstraction. Your keys never leave your machine.

Layer 1

BSV Blockchain

Immutable ownership layer. Stores Metanet DAG transactions, payment channels, and HTLC atomic swap contracts. Unbounded scaling for data at rest.

Part 04 — Key Features

Built for sovereignty

01

HTLC Atomic Swap

Trustless buy and sell. Hash time-locked contracts ensure fair exchange without intermediaries. If either party fails to act, funds return automatically.

Swap Protocol
1 Buyer creates HTLC, locking payment to file hash
2 Seller reveals preimage (decryption key), claims payment
3 Buyer uses preimage to decrypt file

02

Unix CLI

ls, cat, put, get — familiar commands for a revolutionary filesystem. Agent-first design means every operation is scriptable.

Terminal
# Navigate like any Unix system
$ bitfs ls -la /shared/docs/
# Pipe, redirect, compose
$ bitfs cat /notes/draft.md | wc -l
# Upload with encryption
$ bitfs put --encrypt ./file.pdf

03

Paymail Integration

Human-readable addresses. Send files to user@bitfs.org instead of cryptographic hashes. Built on the Paymail protocol for seamless identity resolution.

Address Resolution
02a1b3c4d5e6f7...8a9b0c1d2e3f4
becomes
alice@bitfs.org

04

BIP32 Access Control

Hierarchical key derivation for fine-grained file permissions. Share access to a directory without exposing parent keys. Revoke by rotating a single derivation path.

Key Hierarchy
m — master key (BIP44: m/44'/236'/...) ├— m/44'/236'/0' — vault 0 (filesystem root) │ ├— m/44'/236'/0'/0/0 — root directory │ ├— m/44'/236'/0'/0/1 — /home/ │ ├— m/44'/236'/0'/0/2 — /shared/ ├— m/44'/236'/1' — vault 1 ├— m/44'/236'/2' — payment keys

Part 05 — In Practice

See it in action

bitfs — terminal 
# Upload and encrypt a file
$ bitfs put --encrypt ./report.pdf /shared/docs/
  encrypted → tx:a3f8...c2d1  [2 inputs, 3 outputs]

# List with Merkle proofs
$ bitfs ls -l --spv /shared/docs/
  -rw-r--  42.3K  report.pdf  [spv: verified]
  -rw-r--  1.8K   notes.md    [spv: verified]

# Trustless sale via HTLC
$ bitfs sell --htlc /shared/docs/report.pdf --price 0.001BSV
  htlc published → hash:7b2e...f194  expires: 144 blocks

Part 06 — Deep Dive

Read the Whitepaper

Explore the full technical design — from Metanet DAG construction to Method 42 encryption, HTLC protocols, and the Metanet Chain incentive model.

Download Whitepaper Available in English & Chinese

Part 07 — Ecosystem

Two products, one vision

BitFS stores your files.
Metanet delivers them to the world.

Think of BitFS as the filesystem and Metanet as the delivery network. Together they form a complete decentralized storage-and-retrieval stack — analogous to how IPFS and Filecoin complement each other, but built on Bitcoin.

Visit metanet.org
Filesystem

BitFS

Decentralized encrypted file system. Unix CLI, Method 42 encryption, HTLC atomic swaps. Your keys, your data.

bitfs.org
Delivery Network

Metanet

Decentralized CDN powered by the Metanet Chain. Incentivized retrieval, global node network, MNT token economics.

metanet.org