Skip to main content
note

Current public-DAV authority boundary — 2026-07-12. Pre-launch target design; nothing here proves a live system. A public-DAV consequence may occur only when at least two natural-person councilors bind the exact consequence in a complete valid bound PRISM decision receipt. PRISM records and verifies that receipt only; it never serves as council, signatory, authority, or receipt producer. AI and caste seats stage unsigned proposals only; they never authorize or execute a public-DAV consequence. Constitution or membership adoption establishes constitution and membership only; it does not authorize a later consequence. Policy may constrain an unsigned proposal but never authorizes execution or substitutes for the complete consequence-bound receipt. Before receipt validity, consequence fails closed to read-only proposal, simulation, or deterministic sandbox; live evidence remains gated_pending_complete_valid_bound_receipt. Software deterministically carries out only the exact consequence bound to a complete valid bound PRISM decision receipt from at least two natural-person councilors binding that exact consequence.

Three-Stage Process API Contracts — F1 through F4

Current canonical packet spine — 2026-07-25

The current cross-organ contract is longer than the historical four-packet illustration below because authority, execution, outcome, and adoption are non-substitutable states:

SignalPacket -> ForecastPacket -> DecisionDocket -> ProposalEnvelope
-> ExactConsequence -> AuthorizationReference -> ExecutionIntent
-> ExecutionReceipt -> OutcomeReceipt -> GenomeAdoptionProposal

Circle owns SignalPacket; RealityFutures owns the external ForecastPacket; Agentz compiles DecisionDocket and unsigned ProposalEnvelope; applicable external authority binds only one ExactConsequence; Skyzai may execute only that consequence. An execution receipt is not an outcome receipt, and an outcome may propose genome adoption but cannot mutate the active genome.

Missing probability, warrant, model/oracle/resolution metadata, or freshness produces UNKNOWN/HOLD, never an imputed 0.5. These repository contracts and local fixtures do not establish live packet flow, authority, execution, settlement, or world evidence.

Historical F1–F4 illustrative contract body — preserved for provenance

Overview

The four organs communicate through typed, versioned JSON interfaces. Each interface is a one-way data contract. No organ reads another organ's internal state. All inter-organ communication passes through exactly one of these four channels.

Circle ──F1──> ReFu ──F2──> APU ──F3──> Skyzai ──F4──> Circle

F1: Circle -> RealityFutures (SignalPacket)

Circle publishes verified OSINT signals. ReFu consumes them as market inputs.

{
"schema": "skyzai.signal.v1",
"signal_id": "sig_a1b2c3d4",
"timestamp": "2026-04-12T14:32:00Z",
"source": {
"source_id": "src_reuters_feed",
"eigentrust_score": 0.87,
"source_type": "news_api"
},
"claim": {
"text": "ECB signals rate hold through Q3 2026",
"category": "monetary_policy",
"entities": ["ECB", "EUR"],
"geo": "EU"
},
"evidence_tier": "E",
"watchman_score": 0.82,
"corroboration": {
"independent_sources": 3,
"cross_ref_ids": ["sig_x1", "sig_x2", "sig_x3"]
},
"nostr_event_id": "note1abc...",
"k0_ledger_seal": "ar://tx_hash_abc123"
}

F2: RealityFutures -> APU (ProbabilityBundle)

ReFu outputs priced probabilities. APU consumes them as decision inputs.

{
"schema": "skyzai.probability.v1",
"market_id": "mkt_ecb_q3_hold",
"question": "ECB holds rates through Q3 2026",
"timestamp": "2026-04-12T14:35:00Z",
"lmsr_price": 0.74,
"ensemble_estimate": 0.71,
"confidence_interval": {
"lower_95": 0.62,
"upper_95": 0.83
},
"market_depth": {
"volume_24h_sky": 12450.0,
"total_liquidity_sky": 89200.0,
"num_traders": 847
},
"resolution_date": "2026-10-01T00:00:00Z",
"related_axioms": ["axm_ecb_q1_hold", "axm_ecb_q2_hold"],
"input_signals": ["sig_a1b2c3d4"],
"model_weights": {
"timesfm": 0.45,
"chronos": 0.35,
"domain_specialist": 0.20
}
}

F3: Agentz -> Skyzai (ProposalEnvelope)

APU outputs an unsigned proposal and never signs or executes a consequence. The v1 path described here is public-DAV only. A future private Natural-Person adapter may accept only that Person's exact signed instruction. For the public DAV, software deterministically carries out only the exact consequence bound to a complete valid bound PRISM decision receipt from at least two natural-person councilors binding that exact consequence. PRISM records and verifies only.

