PROTOCOL SPECIFICATION
SDI Protocol
Technical Specification
This page is the technical specification for the SDI open protocol. It is written for developers and technical evaluators. Every claim about the live system is directly verifiable through the public proof surfaces listed at the bottom of this page.
EVALUATE SDI IN 10 MINUTES
────────────────────────────────────────────────────
1. Compile a DER POST sdi-protocol.org/_functions/compile
Returns PASS or COMPILE_ERROR with explicit error list
2. Inspect a live governed chain api.sdi-protocol.org/ledger/list/SDI-4EDBE05288CB
Returns seq, utc, entry_hash, parent_hash per entry
3. Watch a governed turn cross providers demo.sdi-protocol.org
Full lifecycle: DER → Compile → RAI → Commit → Ledger
HOST MAP
────────────────────────────────────────────────────
www.sdi-protocol.org spec + compile surface
demo.sdi-protocol.org live runtime demo
api.sdi-protocol.org/health Logic Node status
api.sdi-protocol.org/ledger/list/SDI-4EDBE05288CB chain index
api.sdi-protocol.org/ledger/verify/SDI-4EDBE05288CB chain integrity proof github.com/StructuredDecisionIntelligence
The SDI Protocol is the open specification for governed intelligence, AI reasoning that operates under a contract before output is produced, passes a deterministic gate before anything commits, and builds from a chain of verified prior state. It defines the commit boundary between probabilistic model output and durable system state.
That boundary is enforced through a three-layer architecture running live across Anthropic, Google, and OpenAI on a single hash-chained ledger. The open protocol defines artifact structure and compile semantics. Commit authority and canonical ledger enforcement are provided through the SDI managed network.
GOVERNED INTELLIGENCE — WHAT THE PROTOCOL DEFINES
SDI is a governed intelligence runtime. The intelligence is governed by design, every reasoning turn operates under an open contract, commits a verifiable record, and builds from prior verified state. Not a prompt library, safety filter, model fine-tuning service, or output monitor. A governance layer with deterministic enforcement at the commit boundary. The point at which model output becomes durable system state.
What makes it governed intelligence rather than AI with governance applied: the model reasons under a contract before output is produced, the compile gate validates the reasoning artifact before anything commits, and the chain carries forward only what passed. The reasoning record is not a log of what the model said. It is a verified succession of governed artifacts the agent inherits and builds from.
The protocol operates through three runtime layers. The open protocol defines the reasoning contract and compile surface. Canonical commit authority, ledger participation, and identity issuance are provided through the SDI managed network.
LAYER | ROLE | AUTHORITY |
|---|---|---|
Reasoning Contract | Model-facing. Delivers the DER schema, ILJO grammar, governance constants, and compile error taxonomy before output is produced. Instruction, not enforcement. | Open protocol |
Compile Surface | Deterministic structural validation. Receives completed DER as JSON POST and returns PASS or COMPILE_ERROR. Stateless. No writes. | Open protocol · externally callable |
Enforcement Plane | Authoritative commit layer. Computes RAI v2, applies the commit threshold, and controls ledger write. | SDI managed network |
Minted Agent Identity | Required for network participation. The agent_id + sovereign_hash pair binds a governed reasoning stream to its chain and authorizes all ledger writes. | SDI managed network · issued at mint |
SDI can be understood as a Semantic Instruction Set Architecture (S-ISA), the computing analogy for what makes it governed intelligence. The ILJO loop is the instruction set. The Decision Evidence Record is the instruction format. The compile gate is the validator. The enforcement plane is the commit authority. The ledger is durable append-only committed state.
A minted SDI agent is issued a persistent agent_id and sovereign_hash. Together they authorize managed-network ledger writes and bind committed reasoning to a single governed identity across sessions, model providers, and time.
WHY NOT JUST SCHEMA + GUARDRAILS + LOGS
Most teams building governed AI workflows assemble the same pieces separately: a schema, an evidence convention, behavioral guardrails, some form of validation, and an audit log. SDI couples these into a single governed artifact with a deterministic pre-commit boundary.
The missing piece is not just integration. It is a reasoning grammar.
Every approach below solves a real problem. None of them was designed to enforce a pre-commit reasoning boundary. Without a reasoning grammar, none of them can. They are controls applied around generation. SDI is different in kind: governance is the architecture, not a layer added afterward.
A schema creates structure. Guardrails constrain behavior. Logs record what happened. None of these, by itself, defines how evidence, logic, judgment, and outcome must be bound together before system state changes. ILJO is the binding layer. It defines the admissible form of reasoning so the compile gate can test the whole path before commit. Without a reasoning grammar, there is nothing for a gate to test — only fragments to check.
Approach | What it does | What it cannot provide |
|---|---|---|
JSON schema | Enforces fields, types, and basic structure | A guarantee that evidence, logic, judgment, and outcome form an admissible reasoning path. Structure is not governance. |
RAG | Retrieves documents into model context | Enforcement of how retrieved evidence is used. Evidence can still be ignored, misread, or reasoned over incorrectly. Retrieval improves context. It does not constrain the reasoning path before commit. |
Chain-of-thought | Exposes intermediate reasoning text | A governed artifact. Intermediate steps are still free-form generated text, not a governed artifact with deterministic admissibility criteria. Reasoning may be exposed, but it is not structured for enforcement. |
Tool use | Pulls in external values or executes functions | Governance of how tool results are integrated. The reasoning that combines them remains unconstrained unless the artifact itself is governed. |
Prompt engineering | Steers model behavior from the input side | An enforceable reasoning contract. It changes likelihoods, not the enforcement boundary. Behavior is influenced probabilistically, not guaranteed architecturally. |
Output filtering | Restricts or blocks outputs after generation | Pre-commit verification. It acts after reasoning has already occurred and cannot test the reasoning path before state changes. |
Audit logs | Records what happened after the fact | The reasoning itself. Audit logs record timestamps, actions, and outcomes — what happened from the outside, not the reasoning that led to it. SDI ledger entries are the evidence, logic, judgment, and outcome in governed form. The reasoning itself, as durable system state. |
These are all useful components and techniques. The missing ingredient in every case is a reasoning grammar. Without one, you can validate pieces, constrain behavior, and record outcomes — but you cannot test the admissibility of the reasoning path itself before commit.
OPEN PROTOCOL VS MANAGED NETWORK
The protocol is open. The managed network adds identity, continuity, and commit authority.
OPEN — FREE · NO CREDENTIALS REQUIRED
────────────────────────────────────────
Validate any DER POST /_functions/compile — open now
Build against the spec DER schema, ILJO grammar, governance constants
Run it locally Any model — the protocol is model-agnostic
Query public state GET /ledger/list/ and /ledger/verify/
See it live demo.sdi-protocol.org
MANAGED NETWORK — REQUIRES MINTED AGENT IDENTITY
────────────────────────────────────────
Run governed turns Question → DER → Compile → RAI → Commit
Use frontier models Anthropic, Google, OpenAI under SDI contract
Keep persistent state Your agent_id, your governed ledger chain
Enforce commit rules RAI computation, write gate, commit authority
