org.bitcoinj.net.discovery

Class SeedPeers

java.lang.Object

org.bitcoinj.net.discovery.SeedPeers

All Implemented Interfaces:

PeerDiscovery

public class SeedPeers
extends Object
implements PeerDiscovery

SeedPeers stores a pre-determined list of Bitcoin node addresses. These nodes are selected based on being active on the network for a long period of time. The intention is to be a last resort way of finding a connection to the network, in case IRC and DNS fail. The list comes from the Bitcoin C++ source code.

Constructor Summary

Constructors

Constructor and Description
SeedPeers(int[] seedAddrs, NetworkParameters params) Supports finding peers by IP addresses
SeedPeers(NetworkParameters params) Supports finding peers by IP addresses

Method Summary

Modifier and Type	Method and Description
InetSocketAddress	getPeer() Acts as an iterator, returning the address of each node in the list sequentially.
InetSocketAddress[]	getPeers(long services, long timeoutValue, TimeUnit timeoutUnit) Returns an array containing all the Bitcoin nodes within the list.
void	shutdown() Stops any discovery in progress when we want to shut down quickly.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

SeedPeers

public SeedPeers(NetworkParameters params)

Supports finding peers by IP addresses

Parameters:

params - Network parameters to be used for port information.

SeedPeers

public SeedPeers(int[] seedAddrs,
                 NetworkParameters params)

Supports finding peers by IP addresses

Parameters:

seedAddrs - IP addresses for seed addresses.

params - Network parameters to be used for port information.

Method Detail

getPeer

@Nullable
public InetSocketAddress getPeer()
                                    throws PeerDiscoveryException

Acts as an iterator, returning the address of each node in the list sequentially. Once all the list has been iterated, null will be returned for each subsequent query.

Returns:

InetSocketAddress - The address/port of the next node.

Throws:

PeerDiscoveryException

getPeers

public InetSocketAddress[] getPeers(long services,
                                    long timeoutValue,
                                    TimeUnit timeoutUnit)
                             throws PeerDiscoveryException

Returns an array containing all the Bitcoin nodes within the list.

Specified by:

getPeers in interface PeerDiscovery

Parameters:

services - Required services as a bitmask, e.g. VersionMessage#NODE_NETWORK.

Throws:

PeerDiscoveryException

shutdown

public void shutdown()

Description copied from interface: PeerDiscovery

Stops any discovery in progress when we want to shut down quickly.

Specified by:

shutdown in interface PeerDiscovery