Testnet Access

Join a Hedera testnet

Hedera testnets provides developers with access to a free testing environment for Hedera network services. Testnets are likely to change and data may be deleted.

1. Create Hedera Portal Profile

Until Open Access of the Hedera network, all users must register through the Hedera Portal in order to create an account on the network. To create your Hedera Portal profile register here and complete the required steps, including email and identity verification (KYC).

Request a testnet

Once you've completed setting up your profile, scroll down and click Join Testnet. This configures a testnet for you to access.

After you click Join testnet scroll back up and, in the network selector, you should see your new testnet. Below that you should see a field to enter a public key, which we will walk through how to generate in the next step.

2. Generate Key Pair

To use your testnet you must tell the Portal the public key you would like to use. To generate a key pair we suggest using either:

Hedera SDK

In this tutorial we'll use the Hedera Java SDK so you can easily start building on the testnet.


Configure Hedera Java SDK

We'll import the Hedera Java SDK in IntelliJ IDEA IDE with Gradle, other guides can be found here.

  1. Open IntelliJ IDEA and create a new Gradle project by navigating to File > New Project
  2. Select Gradle on the left navigation bar and click Next
  3. Enter groupId and artifactId
    • groupId: Example
    • artifactId: Keys
  4. Select the following options on the next screen:
    • Create a separate module for source set
    • Use default Gradle wrapper (recommended)
  5. Open the build.gradle file from the project panel
  6. Update the dependencies sections with the following:
dependencies {
     implementation 'com.hedera.hashgraph:sdk:0.8.1'
  • Note: sourceCompatibility should be set to 11
  • Import Gradle project changes

Create a Key Pair

  1. Navigate to src > main > java
  2. Right click on java folder and select New > Java Class
  3. Enter generateKeys as the class name in the Name field
  4. Edit the generateKeys class to include the following:
import com.hedera.hashgraph.sdk.HederaException;
import com.hedera.hashgraph.sdk.crypto.ed25519.*;

public class generateKeys {

    public static void main(String[] args) throws HederaException {
        var newKey = Ed25519PrivateKey.generate();
        var newPublicKey = newKey.getPublicKey();

        System.out.println("private key = " + newKey);
        System.out.println("public key = " + newPublicKey);

  1. Run generateKeys.main()
  2. Example output:

private key = 302e020100300506032b65700422042002220f3c79628e03a9312789c54406bb94944de7d62506ff5e36db4afd7f223f
public key = 302a300506032b6570032100c1e5b49ffa53f39a47e8fda46354e63618ad05c2465a1277a52cf8bb43e3d90c

Be sure to save your keys in a safe place.

3. Enter Public Key in Hedera Portal

With your public key in hand, return to the Hedera Portal.

Paste your public key into the box similar to below.

Upon submitting your public key your Hedera account will be created on your testnet and you will receive your account ID and network information including network address and node (account ID of the node processing transactions on the network). This information is required to build your client when using the Java SDK to submit transactions and queries. Please reference image below.

You're now ready to build your application using any of the Hedera network services.

Updated a day ago

What's Next

Set up the Hedera Java SDK or find your favorite community supported language

Getting started

Testnet Access

Join a Hedera testnet

Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.