Extending a Root Namespace⚓︎
Root namespaces are leased for a limited duration of approximately one year per registration. If you want to keep a namespace beyond its initial lease, you need to extend it.
This tutorial shows how to extend a root namespace.
Prerequisites⚓︎
- An account that owns an active root namespace. See Registering a Root Namespace.
- XEM to pay for the transaction and lease fees.
When to Extend⚓︎
You can extend a namespace in two situations:
-
Near the end of the lease: Renewal is only allowed during the final 43200 blocks (approximately 30 days) before expiration. The network rejects renewal attempts made earlier than that.
-
During the grace period: The namespace has expired but is still within the grace period, which lasts 43200 blocks (approximately 30 days) after expiration. Extending it restores the namespace to active status immediately.
Extending Subnamespaces and Mosaics
Only root namespaces need to be extended. Subnamespaces and all associated mosaics inherit the root namespace's lifetime.
Extending a root namespace therefore automatically keeps all of its subnamespaces and mosaics usable.
Procedure⚓︎
To extend a namespace, repeat the registration process using the same root namespace name and pay the 100 XEM lease fee again.
The account signing the transaction must be the namespace owner.
The protocol accepts renewals only near the end of the lease or during the grace period.
Duration and Limits⚓︎
Each renewal extends the lease to one year after the block containing the renewal transaction, not one year after the previous expiration. As a consequence, a namespace cannot be prepaid for multiple years in advance.
To maintain a namespace indefinitely, renew it during the renewal window every year.
For more details, see Duration in the Textbook.