The IXO MultiClient SDK provides a unified interface for building Spatial Web client applications that leverage interchain networks, decentralized IXO Matrix data storage, and Agentic Oracles for verifiable digital twins.

​
Key Features

Cognitive Digital Twins

Operate digital domains of real-world systems

Interchain Networks

Connects IXO Protocol networks with most other blockchains

IXO Matrix Data Nodes

Encrypts data in sovereign decentralised stores, with secure messaging

Agentic Oracles

Provide intelligent automations, data verification, with agents and causal AI services

​
Installation

# Using npm
npm install @ixo/impactxclient-sdk

# Using yarn
yarn add @ixo/impactxclient-sdk

​
Quick Start

​
Matrix Client

import { createMatrixClient } from "@ixo/impactxclient-sdk";

// Initialize matrix client
const client = await createMatrixClient({
  baseUrl: "https://matrix.ixo.world",
  accessToken: "YOUR_TOKEN"
});

// Create data room
const room = await client.createRoom({
  name: "Digital Twin Data",
  encryption: true
});

// Store encrypted data
await client.sendEvent(room.roomId, "m.room.message", {
  msgtype: "m.data",
  body: encryptedData
});

​
Oracle Integration

import { createOracleClient } from "@ixo/impactxclient-sdk";

// Initialize oracle client
const oracle = await createOracleClient({
  did: "did:ixo:oracle/123",
  endpoint: "https://oracle.ixo.world"
});

// Verify digital twin data
const verification = await oracle.verify({
  twinId: "did:ixo:twin/456",
  data: twinData,
  context: spatialContext
});

​
Authentication

​
SignX Integration

SignX provides secure authentication and key management for Spatial Web applications.

import { SignX } from "@ixo/impactxclient-sdk";

// Initialize SignX client
const signx = new SignX({
  serviceEndpoint: "https://signx.ixo.world",
  appId: "YOUR_APP_ID"
});

// Authenticate user
const auth = await signx.authenticate({
  challenge: "random_challenge",
  chainId: "impact-hub-1"
});

// Get signing capabilities
const signer = await signx.getSigner(auth.sessionId);

​
The Spatial Web Stack

​
Core Components

​
Blockchain Modules

import { cosmos } from "@ixo/impactxclient-sdk";

// Bank module
const bankMsg = cosmos.bank.v1beta1.MsgSend.fromPartial({/*...*/});

// Staking module
const stakingMsg = cosmos.staking.v1beta1.MsgDelegate.fromPartial({/*...*/});

// Gov module
const govMsg = cosmos.gov.v1beta1.MsgSubmitProposal.fromPartial({/*...*/});

​
Smart Contract Integration

​
Contract Deployment

import { cosmwasm, customQueries } from "@ixo/impactxclient-sdk";

// Get contract code
const codes = customQueries.contract.getContractCodes("devnet", "ixo");
const code = codes.find(c => c.name === "ixo1155");

// Instantiate contract
const instantiateMsg = {
  typeUrl: "/cosmwasm.wasm.v1.MsgInstantiateContract",
  value: cosmwasm.wasm.v1.MsgInstantiateContract.fromPartial({
    sender: myAddress,
    admin: myAddress,
    codeId: code.code,
    label: `${myAddress}-contract-${code.code}`,
    msg: new TextEncoder().encode(JSON.stringify({
      minter: myAddress
    })),
    funds: [{
      denom: "uixo",
      amount: "1"
    }]
  })
};

​
Contract Interaction

// Execute contract message
const executeMsg = {
  typeUrl: "/cosmwasm.wasm.v1.MsgExecuteContract",
  value: cosmwasm.wasm.v1.MsgExecuteContract.fromPartial({
    sender: myAddress,
    contract: contractAddress,
    msg: new TextEncoder().encode(JSON.stringify({
      batch_mint: {
        to: recipient,
        batch: [[tokenId, "1000", "uri"]]
      }
    })),
    funds: [{
      denom: "uixo",
      amount: "1"
    }]
  })
};

​
Error Handling

​
400
error

Invalid message format or parameters

​
401
error

Unauthorized - check wallet connection

​
500
error

Blockchain node error

​
Use Cases

Digital Twin Management

Create, update, and manage digital representations of real-world assets with verifiable state

Secure Data Storage

Store sensitive data in encrypted IXO Matrix rooms with controlled access and blockchain verification

Interchain Operations

Execute transactions across multiple blockchain networks with unified interface and consistent security

Agentic Verification

Implement automated verification workflows using Agentic Oracles for data validation and intelligence

​
Best Practices

Follow these guidelines for robust application development

​
Security

  • Validate all user inputs
  • Use secure key management
  • Implement proper error handling
  • Monitor transaction status

​
Performance

  • Batch transactions when possible
  • Implement proper caching
  • Handle offline scenarios
  • Monitor gas usage

IXO Matrix SDK

Detailed documentation for IXO Matrix integration

IXO Matrix

Overview of the IXO Matrix ecosystem

IXO Oracles

Learn about Agentic Oracle capabilities

​
Next Steps

Components Guide

Learn about IXO Spatial Web components

Smart Contracts Guide

Deploy smart contracts

Query Guide

Using GraphQL to query the Blocksync indexing database