org.bitcoinj.core

Class TransactionOutput

java.lang.Object

org.bitcoinj.core.Message

org.bitcoinj.core.ChildMessage

org.bitcoinj.core.TransactionOutput

public class TransactionOutput
extends ChildMessage

A TransactionOutput message contains a scriptPubKey that controls who is able to spend its value. It is a sub-part of the Transaction message.

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
TransactionOutput(NetworkParameters params, Transaction parent, byte[] payload, int offset) Deserializes a transaction output message.
TransactionOutput(NetworkParameters params, Transaction parent, byte[] payload, int offset, MessageSerializer serializer) Deserializes a transaction output message.
TransactionOutput(NetworkParameters params, Transaction parent, Coin value, Address to) Creates an output that sends 'value' to the given address (public key hash).
TransactionOutput(NetworkParameters params, Transaction parent, Coin value, byte[] scriptBytes)
TransactionOutput(NetworkParameters params, Transaction parent, Coin value, ECKey to) Creates an output that sends 'value' to the given public key using a simple CHECKSIG script (no addresses).

Method Summary

Modifier and Type	Method and Description
protected void	bitcoinSerializeToStream(OutputStream stream) Serializes this message to the provided stream.
TransactionOutput	duplicateDetached() Returns a copy of the output detached from its containing transaction, if need be.
boolean	equals(Object o)
Address	getAddressFromP2PKHScript(NetworkParameters networkParameters) If the output script pays to an address as in P2PKH, return the address of the receiver, i.e., a base58 encoded hash of the public key in the script.
Address	getAddressFromP2SH(NetworkParameters networkParameters) If the output script pays to a redeem script, return the address of the redeem script as described by, i.e., a base58 encoding of [one-byte version][20-byte hash][4-byte checksum], where the 20-byte hash refers to the redeem script.
int	getIndex() Gets the index of this output in the parent transaction, or throws if this output is free standing.
Coin	getMinNonDustValue() Returns the minimum value for this output to be considered "not dust", i.e.
Coin	getMinNonDustValue(Coin feePerKb) Gets the minimum value for a txout of this size to be considered non-dust by Bitcoin Core (and thus relayed).
TransactionOutPoint	getOutPointFor() Returns a new TransactionOutPoint, which is essentially a structure pointing to this output.
Transaction	getParentTransaction() Returns the transaction that owns this output.
int	getParentTransactionDepthInBlocks() Returns the depth in blocks of the parent tx.
Sha256Hash	getParentTransactionHash() Returns the transaction hash that owns this output.
byte[]	getScriptBytes() The backing script bytes which can be turned into a Script object.
Script	getScriptPubKey()
TransactionInput	getSpentBy() Returns the connected input.
Coin	getValue() Returns the value of this output.
int	hashCode()
boolean	isAvailableForSpending() Returns whether markAsSpent(TransactionInput) has been called on this class.
boolean	isDust() Will this transaction be relayable and mined by default miners?
boolean	isMine(TransactionBag transactionBag) Returns true if this output is to a key, or an address we have the keys for, in the wallet.
boolean	isMineOrWatched(TransactionBag transactionBag) Returns true if this output is to a key in the wallet or to an address/script we are watching.
boolean	isWatched(TransactionBag transactionBag) Returns true if this output is to a key, or an address we have the keys for, in the wallet.
void	markAsSpent(TransactionInput input) Sets this objects availableForSpending flag to false and the spentBy pointer to the given input.
void	markAsUnspent() Resets the spent pointer / availableForSpending flag to null.
protected void	parse()
void	setValue(Coin value) Sets the value of this output.
String	toString() Returns a human readable debug string.

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

TransactionOutput

public TransactionOutput(NetworkParameters params,
                         @Nullable
                         Transaction parent,
                         byte[] payload,
                         int offset)
                  throws ProtocolException

Deserializes a transaction output message. This is usually part of a transaction message.

Throws:

ProtocolException

TransactionOutput

public TransactionOutput(NetworkParameters params,
                         @Nullable
                         Transaction parent,
                         byte[] payload,
                         int offset,
                         MessageSerializer serializer)
                  throws ProtocolException

Deserializes a transaction output message. This is usually part of a transaction message.

Parameters:

params - NetworkParameters object.

payload - Bitcoin protocol formatted byte array containing message content.

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

serializer - the serializer to use for this message.

Throws:

ProtocolException

TransactionOutput

public TransactionOutput(NetworkParameters params,
                         @Nullable
                         Transaction parent,
                         Coin value,
                         Address to)

Creates an output that sends 'value' to the given address (public key hash). The amount should be created with something like Coin.valueOf(int, int). Typically you would use Transaction.addOutput(Coin, Address) instead of creating a TransactionOutput directly.

TransactionOutput

public TransactionOutput(NetworkParameters params,
                         @Nullable
                         Transaction parent,
                         Coin value,
                         ECKey to)

Creates an output that sends 'value' to the given public key using a simple CHECKSIG script (no addresses). The amount should be created with something like Coin.valueOf(int, int). Typically you would use Transaction.addOutput(Coin, ECKey) instead of creating an output directly.

TransactionOutput

