Skip to main content

Life or Death

Every pipeline on this page integrates real physics and seals the result as a verifiable ZEQ envelope + ZEQOND receipt. They are independent — each is its own endpoint, MCP tool and CLI verb — but they share the 7-step wizard and one honest rule: a result only seals if it passes its own physical reality check.

Why "life or death"? Because for real dynamics the integrator decides whether a simulation stays physical or quietly turns to nonsense. Run an orbit with the wrong method and the energy drifts, the orbit spirals, and the satellite you were tracking hits the ground — in the numbers, not the sky. The framework refuses to seal a run that has drifted off its manifold. That refusal is the product.

One door — POST /api/zeq/auto (ZeqAuto)

You do not have to know which pipeline you want or which operators it computes with. Send the query and the constants, and the solver registry routes it:

curl -sX POST https://www.zeq.dev/api/zeq/auto \
-H 'Authorization: Bearer YOUR_KEY' -H 'Content-Type: application/json' \
-d '{ "query": "price a european call option",
"constants": { "S0":100, "K":100, "sigma":0.2, "r":0.05, "T":1 } }'
# → solver "quant", operators ["KO42","BLACK_SCHOLES"], value 10.43 $,
# matchedOn ["option","price","call"], + the same envelope & ZEQOND receipt

The reply names the solver it chose, the matchedOn keywords, the real operators it computed with (heat→CHE17 Fick, flow→FL3 Navier–Stokes, sat→CS81, gauge→HEP4, …), the value, and the sealed zeqProof + zeqond_receipt — identical to calling the specific endpoint directly. Pass an explicit "solver" to skip classification. Every solver below is reachable this way, and so is zeq_auto over MCP and zeq auto on the CLI.

Verified live across pipelines: "lennard-jones argon liquid"evolve (NM19), "heat diffusion along a rod"heat (CHE17), "price a call"quant (BLACK_SCHOLES) — each classified, run, and sealed.

The pipelines

PipelineIntegratesMethodReality checkReceipt fields
/solveHULYAS master field ϕ (2nd-order ODE)RK4≤0.1% vs the referenceinternal energy
/multibodyN coupled fields / Newtonian N-bodyRK4NVE energy drift ≤0.1%internal energy, momentum
/evolveZeqEvolvemolecular dynamics (Lennard-Jones + bonds)velocity-Verlet (2nd-order symplectic)NVE energy drift ≤0.1%temperature, pressure, internal energy, momentum
/actionZeqActionHamiltonian trajectory (orbit / oscillator / pendulum)Yoshida symplectic, order 4/6/8energy drift bounded (+ RK4 comparison)internal energy
/heatZeqHeatheat / diffusion ∂T/∂t=α∇²Texplicit FTCS vs Crank–Nicolsonstability r=α·dt/dx²≤½ (explicit blows up)temperature, heat flux
/lorenzZeqLorenzthe Lorenz attractor (chaos)RK4exact contraction −(σ+1+β); Lyapunov + boundedness— (none, honestly)
/waveZeqWavewave equation / Maxwellleapfrog / Yee FDTDCourant C=c·dt/dx≤1; energy conserveddisplacement, velocity / E, B
/flowZeqFlowincompressible Navier–Stokesstable fluids (project)∇·u→0 after projectionvelocity, pressure, viscosity
/fractureZeqFracturecohesive damage / fractureperidynamic + Gauss–Seidelquasi-static equilibrium residualstress, strain, damage, elasticity, traction, contact
/reactZeqReactreaction–diffusion (morphogenesis / excitable media)explicit 2-D (Gray–Scott / FitzHugh–Nagumo)stability D·dt/dx²≤¼; pattern boundedconcentration, reaction rate

Between them, the ten pipelines fill every tier of the ZEQOND receipt with real solver output — ZeqFracture fills the material + boundary tier, and ZeqReact the chemical/biological tier, that nothing else touches.

All four are deterministic — identical inputs reproduce the trajectory and therefore the zeqProof. All four fill the receipt only with fields they genuinely computed; nothing is fabricated.

The proof of the point — symplectic vs RK4

ZeqAction integrates the same Kepler orbit two ways and returns both. RK4 has smaller local error but no structure preservation, so its energy drifts secularly; the symplectic composition's energy stays bounded by construction. Measured, ~30 orbits, dt = 0.01:

methodenergy driftangular momentum drift
RK4 (non-symplectic)7.5×10⁻⁵ % and growing
symplectic order 44.1×10⁻⁵ % (bounded)~10⁻¹⁶ (machine-exact)
symplectic order 62.1×10⁻⁷ % (bounded)~10⁻¹⁶
symplectic order 81.6×10⁻⁹ % — ~48,000× better than RK4~10⁻¹⁶

The RK4 number is the one that keeps growing with every orbit; the symplectic numbers oscillate and never accumulate. Over a long enough run the symplectic method wins at any order — that is the whole reason it exists.

Nothing was replaced

These pipelines were added, not swapped in. /api/zeq/compute, /solve and /multibody are exactly as they were. ZeqEvolve and ZeqAction are new, independent compute pipelines on the same seal — tap them from the API, the zeq_evolve / zeq_action MCP tools, the evolve / action CLI verbs, contracts, or any state machine.

  • ZeqAction — the least-action symplectic integrator (this section's proof).
  • ZeqEvolve — molecular dynamics as a sealed endpoint.
  • The ZEQOND receipt — the fields these pipelines fill.
  • The nano-zeqond — the integer-time grid ZeqAction integrates on.