Navio Technical Knowledge Base

Navio is a Bitcoin Core fork with BLSCT confidential transactions at the base layer. Amounts and parties are hidden for every shielded output, while the chain remains publicly verifiable through BLS12-381 range proofs and Pedersen commitments. Its consensus algorithm is Proof-of-Private-Stake (PoPS) — stake weight without disclosing balances or controlled outputs.

This knowledge base documents the entire Navio surface — protocol, node operation, RPC, BLSCT internals, SDK, explorer, and integration guides:

• Concepts

  The protocol from the top down. BLSCT privacy model, outpoint semantics, consensus & supply, networks, wallet formats.

• Node Operator

  Build, run, and operate naviod. Configuration reference, staking, ElectrumX, pruning, backup, security hardening.

• RPC Reference

  Every JSON-RPC command, grouped by category. Full BLSCT RPC surface — tokens, NFTs, raw transactions, balance proofs.

• BLSCT Protocol

  BLS12-381, double public keys, output construction, view tags, amount recovery, range proofs, signatures, on-chain format.

• SDK — navio-sdk

  TypeScript SDK for wallet management, sync, and transaction construction. Runs in Node.js and browsers.

• libblsct-bindings

  Multi-language bindings for libblsct — TypeScript (native + WASM) and Python shipping; C, Rust, Go planned. Curve primitives, keys, range proofs, CTx.

• Block Explorer — navio-blocks

  Full-stack block explorer. Indexer, REST API, React frontend. Self-host guide + complete API reference.

• Guides

  End-to-end tutorials: build a wallet, mint NFTs, run a staking VPS, atomic swaps, exchange integration.

---

Quick links

• New to Navio? Start with the protocol overview.
• Running a node? Follow the install guide.
• Integrating? Use the SDK quickstart or call RPC directly.
• Building privately-aware explorers or analytics? Read the outpoint model and BLSCT deep dive.

---

Project repositories

Repository	Purpose
nav-io/navio-core	naviod, navio-cli, navio-staker, navio-wallet — the reference C++ implementation.
nav-io/navio-sdk	TypeScript SDK for wallets, sync, and transactions.
nav-io/libblsct-bindings	Multi-language bindings for libblsct — TypeScript (native + WASM), Python. C/Rust/Go planned.
nav-io/navio-blocks	Block explorer (indexer + API + frontend).
nav-io/navio-developer-docs	This site. Contributions welcome via PR.

---

About this documentation

API references for the SDK and BLSCT library are automatically generated nightly from the upstream repositories using TypeDoc. RPC documentation is generated from naviod -help and source headers. The explorer's REST API is generated from its OpenAPI (Swagger) spec. If you spot an outdated handwritten page, open an issue or a PR.