Struct NodeInterface

pub struct NodeInterface { /* private fields */ }

Available on non-WebAssembly only.

A struct representing the interface to the node.

This struct will be used by consumers to interact with the node. You may have as many of it as you need, and you can use it to send requests to the node and get responses back.

Implementations

impl NodeInterface

pub fn new(node_sender: UnboundedSender<NodeNotification>) -> Self

pub async fn add_peer( &self, addr: IpAddr, port: u16, v2transport: bool, ) -> Result<bool, RecvError>

Connects to a specified address and port. This function will return a boolean indicating whether the connection was successful. It may be called multiple times, and may use hostnames or IP addresses.

pub async fn remove_peer( &self, addr: IpAddr, port: u16, ) -> Result<bool, RecvError>

Removes a peer from the node’s peer list. This function will return a boolean indicating whether the peer was successfully removed. It may be called multiple times, and may use hostnames or IP addresses.

pub async fn onetry_peer( &self, addr: IpAddr, port: u16, v2transport: bool, ) -> Result<bool, RecvError>

Attempts to connect to a peer once.

This function will try to connect to the peer once, but will not add it to the node’s peer list. It will return a boolean indicating whether the connection was successful. It may be called multiple times, and may use hostnames or IP addresses.

pub async fn get_block( &self, block: BlockHash, ) -> Result<Option<Block>, RecvError>

Gets a block by its hash.

This function will try to get a block from the network and return it. Note that we don’t keep a local copy of the blockchain, so this function will always make a network request.

pub async fn get_utreexo_block( &self, block: BlockHash, ) -> Result<Option<UtreexoBlock>, RecvError>

Gets a Utreexo block by its hash.

This is similar to get_block, but it returns proof data for the Utreexo accumulator in addition to the block itself.

pub async fn get_mempool_transaction( &self, txid: Txid, ) -> Result<Option<Transaction>, RecvError>

Gets a transaction from the mempool by its ID.

This function will return a transaction from the mempool if it exists. If the transaction is not in the mempool (because it doesn’t exist or because it’s already been mined), this function will return None.

pub async fn get_peer_info(&self) -> Result<Vec<PeerInfo>, RecvError>

Gets information about all connected peers.

This function will return a list of PeerInfo structs, each of which contains information about a single peer.

pub async fn ping(&self) -> Result<bool, RecvError>

Pings all connected peers to check if they are alive.

Trait Implementations

impl Clone for NodeInterface

fn clone(&self) -> NodeInterface

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for NodeInterface

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.