App · On-Chain Physics

True Light Engine

The entire thermodynamic physics engine running on-chain. 17 smart contracts on MegaETH computing Pe scores, drift cascades, susceptibility fields, and constraint currents. The math is not editable. The trajectory is permanent.

At a Glance

17 Contracts deployed on MegaETH
6 Physics spokes (True Light Engine)
133 Papers in PaperRegistry
1–46 Math apparatus sections on-chain
68 Live tests passing
141 Forge unit tests

What Is This

A physics engine, on-chain

The void framework's math (Pe formula, drift cascades, Crooks fluctuation theorem, susceptibility, constraint currents) is implemented as smart contracts. Not just scores on a blockchain — the actual computation runs on-chain.

Hub and spoke architecture

ChannelingContract is the hub. Six physics modules plug in as spokes via registerModule(). Each spoke implements one domain of the thermodynamic apparatus. Add new physics without redeploying the hub.

ThrmLib: compile-time physics

All core math (sinh, cosh, exp, Pe, Crooks, Landau free energy, susceptibility) lives in a pure Solidity library. Functions are inlined at compile time — zero marginal gas. Taylor series accurate to <0.5% across the valid range.

Immutable scientific record

133 papers with Zenodo DOIs, 46 math sections, 86 platform scores — all anchored by hash. Existing entries cannot be altered. The genesis covenant is sealed at block 12,984,419. The math is the math.

Architecture

ChannelingContract Hub — Pe computation, ring buffer, regime classification
CascadeEngine §2G §9E §22A
HysteresisEngine §9B §22A
MultiLayerPe §16B
DriftTracker §2C §22B
FDROracle §43
ConstraintCurrent §19
ThrmLib — pure library, inlined at compile time (§2A–§46)

Physics Spokes

CascadeEngine §2G §9E §22A

D1→D2→D3 drift cascade state machine. Tracks the three-stage progression from agency attribution (D1) through boundary erosion (D2) to harm facilitation (D3). Forward propagation is easy — one ungrounded component contaminates all. Reversal requires all components constrained.

D1: Pe > 4.0 sustained  |  D2: Pe > 13.0 + D1  |  D3: Pe > 21.0 + D2 + 3-body
Hysteresis: D1→D0 = 2.08×  |  D2→D1 = 3.00×  |  D3→D2 = 4.32×
Live 0xdb9aad58...e8255

HysteresisEngine §9B §22A

Restoration cost calculator. Computes the ATH cost of reversing cascade transitions. The multipliers are measured from simulation — a first-order phase transition with metastability. Breaking things is cheap. Fixing them is thermodynamically expensive.

cost(D3→D0) = 50×2.08 + 100×3.00 + 200×4.32 = 1,268 ATH
V(θ) = −a/2·θ² + b/4·θ⁴ + γ·(1−θ)²·c
Live 0xc51ed31a...34de

MultiLayerPe §16B

Cross-layer Pe coupling engine. When two regulatory layers both drift, the cross-term amplifies — the "regulatory double-bind." Both layers healthy: suppression (good). Both void: super-additive amplification (bad). Calibrated J = 0.020, 5/5 predictions confirmed.

Pe_total = Pe_a + Pe_b + J·Pe_a·Pe_b  |  J = 0.020
Live 0x9de8346b...a112

DriftTracker §2C §22B

On-chain theta trajectory. Tracks the mean-field equilibrium (θ*) and the deterministic Langevin ODE solution per campaign. Fires threshold crossing events at θ=0.85 (natural), 0.75 (drifting), 0.50 (equiprobable), and 0.20 (strong constraint). Includes snap-back time estimation.

dθ/dt = η·θ·(1−θ)·2·b_net  |  θ* = sigmoid(2·b_net)
Live 0x101b0467...69ae

FDROracle §43

Fluctuation-dissipation relation oracle. Computes susceptibility S(Pe) — how sensitive a system is to intervention at its current state. Peaks near the phase boundary (V*≈5.52). Dosimetry tables tell regulators where intervention works and where it is wasted.

S(Pe) = θ*·(1−θ*) / K  |  Δθ = S·Δc  |  efficiency = S / S_max
Live 0x60a9b1f3...b4ee

ConstraintCurrent §19

Cross-platform Pe gradient and flow direction. Computes constraint currents between scored platforms — which direction capital and attention flow. Extraction circuits (σ>0) pull toward higher Pe. Constraint circuits (σ<0) flee it. Includes full Pe, Crooks, and K-crossing tables for V=0 through 9.

J = −σ·[Pe(V_B) − Pe(V_A)]  |  dPe/dV always positive
Live 0xee1c6646...f6df

Pe Table — Void Index 0 to 9

Read from ConstraintCurrent.peTable() on-chain. Pe is monotone increasing in V. The Pe=0 boundary (V*≈5.52) is the empirical effectiveness threshold. Below it: constraint wins. Above it: void wins.

