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. Compliance group member submits verification proposal

  2. Members vote on proposal

  3. Upon approval, domain status updates to “Verified”

Only verified domains can participate in platform activities like carbon credit issuance.

​
Next Steps

Protocol Templates

Browse available protocol templates

Entity Management

Learn how to update and manage domains

Governance Guide

Understand the verification process