Update an account

A transaction that updates the properties of an existing account. The network will store the latest updates on the account. If you would like to retrieve the state of an account in the past, you can query a mirror node.

Account Properties

Account Properties

Transaction Fees

• The sender pays for the token association fee and the rent for the first auto-renewal period.
• Please see the transaction and query fees table for the base transaction fee.
• Please use the Hedera fee estimator to estimate the cost of your transaction fee.

Transaction Signing Requirements

• The account key(s) are required to sign the transaction.
• If you are updating the keys on the account, the OLD KEY and NEW KEY must sign.
  • If either is a key list, the key list keys are all required to sign.
  • If either is a threshold key, the threshold value is required to sign.
• If you do not have the required signatures, the network will throw an INVALID_SIGNATURE error.

Maximum Auto-Associations and Fees

Accounts have a property, maxAutoAssociations, and the property’s value determines the maximum number of automatic token associations allowed.

Property Value	Description
0	Automatic token associations or token airdrops are not allowed, and the account must be manually associated with a token. This also applies if the value is less than or equal to usedAutoAssociations.
-1	Unlimited automatic token associations are allowed, and this is the default for accounts created via auto account creation and for accounts that began as hollow accounts and are now complete. Accounts with -1 can receive new tokens without manually associating them. The sender still pays the maxAutoAssociations fee and initial rent for each association.
> 0	If the value is a positive number (number greater than 0), the number of automatic token associations an account can have is limited to that number.

The sender pays the maxAutoAssociations fee and the rent for the first auto-renewal period for the association. This is in addition to the typical transfer fees. This ensures the receiver can receive tokens without association and makes it a smoother transfer process.

Reference: HIP-904

Methods

Method	Type	Requirement
setAccountId(<accountId>)	AccountId	Required
setKey(<key>)	Key	Optional
setReceiverSignatureRequired(<boolean>)	Boolean	Optional
setMaxAutomaticTokenAssociations(<amount>)	int	Optional
setAccountMemo(<memo>)	String	Optional
setAutoRenewPeriod(<duration>)	Duration	Optional
setStakedAccountId(<stakedAccountId>)	AccountId	Optional
setStakedNodeId(<stakedNodeId>)	long	Optional
setDeclineStakingReward(<declineStakingReward>)	boolean	Optional
setDelegationAddress(<delegationAddress>)	EvmAddress	Optional
setExpirationTime(<expirationTime>)	Instant	Disabled

setDelegationAddress (HIP-1340)

Sets, changes, or clears the account’s EOA Code Delegation. The address must be exactly 20 bytes and can be provided as raw bytes, a hex string (with or without the 0x prefix), or an EvmAddress. Pass 0x0000000000000000000000000000000000000000 or null to clear an existing delegation. After update, any EVM call to the account’s address executes the delegate’s code in the account’s storage context.

For ECDSA accounts with a public-key-derived alias, you can alternatively configure delegation via an EIP-7702 Type 4 Ethereum transaction. ED25519 accounts and ECDSA accounts with a long-zero alias must use this HAPI path. See EOA Code Delegation.

Example: set a delegation target

JavaScript

import { AccountUpdateTransaction, AccountId } from "@hashgraph/sdk";

const tx = await new AccountUpdateTransaction()
  .setAccountId(AccountId.fromString("0.0.4567"))
  .setDelegationAddress("0x019b8ee526333d9cbbbc35fff0309794dfa73451")
  .freezeWith(client)
  .sign(accountKey);

await (await tx.execute(client)).getReceipt(client);

// Read it back via property access
console.log(`Delegation address: ${tx.delegationAddress?.toString()}`);

Example: clear an existing delegation

JavaScript

import { AccountUpdateTransaction, AccountId } from "@hashgraph/sdk";

// Pass the zero address (or null) to clear
const tx = await new AccountUpdateTransaction()
  .setAccountId(AccountId.fromString("0.0.4567"))
  .setDelegationAddress("0x0000000000000000000000000000000000000000")
  .freezeWith(client)
  .sign(accountKey);

