1 About DApps and App Mining

Zero-to-DApp 1 of 4

Welcome to the Blockstack Zero-to-DApp tutorial. The tutorial uses the Blockstack platform to teach you about blockchain technology and the Blockstack Ecosystem. The tutorial teaches you what makes a DApp different than a traditional application. You’ll build and run a DApp. You’ll also learn about the Blockstack Signature Fund and the Application Mining program which awards funds to DApp developer every month.

The tutorial has four parts of which this is first, and it contains the following topics:

You can complete the entire Zero-to-DApp tutorial in less than 45 minutes. If you prefer a 10-minute hello-world code sample, see the Hello, Blockstack Tutorial.

Skills you need to follow this tutorial

This tutorial is written for developers and others who want to learn about DApps and how the Blockstack ecosystem supports their development. As a result, the target audience is intentionally broad. Anyone with access to a Windows, Mac, or Linux computer and some familiarity with a command line should be able to follow along.

If you are good at following directions, chances are you can complete this tutorial even if you have no programming experience. Knowledgeable developers should easily be able to complete the tutorial within an hour by following along.

If you are a developer superhero, you may want to skim or move quickly through the pages and that’s fine too.

Note: For best results, use the Chrome browser for this tutorial. Currently, the Blockstack Browser works best in Chrome and you can encounter problems using browsers such as Safari or Firefox. Currently, IE and the Edge browsers are not supported.

How traditional and decentralized applications differ

In this tutorial, you build, run, modify, and deploy a decentralized application (DApp) called Animal Kingdom. A DApp uses blockchain technology for the authentication and data storage components of an application’s platform. Blockchain applications are decentralized applications, meaning they move data control and identity management from central authorities and organizations to individual users.

Anyone who has had their identity stolen or lost money because of a data breach, understands that centralized applications come with personal risk. Anyone who has lived in or visited a foreign country and lost access to a site, to a service, or to information because of government censorship also understands how centralization impacts how people live.

Users and businesses see DApps as valuable because they solve the centralization problems of traditional applications. The following table describes the features of traditional applications and the features of blockchain applications:

Traditional application Decentralized application
Users must create many username and password combinations for each service or application. Each combination must be managed and maintained. Also, each creation requires the user to provide important or unique information into the care of a third-party. Users create and own one or more identities. They use their identities with all applications and services. For example, a user could use the same identity for buying books online as they use for social media.
Multiple third-party applications and services store personal data from individual users in backend servers. These backend servers are under the control of the application or service. Users leaving the application leave their data behind. Personal information and data is encrypted and remains under the control of the user. Users leaving an application leave no data behind because none was stored with the application.
Multiple accounts across many servers make personal data subject to attack, misuse, and uncontrolled collection. Users can audit access to their data and know who accessed their data and which data were accessed.
Central authorities and middlemen control network access enabling them to censor applications and/or users that use them. Companies are developing blockchains that run over peer-to-peer networks. These future networks can make shutting down or entirely blocking a decentralized application close to impossible.

The blockchain technology you build a DApp with determines the features available to your application.

Try your first DApp by creating an identity

The Blockstack Web browser is a DApp for the web. Users can use it to create and manage identities in the Blockstack Ecosystem. DApps built with the Blockstack platform, use the on-boarding sequence provided by the browser to onboard their users. Currently, users can create a Blockstack ID for free or buy their own ID.

If you haven’t already created your own Blockstack ID, do this now. As you create an ID, consider what interactions are familiar to you from traditional applications, and which are not.

To create an initial Blockstack ID, do the following:

  1. Open the Blockstack web application in your browser.

    The application prompts you to create or restore an ID.

  2. Choose Create new ID.

    The browser prompts you to register a unique username in the id.blockstack domain. This is a free Blockstack identity and the format of the ID is:


    You’ll use this initial ID to access the Blockstack Browser and other DApps.

    The Check Availability buttom makes sure your name is unique.

  3. Press Continue when you find an available name you like.

    The application prompts you to enter a password. Blockstack uses this password to encrypt your recovery code. You must record and save this initial password.

    NOTE:The Blockstack team cannot restore your password for you.

  4. Enter a password, confirm it, and press Register ID.

    Blockstack creates an id for you and then prompts you for an email.

    Blockstack uses this email address to send you recovery information. This email is only sent once.

  5. Press Next.

    Blockstack presents you with the completed ID.

    The system prompts you to save your recovery code.

  6. Click Secret Recovery Key to record your key.

    A recovery code is a sequence of words. These words allow you to recover an id.blockstack that you’ve created. You should store the words along with their order, for example, #1 applied and so forth.

  7. Copy your Secret Recovery Key .

