Ukiyo NetworkDeveloper Docs
Architecture

System Overview

Three layers, one directed chain: evidence → authority → credit. Each layer has a hard trust boundary.

Layer map

Industrial production
        │
        ▼
Fulfillment Oracle     (evidence — what is true)
        │ attested score
        ▼
Agency for Smart Contracts  (governance — what may be done)
        │ allowlisted calldata
        ▼
SPOOL Protocol         (credit — what settles)
        │
        ▼
On-chain credit & settlement (Arbitrum → Ethereum L1)

Responsibilities

LayerOwnsMust never
OracleIngestion, scoring, attestation, publicationMove funds or execute credit actions
AgencyAllowlists, simulation gate, escalationHold capital or invent evidence
SPOOLOrder NFTs, spools, advances, repaymentDecide its own unbounded policy

Trust domains

DomainComponentsFailure impact
IndustrialERP, vision, logisticsCorrupted evidence upstream
OracleAgents, attestation signersStale / missing score → fail closed
ExecutionAgent runtime, policy engineBounded erroneous action
L2Arbitrum contracts / sequencerDowntime, delayed hard finality
L1Ethereum settlement rootFinal settlement risk
Invariant

A compromised oracle cannot move funds. A compromised agent cannot exceed its allowlist. A compromised credit contract cannot rewrite attestation history.

Next

Dive into Oracle Architecture,Data Flow, andBlockchain Integration.