org.bitcoinj.core

Class PeerAddress

java.lang.Object

org.bitcoinj.core.Message

org.bitcoinj.core.ChildMessage

org.bitcoinj.core.PeerAddress

public class PeerAddress
extends ChildMessage

A PeerAddress holds an IP address and port number representing the network location of a peer in the Bitcoin P2P network. It exists primarily for serialization purposes.

Instances of this class are not safe for use by multiple threads.

Field Summary

Fields inherited from class org.bitcoinj.core.ChildMessage

parent

Fields inherited from class org.bitcoinj.core.Message

cursor, length, MAX_SIZE, offset, params, payload, protocolVersion, recached, serializer, UNKNOWN_LENGTH

Constructor Summary

Constructors

Constructor and Description
PeerAddress(InetAddress addr) Constructs a peer address from the given IP address.
PeerAddress(InetAddress addr, int port) Constructs a peer address from the given IP address and port.
PeerAddress(InetAddress addr, int port, int protocolVersion) Construct a peer address from a memorized or hardcoded address.
PeerAddress(InetSocketAddress addr) Constructs a peer address from an InetSocketAddress.
PeerAddress(NetworkParameters params, byte[] payload, int offset, int protocolVersion) Construct a peer address from a serialized payload.
PeerAddress(NetworkParameters params, byte[] payload, int offset, int protocolVersion, Message parent, MessageSerializer serializer) Construct a peer address from a serialized payload.
PeerAddress(NetworkParameters params, InetAddress addr) Constructs a peer address from the given IP address.
PeerAddress(NetworkParameters params, InetAddress addr, int port) Constructs a peer address from the given IP address and port.
PeerAddress(NetworkParameters params, InetSocketAddress addr) Constructs a peer address from an InetSocketAddress.
PeerAddress(NetworkParameters params, String hostname, int port) Constructs a peer address from a stringified hostname+port.
PeerAddress(String hostname, int port) Constructs a peer address from a stringified hostname+port.

Method Summary

Modifier and Type	Method and Description
protected void	bitcoinSerializeToStream(OutputStream stream) Serializes this message to the provided stream.
boolean	equals(Object o)
InetAddress	getAddr()
String	getHostname()
int	getPort()
BigInteger	getServices()
InetSocketAddress	getSocketAddress()
long	getTime()
int	hashCode()
static PeerAddress	localhost(NetworkParameters params)
protected void	parse()
void	setAddr(InetAddress addr)
void	setPort(int port)
void	setServices(BigInteger services)
void	setTime(long time)
InetSocketAddress	toSocketAddress()
String	toString()

Methods inherited from class org.bitcoinj.core.ChildMessage

adjustLength, adjustLength, setParent, unCache

Methods inherited from class org.bitcoinj.core.Message

bitcoinSerialize, bitcoinSerialize, getHash, getMessageSize, getParams, hasMoreBytes, isCached, isRecached, readByteArray, readBytes, readHash, readInt64, readStr, readUint32, readUint64, readVarInt, readVarInt, unsafeBitcoinSerialize

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

PeerAddress

public PeerAddress(NetworkParameters params,
                   byte[] payload,
                   int offset,
                   int protocolVersion)
            throws ProtocolException

Construct a peer address from a serialized payload.

Throws:

ProtocolException

PeerAddress

public PeerAddress(NetworkParameters params,
                   byte[] payload,
                   int offset,
                   int protocolVersion,
                   Message parent,
                   MessageSerializer serializer)
            throws ProtocolException

Construct a peer address from a serialized payload.

Parameters:

params - NetworkParameters object.

payload - Bitcoin protocol formatted byte array containing message content.

offset - The location of the first payload byte within the array.

protocolVersion - Bitcoin protocol version.

serializer - the serializer to use for this message.

Throws:

ProtocolException

PeerAddress

public PeerAddress(InetAddress addr,
                   int port,
                   int protocolVersion)

Construct a peer address from a memorized or hardcoded address.

PeerAddress

public PeerAddress(InetAddress addr,
                   int port)

Constructs a peer address from the given IP address and port. Protocol version is the default for Bitcoin.

PeerAddress

public PeerAddress(NetworkParameters params,
                   InetAddress addr,
                   int port)

Constructs a peer address from the given IP address and port.

PeerAddress

public PeerAddress(InetAddress addr)

Constructs a peer address from the given IP address. Port and version number are default for Bitcoin mainnet.

PeerAddress

public PeerAddress(NetworkParameters params,
                   InetAddress addr)

Constructs a peer address from the given IP address. Port is default for Bitcoin mainnet, version number is default for the given parameters.

PeerAddress

public PeerAddress(InetSocketAddress addr)

Constructs a peer address from an InetSocketAddress. An InetSocketAddress can take in as parameters an InetAddress or a String hostname. If you want to connect to a .onion, set the hostname to the .onion address. Protocol version is the default. Protocol version is the default for Bitcoin.

PeerAddress

public PeerAddress(NetworkParameters params,
                   InetSocketAddress addr)

Constructs a peer address from an InetSocketAddress. An InetSocketAddress can take in as parameters an InetAddress or a String hostname. If you want to connect to a .onion, set the hostname to the .onion address.

PeerAddress

public PeerAddress(String hostname,
                   int port)

Constructs a peer address from a stringified hostname+port. Use this if you want to connect to a Tor .onion address. Protocol version is the default for Bitcoin.

PeerAddress

public PeerAddress(NetworkParameters params,
                   String hostname,
                   int port)

Constructs a peer address from a stringified hostname+port. Use this if you want to connect to a Tor .onion address.

Method Detail

localhost

public static PeerAddress localhost(NetworkParameters params)

bitcoinSerializeToStream

protected void bitcoinSerializeToStream(OutputStream stream)
                                 throws IOException

Description copied from class: Message

Serializes this message to the provided stream. If you just want the raw bytes use bitcoinSerialize().

Overrides:

bitcoinSerializeToStream in class Message

Throws:

IOException

parse

protected void parse()
              throws ProtocolException

Specified by:

parse in class Message

Throws:

ProtocolException

getHostname

public String getHostname()

getAddr

public InetAddress getAddr()

getSocketAddress

public InetSocketAddress getSocketAddress()

setAddr

public void setAddr(InetAddress addr)

getPort

public int getPort()

setPort

public void setPort(int port)

getServices

public BigInteger getServices()

setServices

public void setServices(BigInteger services)

getTime

public long getTime()

setTime

public void setTime(long time)

toString

public String toString()

Overrides:

toString in class Object

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toSocketAddress

public InetSocketAddress toSocketAddress()