Skip to main content

Transfer Usership

Transfer the active usership (rental tenant right) of an Ecosystem namespace to a recipient wallet address. Only the current active renter is authorized to execute this instruction. This transfers only temporary lease rights; full ecosystem ownership remains unchanged.

open-token ecosystem transfer-usership --help

Synopsis

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

Arguments​

ArgumentTypeRequiredDescription
<Name>StringYesTarget Ecosystem namespace name. No dot characters. Must reference an existing on‑chain ecosystem with an active non‑expired usership lease.
<To>PubkeyYesRecipient Openverse public‑key address that will receive the usership right. Must be a valid wallet public‑key.

Behaviour​

  • Transaction signer must match stored ecosystem renter public key; returns RenterMismatch on authorization failure.
  • Validates target ecosystem exists, is not expired (NameExpired).
  • Validates there is an active non‑expired rent lease (RentExpired check).
  • Overwrites the stored renter field with recipient <To> public‑key.
  • Lease expiry timestamp remains unchanged; the remaining lease duration is fully inherited by the new renter.
  • Does not modify ecosystem owner, meta, body, ownership expiry, rent‑ask / sale‑ask offer configurations.
  • No token payment occurs; this is a free transfer of temporary usership privilege.
  • Ecosystem owner stays as legal owner throughout the whole transfer process.

Constraints & Validation Rules​

  1. RenterMismatch: Transaction signer is not the current renter of the ecosystem.
  2. RentExpired: No active valid usership lease exists; transfer prohibited.
  3. NameExpired: Underlying ecosystem ownership registration expired; rent operations unavailable.
  4. NameTooLong / NameEmpty: Invalid ecosystem name input.
  5. InvalidPubkey: <To> argument is not a valid Openverse public‑key.

Usage Example​

Transfer usership of ecosystem open to recipient address 7xKZxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx:

open-token ecosystem transfer-usership open 7xKZxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx