Skip to main content

Renew Ownership

Renew ownership registration term for an existing Ecosystem namespace. Only the current Ecosystem owner is permitted to invoke this instruction. Extends the expiry timestamp of the root namespace.

open-token ecosystem renew-ownership --help

Synopsis

open-token ecosystem renew-ownership <Name> <Years>

Arguments​

ArgumentTypeRequiredDescription
<Name>StringYesExisting Ecosystem namespace name. Must be an active, registered ecosystem on‑chain. No dot characters allowed.
<Years>u8YesAdditional full years to extend the Ecosystem registration term. Subject to on‑chain minimum value constraint.

Behaviour​

  • The transaction signer must match the stored Ecosystem owner public key; otherwise returns OwnerMismatch.
  • Validates that the target Ecosystem account exists and is not yet expired.
  • Adds Years * 365 * 86400 seconds to the existing expiry timestamp (based on Openverse Clock::get().unix_timestamp).
  • Deducts ecosystem renewal fee as defined in the on‑chain treasury configuration.
  • Does not modify Meta / Body content or change ownership.
  • Does not auto‑renew child entities under this ecosystem; each entity maintains its own independent expiry timestamp.
  • If the Ecosystem expires, all entities under this namespace become logically unresolvable via the URI scheme, even if entities themselves are still valid.

Constraints & Validation Rules​

  1. OwnerMismatch: Signer is not the Ecosystem owner.
  2. NameExpired: Cannot renew an already‑expired Ecosystem.
  3. NameTooLong / NameEmpty: Invalid ecosystem name input.
  4. YearsTooSmall: Provided years value is below program‑enforced minimum.

Usage Example​

Extend the open root ecosystem for another 3 years:

open-token ecosystem renew-ownership open 3