Skip to main content

Create Entity

Create an Entity: a named resource under an existing Ecosystem namespace. Full human‑readable identifier format: open://<EntityName>, resolved against its parent Ecosystem.

open-token entity create --help

Synopsis

open-token entity create <Name> <Meta> <Body> <Years>

Arguments

ArgumentTypeRequiredDescription
<Name>StringYesEntity resource name within the open:// namespace, e.g. google.com. This is the resource identifier shown in open://google.com. Must belong to an existing parent Ecosystem namespace.
<Meta>StringYesEntity‑level metadata JSON string: profile, avatar, display labels. Single‑line compact JSON required.
<Body>StringYesEntity‑level resolution records JSON string: target addresses, website URIs, text records. Single‑line compact JSON required.
<Years>u8YesRegistration duration in full years for this entity resource. Entity holds its own independent expiry timestamp.

Behaviour

  • Validates that parent Ecosystem namespace exists on‑chain.
  • Validates entity name character set, length and global uniqueness.
  • Creates on‑chain PDA account for the Entity resource.
  • Transaction signer becomes initial entity owner.
  • Entity retains independent expiry timestamp.
  • Logical invalidation rule: If parent Ecosystem expires, entity cannot be resolved via open:// scheme, regardless of entity’s own expiry status.
  • Deducts entity registration fee defined in on‑chain treasury configuration.