public TransactionOutput(NetworkParameters params,
                         @Nullable
                         Transaction parent,
                         Coin value,
                         byte[] scriptBytes)

Method Detail

getScriptPubKey

public Script getScriptPubKey()
                       throws ScriptException

Throws:

ScriptException

getAddressFromP2PKHScript

@Nullable
public Address getAddressFromP2PKHScript(NetworkParameters networkParameters)
                                            throws ScriptException

If the output script pays to an address as in P2PKH, return the address of the receiver, i.e., a base58 encoded hash of the public key in the script.

Parameters:

networkParameters - needed to specify an address

Returns:

null, if the output script is not the form OP_DUP OP_HASH160 OP_EQUALVERIFY OP_CHECKSIG, i.e., not P2PKH

Throws:

ScriptException

getAddressFromP2SH

@Nullable
public Address getAddressFromP2SH(NetworkParameters networkParameters)
                                     throws ScriptException

If the output script pays to a redeem script, return the address of the redeem script as described by, i.e., a base58 encoding of [one-byte version][20-byte hash][4-byte checksum], where the 20-byte hash refers to the redeem script.

P2SH is described by BIP 16 and documented in the Bitcoin Developer Guide.

Parameters:

networkParameters - needed to specify an address

Returns:

null if the output script does not pay to a script hash

Throws:

ScriptException

parse

protected void parse()
              throws ProtocolException

Specified by:

parse in class Message

Throws:

ProtocolException

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

getValue

public Coin getValue()

Returns the value of this output. This is the amount of currency that the destination address receives.

setValue

public void setValue(Coin value)

Sets the value of this output.

getIndex

public int getIndex()

Gets the index of this output in the parent transaction, or throws if this output is free standing. Iterates over the parents list to discover this.

isDust

public boolean isDust()

Will this transaction be relayable and mined by default miners?

getMinNonDustValue

public Coin getMinNonDustValue(Coin feePerKb)

Gets the minimum value for a txout of this size to be considered non-dust by Bitcoin Core (and thus relayed). See: CTxOut::IsDust() in Bitcoin Core. The assumption is that any output that would consume more than a third of its value in fees is not something the Bitcoin system wants to deal with right now, so we call them "dust outputs" and they're made non standard. The choice of one third is somewhat arbitrary and may change in future.

You probably should use getMinNonDustValue() which uses a safe fee-per-kb by default.

Parameters:

feePerKb - The fee required per kilobyte. Note that this is the same as Bitcoin Core's -minrelaytxfee * 3

getMinNonDustValue

public Coin getMinNonDustValue()

Returns the minimum value for this output to be considered "not dust", i.e. the transaction will be relayable and mined by default miners. For normal pay to address outputs, this is 2730 satoshis, the same as Transaction.MIN_NONDUST_OUTPUT.

markAsSpent

public void markAsSpent(TransactionInput input)

Sets this objects availableForSpending flag to false and the spentBy pointer to the given input. If the input is null, it means this output was signed over to somebody else rather than one of our own keys.

Throws:

IllegalStateException - if the transaction was already marked as spent.

markAsUnspent

public void markAsUnspent()

Resets the spent pointer / availableForSpending flag to null.

isAvailableForSpending

public boolean isAvailableForSpending()

Returns whether markAsSpent(TransactionInput) has been called on this class. A Wallet will mark a transaction output as spent once it sees a transaction input that is connected to it. Note that this flag can be false when an output has in fact been spent according to the rest of the network if the spending transaction wasn't downloaded yet, and it can be marked as spent when in reality the rest of the network believes it to be unspent if the signature or script connecting to it was not actually valid.

getScriptBytes

public byte[] getScriptBytes()

The backing script bytes which can be turned into a Script object.

Returns:

the scriptBytes

isMineOrWatched

public boolean isMineOrWatched(TransactionBag transactionBag)

Returns true if this output is to a key in the wallet or to an address/script we are watching.

isWatched

public boolean isWatched(TransactionBag transactionBag)

Returns true if this output is to a key, or an address we have the keys for, in the wallet.

isMine

public boolean isMine(TransactionBag transactionBag)

Returns true if this output is to a key, or an address we have the keys for, in the wallet.

toString

public String toString()

Returns a human readable debug string.

Overrides:

toString in class Object

getSpentBy

@Nullable
public TransactionInput getSpentBy()

Returns the connected input.

getParentTransaction

@Nullable
public Transaction getParentTransaction()

Returns the transaction that owns this output.

getParentTransactionHash

@Nullable
public Sha256Hash getParentTransactionHash()

Returns the transaction hash that owns this output.

getParentTransactionDepthInBlocks

public int getParentTransactionDepthInBlocks()

Returns the depth in blocks of the parent tx.

If the transaction appears in the top block, the depth is one. If it's anything else (pending, dead, unknown) then -1.

Returns:

The tx depth or -1.

getOutPointFor

public TransactionOutPoint getOutPointFor()

Returns a new TransactionOutPoint, which is essentially a structure pointing to this output. Requires that this output is not detached.

duplicateDetached

public TransactionOutput duplicateDetached()

Returns a copy of the output detached from its containing transaction, if need be.

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object