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.

Transaction Fees

• Please see the transaction and query fees table for base transaction fee

• Please use the Hedera fee estimator to estimate your transaction fee cost

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 then 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

Account Properties

Field	Description
Key	The new key for the account. The old key and new key must sign the transaction. If the old key or new key is a threshold key then only the threshold of the old key and new key are required to sign the transaction.
Expiration	The new expiration for the account
Receiver Signature Required	If true, all the account keys must sign any transaction depositing into this account (in addition to all withdrawals). default: false
Max Automatic Token Associations	Setting this account property will modify the existing automatic token association value. If you are trying to reduce the number of auto token association slots, please make sure those slots are empty. If those slots are not empty, please dissociate tokens that were auto associated. The max automatic token association is 1,000 token IDs. Update: There is no limit on how many tokens you can associate in the 0.25 mainnet release. Currently, live on previewnet and testnet. Reference HIP-23 and HIP-367.
Staked ID	Update the node or account this account is staked to. See HIP-406. Note: Accounts cannot stake to contract accounts. This will fixed in a future release.
Decline Rewards	Some accounts may stake to a node and decline earning rewards. If set to true, the account will not receive staking rewards. The default value is false. See HIP-406.
Memo	Add or update a short description that should be recorded with the state of the account entity (maximum length of 100 characters). Anyone can view this memo on the network.
Auto Renew Period	The new period of time in which the account will auto-renew in seconds. The account is charged tinybars for every auto-renew period. Duration type is in seconds. For example, one hour would result in an input value of 3,600 seconds. default: 7,890,000 seconds

Constructor	Description
new AccountUpdateTransaction()	Initializes the AccountUpdateTransaction object

new AccountUpdateTransaction()

Methods

V1

Method	Type	Requirement
setAccountId(<accountId>)	AccountId	Required
setKey(<key>)	PublicKey	Optional
setAutoRenewPeriod(<duration>)	Duration	Optional
setExpirationTime(<expirationTime>)	Instant	Optional
setReceiverSignatureRequired(<boolean>)	Boolean	Optional
setProxyAccountId(<accountId>)	AccountId	Optional

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   
TransactionId txId = transaction.build(client).sign(oldKey).sign(newKey).execute(client);

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

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

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

//Version 1.3.2

JavaScript

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

//Sign the transaction with the old key and new key, submit to a Hedera network   
const txId = await transaction.build(client).sign(oldKey).sign(newKey).execute(client);

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

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

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

//v1.4.4