Package org.bitcoinj.base

Interface AddressParser

All Known Implementing Classes:
Wallet
Functional Interface:
This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
@FunctionalInterface public interface AddressParser
Functional interface for parsing an Address. It takes a String parameter and will parse address strings for a configured set of Networks. For example, if the parser was created with (getDefault(Network) it will only parse addresses for the provided value of Network. If created with getDefault() it will parse addresses matching any known network. The default set of known networks is defined by BitcoinNetwork.

Note: Be aware that the value returned by Address.network() will be normalized. See Address.network() for details.

  • Method Details

    • parseAddress

      Address parseAddress(String addressString) throws AddressFormatException
      Parse an address for a configured set of Networks.
      Parameters:
      addressString - string representation of an address
      Returns:
      A validated address object
      Throws:
      AddressFormatException - invalid address string

    • getDefault

      static AddressParser getDefault()
      Returns:
      The default parser for address and networks types built-in to bitcoinj.

    • getDefault

      static AddressParser getDefault(Network network)
      Parameters:
      network - the network to parse for
      Returns:
      The default (built-in) parser for network

    • getLegacy

      @Deprecated static AddressParser getLegacy()
      Deprecated.
      Get a legacy address parser that knows about networks that have been dynamically added to the list maintained by Networks.
      Returns:
      A parser for all known networks

    • getLegacy

      @Deprecated static AddressParser getLegacy(Network network)
      Deprecated.
      Get a legacy address parser that knows about networks that have been dynamically added to the list maintained by Networks.
      Parameters:
      network - the network to parse for
      Returns:
      A parser that will throw for strings that are not valid for network.

    • getLegacy

      @Deprecated static AddressParser getLegacy(@Nullable NetworkParameters params)
      Deprecated.
      Get a legacy address parser that knows about networks that have been dynamically added to the list maintained by Networks.
      Parameters:
      params - the network to parser for, or null for all networks.
      Returns:
      A parser that will throw for strings that are not valid for network.