Skip to main content
The IXO Matrix State Bot API enables secure, decentralized storage and management of state events and access control lists (ACLs) within Matrix rooms, providing both REST endpoints and Matrix commands.

Core Features

Handle custom state events in Matrix rooms

Features

  • Create and update state events
  • Store JSON objects with unique keys
  • Manage room configurations
Manage permissions and access rights

Features

  • Define granular ACLs
  • Control state event access
  • Set edit permissions
Multiple ways to interact with the bot

Methods

  • RESTful API endpoints
  • Matrix room commands
  • Direct bot interactions

Event Types

State Events

{
  "type": "ixo.room.state",
  "state_key": "unique_identifier",
  "content": {
    // Application-specific data
  }
}

ACL Events

{
  "type": "ixo.room.state.acl",
  "state_key": "state_event_key",
  "content": {
    "read": ["@user:domain.com"],
    "write": ["@admin:domain.com"]
  }
}

Use Cases

dApp Settings

Store application configurations securely

Project Access

Implement fine-grained access control

State Management

Automate state object handling

Development Resources

The Matrix State Bot repository is private. Contact the IXO team to request access for development.
I