pkg/

Package chain provides blockchain chain ID helpers and validation utilities.

Package config provides a tiny loader that populates a configuration struct from multiple sources with clear precedence:

Package entities defines shared domain types for P2P messaging and dynamic configuration.

Package hash provides SHA-256 and xxHash helpers for message and content hashing.

Package identity manages libp2p node identity keys on disk.

Package io provides atomic file I/O and rotating file writer utilities.

Package jwks implements a JWKS cache with disk fallback and background refresh.

Package logger defines the structured AppLogger interface and slog-backed helpers.

Package maps provides generic map utility functions.

Package math provides safe integer conversions with overflow protection.

Package net provides external IP detection, multiaddr builders, and HTTP client helpers.

Package pointers provides generic pointer conversion helpers.

Package rand provides cryptographic random byte and integer utilities.

Package slices provides generic slice operations such as unique, filter, chunk, and flatten.

Package sql provides bulk insert and upsert SQL query builders with retry helpers.

Package syncx provides concurrency primitives including TTL maps, RW maps, broadcasters, and balancers.

Package telemetry provides geolocation lookup and Prometheus metric registry helpers.

Package test_utils provides shared test helpers and fixtures for Optimum services.

Package version exposes build version and commit metadata injected at compile time.