Enum TransactionConfidence.ConfidenceType

    • Enum Constant Summary

      Enum Constants 
      Enum Constant Description
      BUILDING
      If BUILDING, then the transaction is included in the best chain and your confidence in it is increasing.
      DEAD
      If DEAD, then it means the transaction won't confirm unless there is another re-org, because some other transaction is spending one of its inputs.
      IN_CONFLICT
      If IN_CONFLICT, then it means there is another transaction (or several other transactions) spending one (or several) of its inputs but nor this transaction nor the other/s transaction/s are included in the best chain.
      PENDING
      If PENDING, then the transaction is unconfirmed and should be included shortly, as long as it is being announced and is considered valid by the network.
      UNKNOWN
      If a transaction hasn't been broadcast yet, or there's no record of it, its confidence is UNKNOWN.
    • Enum Constant Detail

      • BUILDING

        public static final TransactionConfidence.ConfidenceType BUILDING
        If BUILDING, then the transaction is included in the best chain and your confidence in it is increasing.
      • PENDING

        public static final TransactionConfidence.ConfidenceType PENDING
        If PENDING, then the transaction is unconfirmed and should be included shortly, as long as it is being announced and is considered valid by the network. A pending transaction will be announced if the containing wallet has been attached to a live PeerGroup using PeerGroup.addWallet(Wallet). You can estimate how likely the transaction is to be included by connecting to a bunch of nodes then measuring how many announce it, using TransactionConfidence.numBroadcastPeers(). Or if you saw it from a trusted peer, you can assume it's valid and will get mined sooner or later as well.
      • DEAD

        public static final TransactionConfidence.ConfidenceType DEAD
        If DEAD, then it means the transaction won't confirm unless there is another re-org, because some other transaction is spending one of its inputs. Such transactions should be alerted to the user so they can take action, eg, suspending shipment of goods if they are a merchant. It can also mean that a coinbase transaction has been made dead from it being moved onto a side chain.
      • IN_CONFLICT

        public static final TransactionConfidence.ConfidenceType IN_CONFLICT
        If IN_CONFLICT, then it means there is another transaction (or several other transactions) spending one (or several) of its inputs but nor this transaction nor the other/s transaction/s are included in the best chain. The other/s transaction/s should be IN_CONFLICT too. IN_CONFLICT can be thought as an intermediary state between a) PENDING and BUILDING or b) PENDING and DEAD. Another common name for this situation is "double spend".
    • Method Detail

      • values

        public static TransactionConfidence.ConfidenceType[] values()
        Returns an array containing the constants of this enum type, in the order they are declared. This method may be used to iterate over the constants as follows:
        for (TransactionConfidence.ConfidenceType c : TransactionConfidence.ConfidenceType.values())
            System.out.println(c);
        
        Returns:
        an array containing the constants of this enum type, in the order they are declared
      • valueOf

        public static TransactionConfidence.ConfidenceType valueOf​(java.lang.String name)
        Returns the enum constant of this type with the specified name. The string must match exactly an identifier used to declare an enum constant in this type. (Extraneous whitespace characters are not permitted.)
        Parameters:
        name - the name of the enum constant to be returned.
        Returns:
        the enum constant with the specified name
        Throws:
        java.lang.IllegalArgumentException - if this enum type has no constant with the specified name
        java.lang.NullPointerException - if the argument is null
      • getValue

        public int getValue()