<!DOCTYPE html>
< html lang = "en" >
< head >
< meta charset = "utf-8" >
< meta http-equiv = "X-UA-Compatible" content = "IE=edge" >
< meta name = "viewport" content = "width=device-width, initial-scale=1" >
<!-- Begin Jekyll SEO tag v2.5.0 -->
< title > Manage BNS Names | Blockstack< / title >
< meta name = "generator" content = "Jekyll v3.8.3" / >
< meta property = "og:title" content = "Manage BNS Names" / >
< meta name = "author" content = "Blockstack" / >
< meta property = "og:locale" content = "en_US" / >
< meta name = "description" content = "Manage BNS Names" / >
< meta property = "og:description" content = "Manage BNS Names" / >
< link rel = "canonical" href = "https://zbabystack.netlify.com/core/naming/manage.html" / >
< meta property = "og:url" content = "https://zbabystack.netlify.com/core/naming/manage.html" / >
< meta property = "og:site_name" content = "Blockstack" / >
< meta property = "og:type" content = "article" / >
< meta property = "article:published_time" content = "2018-09-08T19:24:57-07:00" / >
< script type = "application/ld+json" >
{"description":"Manage BNS Names","author":{"@type":"Person","name":"Blockstack"},"@type":"BlogPosting","url":"https://zbabystack.netlify.com/core/naming/manage.html","headline":"Manage BNS Names","dateModified":"2018-09-08T19:24:57-07:00","datePublished":"2018-09-08T19:24:57-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://zbabystack.netlify.com/core/naming/manage.html"},"@context":"http://schema.org"}< / script >
<!-- End Jekyll SEO tag -->
<!-- <meta property="og:image" content="https://zbabystack.netlify.com/assets/posts/logo.png"/> -->
< meta property = "og:image" content = "/assets/posts/logo.png" / >
< link rel = "stylesheet" href = "/assets/css/main.css" >
< link rel = "shortcut icon" type = "image/png" href = "/assets/img/touch-icon.png" >
< link rel = "alternate" type = "application/rss+xml" title = "Blockstack" href = "/feed.xml" >
< script src = "/assets/js/main.js" > < / script >
< / head >
< body >
< header class = "uk-background-secondary" >
< div data-uk-sticky = "sel-target: .uk-navbar-container; cls-active: uk-navbar-sticky" class = "uk-sticky uk-sticky-fixed" style = "position: fixed; top: 0px; width: 1904px;" >
< nav class = "uk-navbar-container" >
< div class = "uk-container" >
< div data-uk-navbar >
< div class = "uk-navbar-left" >
<!-- <a class="uk - navbar - item uk - logo" href="/"><img src="https://zbabystack.netlify.com/assets/posts/logo.png" alt="Docs"></a> -->
< a class = "uk-navbar-item uk-logo" href = "/" > < img src = "/assets/posts/logo.png" alt = "Docs" > < / a >
< / div >
< div class = "uk-navbar-right" >
< ul class = "uk-navbar-nav uk-visible@m" >
< li > < a href = "https://blockstack.org" target = "_blank" > Blockstack.org< / a > < / li >
< li > < a href = "https://forum.blockstack.org/" target = "_blank" > Forums< / a > < / li >
< li > < a href = "https://github.com/blockstack" target = "_blank" > GitHub< / a > < / li >
< / ul >
< div >
< a class = "uk-navbar-toggle" uk-search-icon href = "#" > < / a >
< div class = "uk-drop uk-background-default uk-border-rounded" uk-drop = "mode: click; pos: left-center; offset: 0" >
< form class = "uk-search uk-search-navbar uk-width-1-1" onsubmit = "return false;" >
< input id = "searchBox" class = "uk-search-input" type = "search" placeholder = "Search..." autofocus >
< / form >
< ul id = "searchBox-results" class = "uk-position-absolute uk-width-1-1 uk-list" > < / ul >
< / div >
< / div >
< a class = "uk-navbar-toggle uk-hidden@m" href = "#offcanvas" data-uk-navbar-toggle-icon data-uk-toggle > < / a >
< / div >
< / div >
< / div >
< / nav >
< / div >
< / header >
< div class = "uk-section" >
< div class = "uk-container" >
< div class = "uk-grid-large" data-uk-grid >
< div class = "sidebar-fixed-width uk-visible@m" >
< div class = "sidebar-docs uk-position-fixed" >
< h5 > Overview< / h5 >
< ul class = "uk-nav uk-nav-default doc-nav" >
<!-- -->
< li class = "" > < a href = "/core/naming/introduction.html" > Blockstack Naming Service (BNS)< / a > < / li >
<!-- -->
< li class = "" > < a href = "/core/naming/architecture.html" > Understand the Architecture< / a > < / li >
<!-- -->
< li class = "" > < a href = "/core/naming/namespaces.html" > Understand Namespaces< / a > < / li >
< / ul >
< h5 > Tutorials< / h5 >
< ul class = "uk-nav uk-nav-default doc-nav" >
<!-- -->
< li class = "" > < a href = "/core/naming/tutorial_creation.html" > Create and Launch a Namespace< / a > < / li >
<!-- -->
< li class = "" > < a href = "/core/naming/tutorial_subdomains.html" > Subdomain Design and Implementation< / a > < / li >
< / ul >
< h5 > How to use BNS< / h5 >
< ul class = "uk-nav uk-nav-default doc-nav" >
<!-- -->
< li class = "" > < a href = "/core/naming/pickname.html" > Choose a name< / a > < / li >
<!-- -->
< li class = "" > < a href = "/core/naming/creationhowto.html" > Creating a Namespace< / a > < / li >
<!-- -->
< li class = "" > < a href = "/core/naming/resolving.html" > Resolve a name< / a > < / li >
<!-- -->
< li class = "" > < a href = "/core/naming/register.html" > Register a name< / a > < / li >
<!-- -->
< li class = "uk-active" > < a href = "/core/naming/manage.html" > Manage BNS Names< / a > < / li >
<!-- -->
< li class = "" > < a href = "/core/naming/subdomains.html" > BNS Subdomains< / a > < / li >
< / ul >
< h5 > Other topics< / h5 >
< ul class = "uk-nav uk-nav-default doc-nav" >
<!-- -->
< li class = "" > < a href = "/core/naming/forks.html" > BNS Forks< / a > < / li >
<!-- -->
< li class = "" > < a href = "/core/naming/did.html" > Decentralized Identifiers (DIDs)< / a > < / li >
<!-- -->
< li class = "" > < a href = "/core/naming/comparison.html" > Naming system feature comparison< / a > < / li >
< / ul >
< / div >
< / div >
< div class = "uk-width-1-1 uk-width-expand@m" >
< article class = "uk-article" >
< h1 class = "uk-article-title" > Manage BNS Names< / h1 >
< div class = "uk-article-meta uk-margin-top uk-margin-medium-bottom" >
<!-- <img class="avatar avatar - small" alt="Blockstack" width="32" height="32" data - proofer - ignore="true" src="https://avatars2.githubusercontent.com/Blockstack?v=3&s=32" srcset="https://avatars2.githubusercontent.com/Blockstack?v=3&s=32 1x, https://avatars2.githubusercontent.com/Blockstack?v=3&s=64 2x, https://avatars2.githubusercontent.com/Blockstack?v=3&s=96 3x, https://avatars2.githubusercontent.com/Blockstack?v=3&s=128 4x" /> -->
<!-- Written by <span itemprop="author" itemscope itemtype="http://schema.org/Person"><span itemprop="name">Blockstack</span></span><br> -->
< time datetime = "2018-09-08T19:24:57-07:00" itemprop = "datePublished" >
< a " target = "_blank" href = "https://github.com/blockstack/blockstack-core/blob/master/docs/manage.md" class = "btn btn-default githubEditButton" role = "button" >
< span data-uk-icon = "icon: pencil; ratio: 1.2" > < / span > Edit this page on Github< / a >
< span style = "font-family:Wingdings" > w < / span > Sep 8, 2018
< / time >
< / div >
< div class = "article-content" >
< p class = "no_toc" > This section teaches you how to manage your namespace, it contains the
following sections:< / p >
< ul id = "markdown-toc" >
< li > < a href = "#overview-of-management" id = "markdown-toc-overview-of-management" > Overview of management< / a > < / li >
< li > < a href = "#name_update-live-example" id = "markdown-toc-name_update-live-example" > NAME_UPDATE (live example)< / a > < / li >
< li > < a href = "#name_transfer-live-example" id = "markdown-toc-name_transfer-live-example" > NAME_TRANSFER (live example)< / a > < / li >
< li > < a href = "#name_revoke-live-example" id = "markdown-toc-name_revoke-live-example" > NAME_REVOKE (live example)< / a > < / li >
< li > < a href = "#name_renewal-live-example" id = "markdown-toc-name_renewal-live-example" > NAME_RENEWAL (live example)< / a > < / li >
< / ul >
< h2 id = "overview-of-management" > Overview of management< / h2 >
< p > Once you register a BNS name, you have the power to change its zone file hash,
change its public key hash, destroy it (i.e. render it unresolvable),
or renew it. The BNS consensus rules ensure that < em > only< / em > you, as the owner of
the name’s private key, have the ability to carry out these operations.< / p >
< p > Each of these operations are executed by sending a specially-formatted
blockchain transaction to the blockchain, which BNS nodes read and process.
The operations are listed below:< / p >
< table >
< thead >
< tr >
< th > Transaction Type< / th >
< th > Description< / th >
< / tr >
< / thead >
< tbody >
< tr >
< td > < code class = "highlighter-rouge" > NAME_UPDATE< / code > < / td >
< td > This changes the name’s zone file hash. Any 20-byte string is allowed.< / td >
< / tr >
< tr >
< td > < code class = "highlighter-rouge" > NAME_TRANSFER< / code > < / td >
< td > This changes the name’s public key hash. In addition, the current owner has the option to atomically clear the name’s zone file hash (so the new owner won’t “receive” the zone file).< / td >
< / tr >
< tr >
< td > < code class = "highlighter-rouge" > NAME_REVOKE< / code > < / td >
< td > This renders a name unresolvable. You should do this if your private key is compromised.< / td >
< / tr >
< tr >
< td > < code class = "highlighter-rouge" > NAME_RENEWAL< / code > < / td >
< td > This pushes back the name’s expiration date (if it has one), and optionally both sets a new zone file hash and a new public key hash.< / td >
< / tr >
< / tbody >
< / table >
< p > The reference BNS clients—
< a href = "https://github.com/blockstack/blockstack.js" > blockstack.js< / a > and the < a href = "https://github.com/blockstack/blockstack-browser" > Blockstack
Browser< / a > —can handle creating
and sending all of these transactions for you.< / p >
< h2 id = "name_update-live-example" > NAME_UPDATE (< a href = "https://www.blocktrail.com/BTC/tx/e2029990fa75e9fc642f149dad196ac6b64b9c4a6db254f23a580b7508fc34d7" > live example< / a > )< / h2 >
< p > A < code class = "highlighter-rouge" > NAME_UPDATE< / code > transaction changes the name’s zone file hash. You would send
one of these transactions if you wanted to change the name’s zone file contents.
For example, you would do this if you want to deploy your own < a href = "https://github.com/blockstack/gaia" > Gaia
hub< / a > and want other people to read from it.< / p >
< p > A < code class = "highlighter-rouge" > NAME_UPDATE< / code > transaction is generated from the name, a recent < a href = "#bns-forks" > consensus
hash< / a > , and the new zone file hash. The reference clients gather
this information automatically. See the < a href = "wire-format.md" > transaction format< / a >
document for details on how to construct this transaction.< / p >
< h2 id = "name_transfer-live-example" > NAME_TRANSFER (< a href = "https://www.blocktrail.com/BTC/tx/7a0a3bb7d39b89c3638abc369c85b5c028d0a55d7804ba1953ff19b0125f3c24" > live example< / a > )< / h2 >
< p > A < code class = "highlighter-rouge" > NAME_TRANSFER< / code > transaction changes the name’s public key hash. You would
send one of these transactions if you wanted to:< / p >
< ul >
< li > Change your private key< / li >
< li > Send the name to someone else< / li >
< / ul >
< p > When transferring a name, you have the option to also clear the name’s zone
file hash (i.e. set it to < code class = "highlighter-rouge" > null< / code > ).
This is useful for when you send the name to someone else, so the
recipient’s name does not resolve to your zone file.< / p >
< p > The < code class = "highlighter-rouge" > NAME_TRANSFER< / code > transaction is generated from the name, a recent < a href = "#bns-forks" > consensus
hash< / a > , and the new public key hash. The reference clients gather
this information automatically. See the < a href = "wire-format.md" > transaction format< / a >
document for details on how to construct this transaction.< / p >
< h2 id = "name_revoke-live-example" > NAME_REVOKE (< a href = "https://www.blocktrail.com/BTC/tx/eb2e84a45cf411e528185a98cd5fb45ed349843a83d39fd4dff2de47adad8c8f" > live example< / a > )< / h2 >
< p > A < code class = "highlighter-rouge" > NAME_REVOKE< / code > transaction makes a name unresolvable. The BNS consensus rules
stipulate that once a name is revoked, no one can change its public key hash or
its zone file hash. The name’s zone file hash is set to < code class = "highlighter-rouge" > null< / code > to prevent it
from resolving.< / p >
< p > You should only do this if your private key is compromised, or if you want to
render your name unusable for whatever reason. It is rarely used in practice.< / p >
< p > The < code class = "highlighter-rouge" > NAME_REVOKE< / code > operation is generated using only the name. See the
< a href = "wire-format.md" > transaction format< / a > document for details on how to construct
it.< / p >
< h2 id = "name_renewal-live-example" > NAME_RENEWAL (< a href = "https://www.blocktrail.com/BTC/tx/e543211b18e5d29fd3de7c0242cb017115f6a22ad5c6d51cf39e2b87447b7e65" > live example< / a > )< / h2 >
< p > Depending in the namespace rules, a name can expire. For example, names in the
< code class = "highlighter-rouge" > .id< / code > namespace expire after 2 years. You need to send a < code class = "highlighter-rouge" > NAME_RENEWAL< / code > every
so often to keep your name.< / p >
< p > A < code class = "highlighter-rouge" > NAME_RENEWAL< / code > costs both transaction fees and registration fees. You will
pay the registration cost of your name to the namespace’s designated burn address when you
renew it. You can find this fee using the < code class = "highlighter-rouge" > /v1/prices/names/{name}< / code > endpoint.< / p >
< p > When a name expires, it enters a month-long “grace period” (5000 blocks). It
will stop resolving in the grace period, and all of the above operations will
cease to be honored by the BNS consensus rules. You may, however, send a
< code class = "highlighter-rouge" > NAME_RENEWAL< / code > during this grace period to preserve your name.< / p >
< p > If your name is in a namespace where names do not expire, then you never need to
use this transaction.< / p >
< p > When you send a < code class = "highlighter-rouge" > NAME_RENEWAL< / code > , you have the option of also setting a new public
key hash and a new zone file hash. See the < a href = "wire-format.md" > transaction format< / a >
document for details on how to construct this transaction.< / p >
< div class = "share uk-text-center" >
< a href = "https://twitter.com/intent/tweet?text=Manage BNS Names&url=https://zbabystack.netlify.com/core/naming/manage.html&via=&related=" rel = "nofollow" target = "_blank" title = "Share on Twitter" onclick = "window.open(this.href, 'twitter', 'width=550,height=235');return false;" > < span data-uk-icon = "icon: twitter; ratio: 1.2" > < / span > < / a >
< a class = "uk-margin-small-left" href = "https://www.facebook.com/sharer/sharer.php?u=https%3A%2F%2Fzbabystack.netlify.com%2Fcore%2Fnaming%2Fmanage.html" rel = "nofollow" target = "_blank" title = "Share on Facebook" onclick = "window.open(this.href, 'facebook-share','width=580,height=296');return false;" > < span data-uk-icon = "icon: facebook; ratio: 1.2" > < / span > < / a >
< / div >
< / div >
< hr class = "uk-margin-medium" >
< div class = "uk-margin-large-top" >
< h3 > Related Articles< / h3 >
< ul class = "uk-list" >
< / ul >
< / div >
< / article >
< script >
// Table of contents scroll to
UIkit.scroll('#markdown-toc a', {
duration: 400,
offset: 120
});
< / script >
< / div >
< / div >
< / div >
< div id = "offcanvas" data-uk-offcanvas = "flip: true; overlay: true" >
< div class = "uk-offcanvas-bar" >
< button class = "uk-offcanvas-close" type = "button" data-uk-close > < / button >
< ul class = "uk-nav uk-nav-default" >
<!-- <li><a class="uk - logo uk - margin - small - bottom" href="/"><img src="https://zbabystack.netlify.com/assets/posts/logo.png" alt="Docs"></a></li> -->
< li > < a class = "uk-logo uk-margin-small-bottom" href = "/" > < img src = "/assets/posts/logo.png" alt = "Docs" > < / a > < / li >
< li > < a href = "https://blockstack.org" target = "_blank" > Blockstack.org< / a > < / li >
< li > < a href = "https://forum.blockstack.org/" target = "_blank" > Forums< / a > < / li >
< li > < a href = "https://github.com/blockstack" target = "_blank" > GitHub< / a > < / li >
< / ul >
< div class = "uk-margin-small-top uk-text-center uk-text-muted uk-link-muted" >
< div data-uk-grid class = "uk-child-width-auto uk-grid-small uk-flex-center uk-grid" >
< div class = "uk-first-column" >
< a href = "https://twitter.com/" data-uk-icon = "icon: twitter" class = "uk-icon-link uk-icon" target = "_blank" > < / a >
< / div >
< div >
< a href = "https://www.facebook.com/" data-uk-icon = "icon: facebook" class = "uk-icon-link uk-icon" target = "_blank" > < / a >
< / div >
< div >
< a href = "https://www.instagram.com/" data-uk-icon = "icon: instagram" class = "uk-icon-link uk-icon" target = "_blank" > < / a >
< / div >
< div >
< a href = "https://vimeo.com/" data-uk-icon = "icon: vimeo" class = "uk-icon-link uk-icon" target = "_blank" > < / a >
< / div >
< / div >
< / div >
< / div >
< / div >
< footer class = "uk-section uk-text-center uk-text-muted uk-link-muted" >
< div class = "uk-container uk-container-small" >
<!-- <div>
< ul class = "uk-subnav uk-flex-center" >
< li > < a href = "https://blockstack.org" target = "_blank" > Blockstack.org< / a > < / li >
< li > < a href = "https://forum.blockstack.org/" target = "_blank" > Forums< / a > < / li >
< li > < a href = "https://github.com/blockstack" target = "_blank" > GitHub< / a > < / li >
< / ul >
< / div >
< div class = "uk-margin-medium" >
< div data-uk-grid class = "uk-child-width-auto uk-grid-small uk-flex-center uk-grid" >
< div class = "uk-first-column" >
< a href = "https://twitter.com/" data-uk-icon = "icon: twitter" class = "uk-icon-link uk-icon" target = "_blank" > < / a >
< / div >
< div >
< a href = "https://www.facebook.com/" data-uk-icon = "icon: facebook" class = "uk-icon-link uk-icon" target = "_blank" > < / a >
< / div >
< div >
< a href = "https://www.instagram.com/" data-uk-icon = "icon: instagram" class = "uk-icon-link uk-icon" target = "_blank" > < / a >
< / div >
< div >
< a href = "https://vimeo.com/" data-uk-icon = "icon: vimeo" class = "uk-icon-link uk-icon" target = "_blank" > < / a >
< / div >
< / div >
< / div > -->
< div class = "uk-margin-medium uk-text-small copyright" > © 2018 Blockstack< / div >
< / div >
< / footer >
< script type = "text/javascript" >
/* Create a configuration object */
var ss360Config = {
/* Your site id */
siteId: 'blockstack',
/* A CSS selector that points to your search box */
searchBox: {selector: '#searchBox'}
};
< / script >
< script src = "https://cdn.sitesearch360.com/sitesearch360-v11.min.js" async > < / script >
< / body >
< / html >
