Skip to content

overview.md

Latest commit

 

History

History
83 lines (44 loc) · 4.11 KB

overview.md

File metadata and controls

83 lines (44 loc) · 4.11 KB
Raw
layout page
title Elements Tutorial
permalink /elements-code-tutorial/overview

A simple guide to setting up an Elements Blockchain or Sidechain solution

This guide will take you step-by-step through the process of installing and using Elements

The code examples will show you how to

  • Configure two nodes that can send transactions between one another.

  • Use some basic wallet functionality to send assets between nodes, query balances, view transactions etc.

  • Understand how Confidential Transactions work and how to view amounts and asset types sent between two participants by unblinding them.

  • Issue your own native blockchain assets.

  • Send the new assets between network participants.

  • Reissue more of the assets.

  • Destroy an amount of the assets.

  • Create blocks using the Strong Federation block signing process.

If you choose to run Elements as a sidechain

  • Send assets from a main chain (Bitcoin) to an Elements blockchain using the Federated 2-Way Peg feature.

  • Send assets from an Elements blockchain back to the Bitcoin main chain.

Note: Once you have followed the code tutorial through, you can run all the code within it again without having to type/copy and paste it in line-by-line by following the instructions in the [An easy way to run the main tutorial code]({{ site.url }}/elements-code-tutorial/easy-run-code) section. That contains the same code as the tutorial, grouped into one code block, that can be executed one line at a time. The [Advanced Examples]({{ site.url }}/elements-code-tutorial/advanced-examples) section shows you how to manually issue an asset using the rawissueasset command, how to prove that you were the one who issued the asset using the contract hash parameter, and how to issue to and spend from a multi-sig address.

The tutorial is divided up into logical parts

[Installing Bitcoin]({{ site.url }}/elements-code-tutorial/installing-bitcoin)

[Installing Elements]({{ site.url }}/elements-code-tutorial/installing-elements)

[Setting up your working environment]({{ site.url }}/elements-code-tutorial/working-environment)

[Using Elements to perform basic operations]({{ site.url }}/elements-code-tutorial/basic-operations)

[Using Confidential Transactions]({{ site.url }}/elements-code-tutorial/confidential-transactions)

[Issuing your own assets]({{ site.url }}/elements-code-tutorial/issuing-assets)

[Reissuing assets]({{ site.url }}/elements-code-tutorial/reissuing-assets)

[Block creation in a Strong Federation]({{ site.url }}/elements-code-tutorial/block-creation)

[Elements as a Sidechain]({{ site.url }}/elements-code-tutorial/sidechain)

[Elements as a standalone Blockchain]({{ site.url }}/elements-code-tutorial/blockchain)

[Developing applications on Elements]({{ site.url }}/elements-code-tutorial/application-development)

[Desktop application example in Python]({{ site.url }}/elements-code-tutorial/desktop-application-python)

[Web application example in Python using Flask]({{ site.url }}/elements-code-tutorial/web-application)

[Desktop application example in C# using .NET Core]({{ site.url }}/elements-code-tutorial/desktop-application-dotnetcore)

[MVC Web application example in C# using .NET Core]({{ site.url }}/elements-code-tutorial/web-application-dotnetcore)

[An easy way to run the main tutorial code]({{ site.url }}/elements-code-tutorial/easy-run-code)

If you want to just run the code and not follow the tutorial you can skip to the [An easy way to run the main tutorial code]({{ site.url }}/elements-code-tutorial/easy-run-code) section, although this code is not annotated and steps are not explained.

The instructions have been tested against newly installed Ubuntu 16.04, 17.10.1 and 18.04.1 machines using the "Minimal Installation" Ubuntu install option.

Please note that the terminal commands used within the tutorial may wrap over more than one line and that each line should be run in its entirety.

By following the guide through to completion you should have enough knowledge to build and deploy your own Elements based blockchain.

[Get started: Installing Bitcoin]({{ site.url }}/elements-code-tutorial/installing-bitcoin)