hikari-ledger

Proof-of-Resonance distributed consensus for genesis-os node networks — a CREP-weighted alternative to Proof-of-Work and Proof-of-Stake.

Instead of energy-intensive hash computation (PoW) or capital-based staking (PoS), Proof-of-Resonance (PoR) validates blocks based on each node's CREP harmonic state — the same Coherence/Resonance/Emergence/Poetics tensor used throughout the GenesisAeon ecosystem. Nodes whose CREP state is in higher harmony with the network (higher Γ) earn proportionally more validation weight; a block is accepted once weighted agreement crosses the classic Byzantine fault tolerance threshold of 2/3.

Installation

pip install hikari-ledger

Usage

from hikari_ledger import HikariLedger

ledger = HikariLedger(seed=42)
result = ledger.run_cycle(n_nodes=50, n_blocks=100)
print(result["acceptance_rate"])

print(ledger.get_crep_state())   # {"C": ..., "R": ..., "E": ..., "P": ..., "Gamma": ...}
print(ledger.get_utac_state())   # {"H": ..., "H_star": 0.667, "K": 1.0, ...}
print(ledger.get_phase_events())  # consensus failures / forks
print(ledger.to_zenodo_record())

Or via the CLI:

hikari-ledger run --nodes 50 --blocks 100
hikari-ledger simulate-attack --byzantine-fraction 0.30
hikari-ledger energy-comparison --vs-pow --vs-pos

Physical mapping (UTAC)

Γ_PoR = arctanh(2/3) / σ ≈ 0.367. CONSENSUS_THRESHOLD=2/3 is a genuine mathematical fact (Byzantine fault tolerance), but σ=2.2 is a shared default reused unchanged across unrelated GenesisAeon UTAC packages and never independently derived for distributed-consensus systems — so Γ_PoR is not independently comparable to other domains' Γ values. Its apparent closeness to the Manna sandpile SOC value (0.376, sandpile-utac) is a coincidence of similar threshold magnitudes both passing through the same shared σ, not evidence that PoR consensus and sandpile dynamics share underlying physics — see constants.py's GAMMA_POR docstring for the full reasoning.

Role in the GenesisAeon Ecosystem

hikari-ledger is P29 in the GenesisAeon CREP Criticality Spectrum, representing the distributed-systems domain. It implements the Proof-of-Resonance consensus layer used to coordinate genesis-os node networks, weighting validation rights by each node's measured CREP state rather than computational work or staked capital.

Citation

Built with uv · Typer