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 |
---|---|
| Initializes the AccountUpdateTransaction object |
Methods
Method | Type | Requirement |
---|---|---|
| AccountId | Required |
| PublicKey | Optional |
| Duration | Optional |
| Instant | Optional |
| Boolean | Optional |
| AccountId | Optional |
Last updated