ids

Overview

The ids package provides strongly-typed identifiers for the Lux Network. It includes implementations for various ID types used throughout the ecosystem, ensuring type safety and preventing ID misuse. - Type-Safe IDs: Prevent mixing different ID types at compile time

Latest Tag: v1.2.10

Post-E2E-PQ State (current)

This repo owns the wire-discriminated NodeID surface that the rest of the Lux strict-PQ stack binds to. NodeIDScheme byte values are deliberately kept byte-equal to luxfi/consensus's SigSchemeID so a renumber in either enum trips CI.

Recent significant commits

SHA	Tag	Impact
`218ce97`	v1.2.10	NodeIDScheme + TypedNodeID for wire-discriminated NodeID derivation
`92bb7f3`	v1.2.10	Update go.mod/go.sum
`0e565b4`	v1.2.10	Go 1.26.0 → 1.26.1
`baaf5e1`	v1.2.9	feat: add IChainID for Identity chain
`434364e`	v1.2.9	feat(ids): replace I-Chain with D-Chain

Active versions

Repo: v1.2.10 (next: v1.2.11).
Pinned by: consensus v1.23.4+ (cross-validates SigSchemeID byte alignment), node v1.26.11+ (handshake wire form).

Cross-repo dependencies

Consumed by: consensus, node, crypto, bridge, sdk, genesis.
The 20-byte NodeID array stays byte-identical for storage and map keys; only the scheme byte travels alongside it on the wire.

Where to look for X

NodeIDScheme enum + bytes: node_id_scheme.go
TypedNodeID wire codec: node_id_scheme.go:ParseTypedNodeID / .Bytes
48-byte SHAKE256-384 derivation: NodeIDScheme.DeriveMLDSA
Native chains: native_chains.go

Directory Structure

.
cmd
cmd/test_native
idstest
utils
utils/wrappers

Key Files

aliases_test.go
aliases.go
basic_test.go
bits_test.go
bits.go
go.mod
id_test.go
id.go
native_chains.go
node_id_test.go

Development

Prerequisites

Go 1.21+

Build

go build ./...

Test

go test -v ./...

NodeIDScheme — wire-discriminated NodeID derivation

node_id_scheme.go owns the strict-PQ NodeID surface introduced in v1.2.10:

NodeIDScheme enum: MLDSA65=0x42 (canonical strict-PQ), MLDSA87=0x43 (high-value), Secp256k1=0x90 (CLASSICAL_COMPAT_UNSAFE only). Bytes mirror the consensus SigSchemeID enum so transcripts read the same in both packages.
NodeIDScheme.DeriveMLDSA(chainID, pubKey) (NodeID, FullDigest, error): derives a 48-byte SHAKE256-384 commitment under SP 800-185 left_encode framing of ("LUX_NODE_ID_V1" || chainID || scheme || pubkey). NodeID is FullDigest[:20] for storage/map-key use; FullDigest (48 bytes) is what handshake transcripts and validator set roots bind.
TypedNodeID = {Scheme, NodeID} is the wire form: one scheme byte followed by the 20-byte NodeID. ParseTypedNodeID / Bytes are the wire codec; ErrTypedNodeIDLen / ErrNodeIDSchemeUnknown / ErrNodeIDSchemeMismatch are the typed gate errors.

The 20-byte NodeID array stays byte-identical for storage and map keys; the scheme byte travels alongside it on the wire. Strict-PQ chains derive their 20-byte NodeID from SHAKE256-384(...)[:20]; classical chains keep their RIPEMD160 derivation via NodeIDFromCert.

Integration with Lux Ecosystem

This package is part of the Lux blockchain ecosystem. See the main documentation at:

GitHub: https://github.com/luxfi
Docs: https://docs.lux.network

Auto-generated for AI assistants. Last updated: 2025-12-24

3.5 KiB Raw Permalink Blame History

ids