Package org.bitcoinj.core

Class TransactionOutput

java.lang.Object
org.bitcoinj.core.TransactionOutput
public class TransactionOutput extends Object

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 Details

  • Constructor Details

  • Method Details

    • read

      public static TransactionOutput read(ByteBuffer payload, Transaction parentTransaction) throws BufferUnderflowException, ProtocolException
      Deserialize this transaction output from a given payload.
      Parameters:
      payload - payload to deserialize from
      parentTransaction - parent transaction of the output
      Returns:
      read message
      Throws:
      BufferUnderflowException - if the read message extends beyond the remaining bytes of the payload
      ProtocolException

    • getScriptPubKey

      public Script getScriptPubKey() throws ScriptException
      Throws:
      ScriptException

    • write

      public ByteBuffer write(ByteBuffer buf) throws BufferOverflowException
      Write this transaction output into the given buffer.
      Parameters:
      buf - buffer to write into
      Returns:
      the buffer
      Throws:
      BufferOverflowException - if the output doesn't fit the remaining buffer

    • serialize

      public byte[] serialize()
      Allocates a byte array and writes this transaction output into it.
      Returns:
      byte array containing the transaction output

    • bitcoinSerialize

      @Deprecated public byte[] bitcoinSerialize()
      Deprecated.
      use serialize()

    • messageSize

      public int messageSize()
      Return the size of the serialized message. Note that if the message was deserialized from a payload, this size can differ from the size of the original payload.
      Returns:
      size of the serialized message in bytes

    • getMessageSize

      @Deprecated public int getMessageSize()
      Deprecated.
      Use messageSize()

    • 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 freestanding. Iterates over the parents list to discover this.

    • isDust

      public boolean isDust()
      Will this transaction be considered dust and not be relayable and mined by default miners?
      Returns:
      true if this output is dust

    • 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.

      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.

    • 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
      Returns:
      debug string

    • toString

      public String toString(@Nullable Network network)
      Returns a human-readable debug string.
      Parameters:
      network - if provided, addresses (of that network) will be printed for standard scripts
      Returns:
      debug string

    • 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.

    • setParent

      protected final void setParent(@Nullable Transaction parent)

    • equals

      public boolean equals(Object o)
      Overrides:
      equals in class Object

    • hashCode

      public int hashCode()
      Overrides:
      hashCode in class Object