system_nodeRoles - Bittensor RPC Method

Returns the roles that the Bittensor node is configured with. Common roles include Full (stores and serves all chain data), Authority (participates in block production and consensus), and LightClient (only stores headers). This information helps determine the capabilities and behavior of the node you are connected to.

Parameters

None.

Response

Code Examples

Use Cases

• Node capability detection -- Determine whether the connected node is a full node, an authority (validator), or a light client before making role-specific API calls.
• Health monitoring -- Verify that a validator node is running with the Authority role as expected.
• Client behavior adaptation -- Adjust your application's behavior based on the node type (e.g. skip certain queries on light clients).

Notes

• On Dwellir's shared RPC endpoints, the node role is typically Full.
• Authority nodes participate in block production and may have different performance characteristics.
• This method is safe (read-only) and available on all node configurations.

Related Methods

• system_syncState -- Check the node's sync progress
• system_peers -- List connected peers
• system_localListenAddresses -- Get listen addresses
• system_chain -- Get the chain name
• system_version -- Get the node software version