Congratulations you have created your first ID. You are now ready to start using DApps.

If you already have a Blockstack ID, launch the browser and try resetting it. Or trying logging on from a device or browser software you haven’t used before.

Seeding DApp market with application mining

Blockchain applications are a new paradigm for both application developers and application users. New paradigms in any market, think solar power or electric vehicles, need public and private coalitions to grow. The centralized hosting and services known as cloud computing were once new paradigms. It was the investment of billions in funds and incentives from governments and private companies that grew the cloud computing market.

In 2017 Blockstack announced the Blockstack Signature Fund. The Signature Fund is aimed at growing an ecosystem of decentralized applications on Blockstack. The fund releases funds through a Signature Bounty program. This is a global bounty program using a contest model. Teams from all over the world submit products and a set of judges determine who wins the prize for the best product.

In addition to the bounty program, Blockstack supports an application mining program. This is an early stage program for developers. In this program, application developers register their application on App.co. Then, each month, application developers get paid depending on their application quality ranking. The ranking is determined by a set of application reviewers.

Application mining differs from the venture model or the app studio model because the rewards are in cryptocurrency. Blockstack PBC administrates both the review and delivery of these monthly payments.

App Mining Eligibility Requirements

DApps that are eligible for application mining must:

  • Implement Blockstack authentication
  • Invite registration and use by the general public

Storing data in a Gaia storage hub is optional. Potentially in the future it may be required.

As you work through this Zero-to-DApp tutorial, you’ll build and deploy a sample application that meets these requirements. While the application you build won't be eligible for application mining, completing the tutorial makes you eligible for a free, limited edition t-shirt:

You'll learn how to get your t-shirt in part 4 of this tutorial.

Overview of the DApp you will build

You are going to build a DApp called AnimalKingdom. Animal Kingdom is a DApp for the web. Users log into it and create an animal persona that rules over a specific territory. The combination of persona and territory is a kingdom. Once you create a kingdom, you can add subjects from other kingdoms.

The Animal Kingdom interacts with two Blockstack services, the Blockstack Browser (https://browser.blockstack.org) and the Gaia data storage hub (https://hub.blockstack.org/). The Blockstack Browser is itself a DApp. The storage hub is purely a service without user-facing functionality.

The following table describes the key interactions and screens in the DApp.

Click to enlarge Description

Users log in (authenticate) with a Blockstack identity. By authenticating, the user gives the application the ability to get and put data in the user's Gaia storage hub.

The Blockstack login dialogs are part of the Blockstack Browser which is itself a DApp. Once a user authenticates, the DApp code automatically returns them to the Kingdom they were attempting to enter.

First-time visitors to a kingdom are prompted to create an animal persona and a territory to rule. Once they make a selection, users click Done to create a kingdom to rule. Behind the scenes, the data about the user's selection is stored in the user's Gaia hub.

Each kingdom has animals and territories. Users can edit their original persona/animal combination. You'll learn how to modify the Animal Kingdom code to add new animals and territories.

Users can add subjects from territories in their own Animal Kingdom. The DApp updates the user's Gaia hub each time the user adds a subject. Users can also visit other Animal Kingdom installations and add subjects from these as well. You'll learn how to modify the Other Kingdoms available in your installation.

You can try a completed version of this application for yourself by using your Blockstack identity to log into the Blockstack Animal Kingdom.

Where to go next

This section introduced you to the benefits of a decentralized application (DApp). You also learned that, similar to other new paradigms, both the public and private companies are committing serious resources to developing blockchain tech. Finally, you learned Blockstack is designed so that you can quickly build a DApp and enter this emerging market.

In the next section, you learn more about developing DApps and how they are different from traditional applications. You’ll also learn about the resources Blockstack provides for DApp developers that help you clarify where to put your efforts and how to fund them.

Continue to 2 of 4, Zero-to-DApp.