Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ixo.world/llms.txt

Use this file to discover all available pages before exploring further.

Domains are used to create digital twins of real-world entities.

​
Quick Start

curl -X POST https://api.emerging.eco/v1/domains \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{
    "type": "Project",
    "protocol": "did:ixo:protocol/clean-cooking",
    "metadata": {
      "name": "Clean Cooking Project"
    }
  }'

​
Domain Types

Organisations

Legal or virtual entities, managed as DAOs

Projects

Project type entities for clean cooking initiatives

Assets

Asset type entities for IoT-enabled cooking devices

Protocols

Templates and rules that govern domain behavior

Oracles

Requests

​
Domain Properties

Each domain requires:
  • Digital Identifier: Unique DID following Interchain Identifier format
  • Entity Type: Organisation, Project, Device, etc.
  • Protocol: Defines the Class of entity and its inherited sets of properties
  • Controller: Account/s that manage the domain record (DID Document)
  • Metadata: Additional standard domain settings

​
Creating Domains

​
Required Parameters

​
type
string
required
Entity type (Organisation, Project, Device, etc.)
​
class
string
required
DID of the Protocol that defines the Entity Class
​
metadata
object
Domain settings of the Entity

​
Optional Parameters

​
validFrom
string
ISO timestamp when domain becomes valid
​
validUntil
string
ISO timestamp when domain expires

​
Domain Verification

Domains require verification by the platform’s governance system:
  1. A compliance or program representative submits a verification proposal with the entity package.
  2. Eligible voters review and vote (quorum and thresholds depend on deployment).
  3. On approval, domain status moves to Verified and downstream services (reporting, issuance) can enable.
For a platform-scoped walkthrough (DAO stages, relayer assignment, GraphQL status checks), read Emerging Platform domain registration. For how roles (Developer, Evaluator, Funder, Service provider) map to these steps, read Your role.
Only verified domains can participate in platform activities like carbon credit issuance. Confirm auth and endpoints for your environment in the Authentication matrix and Networks and endpoints.

​
Next steps

Emerging domain registration

Governance stages, entity JSON, and GraphQL examples

Digital twins

Model entities, protocols, and relationships

Identity and credentials

How DIDs, claims, and verifiable credentials connect

DAOs

How decentralized governance fits IXO programs