Installation
This section explains how to install the required tools to build a decentralized javascript application (dApp). Usually you start building your dApp on the Alphanet network with claimed CAPS tokens from the faucet. Extend it to the Mainnet network will be as simple as changing the websocket endpoint.
1. Create a Ternoa Account​
Before starting building your dApp on top of the Ternoa chain you will need a Ternoa account.
Download Ternoa Wallet App​
The easiest way to create an account is to use the Ternoa Wallet 📱
or Create an account on Polkadot Portal​
You can also create a Ternoa account from the Polkadot Portal:
First click on the + Account button.
A modal will pop displaying your account address starting with the number 5 and a secret mnemonic sequence of words: this is your secret seed phrase.
You should back up these words. Please, store the seed somewhere safe, secret, and secure. If you cannot access your account, you will be able to restore it using those words.
Click on the checkbox and moved to step 2.
Fullfil inputs with a descriptive name for your account and a strong password. Finally on step 3 click on the + Save button.
Congratulations your account is created 🎉
Extensions​
Use an extension browser to simplify tansactions signing:
Official:
Alternatives:
2. Get some free test CAPS​
The Alphanet faucet provides you with some free test CAPS tokens to start building on Ternoa on the Alphanet network.
It is accessible via the Ternoa website.
Paste your fresh Ternoa account address created previously (it starts with the number 5 e.g. 5DFAg6g9n3fNT2qRUjP5sJ7R2pXKZ99PLVDSt5a1psr7BFJ1), verify the captcha and click on the Claim button.
You will receive alpha CAPS tokens in few minutes.
If the daily 100 CAPS are not enough, feel free to reach us on Discord for more.
3. Install ternoa-JS Library​
Pre-requisites: Node.js
On your existing JavaScript project, install the ternoa-js lib.
Install the latest stable version of the ternoa-js library by running this command:
npm install ternoa-js
This package provides TypeScript types, but you will need TypeScript version 4.2 or higher to use them properly.
You can test out our upcoming features in our Alpha @alpha or Release candidate @rc versions. These versions aren't stable and might contain some technical errors. @alpha versions are for internal and public testing only whereas @rc releases tend to be the closest to its production version.
You can check out our version list over @ npm. Installing a specific version is as easy as replacing the 1.2.0-rc0 with your desired version:
# for version 1.2.0-rc0
npm i ternoa-js@1.2.0-rc0
That's all! You're ready to build your dApp on Ternoa!