Domain Registration

Create and manage digital twins of real-world entities using the IXO Stack

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

typestringrequired
classstringrequired
metadataobject

Optional Parameters

validFromstring
validUntilstring

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.

Next steps