$ show tari-project/tari
This repository is the Rust implementation of the Minotari/Tari base-layer blockchain protocol. It is primarily a large application monorepo, although it embeds deep cryptographic and consensus research. In production, it ships as several runnable binaries: a base node (minotari_node), a console wallet (minotari_console_wallet), a SHA-3 miner (minotari_miner), a Monero merge-mining proxy (minotari_merge_mining_proxy), an offline signer, and experimental MCP servers (minotari_mcp_node, minotari_mcp_wallet) that expose node and wallet capabilities to AI agents. The node validates and stores blockchain data using LMDB for chain state and SQLite for peer/wallet/DHT metadata, synchronizes via block/header/horizon sync state machines, and communicates over a custom stack combining TCP/Tor transports, Noise encryption, and a DHT for discovery and message propagation. Wallets construct confidential transactions with Pedersen commitments, range proofs, covenants, and one-sided payments, and expose gRPC/HTTP APIs. Architecturally, the workspace is divided into base-layer crates (core, wallet, transaction_components, mmr, p2p, sidechain), a custom comms stack (comms/core, comms/dht), shared infrastructure (service_framework, storage, shutdown, metrics, derive, hashing), and application binaries. The service framework uses Tower-style initializers and reply channels; the consensus layer includes multiple PoW algorithms (SHA3x, Cuckaroo, Monero RandomX), validation pipelines, mempool management, reorg handling, and sidechain validator-node logic. Data flows from transaction construction in the wallet through gRPC/HTTP submission to the node's mempool, then into block templates, validation, and LMDB chain storage; P2P messages propagate over the DHT/Tor transport. Code quality is generally strong: core components have extensive integration tests, benches, CI workflows, and careful error typing. The MMR, sparse Merkle tree, hashing, and dedup cache components are cleanly isolated and reusable. However, the size of the codebase leads to some rough edges: MCP servers contain placeholder implementations, wallet FFI code relies on raw unsafe, and a few modules carry stale comments or dead code. Overall, this is a professionally maintained blockchain implementation rather than an experimental research repo.
The LLM identified 4 files worth highlighting for reuse:
Implements a Merkle Mountain Range, an append-only authenticated data structure, with pruning, serialization, and inclusion proofs. The crate is standalone, tested, and benchmarked, making it directly reusable for any project needing verifiable logs or UTXO/kernel commitments.
A generic sparse Merkle tree (Jellyfish Merkle Tree) implementation backed by a pluggable key-value store, with an in-memory store included. It provides a clean abstraction for authenticated state in distributed systems and can be extracted as a standalone crate.
Defines the hash_domain! macro and domain-separated hasher utilities used across consensus, transactions, MMRs, and wallets. Domain separation is a non-obvious cryptographic best practice; this crate packages it in a way that can be reused by any Rust project needing typed hash domains.
SQLite-backed message dedup cache with Diesel upsert-on-conflict and automatic trimming of least-recently-hit entries. It solves a recurring distributed-systems problem, duplicate message suppression, and is decoupled enough to be reused for event ingestion, webhook dedup, or P2P message caches.