A step-by-step tutorial to help you build your first blockchain on ABT Node

Deploying a new blockchain using ArcBlock's new ABT Node is as simple as a few clicks. Before we get started let's first understand why ABT Node is a game-changer for developers and how it makes creating and deploying blockchains easy.

ABT Node Overview

The new ABT Node is the foundation of the ArcBlock Platform and is the easiest way for developers to create, deploy, and manage blockchains and decentralized applications.

Out of the box, ABT Node includes these core features:

  • Blocklets: Better building blocks for decentralized apps that allow any ABT Node user to extend the functionality of their node. Blocklets can be stand-alone applications, reusable components, or smart-contracts that extend the blockchains capabilities and features that can be installed on demand.
  • Modern Blockchain Framework: ABT Node includes ArcBlock's Blockchain Framework that makes one-click blockchain deployments easy including management and scaling the blockchain. In addition, ArcBlock's Blockchain Framework has a built-in atomic swap protocol to make interchain communications and asset exchanges easy.
  • Integrated Decentralized Identity Support: The industry's first ready-made W3C DID compatible decentralized identity service that gives developers ready-made tools, libraries and reusable components to create and use digital identities rooted on ArcBlock's blockchains.

1. Deploy ABT Node

ABT Node includes several deployment options including deploying your node from the AWS Marketplace or running it locally on your device.

AWS Marketplace

You can deploy ABT Node from the AWS Marketplace following the steps listed here.

Deploy ABT Node on your device

For this exmaple, let's go ahead and setup ABT Node locally on your laptop/desktop.

Once you have completed the steps, you should see your available URL in your terminal window similar to the example below. Enter it into your browser:

ABT Node Daemon started successfully: http://YOUR_URL_YOU_SELECTED_DURING_SETUP:8089

2. Setup ABT Node

At this point, we are ready to do some basic setup in order to secure your ABT Node and login using your own decentralized identity that you control using your ABT Wallet. If you haven't downloaded the wallet do so now, otherwise, let's go ahead and scan the QR Code using your ABT Wallet.

abtnode login

Go ahead and enter the name of your node and finish the steps.

3. ABT Node Dashboard

Upon logging in to your ABT Node you will be taken to the main dashboard view. In this view, you can see basic information about your node including storage, your node and owner DID addresses and an overview of running blocklets, team members and more.

abtnode dashboard

For this example, we want to create and deploy our first blockchain in the ABT Node. As a first step, let's go to the marketplace located on the left-hand action bar.

marketplace

The marketplace is where you can find and install Blocklets. If you remember from our description earlier, Blocklets can be stand-alone apps, reusable components, or smart contracts that allow us to extend the functionality of our ABT Node. For this tutorial, let's find the Blocklet named Blockchain Manager and install it. By default, the latest version of the Blocklet will be installed.

blockchain manager

By installing the Blockchain Manager your ABT Node now supports the ability to one-click create, deploy and manage blockchains inside of the ABT Node. Once it is done installing, select the open button.

open

4. Blockchain Manager Blocklet

After selecting open you will be taken to the Blockchain Manager overview page. In this area, we can see all the details about our blocklet including details such as name, version, DID address, and more. You will also see some other tabs that allows you to view additional details about your blockchain manager blocklet.

manager overview

Disk Info

On this tab, you can see details about data and directories.

disk info

Runtime Info

The Runtime tab will show you details about your blocklet once it has been started including details such as time running, uptime and so on.

Configuration

The configuration tab includes key information about your blocklet including port, directory, based URL and more. Be sure to look over this page to familiarize yourself with it.

blockchain configuration

Start your Blockchain Manager Blocklet

In order to create our first blockchain, we need to first start the blocklet. On the top right corner, press start to enable the blocklet to run.

start

After you press start, you will now see some new information on your overview tab. You can verify that your blocklet is running and a new Admin Inteface link. Let's click on the new link.

admin

Create Your Blockchain

The new Admin Interface takes you to the new Create Chain interface. As a first time visitor, you will see that your blockchain manager currently has No chains. Let's go ahead and select Create Chain.

create chain

Simple or Advanced Blockchain Setup

When you select to create a new blockchain you have the choice of creating a new blockchain using a simple version or more advanced version that increases the available customization options you have when creating your chain. For the purposes of this example, we are going to use the simple view and the included defaults such as total tokens available on the blockchain and number of decimal places. Let's begin.

create simple

  1. Go ahead and enter a new chain name
  2. Add a token name for your blockchain. Note, The chain name should start with a letter, only contain 0-9, a-z, A-Z, and length between 4~24
  3. Create your ticker symbol. Note, The token name should start with a letter, only contain 0-9, a-z, A-Z, and length between 6~36
  4. Add yourself as the moderator for the new blockchain. This is an important step to secure the blockchain and asset you are generating.
  5. Now, select create chain
  6. You will see that your blockchain is being created. It can take up to 45-seconds for your new blockchain to start depending on your machine.

create chain 2

  1. Once your chain is created, you will need to start it. On the right-hand side, select the action menu and click on start.

start chain

  1. If you are running your ABT Node locally on your device you may need to allow the application to accept incoming network connections. Click on allow.

connections

Managing Your New Blockchain

By now, your new blockchain is up and running. On the view and manage blockchain window click on mytestchain on the left-hand side. This will take you to the updated overview area for your blockchain. As you can see now, the blockchain is running and you have new Forge gRRC and Forge GQL Endpoints.

live chain

Processes

If you select the processes tab you can see some details about your chain including the usage of CPU, Memory and Uptime for your different processes.

processes

Configuration

chain configuration

Explorer

No blockchain would be complete without a blockchain explorer for your new chain. If you select Explorer on the navigation you will see that your new chain gives a powerful, but easy to understand dashboard view of your blockchain.

blockchain explorer

In this view, you can see the number of blocks generated on your chain, transactions, validators and more. In addition, you can see top account holders including our previously created moderator address and token balance from when we created the chain. On the action bar located on the left-hand side, you will also see some additional options and views for your blockchain.

explorer action

Blocklets View

Our new blockchain has been created and deployed successfully. Let's go back to the Blocklets section to see the current status. Select Blocklets on the left-hand action bar and now we can see that our Blockchain Manager blocklet is running and there is now an available Admin Interface and Doc Interface available to us.

blocklets overview

What's Next

What's next is up to you. You can go and build another blockchain or try installing another blocklet to add more functionality to your ABT Node. Check out our Managing ArcBlock Blocklets overview to help get started with Blocklets.