Installation and usage of the platform
Deploying the platform in the trial mode (Sandbox)¶
To familiarize yourself with the Waves Enterprise blockchain platform, a free trial version running in a Docker container is available to you. No license is required to install and use it, and the blockchain height is limited to 30,000 blocks. With a block round time of 30 seconds, the full operation time of the platform in trial mode is 10 days.
When you deploy the platform in the trial mode, you get a local version of the blockchain where you can test the basic features:
signing and sending transactions;
obtaining data from the blockchain;
installation and call of smart contracts;
transfer of confidential data between nodes.
You can interact with the platform through gRPC API and REST API interfaces.
Platform installation¶
Before you start the installation, make sure you have Docker Engine and Docker Compose installed on your machine. Also, familiarize yourself with the blockchain platform system requirements.
Note that you may need administrator rights to run commands on Linux (the sudo
prefix followed by the administrator password).
Create a working directory and place the docker-compose.yml file into it. You can download this file from the official Waves Enterprise repository on GitHub with the latest platform release or use the wget utility in the terminal:
wget https://raw.githubusercontent.com/waves-enterprise/we-node/release-1.16/node/src/docker/docker-compose.yml
Open the terminal and navigate to the directory containing the downloaded docker-compose.yml file. Start the Docker container to deploy the platform:
docker run --rm -ti -v $(pwd):/config-manager/output wavesenterprise/config-manager:latest
Wait for the message informing about the end of the deployment:
INFO [launcher] WE network environment is ready!
This will create 3 nodes with automatically generated credentials. Information about the nodes is available in the ./credentials.txt file:
node-0
blockchain address: 3Nzi7jJYn1ek6mMvtKbPhehxMQarAz9YQvF
public key: 7cLSA5AnvZgiL8CnoffwxXPkpQhvviJC9eywBKSUsi58
keystore password: OEtrVSL9gzjO87jYx-gIoQ
keypair password: JInWk1kauuZDHGXFJ-rNXQ
API key: we
node-1
blockchain address: 3Nxz6BYyk6CYrqH4Zudu5UYoHU6w7NXbZMs
public key: VBkFFQmaHzv3YMiWLhh4qsCn4prUvteWsjgiiHEpWEp
keystore password: FsUp3xiX_NF-bQ9gw6t0sA
keypair password: Qf2rBgBT9pnozLPOkO1yYw
API key: we
node-2
blockchain address: 3NtT9onn8VH1DsbioPVBuhU4pnuCtBtbsTr
public key: 8YkDPLsek5VF5bNY9g2dxAthd9AMmmRyvMPTv1H9iEpZ
keystore password: T77fAroHavbWCS6Uir2oFg
keypair password: bELB4EU1GDd5rS-RId_6pA
API key: we
Run the finished configuration:
docker-compose up -d
If the nodes run successfully, the following message will be displayed:
Creating network "platf_we-network" with driver "bridge"
Creating node-2 ... done
Creating node-0 ... done
Creating node-1 ... done
The REST API and gRPC API node interfaces are available at the following addresses:
Node |
REST API |
gRPC API |
---|---|---|
node-0 |
localhost:6862 |
localhost:6865 |
node-1 |
localhost:6872 |
localhost:6875 |
node-2 |
localhost:6882 |
localhost:6885 |
To stop the running nodes, run the following command:
docker-compose down