go-blockchain

go-blockchain is a Go reimplementation of the Lethean blockchain protocol. It provides a pure-Go implementation of chain logic, data structures, and networking, delegating only mathematically complex cryptographic operations (ring signatures, Bulletproofs+, Zarcanum proofs) to a cleaned C++ library via CGo.

Architecture Decision: ADR-001

The project follows the Go Shell + C++ Crypto Library pattern (ADR-001):

Protocol logic (block validation, difficulty, P2P, RPC, chain storage) is written in pure Go.
Cryptographic primitives (Ed25519 ops, stealth addresses, ring signatures, range proofs) are provided by a C++ library accessed through a CGo bridge.
This is the same bridge pattern used by the project's native MLX backend (Go to C via CGo to Metal).

Lineage

CryptoNote (van Saberhagen, 2013)
    |
IntenseCoin (2017)
    |
Lethean (2017-present)
    |
Zano rebase (2025)  -- privacy upgrades: Zarcanum, CLSAG, Bulletproofs+, confidential assets
    |
go-blockchain       -- Go reimplementation of the Zano-fork protocol

The Lethean mainnet launched on 2026-02-12 with genesis timestamp 1770897600 (12:00 UTC). The chain runs a hybrid PoW/PoS consensus with 120-second block targets.

Licence

European Union Public Licence (EUPL) version 1.2

SPDX-License-Identifier: EUPL-1.2

Module Path

forge.lthn.ai/core/go-blockchain

Wiki Contents

Page	Description
Architecture	Package structure, dependency diagram, CGo boundary
Chain Parameters	Full configuration reference (tokenomics, prefixes, timing, limits, ports)
Hardfork Schedule	All 7 hardforks with heights, dates, and changes
RPC Reference	Daemon (~40 methods) and wallet (~35 methods) API documentation
Crypto Primitives	What the C++ bridge provides: signatures, proofs, hashes
Data Structures	Field-level documentation of blocks, transactions, addresses
P2P Protocol	Levin wire format, command IDs, peer management
Development Phases	9-phase roadmap from config through to full node

Source References

C++ chain: Lethean blockchain (239 files, ~37K lines)
Upstream: Zano Project (privacy protocol basis)
CryptoNote: Original protocol by Nicolas van Saberhagen