Class UpdateAccountExtensions
Extension methods for updating cryptocurrency account properties.
Inherited Members
Namespace: Hiero
Assembly: Hiero.dll
Syntax
public static class UpdateAccountExtensions
Methods
| Edit this page View SourceUpdateAccountAsync(ConsensusClient, UpdateAccountParams, Action<IConsensusContext>?)
Updates the changeable properties of a hedera network account.
Declaration
public static Task<TransactionReceipt> UpdateAccountAsync(this ConsensusClient client, UpdateAccountParams updateParameters, Action<IConsensusContext>? configure = null)
Parameters
| Type | Name | Description |
|---|---|---|
| ConsensusClient | client | The Consensus Node Client orchestrating the update. |
| UpdateAccountParams | updateParameters | The account update parameters, includes a required EntityId reference to the account to update plus a number of changeable properties of the account. |
| Action<IConsensusContext> | configure | Optional callback method providing an opportunity to modify the execution configuration for just this method call. It is executed prior to submitting the request to the network. |
Returns
| Type | Description |
|---|---|
| Task<TransactionReceipt> | A transaction receipt indicating success of the operation. |
Examples
// Rotate the signing key on an existing account. The network requires
// both the *current* key and the *new* key to sign — supply the new
// signatory on the params so it is combined with the existing context
// signatory during signing.
var receipt = await client.UpdateAccountAsync(new UpdateAccountParams
{
Account = account,
Endorsement = newEndorsement,
Memo = "Key rotation 2026-Q2",
Signatory = newSignatory
});
Console.WriteLine($"Update status: {receipt.Status}");
Exceptions
| Type | Condition |
|---|---|
| ArgumentException | If required arguments are missing or invalid. |
| InvalidOperationException | If required context configuration is missing. |
| PrecheckException | If the gateway node refused the transaction. Only a code about the transaction itself proves it did not execute; any other code leaves the outcome unknown, so settle it by its transaction id on a mirror node rather than resubmitting it (see PrecheckException). |
| ConsensusException | If the outcome could not be confirmed: the transaction may have executed, so settle it by its transaction id on a mirror node rather than resubmitting it. |
| TransactionException | If the network rejected the update request as invalid or had missing data. |