Class UpdateTopicExtensions
Extension methods for updating consensus topics.
Inherited Members
Namespace: Hiero
Assembly: Hiero.dll
Syntax
public static class UpdateTopicExtensions
Methods
| Edit this page View SourceUpdateTopicAsync(ConsensusClient, UpdateTopicParams, Action<IConsensusContext>?)
Updates the changeable properties of a Hedera Network Topic.
Declaration
public static Task<TransactionReceipt> UpdateTopicAsync(this ConsensusClient client, UpdateTopicParams updateParameters, Action<IConsensusContext>? configure = null)
Parameters
| Type | Name | Description |
|---|---|---|
| ConsensusClient | client | The Consensus Node Client receiving the update transaction. |
| UpdateTopicParams | updateParameters | The Topic update parameters, includes a required EntityId reference to the Topic to update plus a number of changeable properties of the Topic. |
| 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
// Update mutable topic properties. Null fields are left unchanged.
// Requires the topic's Administrator key to sign; topics created
// without one are immutable.
var receipt = await client.UpdateTopicAsync(new UpdateTopicParams
{
Topic = topic,
Memo = newMemo
});
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. |