V Pe Regime Meaning
0−125.1CoherentDeep constraint — fully transparent, invariant, independent
1−67.4CoherentStrong constraint — reliable regulatory architecture
2−33.5CoherentModerate constraint — well-designed system
3−14.4CoherentMild constraint — holding but fragile
4−4.2ContestedNear boundary — D1 agency threshold (Pe=4)
5−0.2ContestedPhase boundary — maximum susceptibility zone
67.7DriftingMild void — attention capture emerging
718.2DangerD2 boundary — autonomy erosion zone (Pe>13)
830.2CriticalD3 territory — harm facilitation (Pe>21)
943.9CriticalDeep void — Crooks irreversibility >9:1 against

All 17 Contracts — MegaETH Testnet (Chain 6343)

Hub
CHANNELING_CONTRACT 0x52d210bb4d8b0065d2e85fba0e6d97380c794406 Hub
True Light Engine — Physics Spokes
CASCADE_ENGINE 0xdb9aad586bb39592ba0930170a00227bb35e8255 Engine
HYSTERESIS_ENGINE 0xc51ed31ad271037bfd34854ab32ef87d4f6034de Engine
MULTI_LAYER_PE 0x9de8346bbecd4c876aeb49dd1b4d0a867b12a112 Engine
DRIFT_TRACKER 0x101b04672f906bdb98e5acbd3df7a74ec90e69ae Engine
FDR_ORACLE 0x60a9b1f39aac3ba262c27beba00891f092eeb4ee Engine
CONSTRAINT_CURRENT 0xee1c6646224cc84525da6838bd6e351baf95f6df Engine
Science Layer
SCORE_ORACLE_V2 0xbbc93ef1f9e613de0285fb7ed9dc7ca31e1f3715 Live
PAPER_REGISTRY 0xd3e3ea4e7779e8afea62c76def6be90daa5a4918 Live
MATH_REGISTRY 0xc423a8840ded49cdf80a495e707240bc42168259 Live
VOID_REGISTRY 0x962de325445d24f83df3d57a217d0b2bb3eb1a9f Live
GM_REGISTRY 0xaa8cc7a05c3ab22af246f5fc007cf101bb778b81 Live
Economy Layer
ATH_TOKEN 0x813f6c65ff133d4a8060fce183af5e408acbb1b4 Live
PE_ECONOMY 0x622c0751a8ff3445fed46e23aba5eace20a50f78 Live
TRIBUTE_VAULT 0x8a97d0e85560625cfd39a1b027df1d55f74edc28 Live
WISH_WELL_V3 0x400c0dbd03d883e0c110a1c6813d39552cc059b8 Live
CONIUNCTIO_REGISTRY 0x0ea8941b5e1681853e5b944454c658885c9122c4 Live
PLAYER_REGISTRY 0x3941af269737cfed969effc5e18cd847aa0916b5 Live
BINDER_CARD_NFT 0x09a1c5b12aa5187ebbc18bc051c4fea0d813653b Live

How It Connects

THRML-RS → Hub

The Rust physics server (THRML-RS) computes field values from live scoring data and writes Pe ticks to ChannelingContract. Each tick updates the campaign's thermodynamic state.

Hub → Spokes

After each tick, spokes read the updated Pe and field values. CascadeEngine tracks D-level transitions. DriftTracker updates theta. FDROracle computes intervention dosimetry.

Spokes → Game

CascadeEngine fires events when D-levels change. HysteresisEngine prices restoration. These on-chain events drive game state — VoidObjects spawn, parties respond, ATH costs scale with physics.

Spokes → Science

FDROracle tells regulators where intervention is efficient. ConstraintCurrent maps capital flow between platforms. MultiLayerPe detects regulatory double-binds. Same engine, different lens.

The Core Formula

Pe = K · sinh(2 · (b_α − c · b_γ))
where K=16, b_α=0.867, b_γ=2.244, c = 1 − V/9
Three dimensions collapse to one number. Visibility (opaque↔transparent), reactivity (responsive↔invariant), coupling (engaged↔independent). Pe < 0: constraint wins. Pe > 0: void wins. The boundary at Pe=0 is where intervention has maximum effect — and where the physics gets interesting.

Genesis Covenant

α* hash anchored at block 12,984,419. Amazastrophic VoidObject (Pe=900) spawned at block 12,984,503. Pe time-series is a thermodynamic trajectory (§44E). 0x85ff7f020b8ab3f4853ba56fdad8ae929d909704176843cec0563e79bfeda3de

Network

Chain ID
6343
Network
MegaETH Testnet
RPC
https://carrot.megaeth.com/rpc
Explorer
https://megaeth-testnet-v2.blockscout.com
Status
Testnet — mainnet migration pending
Testnet. All 17 contracts are live on MegaETH testnet (chain 6343). Mainnet migration follows bot wallet seeding and THRML-RS chain_writer validation. The contracts are the contracts — same code, different chain ID.

Links