@ -23,19 +23,19 @@ Blockstack envisions a world where users control their own data, and power flows
In the decentralied internet, that information stays with you and it isn't
collected or stored by anyone. Applications that operate in the decentralized
internet are called _decentralized applications_ or Dapps for short.
internet are called _decentralized applications_ or DApps for short.
## What is Blockstack?
Blockstack is an ecosystem to support both Dapp users and Dapp developers. For
users, Blockstack makes software to create Blockstack identities and find Dapps.
For developers, Blockstack develops an ecosystem of software and services that developrs can use to build Dapps.
Blockstack is an ecosystem to support both DApp users and DApp developers. For
users, Blockstack makes software to create Blockstack identities and find DApps.
For developers, Blockstack develops an ecosystem of software and services that developrs can use to build DApps.
Blockstack through its
## How do Dapps differ applications I typically use?
## How do DApps differ applications I typically use?
Dapps differ from Web applications in two ways:
DApps differ from Web applications in two ways:
* **Users have identities not accounts**. The user brings their identity to the
applications; applications do not require the user to create accounts and
@ -58,15 +58,15 @@ private key. As long as no one gets access to your private key, no one can
control your data or ID. When you use Blockstack, by design, your private keys
are never sent to any remote servers.
## Do Dapps uwork with a regular browser?
## Do DApps uwork with a regular browser?
Yes! Dapps run in the web browsers (Chrome, Safari, Internet Explorer, etc.) you know and love.
Yes! DApps run in the web browsers (Chrome, Safari, Internet Explorer, etc.) you know and love.
## What is the Blockstack Browser?
The Blockstack Browser is the Dapp users use to create and manage their identities and configure their data storage. The browser is also where users can go to discover and use apps using Blockstack.
The Blockstack Browser is the DApp users use to create and manage their identities and configure their data storage. The browser is also where users can go to discover and use apps using Blockstack.
The Blockstack Browser also handles login requests from Dapps that allow their users to log in with Blockstack. When a user clicks a **Log In with Blockstack** button, they are redirected to the Blockstack Browser to approve the request before being logged into the app.
The Blockstack Browser also handles login requests from DApps that allow their users to log in with Blockstack. When a user clicks a **Log In with Blockstack** button, they are redirected to the Blockstack Browser to approve the request before being logged into the app.
Blockstack allows you to create one free identity in the Blockstack
_namespace_. A namespace a top-level category in the Blockstack Ecosystem. A
namespace is similar to the domains you are familiar with from using the web,
`google.com` is domain and so is the `gouvernement.fr` domain. An identity in
the `.blockstack` namespace has the _`username`_`.id.blockstack` format.
You can also purchase your own identity (`.id`) using bitcoin (BTC). A name's
price depends on its length in characters and the current Bitcoin fees. For
example, ranges such as .00831 and .001943 BTC 20-80 US dollars is not
unusual.
## Create an ID
To, create an id, do the following:
1. Go to the <ahref="https://browser.blockstack.org"target="\_blank">Blockstack Web Browser</a>.
You have Blockstack Browser installed: If you start from ADD USERNAME from IDs window, jump to 6.
1/ You do not have the Blockstack Browser installed: go to https://explorer.blockstack.org/ 99
2/ Search for your name typing “yourname.id” on the search box. If your .id is “free”, the response will be “Ooops ! The name yourname.id doesn’t exist.” or will show a owner “mnbhbu235j46ijnowejjybjb” with Expires field empty and just NAME_IMPORT, no NAME_REGISTRATION.
3/ Install de Blockstack Browser, open an account, write by hand on a piece of paper and make two copies of mnemonic 12 words phrase, DO NOT KEEP IT IN THE COMPUTER, DO NOT UPLOAD IT TO THE CLOUD, DO NOT COPY IT IN THE CLIPBOARD.
4/ Go to IDs
5/ Click ADD USERNAME. (or MORE and CREATE NEW ID if you want more than one .id’s)
6/ Try your selected name (without “.id”)
7/ If available, check the price.
(If you want to buy a name with your wallet empty the process is a little more complex because the transfer can take a long time and the process will seems frozen, so I recommend to supply your wallet before, go to step 8)
8/ Click WALLET
9/ Fund your wallet with the correct amount or more.
10/ Wait until you see the bitcoin amount in your wallet. Sometimes bitcoin net can take a minute or one hour (or 5) to perform the transaction depending on the demand of network operations, in the following link you will see approx. the time it will take to complete the transaction based on your fee: https://bitcoinfees.earn.com/ 22
10/ Back to ADD USERNAME
11/ Write your name and click search.
12/ Click BUY
13/ The process takes one hour or six blocks, DO NOT TURN OFF the browser or the computer for two hours.
Through the Blockstack browser you can create an identity. Your identity is a
point of contact as you interact with others through Dapps. Others may be
Through the Blockstack Browser you can create an identity. Your identity is a
point of contact as you interact with others through DApps. Others may be
individual users or companies or software. Unless you allow it, none of these
others have access to anything other than your identity label, for example
`moxiegirl.id.blockstack`. To learn more about you, others must ask and you can
choose to share -- or not.
`moxiegirl.id.blockstack`. Typically, others must ask to learn more about you,
and you can choose to share – or not.
This document explains one type of identity, the Blockstack ID. You learn how to
create them, as well as when and how to restore them. It contains the following sections:
@ -19,65 +19,89 @@ create them, as well as when and how to restore them. It contains the following
{:toc}
## Understand Blockstack IDs
## Understand how identities function in the Blockstack Ecosystem
Interacting within the decentralized internet requires that you have at least
one identity, though you can create several. Your identity is created through a
registrar. Blockstack maintains a registrar for creating identities that you
can use to interact with distributed applications (Dapps).
In this section, you learn about identity so you can use it securely.
To use the Blockstack Browser or to develop a Dapp you
require a Blockstack ID, for example `moxiegirl.id.blockstack`. A Blockstack ID
is a digital identity that is registered With Blockstack. Think of the ID as a
form of identification, like a drivers license, but this license identifies you
on the virtual internet highway.
### Why is an identity not an account
On the internet of today, an account you create for an applications stays with
the company providing that app. This company keeps data you enter about yourself
and data about how you use their application. When you close your account, the
company retains that data.
Your personal data storage is linked to this ID. You use this ID to
identify yourself to other users and to sign into applications. When you add a
picture to a Dapp, the picture appears in the Dapp but the picture's bits and bytes
are stored in your personal storage.
In decentralized, blockchain software, _identity_ is a combination of
username and key. The data associated with that identity stays with it, this
means applications or central authorities do not keep our control access to your
data.
You give a DApp access to your data but when you decide to no longer use that
application, you withdraw that access. The DApp developer can no longer access
information about you.
When you log into another application with your ID, that application can ask for access to that storage and then use that picture. The application must ask you, it knows you by your ID, and
### How do you get an identity
Decentralized applications that want to access your data need your
identity and your permission.
Think of the ID as a form of identification, like a drivers license. Like
drivers' licenses, each identity is unique, but this license identifies you on
the virtual internet highway. An identity is created through a registrar of which there are many.
When you first sign up through the Blockstack browser, you create an initial
human-readable identity in the `id.blockstack` domain. This initial identity has
the format:
For DApps in the Blockstack Ecosystem, Blockstack maintains an identity
registrar. The Blockstack Browser is Blockstack's DApp for creating and managing
identities in the Blockstack registration space. An example of a registered
Blockstack ID is the `larry.id` ID. The `.id` designation is required, the
`larry` portion is a unique string.
_`USERNAME`_`.id.blockstack`
The Blockstack Browser allows new users to create free IDs. These free IDs have
included the word `blockstack` in the ID, like this `moxiegirl.id.blockstack`. The
additional `blockstack` portion of the name is called a _namespace_. It just
means all the names belong to a particular entity. You don't have to use a free
`id.blockstack` identity. You can also buy an identity that just has a unique
name and the `.id` portion.
The _`USERNAME`_ portion must be unique. You enter an email and password to
create the initial identity. Blockstack uses the password to:
This first ID you create is a _primary ID_. Once you create a primary identity,
you can add other, sub-identities to it. Sub-identities can have the
`id.blockstack` or the `.id` format. You might created sub-identities for the
same reason you have a work and home email.
* seed a _recovery code_ an encrypted string, for example `36mWivFdy0YPH2z31EflpQz/Y0UMrOrJ++lH=0EI7c3mop2JuRBm5W1P0BwXxSTazJsUjOAmC55rFUWINqDqGccLio0iwzGclAhaHGZQ5M52`
* seed a _recovery key_ which is a squence of words `applied binge crisp pictorial fiery dancing agreeable frogs light finish ping apple`
### What is a key?
The email is provided to allow either Blockstack or a decentralized application
to communicate information to you. In Blockstacks' case, the email is used to
send you reovery information.
IDs have keys. These key unlock your identity like opening the door to a private
home. You should keep your ID secret and in a safe place. When you create an
ID, Blocktack creates the key for you. When you create an ID, Blockstack sends
you an email with a recovery code you can use to view your key.
While Blockstack registers your human readable ID and the recovery key. _You_ must
* _secret recovery key_ which is a sequence of words `applied binge crisp pictorial fiery dancing agreeable frogs light finish ping apple`
* _recovery code_ an encrypted string, for example, `36mWivFdy0YPH2z31EflpQz/Y0UMrOrJ++lH=0EI7c3mop2JuRBm5W1P0BwXxSTazJsUjOAmC55rFUWINqDqGccLio0iwzGclAhaHGZQ5M52`
You receive the recovery code only once. When you get this email, You should
**View Secret Recovery Key** immediately and save to a secure location such as a
password manager.
<divclass="uk-card uk-card-default uk-card-body">
<p>When Blockstack registers your human-readable ID and the recovery key. _You_ must
record the:
</p>
<ul>
<li>recovery key</li>
<li>recovery code (in the order the words appear)</li>
<li>initial password (the password lasts until you **RESET** the browser)</li>
</ul>
<p>Blockstack does not store them, so it can't give them to you later if they are
lost.</p>
</div>
* recovery key
* recovery code (in the order the words apepar)
* initial password
### Where can you use a Blockstack ID
Blockstack does not store them, so it can't give them to you later if they are
lost.
You can use your Blockstack ID with every DApp in the Blockstack Ecosystem. To
create an ID, you use a DApp called the Blockstack Browser. Any DApp data you
create is linked to this ID.
Your initial ID is created in the `id.blockstack` domain. The initial identity
remains primary, and you need this primary ID and its associated information
(recovery code, recovery key, and password) to use the browser again.
For example, if you add a picture to a DApp, the picture appears in the DApp, but
the picture's bits and bytes are stored in your personal storage. When you log
into another DApp with your ID, that application can ask for access to your
storage.
Finally, the `id.blockstack` domain is sponsored by the Blockstack registrar and
identities on it are free. Once you are using the Blockstack Browser, you can
create additional identities outside of this domain and controlled by other
registrars. Coin is required to purchase identities on other domains.
## Create an initial Blockstack ID
@ -123,7 +147,7 @@ not accessible by anyone.
5. Enter an email and press **Next**.
The system prompts you for an password and its confirmation. This password
The system prompts you for a password and its confirmation. This password
can be one you entered previously or an entirely new one. Write this password
down. You can use the password during your current Blockstack browser
interaction to reveal your keychain or change your password. Blockstack does
@ -135,7 +159,7 @@ not accessible by anyone.

