Skip to content

Getting Started on BlockApps STRATO

Introduction

All transactions on the blockchain are tied to a user account, and most transactions require that user to have a balance of credit (or “gas ) in their account. Along these lines, in order to upload and invoke a smart contract, you must first create an account

What is an account?

An account is your address on the blockchain, which is represented by a string.

On the STRATO platform, accounts use a string as the username, along with a user-created password. If OAuth is enabled for the node and used in an application, the username is often an email address, however, the platform supports other custom options (like username, etc.)

Creating an account:

You can create a user on the Accounts tab of the STRATO dashboard UI or done programmatically using the following curl command:

curl -X POST "http://<your_strato_ip_address>/bloc/v2.2/users/<your_new_user_name>" -H "accept: application/json;charset=utf-8" -H "Content-Type: application/json;charset=utf-8" -d "\"<your_new_user_password>\""

Note: If you copy and paste these Bash commands in your terminal, be sure to remove any whitespacing

When creating accounts, you should save a copy of your password in a secure location. Currently, STRATO does not offer a password recovery tool inside the platform, which means that the loss of a password will result in losing access to your blockchain account permanently.

Once the user has been created, the node will respond by providing a blockchain address for your user. If you lose track of this account address, you can copy the link from the account on the Account tab of the STRATO management dashboard (SMD), or you can retrieve it using this curl request:

curl -X GET "http://<your_strato_ip_address>/bloc/v2.2/users/<your_new_user_name>" -H "accept: application/json;charset=utf-8"

Fauceting (adding value) to A User Account (Main Blockchain)

To perform transactions, an account must have a positive Ether balance to pay the gas price, or anti-spam fee, for each transaction. To “run the faucet” or add Ether value to your balance, you can either select the Faucet button on the Account tab of the SMD or you can use the following curl command:

curl -X POST "http://<your_strato_ip_address>/strato-api/eth/v1.2/faucet" -H "accept: application/json;charset=utf-8" -H "Content-Type: application/x-www-form-urlencoded" -d "address=<your_new_user_blockchain_address>"

Creating Users and Fauceting on a Private Chain

Users created on a private chain are either created as part of the initial private chain setup, or they are added to a private chain later. More details on how this is accomplished will be provided in the Private Chain section.

When users are created on a private chain, they must be created with a starting balance. For that reason, in order to create a user on a private chain, the account from which they are created must have sufficient ether to transfer the initial ether balance specified to the new private chain user. We will go into more detail under the Private Chain section, but this generally means that the private chain should be established with a large enough ether balance to sustain the chain's operations over times.

Note: Because the user on a private chain can only receive tokens from an existing address on the private chain that has a balance, the fauceting of a private chain account may require either a contractual provision in the smart contract governing the private chain or the transfer of ether from another private chain participant to the user.