<!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 > Understand Namespaces | Blockstack< / title >
< meta name = "generator" content = "Jekyll v3.8.3" / >
< meta property = "og:title" content = "Understand Namespaces" / >
< meta name = "author" content = "Blockstack" / >
< meta property = "og:locale" content = "en_US" / >
< meta name = "description" content = "Understand Namespaces" / >
< meta property = "og:description" content = "Understand Namespaces" / >
< link rel = "canonical" href = "https://zbabystack.netlify.com/core/naming/namespaces.html" / >
< meta property = "og:url" content = "https://zbabystack.netlify.com/core/naming/namespaces.html" / >
< meta property = "og:site_name" content = "Blockstack" / >
< meta property = "og:type" content = "article" / >
< meta property = "article:published_time" content = "2018-09-05T15:55:10-07:00" / >
< script type = "application/ld+json" >
{"description":"Understand Namespaces","author":{"@type":"Person","name":"Blockstack"},"@type":"BlogPosting","url":"https://zbabystack.netlify.com/core/naming/namespaces.html","headline":"Understand Namespaces","dateModified":"2018-09-05T15:55:10-07:00","datePublished":"2018-09-05T15:55:10-07:00","mainEntityOfPage":{"@type":"WebPage","@id":"https://zbabystack.netlify.com/core/naming/namespaces.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 = "uk-active" > < 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" > Creating 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/resolving.html" > Resolve a name< / a > < / li >
<!-- -->
< li class = "" > < a href = "/core/naming/register.html" > Register a name< / a > < / li >
<!-- -->
< li class = "" > < 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" > DID Encoding for Subdomains< / 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" > Understand Namespaces< / 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-05T15:55:10-07:00" itemprop = "datePublished" >
< a " target = "_blank" href = "https://github.com/moxiegirl/docs-new/blob/master/_core/naming/namespaces.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 5, 2018
< / time >
< / div >
< div class = "article-content" >
< p > Namespaces are the top-level naming objects in BNS.< / p >
< p > They control a few properties about the names within them:< / p >
< ul >
< li > How expensive they are to register< / li >
< li > How long they last before they have to be renewed< / li >
< li > Who (if anyone) receives the name registration fees< / li >
< li > Who is allowed to seed the namespace with its initial names.< / li >
< / ul >
< p > At the time of this writing, by far the largest BNS namespace is the < code class = "highlighter-rouge" > .id< / code >
namespace. Names in the < code class = "highlighter-rouge" > .id< / code > namespace are meant for resolving user
identities. Short names in < code class = "highlighter-rouge" > .id< / code > are more expensive than long names, and have
to be renewed by their owners every two years. Name registration fees are not
paid to anyone in particular—they are instead sent to a “black hole” where
they are rendered unspendable (the intention is to discourage ID sqautters).< / p >
< p > Unlike DNS, < em > anyone< / em > can create a namespace and set its properties. Namespaces
are created on a first-come first-serve basis, and once created, they last
forever.< / p >
< p > However, creating a namespace is not free. The namespace creator must < em > burn< / em >
cryptocurrency to do so. The shorter the namespace, the more cryptocurrency
must be burned (i.e. short namespaces are more valuable than long namespaces).
For example, it cost Blockstack PBC 40 BTC to create the < code class = "highlighter-rouge" > .id< / code > namespace in 2015
(in transaction
< code class = "highlighter-rouge" > 5f00b8e609821edd6f3369ee4ee86e03ea34b890e242236cdb66ef6c9c6a1b281< / code > ).< / p >
< p > Namespaces can be between 1 and 19 characters long, and are composed of the
characters < code class = "highlighter-rouge" > a-z< / code > , < code class = "highlighter-rouge" > 0-9< / code > , < code class = "highlighter-rouge" > -< / code > , and < code class = "highlighter-rouge" > _< / code > .< / p >
< h2 id = "namespace-organization" > Namespace Organization< / h2 >
< p > BNS names are organized into a global name hierarchy. There are three different
layers in this hierarchy related to naming:< / p >
< ul >
< li >
< p > < strong > Namespaces< / strong > . These are the top-level names in the hierarchy. An analogy
to BNS namespaces are DNS top-level domains. Existing BNS namespaces include
< code class = "highlighter-rouge" > .id< / code > , < code class = "highlighter-rouge" > .podcast< / code > , and < code class = "highlighter-rouge" > .helloworld< / code > . All other names belong to exactly one
namespace. Anyone can create a namespace, but in order for the namespace
to be persisted, it must be < em > launched< / em > so that anyone can register names in it.
Namespaces are not owned by their creators.< / p >
< / li >
< li >
< p > < strong > BNS names< / strong > . These are names whose records are stored directly on the
blockchain. The ownership and state of these names are controlled by sending
blockchain transactions. Example names include < code class = "highlighter-rouge" > verified.podcast< / code > and
< code class = "highlighter-rouge" > muneeb.id< / code > . Anyone can create a BNS name, as long as the namespace that
contains it exists already. The state for BNS names is usually stored in the < a href = "atlas_network.md" > Atlas
network< / a > .< / p >
< / li >
< li >
< p > < strong > BNS subdomains< / strong > . These are names whose records are stored off-chain,
but are collectively anchored to the blockchain. The ownership and state for
these names lives within the < a href = "atlas_network.md" > Atlas network< / a > . While BNS
subdomains are owned by separate private keys, a BNS name owner must
broadcast their subdomain state. Example subdomains include < code class = "highlighter-rouge" > jude.personal.id< / code >
and < code class = "highlighter-rouge" > podsaveamerica.verified.podcast< / code > . Unlike BNS namespaces and names, the
state of BNS subdomains is < em > not< / em > part of the blockchain consensus rules.< / p >
< / li >
< / ul >
< p > A feature comparison matrix summarizing the similarities and differences
between these name objects is presented below:< / p >
< table >
< thead >
< tr >
< th > Feature< / th >
< th > < strong > Namespaces< / strong > < / th >
< th > < strong > BNS names< / strong > < / th >
< th > < strong > BNS Subdomains< / strong > < / th >
< / tr >
< / thead >
< tbody >
< tr >
< td > Globally unique< / td >
< td > X< / td >
< td > X< / td >
< td > X< / td >
< / tr >
< tr >
< td > Human-meaningful< / td >
< td > X< / td >
< td > X< / td >
< td > X< / td >
< / tr >
< tr >
< td > Owned by a private key< / td >
< td > < / td >
< td > X< / td >
< td > X< / td >
< / tr >
< tr >
< td > Anyone can create< / td >
< td > X< / td >
< td > X< / td >
< td > [1]< / td >
< / tr >
< tr >
< td > Owner can update< / td >
< td > < / td >
< td > X< / td >
< td > [1]< / td >
< / tr >
< tr >
< td > State hosted on-chain< / td >
< td > X< / td >
< td > X< / td >
< td > < / td >
< / tr >
< tr >
< td > State hosted off-chain< / td >
< td > < / td >
< td > X< / td >
< td > X< / td >
< / tr >
< tr >
< td > Behavior controlled by consensus rules< / td >
< td > X< / td >
< td > X< / td >
< td > < / td >
< / tr >
< tr >
< td > May have an expiration date< / td >
< td > < / td >
< td > X< / td >
< td > < / td >
< / tr >
< / tbody >
< / table >
< p > [1] Requires the cooperation of a BNS name owner to broadcast its transactions< / p >
< div class = "share uk-text-center" >
< a href = "https://twitter.com/intent/tweet?text=Understand Namespaces&url=https://zbabystack.netlify.com/core/naming/namespaces.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%2Fnamespaces.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 >
