Introduction

The IXO Spatial Web SDKs provide developers with the tools to build real-world applications that leverage digital twins, AI oracles, secure data rooms, and interchain networks. This software stack enables the creation of verifiable digital domains that can interact with physical and digital entities across the Spatial Web.

Core SDKs

MultiClient SDK

Connect with IXO and Cosmos networks for interchain operations

Matrix Client SDK

Build secure data rooms and encrypted communication channels

Oracle Agent SDK

Create AI-powered verification and analytics agents

SignX SDK

Manage cryptographic signatures and authentication

Architecture Overview

The IXO Spatial Web stack combines digital twins, secure data matrix, AI oracles, and interchain networks to create verifiable digital domains that can interact with physical and digital entities.

Core Layers

Digital Twin Layer

Digital representations of physical and cognitive entities

Data Matrix Layer

Encrypted storage and secure communication channels

Intelligent Oracle Layer

AI-powered verification and analytics networks

Blockchain Layer

Interchain identity and transaction management

Digital Domain Architecture

Digital Domains: Verifiable digital representations of any entity
Domain Networks: Interconnected webs of digital domains
Oracle Domains: AI-enabled verification networks
Service Domains: Specialized capability providers

// Create digital domain
const domain = await Entity.create({
  type: "DigitalDomain",
  class: "Entity",
  capabilities: ["verification", "dataCollection"],
  context: spatialContext
});

// Create oracle domain
const oracle = await Entity.create({
  type: "DigitalDomain",
  class: "Oracle",
  capabilities: ["verification", "analytics"]
});

Decentralized Identifiers: W3C DIDs for unique identification
Controllers: Domain management permissions
Services: Associated endpoints and capabilities
Verifiable Credentials: Proofs and certifications
Relationships: Connections to other domains

// Define domain properties
const domain = {
  did: "did:ixo:domain/123",
  controller: "did:ixo:org/456",
  services: [{
    id: "#verification",
    type: "VerificationService",
    endpoint: "https://oracle.ixo.world"
  }],
  credentials: [{
    type: "DomainVerification",
    issuer: "did:ixo:oracle/789"
  }]
};

Time-Sequenced Records: Immutable state history
State Transitions: Verified changes in domain state
Proofs: Cryptographic evidence of state
Claims: Verifiable statements about domains

// Record state transition
await domain.transition({
  from: "active",
  to: "updated",
  evidence: {
    type: "OracleVerification",
    proof: verificationResult
  }
});

Data Matrix Layer

Encrypted Rooms: End-to-end encrypted data spaces
Access Control: Fine-grained permissions
File Storage: Secure document management
Audit Trails: Activity logging

// Create encrypted room
const room = await matrix.createRoom({
  name: "Entity Data",
  encryption: true,
  permissions: {
    read: ["did:ixo:oracle/123"],
    write: ["did:ixo:device/456"]
  }
});

Secure Messaging: Encrypted real-time messaging
Data Streaming: IoT and sensor data ingestion
Event Publishing: State change notifications
Bot Integration: Automated room management

// Set up data stream
const stream = await matrix.createStream({
  roomId: room.roomId,
  type: "DeviceTelemetry",
  schema: telemetrySchema
});

// Handle events
stream.on("data", async (telemetry) => {
  await oracle.verify(telemetry);
});

Oracle Layer

AI Models: Specialized verification models
Causal Analysis: Impact attribution
Evidence Collection: Multi-source data gathering
Proof Generation: Cryptographic attestations

// Configure oracle network
const network = await Oracle.createNetwork({
  type: "VerificationNetwork",
  models: ["causal-inference", "anomaly-detection"],
  minConsensus: 0.67
});

Location Services: Precise positioning
Spatial Queries: Location-based search
Geo-fencing: Location-based rules
Spatial Relations: Geographic relationships

// Query spatial context
const entities = await spatial.query({
  center: location,
  radius: 1000,
  relations: ["contains", "nearBy"],
  type: "PhysicalAsset"
});

Blockchain Layer

DID Registry: Decentralized identifier system
Key Management: Cryptographic key handling
Credential Issuance: Verifiable credential system
Authentication: SignX integration

// Register DID
const did = await chain.identity.register({
  type: "EntityDID",
  controller: ownerAddress,
  verificationMethod: [{
    id: "#key-1",
    type: "Ed25519VerificationKey2020",
    controller: ownerAddress
  }]
});

State Anchoring: Cryptographic state proofs
Smart Contracts: CosmWasm integration
Token Operations: Asset management
Governance: DAO integration