await (await tx.execute(client)).getReceipt(client);

Java

//Create the transaction to update the key on the account
AccountUpdateTransaction transaction = new AccountUpdateTransaction()
    .setAccountId(accountId)
    .setKey(updateKey);

//Sign the transaction with the old key and new key, submit to a Hedera network
TransactionResponse txResponse = transaction.freezeWith(client).sign(oldKey).sign(newKey).execute(client);

//Request the receipt of the transaction
TransactionReceipt receipt = txResponse.getReceipt(client);

//Get the transaction consensus status
Status transactionStatus = receipt.status;

System.out.println("The transaction consensus status is " +transactionStatus);

//Version 2.0.0

//Create the transaction to update the key on the account
const transaction = await new AccountUpdateTransaction()
    .setAccountId(accountId)
    .setKey(updateKey)
    .freezeWith(client);

//Sign the transaction with the old key and new key
const signTx = await (await transaction.sign(oldKey)).sign(newKey);

//SIgn the transaction with the client operator private key and submit to a Hedera network
const txResponse = await signTx.execute(client);

//Request the receipt of the transaction
const receipt = await txResponse.getReceipt(client);

//Get the transaction consensus status
const transactionStatus = receipt.status;

console.log("The transaction consensus status is " +transactionStatus.toString());

//v2.0.5

//Create the transaction to update the key on the account
transaction, err := hedera.NewAccountUpdateTransaction().
        SetAccountID(newAccountId).
        SetKey(updateKey.PublicKey()).
        FreezeWith(client)

if err != nil {
    panic(err)
}

//Sign the transaction with the old key and new key, submit to a Hedera network
txResponse, err := transaction.Sign(newKey).Sign(updateKey).Execute(client)

//Request the receipt of the transaction
receipt, err := txResponse.GetReceipt(client)
if err != nil {
    panic(err)
}

//Get the transaction consensus status
transactionStatus := receipt.Status

println("The transaction consensus status is ", transactionStatus)

//Version 2.0.0

// Create the transaction to update the key on the account
let transaction = AccountUpdateTransaction::new()
    .account_id(account_id)
    .key(update_key);

// Sign the transaction with the old key and new key
let tx_response = transaction
    .freeze_with(&client)?
    .sign(old_key)
    .sign(new_key)
    .execute(&client).await?;

// Request the receipt of the transaction
let receipt = tx_response.get_receipt(&client).await?;

// Get the transaction consensus status
let status = receipt.status;

println!("The transaction consensus status is {:?}", status);

// v0.34.0

Get transaction values

Return the properties of an account create transaction.

Method	Type	Description
getKey()	Key	Returns the public key on the account
getInitialBalance()	Hbar	Returns the initial balance of the account
getReceiverSignatureRequired()	boolean	Returns whether the receiver signature is required or not
getExpirationTime()	Instant	Returns the expiration time
getAccountMemo()	String	Returns the account memo
getDeclineStakingReward()	boolean	Returns whether or not the account is declining rewards
getStakedNodeId()	long	Returns the node ID the account is staked to
getStakedAccountId()	AccountId	Returns the account ID the node is staked to
getAutoRenewPeriod()	Duration	Returns the auto renew period on the account

Java

//Create a transaction
AccountUpdateTransaction transaction = new AccountUpdateTransaction()
    .setAccountId(accountId)
    .setKey(newKeyUpdate);

//Get the key on the account
Key accountKey = transaction.getKey();

//v2.0.0

//Create a transaction
const transaction = new AccountUpdateTransaction()
    .setAccountId(accountId)
    .setKey(newKeyUpdate);

//Get the key of an account
const accountKey = transaction.getKey();

//v2.0.0

//Create the transaction 
transaction, err := hedera.NewAccountUpdateTransaction().
        SetAccountID(newAccountId).
        SetKey(updateKey.PublicKey())

//Get the key of an account
accountKey := transaction.GetKey()

//v2.0.0