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"
}
}'from emerging import Client
client = Client('YOUR_API_KEY')
domain = client.domains.create(
type="Project",
protocol="did:ixo:protocol/clean-cooking",
metadata={
"name": "Clean Cooking Project"
}
)Domain Types
Legal or virtual entities, managed as DAOs
Project type entities for clean cooking initiatives
Asset type entities for IoT-enabled cooking devices
Templates and rules that govern domain behavior
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
Entity type (Organisation, Project, Device, etc.)
DID of the Protocol that defines the Entity Class
Domain settings of the Entity
Optional Parameters
ISO timestamp when domain becomes valid
ISO timestamp when domain expires
Domain Verification
Domains require verification by the platform's governance system:
- A compliance or program representative submits a verification proposal with the entity package.
- Eligible voters review and vote (quorum and thresholds depend on deployment).
- 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.