// Anchor state
const tx = await chain.anchor({
  entityDid: twin.did,
  stateHash: proofHash,
  evidence: verificationProof
});

Getting Started

Installation

# Install core SDKs
npm install @ixo/impactxclient-sdk @ixo/matrixclient-sdk
npm install @ixo/oracle-agent-sdk @ixo/signx-sdk

Basic Setup

Key Features

Spatial Awareness

// Get spatial context
const context = await spatial.getContext({
  latitude: 51.5074,
  longitude: -0.1278,
  precision: 6
});

// Query nearby entities
const nearby = await spatial.queryEntities({
  center: context,
  radius: 1000,
  type: "PhysicalAsset"
});

Secure Data Rooms

// Create encrypted room
const room = await matrix.createRoom({
  name: "Asset Data",
  encryption: true,
  visibility: "private"
});

// Set access control
await matrix.setRoomPermissions(room.roomId, {
  readAccess: ["did:ixo:oracle/123"],
  writeAccess: ["did:ixo:device/456"]
});

AI Verification

// Configure oracle
const oracle = await Oracle.create({
  type: "VerificationOracle",
  model: "causal-inference-v1",
  confidence: 0.95
});

// Verify data
const result = await oracle.verify({
  data: assetData,
  context: spatialContext,
  rules: verificationRules
});

SDK Integration Examples

Digital Twin System

async function createAssetTwin() {
  // Create digital twin
  const twin = await chain.entity.create({
    type: "PhysicalAsset",
    location: spatialContext
  });

  // Create data room
  const room = await matrix.createRoom({
    name: `Asset ${twin.did}`,
    encryption: true
  });

  // Configure oracle
  const oracle = await Oracle.create({
    type: "AssetVerification"
  });

  // Link components
  await twin.linkDataRoom(room.roomId);
  await twin.setVerificationOracle(oracle.did);

  return twin;
}

Verification Flow

async function verifyAssetState() {
  // Collect data
  const telemetry = await device.getTelemetry();
  const location = await device.getLocation();

  // Create verification session
  const session = await oracle.createVerification({
    type: "AssetState",
    subject: twin.did,
    context: {
      location,
      timestamp: Date.now()
    }
  });

  // Generate proof
  const proof = await session.verify(telemetry);

  // Store result
  await matrix.storeProof(room.roomId, proof);
}

Best Practices

Follow these guidelines for robust Spatial Web applications

Security

Use encrypted data rooms
Implement proper authentication
Validate spatial context
Monitor oracle accuracy

Performance

Cache spatial queries
Batch blockchain operations
Handle offline scenarios
Implement retry logic

Next Steps

Tutorials

Follow step-by-step guides

API Reference

Explore detailed documentation

Examples

View sample applications

Community

Join the developer community

Get Started

Platforms

Developers

Articles

Core SDKs

MultiClient SDK

Matrix Client SDK

Oracle Agent SDK

SignX SDK

Architecture Overview

Core Layers

Digital Twin Layer

Data Matrix Layer

Intelligent Oracle Layer

Blockchain Layer

Digital Domain Architecture

Data Matrix Layer

Oracle Layer

Blockchain Layer

Getting Started

Installation

Basic Setup

Key Features

Spatial Awareness

Secure Data Rooms

AI Verification

SDK Integration Examples

Digital Twin System

Verification Flow

Best Practices

Security

Performance

Next Steps

Tutorials

API Reference

Examples

Community

Get Started

Platforms

Developers

Articles

​Core SDKs

MultiClient SDK

Matrix Client SDK

Oracle Agent SDK

SignX SDK

​Architecture Overview

​Core Layers

Digital Twin Layer

Data Matrix Layer

Intelligent Oracle Layer

Blockchain Layer

​Digital Domain Architecture

​Data Matrix Layer

​Oracle Layer

​Blockchain Layer

​Getting Started

​Installation

​Basic Setup

​Key Features

​Spatial Awareness

​Secure Data Rooms

​AI Verification

​SDK Integration Examples

​Digital Twin System

​Verification Flow

​Best Practices

​Security

​Performance

​Next Steps

Tutorials

API Reference

Examples

Community

Core SDKs

Architecture Overview

Core Layers

Digital Domain Architecture

Data Matrix Layer

Oracle Layer

Blockchain Layer

Getting Started

Installation

Basic Setup

Key Features

Spatial Awareness

Secure Data Rooms

AI Verification

SDK Integration Examples

Digital Twin System

Verification Flow

Best Practices

Security

Performance

Next Steps