This is a [D] target contract, not proof of a live authority or settlement runtime. proposal_hash is SHA-256 over the RFC 8785 JSON Canonicalization Scheme (JCS) encoding of the complete F3 object, excluding only the proposal_hash field itself.

{
"schema": "skyzai.prism.proposal_envelope.v1",
"envelope_id": "env_d4e5f6g7",
"hash_algorithm": "SHA-256",
"canonicalization": "RFC8785-JCS",
"proposal_hash": "sha256:proposal_hash...",
"timestamp": "2026-04-12T14:38:00Z",
"action": {
"type": "rebalance",
"asset": "EUR_HOLD_Q3",
"direction": "long",
"size_sky": 500.0,
"position_sizing": {
"method": "lx_optimal",
"lx_value": 2.85,
"kelly_fraction": 0.12
}
},
"council_deliberation": {
"intelligence": {"vote": "proceed", "confidence": 0.82},
"strategy": {"vote": "proceed", "edge": 0.08},
"legal": {"vote": "proceed", "k_violations": []},
"treasury": {"vote": "proceed", "exposure_after": 0.15},
"chief_of_staff": "PROCEED"
},
"risk_parameters": {
"stop_loss_pct": 0.05,
"max_drawdown_pct": 0.10,
"correlation_flag": false
},
"phi_split": {
"lp100_pct": 61.8,
"operations_pct": 38.2
},
"authority_status": "gated_pending_complete_valid_bound_receipt",
"input_bundles": ["mkt_ecb_q3_hold"]
}

Authorization Transition: Proposal -> AuthorityReceipt

F3 never becomes executable by changing its own status. A separate authority receipt must bind the exact proposal hash. For a public DAV, the validator must establish at least two distinct natural-person councilors and reject AI/caste signatures. Missing, mismatched, replayed, or undersized authority fails closed; F4 is not emitted.

authority_mode MUST equal public_dav_prism in v1. The private_natural_person is deferred to a later versioned receipt schema; v1 adapters must reject it and every other value rather than translate an unknown mode through an implicit alias.

The exact superseded two-mode paragraph follows as dated K3 provenance.

authority_mode is a closed discriminator at this interface: public_dav_prism denotes the public-DAV quorum path, while private_natural_person denotes a Natural Person authorizing only their own private act. Adapters must reject every other value rather than translate an unknown mode through an implicit alias.

Before reading any F3 content field, the adapter MUST recompute SHA-256 over the RFC 8785/JCS encoding of the complete F3 object excluding only proposal_hash. Both proposal.proposal_hash and authority_receipt.proposal_hash MUST equal that recomputed digest, and the receipt's proposal_envelope_id MUST equal the proposal's envelope_id. Tampering with an action while retaining the old carried hash therefore fails closed before deliberation or execution.

If the recomputed F3 proposal is HOLD, the adapter returns a non-F4 ProposalDisposition.no_action; no authority or execution receipt is emitted. For every non-HOLD proposal, a missing authority receipt fails closed before F4.

{
"schema": "skyzai.authority_receipt.v1",
"receipt_id": "authrcpt_prism_001",
"authority_mode": "public_dav_prism",
"decision_id": "decision_prism_001",
"proposal_envelope_id": "env_d4e5f6g7",
"proposal_hash": "sha256:proposal_hash...",
"natural_person_councilors": [
{"councilor_id": "npub1...", "signature": "sig_1..."},
{"councilor_id": "npub2...", "signature": "sig_2..."}
],
"ai_signatures": [],
"validation_status": "valid",
"validated_at": "2026-04-12T14:39:00Z"
}

F4: Skyzai -> Circle (SettlementReceipt)

Skyzai broadcasts execution results only after validating the bound authority receipt. The F4 envelope embeds the full receipt and a hash of its canonical JSON encoding, carrying the signer entries for later verification rather than making validation_status the proof. Independent cryptographic verification remains gated until the signature scheme, key registry/encoding, and domain-separated signed payload are specified. The nested authority_receipt.proposal_envelope_id MUST equal the F4 envelope_id; any hash, identity, signature, mode, or envelope mismatch fails closed. authority_receipt_hash is SHA-256 over the RFC 8785/JCS encoding of the full nested authority_receipt; the top-level hash metadata and hash field are not part of that nested object. Circle ingests the settlement and authority trace as new observations.

