org.bitcoinj.core

Class Address

java.lang.Object

org.bitcoinj.core.PrefixedChecksummedBytes

org.bitcoinj.core.Address

All Implemented Interfaces:

java.io.Serializable, java.lang.Cloneable, java.lang.Comparable<PrefixedChecksummedBytes>

Direct Known Subclasses:

LegacyAddress, SegwitAddress

public abstract class Address
extends PrefixedChecksummedBytes

Base class for addresses, e.g. native segwit addresses (SegwitAddress) or legacy addresses (LegacyAddress).

Use fromString(NetworkParameters, String) to conveniently construct any kind of address from its textual form.

See Also:

Serialized Form

Field Summary

Fields inherited from class org.bitcoinj.core.PrefixedChecksummedBytes

bytes, params

Constructor Summary

Constructors

Constructor and Description
Address(NetworkParameters params, byte[] bytes)

Method Summary

Modifier and Type	Method and Description
static Address	fromKey(NetworkParameters params, ECKey key, Script.ScriptType outputScriptType) Construct an Address that represents the public part of the given ECKey.
static Address	fromString(NetworkParameters params, java.lang.String str) Construct an address from its textual form.
abstract byte[]	getHash() Get either the public key hash or script hash that is encoded in the address.
abstract Script.ScriptType	getOutputScriptType() Get the type of output script that will be used for sending to the address.

Methods inherited from class org.bitcoinj.core.PrefixedChecksummedBytes

clone, compareTo, equals, getParameters, hashCode

Methods inherited from class java.lang.Object

finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Address

public Address(NetworkParameters params,
               byte[] bytes)

Method Detail

fromString

public static Address fromString(@Nullable
                                 NetworkParameters params,
                                 java.lang.String str)
                          throws AddressFormatException

Construct an address from its textual form.

Parameters:

params - the expected network this address is valid for, or null if the network should be derived from the textual form

str - the textual form of the address, such as "17kzeh4N8g49GFvdDzSf8PjaPfyoD1MndL" or "bc1qw508d6qejxtdg4y5r3zarvary0c5xw7kv8f3t4"

Returns:

constructed address

Throws:

AddressFormatException - if the given string doesn't parse or the checksum is invalid

AddressFormatException.WrongNetwork - if the given string is valid but not for the expected network (eg testnet vs mainnet)

fromKey

public static Address fromKey(NetworkParameters params,
                              ECKey key,
                              Script.ScriptType outputScriptType)

Construct an Address that represents the public part of the given ECKey.

Parameters:

params - network this address is valid for

key - only the public part is used

outputScriptType - script type the address should use

Returns:

constructed address

getHash

public abstract byte[] getHash()

Get either the public key hash or script hash that is encoded in the address.

Returns:

hash that is encoded in the address

getOutputScriptType

public abstract Script.ScriptType getOutputScriptType()

Get the type of output script that will be used for sending to the address.

Returns:

type of output script