No description

Find a file

Claude 1416a6714a feat(crypto): Phase 2a scaffold — vendored C++ and CMake build Extract CryptoNote crypto sources from upstream (fa1608cf). Build as static libcryptonote.a via CMake with compat stubs for external dependencies (warnings, logging, varint, profiling). 37 upstream files, 10 compat stubs, 680KB static library. Co-Authored-By: Charon <charon@lethean.io>		2026-02-20 18:21:44 +00:00
config	feat: Phase 0 scaffold -- config, types, wire, difficulty	2026-02-20 15:10:33 +00:00
crypto	feat(crypto): Phase 2a scaffold — vendored C++ and CMake build	2026-02-20 18:21:44 +00:00
difficulty	feat: Phase 0 scaffold -- config, types, wire, difficulty	2026-02-20 15:10:33 +00:00
docs	docs: archive CryptoNote+ whitepaper (Aldanov, 2018)	2026-02-20 18:03:50 +00:00
types	feat(wire): Phase 1 wire serialisation — bit-identical to C++ daemon	2026-02-20 17:16:08 +00:00
wire	feat(wire): Phase 1 wire serialisation — bit-identical to C++ daemon	2026-02-20 17:16:08 +00:00
.gitignore	feat(crypto): Phase 2a scaffold — vendored C++ and CMake build	2026-02-20 18:21:44 +00:00
CLAUDE.md	docs: graduate Phase 0 into production documentation	2026-02-20 15:24:38 +00:00
go.mod	feat: Phase 0 scaffold -- config, types, wire, difficulty	2026-02-20 15:10:33 +00:00
go.sum	feat: Phase 0 scaffold -- config, types, wire, difficulty	2026-02-20 15:10:33 +00:00
README.md	docs: graduate Phase 0 into production documentation	2026-02-20 15:24:38 +00:00

README.md

go-blockchain

Pure Go implementation of the Lethean blockchain protocol. Provides chain configuration, core cryptographic data types, CryptoNote wire serialisation, and LWMA difficulty adjustment for the Lethean CryptoNote/Zano-fork chain. Follows ADR-001: protocol logic in Go, cryptographic primitives deferred to a C++ bridge in later phases. Lineage: CryptoNote to IntenseCoin (2017) to Lethean to Zano rebase.

Module: forge.lthn.ai/core/go-blockchain Licence: EUPL-1.2 Language: Go 1.25

Quick Start

import (
    "forge.lthn.ai/core/go-blockchain/config"
    "forge.lthn.ai/core/go-blockchain/types"
    "forge.lthn.ai/core/go-blockchain/wire"
    "forge.lthn.ai/core/go-blockchain/difficulty"
)

// Query the active hardfork version at a given block height
version := config.VersionAtHeight(config.MainnetForks, 10081) // returns HF2

// Check if a specific hardfork is active
active := config.IsHardForkActive(config.MainnetForks, config.HF4Zarcanum, 50000) // false

// Encode and decode a Lethean address
addr := &types.Address{SpendPublicKey: spendKey, ViewPublicKey: viewKey}
encoded := addr.Encode(config.AddressPrefix)
decoded, prefix, err := types.DecodeAddress(encoded)

// Varint encoding for the wire protocol
buf := wire.EncodeVarint(0x1eaf7)
val, n, err := wire.DecodeVarint(buf)

// Calculate next block difficulty
nextDiff := difficulty.NextDifficulty(timestamps, cumulativeDiffs, 120)

Documentation

Architecture -- package structure, key types, design decisions, ADR-001
Development Guide -- prerequisites, test patterns, coding standards
Project History -- completed phases with commit hashes, known limitations

Build & Test

go test ./...
go test -race ./...
go vet ./...
go build ./...

Licence

European Union Public Licence 1.2 -- see LICENCE for details.