Skip to main content

Renew Usership

Renew the active rental usership (tenant lease) period of an Ecosystem namespace. This extends the renter’s temporary usage right, does not change ecosystem ownership. Only the current renter (tenant) is authorized to call this instruction.

open-token ecosystem renew-usership --help

Synopsis

open-token ecosystem renew-usership <Name> <Days>

Arguments​

ArgumentTypeRequiredDescription
<Name>StringYesName of target Ecosystem namespace. Must be an existing on‑chain ecosystem, no dot characters allowed. Must currently have an active rent / usership lease.
<Days>u32YesAdditional days to extend the active rental usership. Subject to on‑chain minimum and maximum rent duration constraints.

Behaviour​

  • Transaction signer must match stored ecosystem renter public key; returns RenterMismatch on authorization failure.
  • Validates that an active non‑expired rent lease exists for this ecosystem; fails if no rent is active or rent already expired (RentExpired).
  • Extends the rent expiry timestamp by adding provided <Days> in seconds (days * 86400).
  • Deducts rent renewal payment according to on‑chain treasury rent rate configuration.
  • Does not modify ecosystem ownership, meta, body content.
  • Does not affect the underlying ecosystem ownership expiry timestamp; only extends the temporary tenant usership window.
  • Ecosystem owner remains full owner during and after rent renewal; renter only obtains usage privileges for the rent period.
  • After rent expiry, usership privileges are revoked automatically; owner regains exclusive usage rights.

Constraints & Validation Rules​

  1. RenterMismatch: Signer is not the current renter of the ecosystem.
  2. RentExpired: Existing rent lease has already expired; cannot renew an expired usership.
  3. DaysTooSmall: Input days value is below program‑enforced minimum rent duration.
  4. RentTooLong: Requested extension exceeds maximum allowed rent duration limit.
  5. NameTooLong / NameEmpty: Invalid ecosystem name input.

Usage Example​

Extend active usership lease of ecosystem open for additional 30 days:

open-token ecosystem renew-usership open 30