{
"schema": "skyzai.receipt.v1",
"receipt_id": "rcpt_h8i9j0k1",
"timestamp": "2026-04-12T14:39:12Z",
"envelope_id": "env_d4e5f6g7",
"authority_receipt_hash": "sha256:canonical_authority_receipt_hash...",
"authority_receipt_hash_algorithm": "SHA-256",
"authority_receipt_canonicalization": "RFC8785-JCS",
"authority_receipt": {
"schema": "skyzai.authority_receipt.v1",
"receipt_id": "authrcpt_prism_001",
"authority_mode": "public_dav_prism",
"decision_id": "decision_prism_001",
"proposal_envelope_id": "env_d4e5f6g7",
"proposal_hash": "sha256:proposal_hash...",
"natural_person_councilors": [
{"councilor_id": "npub1...", "signature": "sig_1..."},
{"councilor_id": "npub2...", "signature": "sig_2..."}
],
"ai_signatures": [],
"validation_status": "valid",
"validated_at": "2026-04-12T14:39:00Z"
},
"execution": {
"status": "settled",
"asset": "EUR_HOLD_Q3",
"filled_size_sky": 500.0,
"avg_price": 0.74,
"settlement_tx": "0.0.12345@1681234567.000000000"
},
"k0_receipt": {
"arweave_tx": "ar://tx_hash_def456",
"schema_version": "skyzai.transfer_receipt.v1"
},
"relay_broadcast": {
"nostr_event_id": "note1def...",
"relay_urls": ["wss://relay.skyzai.com", "wss://relay.damus.io"]
},
"phi_split_applied": {
"to_lp100": 309.0,
"to_operations": 191.0
}
}

Versioning

All schemas use semantic versioning (v1, v2, etc.). Breaking changes increment the major version. Organs must support the current version and one version back. Schema definitions are published at schemas.skyzai.com.


Agent Execution Surface

If you are an AI agent reading this document:

  1. This is a downstream public content page. The canonical source lives in EMERGENTISM_ORG/08_FRAMEWORK_SUPPORT/ or SKYZAI_ORG/. Edit source upstream, not here.
  2. Preserve evidence tiers. Do not promote claims up the [C] < [D] < [S] < [B] < [E] ladder when reproducing them here; [I]/[A] qualifiers never substitute for [B]/[E].
  3. Regenerate from source. If the upstream source changes, regenerate this page rather than editing it independently.
  4. Canonical Path: SKYZAI_ORG/07_PWAs/skyzai_org/wiki/35-api-contracts.md

Output: This is content. Route edits to upstream source. Regenerate when source changes.

K3 public-DAV authority history — 2026-07-12

K3 historical reference — not active authority
note

Current public-DAV boundary — 2026-07-10. Pre-launch target design; nothing here is live. The active DAV is public and targets PRISM, with no K2 runtime, launch, genesis/bootstrap, or fallback dependency. Consequential authority requires at least two natural-person councilors; AI/caste seats stage unsigned proposals only. Before quorum, behavior fails closed to read-only/proposal, simulation, or deterministic sandbox, and a live decision receipt remains gated pending quorum.

APU outputs an unsigned proposal. Skyzai may execute only after the applicable typed authority membrane supplies a private natural-principal signature or a valid public-DAV PRISM quorum decision receipt.

{
"schema": "skyzai.prism.proposal_envelope.v1",
"envelope_id": "env_d4e5f6g7",
"hash_algorithm": "SHA-256",
"canonicalization": "RFC8785-JCS",
"proposal_hash": "sha256:proposal_hash...",
"timestamp": "2026-04-12T14:38:00Z",
"action": {
"type": "rebalance",
"asset": "EUR_HOLD_Q3",
"direction": "long",
"size_sky": 500.0,
"position_sizing": {
"method": "lx_optimal",
"lx_value": 2.85,
"kelly_fraction": 0.12
}
},
"council_deliberation": {
"intelligence": {"vote": "proceed", "confidence": 0.82},
"strategy": {"vote": "proceed", "edge": 0.08},
"legal": {"vote": "proceed", "k_violations": []},
"treasury": {"vote": "proceed", "exposure_after": 0.15},
"chief_of_staff": "PROCEED"
},
"risk_parameters": {
"stop_loss_pct": 0.05,
"max_drawdown_pct": 0.10,
"correlation_flag": false
},
"phi_split": {
"lp100_pct": 61.8,
"operations_pct": 38.2
},
"authority_status": "gated_pending_quorum",
"input_bundles": ["mkt_ecb_q3_hold"]
}
APU · local guide, not live AI Api Contracts

Context: Api Contracts. Local guide only. Messages are not sent or saved.

Skyzai

Explore the protocol map Development & availabilityContact Skyzai

Your world. Better connected.
A Skyzai experience, with APU.

Skyzai is coming together.

The shared app at skyzai.com is in development. Explore the website while we build the connected experience.