C# Class BitSharper.PeerGroup

Maintain a number of connections to peers.

PeerGroup tries to maintain a constant number of connections to a set of distinct peers. Each peer runs a network listener in its own thread. When a connection is lost, a new peer will be tried after a delay as long as the number of connections less than the maximum.

Connections are made to addresses from a provided list. When that list is exhausted, we start again from the head of the list.

The PeerGroup can broadcast a transaction to the currently connected set of peers. It can also handle download of the block chain from peers, restarting the process when peers die. @author [email protected] (Miron Cuperman a.k.a devrandom)

Afficher le fichier Open project: TangibleCryptography/BitSharper Class Usage Examples

Méthodes publiques

Méthode	Description
AddAddress ( PeerAddress peerAddress ) : void	Add an address to the list of potential peers to connect to.
AddPeerDiscovery ( IPeerDiscovery peerDiscovery ) : void	Add addresses from a discovery source to the list of potential peers to connect to.
BroadcastTransaction ( Transaction tx ) : bool	Broadcast a transaction to all connected peers.
DownloadBlockChain ( ) : void	Download the block chain from peers. This method wait until the download is complete. "Complete" is defined as downloading from at least one peer all the blocks that are in that peer's inventory.
PeerGroup ( IBlockStore blockStore, NetworkParameters @params, BlockChain chain ) : System	Creates a PeerGroup with the given parameters and a default 5 second connection timeout.
PeerGroup ( IBlockStore blockStore, NetworkParameters @params, BlockChain chain, int connectionDelayMillis ) : System	Creates a PeerGroup with the given parameters. The connectionDelayMillis parameter controls how long the PeerGroup will wait between attempts to connect to nodes or read from any added peer discovery sources.
Run ( ) : void	Repeatedly get the next peer address from the inactive queue and try to connect. We can be terminated with Thread.interrupt. When an interrupt is received, we will ask the executor to shutdown and ask each peer to disconnect. At that point no threads or network connections will be active.
Start ( ) : void	Starts the background thread that makes connections.
StartBlockChainDownload ( IPeerEventListener listener ) : void	Start downloading the block chain from the first available peer. If no peers are currently connected, the download will be started once a peer starts. If the peer dies, the download will resume with another peer.
Stop ( ) : void	Stop this PeerGroup. The peer group will be asynchronously shut down. After it is shut down all peers will be disconnected and no threads will be running.

Méthodes protégées

Méthode	Description
HandleNewPeer ( Peer peer ) : void
HandlePeerDeath ( Peer peer ) : void

Private Methods

Méthode	Description
DiscoverPeers ( ) : void
StartBlockChainDownloadFromPeer ( Peer peer ) : void
TryNextPeer ( ) : void	Try connecting to a peer. If we exceed the number of connections, delay and try again.

Method Details

AddAddress() public méthode

Add an address to the list of potential peers to connect to.

public AddAddress ( PeerAddress peerAddress ) : void
peerAddress	PeerAddress
Résultat	void

AddPeerDiscovery() public méthode

Add addresses from a discovery source to the list of potential peers to connect to.

public AddPeerDiscovery ( IPeerDiscovery peerDiscovery ) : void
peerDiscovery	IPeerDiscovery
Résultat	void

BroadcastTransaction() public méthode

Broadcast a transaction to all connected peers.

public BroadcastTransaction ( Transaction tx ) : bool
tx	Transaction
Résultat	bool

DownloadBlockChain() public méthode

Download the block chain from peers.

This method wait until the download is complete. "Complete" is defined as downloading from at least one peer all the blocks that are in that peer's inventory.

public DownloadBlockChain ( ) : void
Résultat	void

HandleNewPeer() protected méthode

protected HandleNewPeer ( Peer peer ) : void
peer	Peer
Résultat	void

HandlePeerDeath() protected méthode

protected HandlePeerDeath ( Peer peer ) : void
peer	Peer
Résultat	void

PeerGroup() public méthode

Creates a PeerGroup with the given parameters and a default 5 second connection timeout.

public PeerGroup ( IBlockStore blockStore, NetworkParameters @params, BlockChain chain ) : System
blockStore	IBlockStore
@params	NetworkParameters
chain	BlockChain
Résultat	System

PeerGroup() public méthode

Creates a PeerGroup with the given parameters. The connectionDelayMillis parameter controls how long the PeerGroup will wait between attempts to connect to nodes or read from any added peer discovery sources.

public PeerGroup ( IBlockStore blockStore, NetworkParameters @params, BlockChain chain, int connectionDelayMillis ) : System
blockStore	IBlockStore
@params	NetworkParameters
chain	BlockChain
connectionDelayMillis	int
Résultat	System

Run() public méthode

Repeatedly get the next peer address from the inactive queue and try to connect.

We can be terminated with Thread.interrupt. When an interrupt is received, we will ask the executor to shutdown and ask each peer to disconnect. At that point no threads or network connections will be active.

public Run ( ) : void
Résultat	void

Start() public méthode

Starts the background thread that makes connections.

public Start ( ) : void
Résultat	void

StartBlockChainDownload() public méthode

Start downloading the block chain from the first available peer.

If no peers are currently connected, the download will be started once a peer starts. If the peer dies, the download will resume with another peer.

public StartBlockChainDownload ( IPeerEventListener listener ) : void
listener	IPeerEventListener	A listener for chain download events, may not be null.
Résultat	void

Stop() public méthode

Stop this PeerGroup.

The peer group will be asynchronously shut down. After it is shut down all peers will be disconnected and no threads will be running.

public Stop ( ) : void
Résultat	void