Account Client¶

AccountClient provides APIs for managing Hiero accounts, including account creation, deletion, updates, and balance queries.

Note

Account operations that submit transactions to the Hiero network require HBAR to pay transaction fees. The configured operator account is used as the transaction payer and must have sufficient HBAR balance.

Methods¶

Method	Description
`createAccount()`	Creates a new account with a default balance of 0 HBAR.
`createAccount(Hbar initialBalance)`	Creates a new account with the specified initial HBAR balance.
`createAccount(long initialBalanceInHbar)`	Creates a new account with the specified initial balance in HBAR.
`deleteAccount(Account account)`	Deletes an account and transfers the remaining balance to the operator account.
`deleteAccount(Account account, Account toAccount)`	Deletes an account and transfers the remaining balance to the specified account.
`updateAccountKey(Account account, PrivateKey updatedPrivateKey)`	Updates the account private key.
`updateAccountMemo(Account account, String memo)`	Updates the account memo.
`updateAccount(Account account, PrivateKey updatedPrivateKey, String memo)`	Updates both account key and memo.
`getAccountBalance(AccountId accountId)`	Retrieves the HBAR balance of the specified account.
`getAccountBalance(String accountId)`	Retrieves account balance using an account ID string.
`getOperatorAccountBalance()`	Retrieves the balance of the configured operator account.
`transferHbar(AccountId toAccountId, Hbar amount)`	Transfers HBAR from the operator account to another account.
`transferHbar(String toAccountId, Hbar amount)`	Transfers HBAR from the operator account using an account ID string.
`transferHbar(AccountId toAccountId, long amountInHbar)`	Transfers HBAR from the operator account using an amount specified in HBAR.
`transferHbar(AccountId fromAccountId, PrivateKey fromAccountKey, AccountId toAccountId, Hbar amount)`	Transfers HBAR between accounts using the sender account ID and private key.
`transferHbar(Account fromAccount, AccountId toAccountId, Hbar amount)`	Transfers HBAR between accounts using an existing account object as the sender.
`transferHbar(String fromAccountId, String fromAccountKey, String toAccountId, long amountInHbar)`	Transfers HBAR between accounts using string-based account credentials.

Create Account¶

Creates a new Hiero account.

createAccount()

Account account = accountClient.createAccount();

AccountId accountId = account.accountId();

createAccount(Hbar initialBalance)

Account account = accountClient.createAccount(
    Hbar.from(10)
);

AccountId accountId = account.accountId();

Delete Account¶

Deletes an account and transfers the remaining balance.

deleteAccount(Account account)

Account account = accountClient.createAccount();

accountClient.deleteAccount(account);

Info

If toAccount is not provided, the remaining account balance is transferred to the configured operator account.

deleteAccount(Account account, Account toAccount)

Account account = accountClient.createAccount();
Account receiver = accountClient.createAccount();

accountClient.deleteAccount(account, receiver);

Update Account¶

Updates account configuration such as keys and memo.

updateAccountKey(Account account, PrivateKey updatedPrivateKey)

Account account = accountClient.createAccount();
PrivateKey newKey = PrivateKey.generateED25519();

Account updatedAccount =
    accountClient.updateAccountKey(
        account, 
        newKey
    );

updateAccountMemo(Account account, String memo)

Account account = accountClient.createAccount();

Account updatedAccount = accountClient.updateAccountMemo(
    account,
    "Updated account memo"
);

updateAccount(Account account, PrivateKey updatedPrivateKey, String memo)

Account account = accountClient.createAccount();
PrivateKey newKey = PrivateKey.generateED25519();

Account updatedAccount = accountClient.updateAccount(
    account,
    newKey,
    "Updated account"
);

Get Account Balance¶

Retrieves account balances from the Hiero network.

getAccountBalance(AccountId accountId)

AccountId accountId = AccountId.fromString("0.0.1234");

Hbar balance =
    accountClient.getAccountBalance(accountId);

getOperatorAccountBalance()

Hbar balance =
    accountClient.getOperatorAccountBalance();

Transfer Hbar¶

Transfer Hbar between account.

transferHbar(AccountId toAccountId, Hbar amount)

AccountId receiverAccountId =
    AccountId.fromString("0.0.4321");

accountClient.transferHbar(
    receiverAccountId,
    Hbar.from(10)
);

transferHbar(AccountId fromAccountId, PrivateKey fromAccountKey, AccountId toAccountId, Hbar amount)

AccountId senderAccountId =
    AccountId.fromString("0.0.1234");

PrivateKey senderPrivateKey =
    PrivateKey.generateED25519();

AccountId receiverAccountId =
    AccountId.fromString("0.0.4321");

accountClient.transferHbar(
    senderAccountId,
    senderPrivateKey,
    receiverAccountId,
    Hbar.from(25)
);

transferHbar(Account fromAccount, AccountId toAccountId, Hbar amount)

Account senderAccount =
    accountClient.createAccount();

AccountId receiverAccountId =
    AccountId.fromString("0.0.4321");

accountClient.transferHbar(
    senderAccount,
    receiverAccountId,
    Hbar.from(25)
);

Info

Transfers initiated from the operator account are signed by the configured operator account. Transfers between arbitrary accounts require the sender account's private key to authorize the transaction.