Environment Set-up

Search…
Environment Set-up
In this section you will complete the following:
Create your project directory
Create a .env file and store your Hedera testnet account ID and private key
Set-up your Hedera testnet client
Note: The Hedera JavaScript SDK supports React Native with Expo on Android devices and Android emulators. It does not currently support React Native Bare.
Pre-requisites:
Introduction
Step 1: Set up your node.js environment
1.1 Create a new directory for our sample & move into it
Open your terminal and create a directory called hello-hedera-js-sdk. After you create the project directory navigate into the directory.
1
mkdir hello-hedera-js-sdk && cd hello-hedera-js-sdk
Copied!
1.2. Initialize a node.js project in this new directory
1
npm init
Copied!
Note: you can just say “yes” to all of the defaults and/or plugin what makes sense. It’s an example!
1
{
2
  "name": "hello-hedera-js-sdk",
3
  "version": "",
4
  "description": "",
5
  "main": "index.js",
6
  "scripts": {
7
    "test": "echo \"Error: no test specified\" && exit 1"
8
  },
9
  "author": "",
10
  "license": "ISC"
11
}
Copied!
Step 2: Install the Hedera JavaScript SDK
Note: Please follow the example in the version of the SDK you are using. Code specific to v2.0 of the SDK will be marked in the code block tab title, otherwise, it works for both v2.0 and v1.0. The examples may not be compatible if you are using a different version than what is listed.
Now that you have your node environment setup, we can get started with Hedera’s JS SDK! You can open this project in your favorite text editor like Visual Studio Code.
Install it with your favorite package manager.
v2.0
v1.0
1
// install Hedera's JS SDK with NPM
2
// This example uses Hedera JavaScript SDK v2.0.13
3
npm install --save @hashgraph/[email protected]
4
​
5
// Install with Yarn
6
yarn add @hashgraph/[email protected]
Copied!
1
// install Hedera's JS SDK with NPM
2
// This example uses Hedera JavaScript SDK v1.4.4
3
npm install --save @hashgraph/[email protected]
4
​
5
// Install with Yarn
6
yarn add @hashgraph/[email protected]
Copied!
Install dotenv with your favorite package manager. This will allow our node environment to use your testnet account ID and the private key that we will store in a .env file next.
1
// install with NPM
2
npm install dotenv
3
​
4
// Install with Yarn
5
yarn add dotenv
Copied!
Step 3: Create a .env file in your project
The .env file will store your Hedera testnet account ID and private key. Create this file in the root directory of your project and save it as .env file.
Now you can add your testnet account ID and private key provided from your Hedera Portal Account.
.env
1
MY_ACCOUNT_ID= TESTNET ACCOUNT ID (0.0.x)
2
MY_PRIVATE_KEY= TESTNET PRIVATE KEY (302e...)
Copied!
Step 4: Create an index.js file in the 'root' directory
This file will contain the code we will write in the following samples. Your project structure should look something like this after:
Grab your Hedera testnet account ID and private key from the .env file.
1
const { Client } = require("@hashgraph/sdk");
2
require("dotenv").config();
3
​
4
async function main() {
5
​
6
    //Grab your Hedera testnet account ID and private key from your .env file
7
    const myAccountId = process.env.MY_ACCOUNT_ID;
8
    const myPrivateKey = process.env.MY_PRIVATE_KEY;
9
​
10
    // If we weren't able to grab it, we should throw a new error
11
    if (myAccountId == null ||
12
        myPrivateKey == null ) {
13
        throw new Error("Environment variables myAccountId and myPrivateKey must be present");
14
    }
15
}
16
main();
Copied!
Step 5: Create your Hedera testnet client
You have the option to create a client for the Hedera mainnet or testnet. Since we are using a Hedera testnet account ID and private key, we will create a client for the Hedera testnet.
After you create your Hedera testnet client, you will need to set the operator information. The operator is the account that will pay for the transaction and query fees. You will need to sign the transaction or query with the private key of the account to authorize the payment.
index.js
1
// Create our connection to the Hedera network
2
// The Hedera JS SDK makes this really easy!
3
const client = Client.forTestnet();
4
​
5
client.setOperator(myAccountId, myPrivateKey);
Copied!
The client has a default max transaction fee of 100,000,000 tinybars (1 hbar) and default max query payment of 100,000,000 tinybars (1 hbar). If you need to change these values, you can use.setMaxTransactionFee() for a transaction and .setMaxQueryPayment() for queries.
Your project environment is now set up to successfully submit transactions/queries to the Hedera test network!
Next, you will learn how to create a Hedera testnet account.
Code Check ✅
What your index.js file should look like at this point:
index.js
1
const { Client } = require("@hashgraph/sdk");
2
require("dotenv").config();
3
​
4
async function main() {
5
​
6
    //Grab your Hedera testnet account ID and private key from your .env file
7
    const myAccountId = process.env.MY_ACCOUNT_ID;
8
    const myPrivateKey = process.env.MY_PRIVATE_KEY;
9
​
10
    // If we weren't able to grab it, we should throw a new error
11
    if (myAccountId == null ||
12
        myPrivateKey == null ) {
13
        throw new Error("Environment variables myAccountId and myPrivateKey must be present");
14
    }
15
​
16
    // Create our connection to the Hedera network
17
    // The Hedera JS SDK makes this really easy!
18
    const client = Client.forTestnet();
19
​
20
    client.setOperator(myAccountId, myPrivateKey);
21
}
22
main();
Copied!
Getting Started - Previous
JavaScript
Create an account
Last modified 24d ago
Copy link
Contents
Pre-requisites:
Step 1: Set up your node.js environment
1.1 Create a new directory for our sample & move into it
1.2. Initialize a node.js project in this new directory
Step 2: Install the Hedera JavaScript SDK
Step 3: Create a .env file in your project
Step 4: Create an index.js file in the 'root' directory
Step 5: Create your Hedera testnet client
Code Check ✅