πŸ“– The complete guide to State Contracts β€” what they are, how to use this studio, where they live

Part 1 Β· What a state contract is

A state contract is a small physics state machine that runs on your state machine. You declare the states it can be in (e.g. idle β†’ watching β†’ alert) and the transitions between them. Each transition carries a real operator β€” the verbatim equation of a physical law (NIST CODATA-bound, ≀0.1% precision) β€” and fires when a value crosses your threshold, or on a time trigger. The kernel evaluates it on the HulyaPulse heartbeat (1.287 Hz) and writes every fire to your tamper-evident entangled state.

Not a blockchain smart contract (no gas, no bytecode, financial-only). State-first, pulse-synchronised, physics-grade, chain-rooted.

Part 2 Β· The easy pipeline (4 steps)

  1. Pick β€” describe it in ✦ Generate (the kernel architects it), pick a template by name (πŸ“š, 69 industry examples), or write JSON in ⌁ Expert. Always: preview β†’ one-click deploy.
  2. Set β€” your thresholds and (optionally) where it runs: this state machine, or your own server.
  3. Deploy β€” it’s saved to your state machine and starts safe (paused-ready).
  4. Manage β€” find every contract under πŸ“ Saved: open, edit, pause/resume, fire, or change hosting. This is your contracts’ home.

Part 3 Β· Where your contracts are saved (the files question)

Every contract you deploy is saved on your state machine and listed under πŸ“ Saved here (and in Workbench β†’ step 7 Β· Files). Each deploy snapshots a version β€” roll back any time. Every fire is a row on your entangled-state chain, viewable in the chain observer.

Part 4 Β· Hosting elsewhere β€” run the compute on your own server

By default a contract’s compute runs on this state machine. You can instead point its execution at your own server (a signed webhook URL): the kernel sends each transition’s payload to your endpoint, your code computes, and the signed result is written back to your chain. The contract, its state, and its proof stay anchored to your state machine β€” you just host the work wherever you like. Set it per-contract under πŸ“ Saved β†’ Hosting.

Part 5 Β· The shape of a contract (JSON, for Expert)

  • name (required, 1–255), states object (one initial), transitions array of { from, to, operator, condition?, trigger? }.
  • Triggers: recurring (every N Zeqonds), one_shot, on_event/on_events, on_aggregate.

Part 6 Β· Cost

Each fire is billed in credits (fuel); the compute mints a ZEQ envelope (80% to you on paid-funded). Heavier operators cost more.

resolving your state machine…
Loading State Contracts…