Struct solana_core::cluster_info::ClusterInfo

pub struct ClusterInfo {
    pub gossip: RwLock<CrdsGossip>,
    // some fields omitted
}

Fields

gossip: RwLock<CrdsGossip>

The network

Methods

impl ClusterInfo

pub fn new_with_invalid_keypair(contact_info: ContactInfo) -> Self

Without a valid keypair gossip will not function. Only useful for tests.

pub fn new(contact_info: ContactInfo, keypair: Arc<Keypair>) -> Self

pub fn clone_with_id(&self, new_id: &Pubkey) -> Self

pub fn update_contact_info<F>(&self, modify: F) where
    F: FnOnce(&mut ContactInfo), 

pub fn insert_info(&self, contact_info: ContactInfo)

pub fn set_entrypoint(&self, entrypoint: ContactInfo)

pub fn id(&self) -> Pubkey

pub fn lookup_contact_info<F, Y>(&self, id: &Pubkey, map: F) -> Option<Y> where
    F: FnOnce(&ContactInfo) -> Y, 

pub fn my_contact_info(&self) -> ContactInfo

pub fn my_shred_version(&self) -> u16

pub fn lookup_epoch_slots(&self, ix: EpochSlotsIndex) -> EpochSlots

pub fn contact_info_trace(&self) -> String

pub fn push_lowest_slot(&self, id: Pubkey, min: Slot)

pub fn push_epoch_slots(&self, update: &[Slot])

pub fn push_message(&self, message: CrdsValue)

pub fn push_accounts_hashes(&self, accounts_hashes: Vec<(Slot, Hash)>)

pub fn push_snapshot_hashes(&self, snapshot_hashes: Vec<(Slot, Hash)>)

pub fn push_vote(&self, tower_index: usize, vote: Transaction)

pub fn get_votes(
    &self,
    since: u64
) -> (Vec<CrdsValueLabel>, Vec<Transaction>, u64)

Get votes in the crds

• since - The timestamp of when the vote inserted must be greater than since. This allows the bank to query for new votes only.

• return - The votes, and the max timestamp from the new set.

pub fn get_snapshot_hash(&self, slot: Slot) -> Vec<(Pubkey, Hash)>

pub fn get_accounts_hash_for_node<F, Y>(
    &self,
    pubkey: &Pubkey,
    map: F
) -> Option<Y> where
    F: FnOnce(&Vec<(Slot, Hash)>) -> Y, 

pub fn get_snapshot_hash_for_node<F, Y>(
    &self,
    pubkey: &Pubkey,
    map: F
) -> Option<Y> where
    F: FnOnce(&Vec<(Slot, Hash)>) -> Y, 

pub fn get_lowest_slot_for_node<F, Y>(
    &self,
    pubkey: &Pubkey,
    since: Option<u64>,
    map: F
) -> Option<Y> where
    F: FnOnce(&LowestSlot, u64) -> Y, 

pub fn get_epoch_slots_since(
    &self,
    since: Option<u64>
) -> (Vec<EpochSlots>, Option<u64>)

pub fn all_rpc_peers(&self) -> Vec<ContactInfo>

all validators that have a valid rpc port regardless of shred_version.

pub fn gossip_peers(&self) -> Vec<ContactInfo>

pub fn all_tvu_peers(&self) -> Vec<ContactInfo>

all validators that have a valid tvu port regardless of shred_version.

pub fn tvu_peers(&self) -> Vec<ContactInfo>

all validators that have a valid tvu port and are on the same shred_version.

pub fn all_storage_peers(&self) -> Vec<ContactInfo>

all peers that have a valid storage addr regardless of shred_version.

pub fn storage_peers(&self) -> Vec<ContactInfo>

all peers that have a valid storage addr and are on the same shred_version.

pub fn retransmit_peers(&self) -> Vec<ContactInfo>

all peers that have a valid tvu

pub fn repair_peers(&self, slot: Slot) -> Vec<ContactInfo>

all tvu peers with valid gossip addrs that likely have the slot being requested

pub fn is_archiver(contact_info: &ContactInfo) -> bool

pub fn sorted_retransmit_peers_and_stakes(
    &self,
    stakes: Option<Arc<HashMap<Pubkey, u64>>>
) -> (Vec<ContactInfo>, Vec<(u64, usize)>)

pub fn shuffle_peers_and_index(
    id: &Pubkey,
    peers: &[ContactInfo],
    stakes_and_index: &[(u64, usize)],
    seed: [u8; 32]
) -> (usize, Vec<(u64, usize)>)

Return sorted Retransmit peers and index of Self.id() as if it were in that list

pub fn tpu_peers(&self) -> Vec<ContactInfo>

compute broadcast table

pub fn describe_data_plane(nodes: usize, fanout: usize) -> (usize, Vec<usize>)

Given a node count and fanout, it calculates how many layers are needed and at what index each layer begins.

pub fn retransmit_to(
    peers: &[&ContactInfo],
    packet: &mut Packet,
    slot_leader_pubkey: Option<Pubkey>,
    s: &UdpSocket,
    forwarded: bool
) -> Result<(), Error>

retransmit messages to a list of nodes

Remarks

We need to avoid having obj locked while doing a io, such as the send_to

pub fn gossip(
    obj: Arc<Self>,
    bank_forks: Option<Arc<RwLock<BankForks>>>,
    sender: PacketSender,
    exit: &Arc<AtomicBool>
) -> JoinHandle<()>

randomly pick a node and ask them for updates asynchronously

pub fn listen(
    me: Arc<Self>,
    bank_forks: Option<Arc<RwLock<BankForks>>>,
    requests_receiver: PacketReceiver,
    response_sender: PacketSender,
    exit: &Arc<AtomicBool>
) -> JoinHandle<()>

pub fn gossip_contact_info(id: &Pubkey, gossip: SocketAddr) -> ContactInfo

pub fn spy_contact_info(id: &Pubkey) -> ContactInfo

pub fn gossip_node(
    id: &Pubkey,
    gossip_addr: &SocketAddr
) -> (ContactInfo, UdpSocket, Option<TcpListener>)

An alternative to Spy Node that has a valid gossip address and fully participate in Gossip.

pub fn spy_node(id: &Pubkey) -> (ContactInfo, UdpSocket, Option<TcpListener>)

A Node with dummy ports to spy on gossip via pull requests