Package org.bitcoinj.core

Class RejectMessage

java.lang.Object
org.bitcoinj.core.BaseMessage
org.bitcoinj.core.RejectMessage
All Implemented Interfaces:
Message
public class RejectMessage extends BaseMessage
A message sent by nodes when a message we sent was rejected (ie a transaction had too little fee/was invalid/etc). See BIP61 for details.

Instances of this class are immutable.

  • Constructor Details

    • RejectMessage

      public RejectMessage(RejectMessage.RejectCode code, @Nullable Sha256Hash rejectedMessageHash, String rejectedMessage, String reason)
      Constructs a reject message that fingers the object with the given hash as rejected for the given reason.

  • Method Details

    • read

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

    • bitcoinSerializeToStream

      public void bitcoinSerializeToStream(OutputStream stream) throws IOException
      Description copied from class: BaseMessage
      Serializes this message to the provided stream. If you just want the raw bytes use BaseMessage.serialize().
      Specified by:
      bitcoinSerializeToStream in class BaseMessage
      Throws:
      IOException

    • rejectedMessage

      public String rejectedMessage()
      Provides the type of message which was rejected by the peer. Note that this is ENTIRELY UNTRUSTED and should be sanity-checked before it is printed or processed.
      Returns:
      rejected message type

    • getRejectedMessage

      @Deprecated public String getRejectedMessage()
      Deprecated.
      use rejectedMessage()

    • rejectedMessageHash

      public Sha256Hash rejectedMessageHash()
      Provides the hash of the rejected object (if getRejectedMessage() is either "tx" or "block"), otherwise null.
      Returns:
      hash of rejected object

    • getRejectedObjectHash

      @Deprecated public Sha256Hash getRejectedObjectHash()
      Deprecated.
      use rejectedMessageHash()

    • code

      public RejectMessage.RejectCode code()
      The reason code given for why the peer rejected the message.
      Returns:
      reject reason code

    • getReasonCode

      @Deprecated public RejectMessage.RejectCode getReasonCode()
      Deprecated.
      use code()

    • reason

      public String reason()
      The reason message given for rejection. Note that this is ENTIRELY UNTRUSTED and should be sanity-checked before it is printed or processed.
      Returns:
      reject reason

    • getReasonString

      @Deprecated public String getReasonString()
      Deprecated.
      use reason()

    • toString

      public String toString()
      A String representation of the relevant details of this reject message. Be aware that the value returned by this method includes the value returned by getReasonString, which is taken from the reject message unchecked. Through malice or otherwise, it might contain control characters or other harmful content.
      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