At this point, you can go onto work with Dapps or you can review your recovery key.
At this point, you can go onto work with DApps or you can review your recovery key.
### Restore with a recovery code and original password
@ -160,8 +184,8 @@ not accessible by anyone.
5. Enter an email and press **Next**.
The system prompts you for an password. This must be the password entered
when you first created your identity. If you have forgetten this passowrd,
The system prompts you for a password. This must be the password entered
when you first created your identity. If you have forgotten this password,
Blockstack cannot provide it to you. Instead, you must switch to using your
recovery key rather than your code to restore your identity.
@ -171,4 +195,4 @@ not accessible by anyone.

At this point, you can go work with Dapps or you can review your recovery key.
At this point, you can go work with DApps or you can review your recovery key.
@ -17,7 +17,7 @@ control plane ,The part of a network that carries signaling traffic and is respo
core node,A server that runs Blockstack Core services.,Filing
crypto-asset,"A digital asset which utilises cryptography, peer-to-peer networking, and a public ledger to regulate the creation of new units, verify transactions, and secure the transactions without the intervention of any middleman.",Filing
cryptography,"The practise and study of encryption and decryption - encoding data so that it can only be decoded by specific individuals. A system for encrypting and decrypting data is a cryptosystem.",General Tech
decentralized application (Dapp),"A Dapp is a service that enables direct interaction between end users and providers (e.g. connecting buyers and sellers in some marketplace, owners and stores in file storage). A term coined by Ethereum. See their glossary: http://ethdocs.org/en/latest/glossary.html",Blockchain general
decentralized application (DApp),"A DApp is a service that enables direct interaction between end users and providers (e.g. connecting buyers and sellers in some marketplace, owners and stores in file storage). A term coined by Ethereum. See their glossary: http://ethdocs.org/en/latest/glossary.html",Blockchain general
digital asset,"Also referred to as a crypto-asset. Any set of unique digital information—including, for example, programs, decentralized programs, isolated chunks of programming code, collections of data, e-mail or web addresses or cryptocurrency tokens—that is capable of being stored and uniquely tracked on a computer network such as the Blockstack network and over which a user can maintain control through that network.",Filing
digital fingerprint,"A digital fingerprint is a unique number of a fixed length that can be produced by running any set of digital information through something called a cryptographic hash function. Each set of digital information (including a digital asset, and the digital record of any network operation on that digital asset) should (as a practical matter) have a unique digital fingerprint, which allows that set of digital information to be identified. However, it is almost impossible to recreate a digital asset from its digital fingerprint. The Blockstack network uses industry-standard algorithms such as SHA-256 to create digital fingerprints.",Filing
digital signature,"A digital signature is a sequence of digital information combining a user’s private key and any digital information that the user wishes to sign. Any other party can use the user’s paired public key to verify that the digital signature is authentic, i.e. that the public key was generated from a particular piece of digital information and the user’s private key.",Filing
Can't render this file because it contains an unexpected character in line 14 and column 0.
class="twitter-share-button" data-size="large" data-text="I'm the ruler of my Animal Kingdom. Just submitted my Blockstack sample DApp to App.co @TheDappStore! Dapp on people." data-hashtags="blockstack,
class="twitter-share-button" data-size="large" data-text="I'm the ruler of my Animal Kingdom. Just submitted my Blockstack sample DApp to App.co @TheDAppStore! DApp on people." data-hashtags="blockstack,