Struct Service 

pub struct Service { /* private fields */ }

Central service for Bittensor chain interactions with connection pooling and retry mechanisms

Implementations

impl Service

pub async fn new(config: BittensorConfig) -> Result<Self, BittensorError>

Creates a new Service instance with the provided configuration.

Arguments

• config - The Bittensor configuration containing network and wallet settings

Returns

• Result<Self, BittensorError> - A Result containing either the initialized Service or an error

Errors

• NetworkError - If connection to the client network fails
• WalletError - If wallet key loading or signer creation fails

pub async fn serve_axon( &self, netuid: u16, axon_addr: SocketAddr, ) -> Result<(), BittensorError>

Serves an axon on the Bittensor network with retry logic.

Arguments

• netuid - The subnet UID to serve the axon on
• axon_addr - The socket address where the axon will be served

Returns

• Result<(), BittensorError> - A Result indicating success or failure

Errors

• TxSubmissionError - If the serve_axon transaction fails to submit
• MaxRetriesExceeded - If all retry attempts are exhausted

pub async fn set_weights( &self, netuid: u16, weights: Vec<(u16, u16)>, ) -> Result<(), BittensorError>

Sets weights for neurons in the subnet with retry logic.

Arguments

• netuid - The subnet UID to set weights for
• weights - Vector of (uid, weight) pairs representing neuron weights

Returns

• Result<(), BittensorError> - A Result indicating success or failure

Errors

• TxSubmissionError - If the set_weights transaction fails to submit
• InvalidWeights - If the weight vector is invalid
• MaxRetriesExceeded - If all retry attempts are exhausted

pub async fn get_neuron( &self, netuid: u16, uid: u16, ) -> Result<Option<NeuronInfo>, BittensorError>

Gets neuron information for a specific UID in the subnet.

Arguments

• netuid - The subnet UID
• uid - The neuron UID to get information for

Returns

• Result<Option<NeuronInfo>, BittensorError> - A Result containing either the neuron info or an error

Errors

• RpcError - If the RPC call fails

pub async fn get_metagraph( &self, netuid: u16, ) -> Result<Metagraph, BittensorError>

Gets the complete metagraph for a subnet with circuit breaker protection.

Arguments

• netuid - The subnet UID to get the metagraph for

Returns

• Result<Metagraph, BittensorError> - A Result containing either the metagraph or an error

Errors

• RpcError - If the RPC call fails
• SubnetNotFound - If the subnet doesn’t exist
• ServiceUnavailable - If circuit breaker is open

pub async fn get_selective_metagraph( &self, netuid: u16, fields: Vec<u16>, ) -> Result<SelectiveMetagraph, BittensorError>

Retrieves a selective metagraph for a specific subnet, containing only the requested fields.

Arguments

• netuid - The subnet UID to get the selective metagraph for
• fields - Vector of field indices to include in the selective metagraph

Returns

• Result<SelectiveMetagraph, BittensorError> - A Result containing either the selective metagraph or an error

Errors

• RpcError - If connection to the runtime API fails
• RpcError - If the selective metagraph call fails
• RpcError - If no selective metagraph is found for the subnet

Example

let fields = vec![0, 1, 2]; // Include first three fields
let selective_metagraph = service.get_selective_metagraph(1, fields).await?;

pub async fn get_block_number(&self) -> Result<u64, BittensorError>

Retrieves the current block number from the Bittensor network.

Returns

• Result<u64, BittensorError> - A Result containing either the current block number or an error

Errors

• RpcError - If connection to the latest block fails

Example

let block_number = service.get_block_number().await?;
println!("Current block: {}", block_number);

pub fn get_account_id(&self) -> AccountId

Returns the account ID associated with the service’s signer.

Returns

• &AccountId - Reference to the signer’s account ID

Example

let account_id = service.get_account_id();
println!("Account ID: {}", account_id);

pub async fn get_current_block(&self) -> Result<u64, BittensorError>

Get current block number (alias for get_block_number)

pub async fn submit_extrinsic<T>( &self, payload: T, ) -> Result<(), BittensorError>

where T: Payload,

Submit an extrinsic (transaction) to the chain

pub fn get_network(&self) -> &str

Returns the configured network name for this service instance.

Returns

• &str - Reference to the network name

Example

let network = service.get_network();
println!("Connected to network: {}", network);

pub fn get_netuid(&self) -> u16

Returns the configured subnet UID for this service instance.

Returns

• u16 - The subnet UID

Example

let netuid = service.get_netuid();
println!("Subnet UID: {}", netuid);

pub fn sign_data(&self, data: &[u8]) -> Result<String, BittensorError>

Sign data with the service’s signer (hotkey)

This method signs arbitrary data with the validator/miner’s hotkey. The signature can be verified using verify_bittensor_signature.

Arguments

• data - The data to sign

Returns

• Result<String, BittensorError> - Hex-encoded signature string

Example

let nonce = "test-nonce-123";
let signature = service.sign_data(nonce.as_bytes())?;
println!("Signature: {}", signature);

impl Service

pub async fn get_retry_stats(&self) -> RetryStats

Gets retry statistics for monitoring

pub async fn reset_circuit_breaker(&self)

Resets the circuit breaker state (for recovery operations)

pub async fn connection_metrics(&self) -> ConnectionPoolMetrics

Get connection pool metrics for monitoring

pub async fn force_reconnect(&self) -> Result<(), BittensorError>

Force reconnection of all connections

pub async fn shutdown(self)

Gracefully shutdown the service

Trait Implementations

impl Drop for Service

fn drop(&mut self)

Executes the destructor for this type.