Skip to main content

Transfer Ownership

Transfer full ownership of an existing Ecosystem namespace to a recipient wallet address. Only the current Ecosystem owner is authorized to execute this instruction. This is a direct manual transfer and does not involve token payment; unrelated to sale‑offer workflow.

open-token ecosystem transfer-ownership --help

Synopsis

open-token ecosystem transfer-ownership <Name> <To>

Arguments​

ArgumentTypeRequiredDescription
<Name>StringYesTarget Ecosystem namespace name. No dot characters. Must reference an existing non‑expired on‑chain ecosystem account.
<To>PubkeyYesRecipient Openverse public key address that will receive full ecosystem ownership. Must be a valid wallet public‑key.

Behaviour​

  • Transaction signer must match stored Ecosystem owner public key; returns OwnerMismatch on authorization failure.
  • Validates target ecosystem exists and is not expired (NameExpired).
  • Overwrites the stored owner field with the recipient <To> public‑key.
  • Any active usership lease remains completely unchanged after ownership transfer: existing renter retains usership rights until rent expiry.
  • Does not modify ecosystem Meta, Body, ownership expiry timestamp, sale‑offer configuration, or rent‑offer configuration.
  • The sale / rent offer flags and pricing values persist; the new owner may later adjust them via sale‑ask / rent‑ask.
  • No tokens are exchanged in this operation; this is a free administrative ownership hand‑off.

Constraints & Validation Rules​

  1. OwnerMismatch: Transaction signer is not the Ecosystem owner.
  2. NameExpired: Ecosystem ownership registration is expired; ownership transfer prohibited.
  3. NameTooLong / NameEmpty: Invalid ecosystem name input.
  4. InvalidPubkey: <To> argument is not a valid Openverse public‑key.

Usage Example​

Transfer ownership of ecosystem open to recipient address 7xKZxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:

open-token ecosystem transfer-ownership open 7xKZxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx