Skip to main content

Oracle Feed (External Ingest)

Brings the outside world in. Every 60 Zeqonds it calls your registered oracle external protocol, binds the response, runs KO42, and emits oracle_datum — a signed, Zeqond-stamped record of exactly what the upstream returned and when. The honest substrate for price feeds, weather, lab instruments, any third-party data. (Wire an external API named oracle on your machine first.)

CategoryFoundations
Template IDoracle-feed
Definitionoracle_feed v1.0
States2 (initial: live; terminal: paused)
Transitions2
Operators composedKO42
Audit clockon · tick rate 1

What it's for

  • Price / FX / rate oracles
  • Weather & IoT gateway polling
  • Lab instrument or vendor-API ingest

States

StateRole
liveinitial
pausedterminal

Transitions

FromToOperatorFires whenProofTrigger / actions
liveliveKO42norecurring · every 60 Zeqonds · pre: api_call oracle/latestfeed; post: emit oracle_datum
livepausedKO42input.pause == trueno

Operators it composes

Each transition fires a registry operator through the master equation (compute → prove → verify). This template composes:

  • KO42

Browse the operators at /operators/; the building blocks a transition calls are the framework's protocols. KO42 is the always-on substrate operator; physics operators carry proof_required: true, so each fire runs the full compute → prove → verify path and lands a verifiable proof digest on your entangled state.

Deploy it

Inspect the full definition, then deploy it onto your state machine. Every fire is Zeqond-stamped onto your entangled state.

# 1. Inspect — the full definition (states, transitions, operators) as served
curl -sS https://zeqsdk.com/api/contracts/templates/oracle-feed

# 2. Deploy onto your machine (auth: session; body carries your machine slug)
curl -sS -X POST https://zeqsdk.com/api/contracts/templates/oracle-feed/deploy \
-H "Content-Type: application/json" \
-b "<your session cookie>" \
-d '{"slug":"<your-machine>"}'
# → 201 { "ok": true, "contract": { "id": "…", "currentState": "live", … },
# "template_id": "oracle-feed" }

The deploy path runs the same two-stage validation as the canonical create route (ContractDefinitionSchema.parse + validateContractDefinition against the live registry), writes the creation row onto your entangled state, and schedules the first fire. From there, drive transitions with POST /api/chain/<your-machine>/contracts/<id>/transition or let any triggers fire them autonomously.

Next

  • Contract IDE — author, preview, and deploy contracts (this template is in the Templates tab).
  • State Contracts — the full contract model: conditions, triggers, pre/post actions, lifecycle.
  • Templates Library — every ready-to-deploy contract, grouped by category.
  • Protocols — the named building blocks a transition composes.