No description

Find a file

Claude 1c763a8c31 feat(crypto): CLSAG ring signatures (GG/GGX/GGXXG) and proof verification stubs CLSAG_GG generation and verification with flat-buffer ring marshalling. Cofactor helpers (PointMul8/PointDiv8) for 1/8 premultiplication handling. CLSAG_GGX and CLSAG_GGXXG verify-only bindings (GGX sig size tests). Bulletproofs+, BGE, and Zarcanum verification stubs — implementation deferred to Phase 4 when RPC provides real on-chain proof data. 19 tests pass, 3 skipped (proof stubs), all clean with -race. Co-Authored-By: Charon <charon@lethean.io>		2026-02-20 18:47:08 +00:00
config	feat: Phase 0 scaffold -- config, types, wire, difficulty	2026-02-20 15:10:33 +00:00
crypto	feat(crypto): CLSAG ring signatures (GG/GGX/GGXXG) and proof verification stubs	2026-02-20 18:47:08 +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.