Java Quickstart

Connect to Hedera testnet from Java, query your balance, and transfer HBAR.

This page gets a Java application talking to Hedera testnet: SDK install, operator credentials, balance query, and an HBAR transfer.

Prerequisites

• JDK 11 or later
• Maven 3.8+ or Gradle 8+
• A Hedera testnet account with ECDSA keys from the developer portal

Step 1: Add the SDK dependency

For Maven, add to pom.xml:

<dependencies>
    <dependency>
        <groupId>com.hedera.hashgraph</groupId>
        <artifactId>sdk</artifactId>
        <version>2.77.0</version>
    </dependency>
    <dependency>
        <groupId>io.grpc</groupId>
        <artifactId>grpc-netty-shaded</artifactId>
        <version>1.83.1</version>
    </dependency>
    <dependency>
        <groupId>io.github.cdimascio</groupId>
        <artifactId>dotenv-java</artifactId>
        <version>3.0.0</version>
    </dependency>
</dependencies>

For Gradle, add to build.gradle:

dependencies {
    implementation 'com.hedera.hashgraph:sdk:2.77.0'
    implementation 'io.grpc:grpc-netty-shaded:1.83.1'
    implementation 'io.github.cdimascio:dotenv-java:3.0.0'
}

grpc-netty-shaded is the network transport. Without it the SDK compiles, then throws at runtime when you actually try to talk to the network.

Step 2: Credentials

Create a .env file in your project root (and add it to .gitignore):

OPERATOR_ID=0.0.1234
OPERATOR_KEY=3030020100300706052b8104000a04220420a1b2c...

OPERATOR_ID is your Hedera account ID (for example, 0.0.1234). OPERATOR_KEY is your account’s ECDSA private key: copy the DER Encoded Private Key (starts with 303...) from the developer portal.

Step 3: Connect, query, transfer

Create src/main/java/HederaQuickstart.java:

import com.hedera.hashgraph.sdk.*;
import io.github.cdimascio.dotenv.Dotenv;

public class HederaQuickstart {

    public static void main(String[] args) throws Exception {
        Dotenv env = Dotenv.load();
        AccountId operatorId = AccountId.fromString(env.get("OPERATOR_ID"));
        PrivateKey operatorKey = PrivateKey.fromStringECDSA(env.get("OPERATOR_KEY"));

        // Connect to testnet using the operator account as the default payer.
        Client client = Client.forTestnet();
        client.setOperator(operatorId, operatorKey);

        // 1. Query the operator's balance (free mirror node read).
        // MirrorNodeAccountBalanceQuery replaces the deprecated AccountBalanceQuery.
        Hbar balance = new MirrorNodeAccountBalanceQuery()
            .setAccountId(operatorId)
            .execute(client)
            .hbars;
        System.out.println("Operator balance: " + balance);

        // 2. Transfer 1 HBAR to account 0.0.3 (a test recipient).
        AccountId recipient = AccountId.fromString("0.0.3");
        TransactionResponse response = new TransferTransaction()
            .addHbarTransfer(operatorId, Hbar.from(-1))
            .addHbarTransfer(recipient, Hbar.from(1))
            .execute(client);

        TransactionReceipt receipt = response.getReceipt(client);
        System.out.println("Transfer status: " + receipt.status);
        System.out.println("Transaction ID: " + response.transactionId);

        client.close();
    }
}

Step 4: Run it

# Maven (package as a JAR with dependencies, then run it)
mvn package
java -cp target/your-artifact-with-dependencies.jar HederaQuickstart

# Gradle
./gradlew run

Expected output:

Operator balance: 10000 ℏ
Transfer status: SUCCESS
Transaction ID: 0.0.1234@1700000000.123456789

Look up the transaction on HashScan:

https://hashscan.io/testnet/transaction/<transactionId>

Prefer a local network? Solo runs a full Hedera stack on your machine, no testnet rate limits, no faucet, no resets. See Using Solo with Hiero SDKs to point the SDK at a local Solo network instead of testnet.

What’s next

Create an Account

Generate a new account programmatically and fund it from your operator.

Create a Token

Mint a native HTS token with custom supply and decimals.

Submit to a Topic

Publish a message to HCS for verifiable, ordered audit logs.

SDK Reference

Full API reference on GitHub.

The four Hiero SDKs (JavaScript, Java, Go, Python) share the same API surface, so code translates almost line-for-line between them. Differences are mostly language-idiomatic.