org.bitcoinj.core

Class GetUTXOsMessage

java.lang.Object

org.bitcoinj.core.Message

org.bitcoinj.core.GetUTXOsMessage

All Implemented Interfaces:

Serializable

public class GetUTXOsMessage
extends Message

This command is supported only by Bitcoin XT nodes, which advertise themselves using the second service bit flag. It requests a query of the UTXO set keyed by a set of outpoints (i.e. tx hash and output index). The result contains a bitmap of spentness flags, and the contents of the associated outputs if they were found. The results aren't authenticated by anything, so the peer could lie, or a man in the middle could swap out its answer for something else. Please consult BIP 65 for more information on this message.

Note that this message does not let you query the UTXO set by address, script or any other criteria. The reason is that Bitcoin nodes don't calculate the necessary database indexes to answer such queries, to save space and time. If you want to look up unspent outputs by address, you can either query a block explorer site, or you can use the FullPrunedBlockChain class to build the required indexes yourself. Bear in that it will be quite slow and disk intensive to do that!

See Also:

Serialized Form

Nested Class Summary

Nested classes/interfaces inherited from class org.bitcoinj.core.Message

Message.LazyParseException

Field Summary

Fields

Modifier and Type	Field and Description
static int	MIN_PROTOCOL_VERSION
static int	SERVICE_FLAGS_REQUIRED Bitmask of service flags required for a node to support this command (0x3)

Fields inherited from class org.bitcoinj.core.Message

checksum, cursor, length, MAX_SIZE, offset, params, parsed, parseLazy, parseRetain, payload, protocolVersion, recached, UNKNOWN_LENGTH

Constructor Summary

Constructors

Constructor and Description
GetUTXOsMessage(NetworkParameters params, byte[] payloadBytes)
GetUTXOsMessage(NetworkParameters params, List<TransactionOutPoint> outPoints, boolean includeMempool)

Method Summary

Modifier and Type	Method and Description
boolean	equals(Object o)
boolean	getIncludeMempool()
ImmutableList<TransactionOutPoint>	getOutPoints()
int	hashCode()
protected void	parse()
protected void	parseLite() Perform the most minimal parse possible to calculate the length of the message payload.

Methods inherited from class org.bitcoinj.core.Message

adjustLength, bitcoinSerialize, bitcoinSerialize, ensureParsed, getHash, getMessageSize, getParams, isCached, isParsed, isRecached, maybeParse, unCache, unsafeBitcoinSerialize

Methods inherited from class java.lang.Object

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

Field Detail

MIN_PROTOCOL_VERSION

public static final int MIN_PROTOCOL_VERSION

See Also:

Constant Field Values

SERVICE_FLAGS_REQUIRED

public static final int SERVICE_FLAGS_REQUIRED

Bitmask of service flags required for a node to support this command (0x3)

See Also:

Constant Field Values

Constructor Detail

GetUTXOsMessage

public GetUTXOsMessage(NetworkParameters params,
                       List<TransactionOutPoint> outPoints,
                       boolean includeMempool)

GetUTXOsMessage

public GetUTXOsMessage(NetworkParameters params,
                       byte[] payloadBytes)

Method Detail

parse

protected void parse()
              throws ProtocolException

Throws:

ProtocolException

getIncludeMempool

public boolean getIncludeMempool()

getOutPoints

public ImmutableList<TransactionOutPoint> getOutPoints()

parseLite

protected void parseLite()
                  throws ProtocolException

Description copied from class: Message

Perform the most minimal parse possible to calculate the length of the message payload. This is only required for subclasses of ChildMessage as root level messages will have their length passed into the constructor.

Implementations should adhere to the following contract: If parseLazy = true the 'length' field must be set before returning. If parseLazy = false the length field must be set either within the parseLite() method OR the parse() method. The overriding requirement is that length must be set to non UNKNOWN_MESSAGE value by the time the constructor exits.

Specified by:

parseLite in class Message

Throws:

ProtocolException

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object