Class CreateRegisteredNodeExtensions

Extension methods for registering nodes in the HIP-1137 registry.

Inheritance

object

CreateRegisteredNodeExtensions

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Namespace: Hiero

Assembly: Hiero.dll

Syntax

[Experimental("HIERO001", UrlFormat = "https://github.com/bugbytesinc/Hiero/blob/main/docs/blocknode-client-plan.md")]
public static class CreateRegisteredNodeExtensions

Methods

CreateRegisteredNodeAsync(ConsensusClient, CreateRegisteredNodeParams, Action<IConsensusContext>?)

Registers a new node in the HIP-1137 on-chain registered-node registry.

Declaration

public static Task<RegisteredNodeReceipt> CreateRegisteredNodeAsync(this ConsensusClient client, CreateRegisteredNodeParams createParams, Action<IConsensusContext>? configure = null)

Parameters

Type	Name	Description
ConsensusClient	client	The Consensus Node Client orchestrating the request.
CreateRegisteredNodeParams	createParams	The registration parameters: admin key, optional description, and service endpoints.
Action<IConsensusContext>	configure	Optional callback method providing an opportunity to modify the execution configuration for just this method call.

Returns

Type	Description
Task<RegisteredNodeReceipt>	A receipt carrying the network-assigned registered-node id.

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 request as invalid or had missing data.