The IXO Spatial Web platform uses a systems-thinking approach where each physical or conceptual component is represented as a Digital Entity with its own Domain. Clean cooking systems serve as a practical example throughout this guide.

Twin Types

Physical Twins

Digital representations of physical devices and sensors (e.g., cooking stoves, IoT monitors, and tracked inventory)

Cognitive Twins

Digital models of organizational structures (e.g., projects, funders, distribution agents)

Twin Systems

Digital representation of the networks of relationships and interactions between real-world entities

Oracle Twins

AI-enabled agentic services performing evaluations, verification, and intelligent automations

Entity Structure

Domain Properties

did
string
required

W3C Decentralized Identifier for unique entity identification

controller
string
required

Entity with update permissions

services
array

Associated services and endpoints

verifiableCredential
array

Issued certificates and proofs

Entity Relationships

Using Protocols

Protocols are templates that define standard properties and relationships for specific entity types. They can be customized for any domain.

Protocol Structure

{
  "type": "Protocol",
  "properties": {
    "metricOne": "string",
    "metricTwo": "number",
    "measurements": "object"
  },
  "relationships": {
    "verifier": "OracleEntity",
    "operator": "OrganizationEntity"
  }
}

Instantiating Entities

Next Steps

Entity Guide

Learn about entity management

Protocol Guide

Create custom protocols

Oracle Guide

Implement verification systems

Integration Guide

Connect physical devices