Skip to main content
This section documents API interfaces only. It does not define protocol concepts, product positioning, or canonical endpoint literals. For a single comparison table (read/write, purpose, links to auth and endpoints), start at API introduction.

​
API surfaces

Blockchain RPC API

Direct node-level interface for IXO Protocol transaction and state access.

Blockchain REST API

HTTP/JSON gateway over gRPC query services for IXO Protocol modules.

IXO Blocksync GraphQL API

Indexed query interface for chain data through IXO Blocksync.

Matrix state bot API

Service API for state and ACL operations in IXO Matrix rooms.

Registry API

Application API for Impact Hub Registry service workflows.

USSD gateway API

Session endpoint for the IXO USSD gateway — accepts input from telecom gateways and returns USSD responses.

​
Boundary between protocol and services

  • IXO Protocol APIs: rpc-api and grpc-gateway-api.
  • Service APIs: blocksync-graphql-api, matrix-state-bot-api, and registry-api.
  • Protocol concepts and module behavior belong in protocol documentation, not API operation pages.

​
Shared references

Networks and endpoints

Confirm canonical endpoint mappings by network and environment.

Authentication matrix

Verify interface-specific authentication requirements and literals.

Product and SDK map

Navigate IXO products, APIs, and SDK references.

Authentication

Compare authentication schemes by API surface.

Error handling

Handle common API and transport failures.

Pagination

Use cursor and page patterns for large result sets.