Package org.bitcoinj.base

Class LegacyAddress

java.lang.Object

org.bitcoinj.base.LegacyAddress

All Implemented Interfaces:

Comparable<Address>, Address

public class LegacyAddress
extends Object
implements Address

A Bitcoin address looks like 1MsScoe2fTJoq4ZPdQgqyhgWeoNamYPevy and is derived from an elliptic curve public key plus a set of network parameters. Not to be confused with a PeerAddress or AddressMessage which are about network (TCP) addresses.

A standard address is built by taking the RIPE-MD160 hash of the public key bytes, with a version prefix and a checksum suffix, then encoding it textually as base58. The version prefix is used to both denote the network for which the address is valid (see BitcoinNetwork, and also to indicate how the bytes inside the address should be interpreted. Whilst almost all addresses today are hashes of public keys, another (currently unsupported type) can contain a hash of a script instead.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	LegacyAddress.AddressHeader	Address header of legacy P2PKH addresses for standard Bitcoin networks.
static enum	LegacyAddress.P2SHHeader	Address header of legacy P2SH addresses for standard Bitcoin networks.

Field Summary

Fields

Modifier and Type	Field	Description
protected final byte[]	bytes
static final int	LENGTH	An address is a RIPEMD160 hash of a public key, therefore is always 160 bits or 20 bytes.
protected final Network	network
final boolean	p2sh	True if P2SH, false if P2PKH.

Fields inherited from interface org.bitcoinj.base.Address

PARTIAL_ADDRESS_COMPARATOR

Method Summary

Modifier and Type	Method	Description
int	compareTo(Address o)	Comparison field order for addresses is: Network.id() Legacy vs.
boolean	equals(Object o)
static LegacyAddress	fromBase58(String base58, Network network)	Construct a LegacyAddress from its base58 form.
static LegacyAddress	fromBase58(NetworkParameters params, String base58)	Deprecated. Use fromBase58(String, Network)
static LegacyAddress	fromKey(NetworkParameters params, ECKey key)	Deprecated. Use ECKey.toAddress(ScriptType, Network)
static LegacyAddress	fromPubKeyHash(Network network, byte[] hash160)	Construct a LegacyAddress that represents the given pubkey hash.
static LegacyAddress	fromPubKeyHash(NetworkParameters params, byte[] hash160)	Deprecated. Use fromPubKeyHash(Network, byte[])
static LegacyAddress	fromScriptHash(Network network, byte[] hash160)	Construct a LegacyAddress that represents the given P2SH script hash.
static LegacyAddress	fromScriptHash(NetworkParameters params, byte[] hash160)	Deprecated. Use fromScriptHash(Network, byte[])
byte[]	getHash()	The (big endian) 20 byte hash that is the core of a Bitcoin address.
ScriptType	getOutputScriptType()	Get the type of output script that will be used for sending to the address.
static NetworkParameters	getParametersFromAddress(String address)	Deprecated.
int	getVersion()	Get the version header of an address.
int	hashCode()
Network	network()	Get the network this address works on.
String	toBase58()	Returns the base58-encoded textual form, including version and checksum bytes.
String	toString()

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.bitcoinj.base.Address

getParameters

Field Details

LENGTH

public static final int LENGTH

An address is a RIPEMD160 hash of a public key, therefore is always 160 bits or 20 bytes.

See Also:

• Constant Field Values

network

protected final Network network

bytes

protected final byte[] bytes

p2sh

public final boolean p2sh

True if P2SH, false if P2PKH.

Method Details

fromPubKeyHash

@Deprecated
public static LegacyAddress fromPubKeyHash(NetworkParameters params,
 byte[] hash160)
                                    throws AddressFormatException

Deprecated.

Use fromPubKeyHash(Network, byte[])

Construct a LegacyAddress that represents the given pubkey hash. The resulting address will be a P2PKH type of address.

Parameters:

params - network this address is valid for

hash160 - 20-byte pubkey hash

Returns:

constructed address

Throws:

AddressFormatException

fromPubKeyHash

public static LegacyAddress fromPubKeyHash(Network network,
 byte[] hash160)
                                    throws AddressFormatException

Construct a LegacyAddress that represents the given pubkey hash. The resulting address will be a P2PKH type of address.

Parameters:

network - network this address is valid for

hash160 - 20-byte pubkey hash

Returns:

constructed address

Throws:

AddressFormatException

fromKey

@Deprecated
public static LegacyAddress fromKey(NetworkParameters params,
 ECKey key)

Deprecated.

Use ECKey.toAddress(ScriptType, Network)

Construct a LegacyAddress that represents the public part of the given ECKey. Note that an address is derived from a hash of the public key and is not the public key itself.

Parameters:

params - network this address is valid for

key - only the public part is used

Returns:

constructed address

fromScriptHash

@Deprecated
public static LegacyAddress fromScriptHash(NetworkParameters params,
 byte[] hash160)
                                    throws AddressFormatException

Deprecated.

Use fromScriptHash(Network, byte[])

Construct a LegacyAddress that represents the given P2SH script hash.

Parameters:

params - network this address is valid for

hash160 - P2SH script hash

Returns:

constructed address

Throws:

AddressFormatException

fromScriptHash

public static LegacyAddress fromScriptHash(Network network,
 byte[] hash160)
                                    throws AddressFormatException

Construct a LegacyAddress that represents the given P2SH script hash.

Parameters:

network - network this address is valid for

hash160 - P2SH script hash

Returns:

constructed address

Throws:

AddressFormatException

fromBase58

@Deprecated
public static LegacyAddress fromBase58(@Nullable
 NetworkParameters params,
 String base58)
                                throws AddressFormatException,
AddressFormatException.WrongNetwork

Deprecated.

Use fromBase58(String, Network)

Construct a LegacyAddress from its base58 form.

Parameters:

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

base58 - base58-encoded textual form of the address

Throws:

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

AddressFormatException.WrongNetwork - if the given address is valid but for a different chain (e.g. testnet vs mainnet)

fromBase58

public static LegacyAddress fromBase58(String base58,
 @Nonnull
 Network network)
                                throws AddressFormatException,
AddressFormatException.WrongNetwork

Construct a LegacyAddress from its base58 form.

Parameters:

base58 - base58-encoded textual form of the address

network - expected network this address is valid for

Throws:

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

AddressFormatException.WrongNetwork - if the given address is valid but for a different chain (e.g. testnet vs mainnet)

network

public Network network()

Get the network this address works on. Use of BitcoinNetwork is preferred to use of NetworkParameters when you need to know what network an address is for.

Specified by:

network in interface Address

Returns:

the Network.

getVersion

public int getVersion()

Get the version header of an address. This is the first byte of a base58 encoded address.

Returns:

version header as one byte

toBase58

public String toBase58()

Returns the base58-encoded textual form, including version and checksum bytes.

Returns:

textual form

getHash

public byte[] getHash()

The (big endian) 20 byte hash that is the core of a Bitcoin address.

Specified by:

getHash in interface Address

Returns:

hash that is encoded in the address

getOutputScriptType

public ScriptType getOutputScriptType()

Get the type of output script that will be used for sending to the address. This is either ScriptType.P2PKH or ScriptType.P2SH.

Specified by:

getOutputScriptType in interface Address

Returns:

type of output script

getParametersFromAddress

@Deprecated
public static NetworkParameters getParametersFromAddress(String address)
                                                  throws AddressFormatException

Deprecated.

Given an address, examines the version byte and attempts to find a matching NetworkParameters. If you aren't sure which network the address is intended for (eg, it was provided by a user), you can use this to decide if it is compatible with the current wallet.

Returns:

network the address is valid for

Throws:

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

equals

public boolean equals(Object o)

Overrides:

equals in class Object

hashCode

public int hashCode()

Overrides:

hashCode in class Object

toString

public String toString()

Overrides:

toString in class Object

compareTo

public int compareTo(Address o)

Comparison field order for addresses is:

1. Network.id()
2. Legacy vs. Segwit
3. (Legacy only) Version byte
4. remaining bytes

Implementations use Address.PARTIAL_ADDRESS_COMPARATOR for tests 1 and 2.

Specified by:

compareTo in interface Address

Specified by:

compareTo in interface Comparable<Address>

Parameters:

o - other Address object

Returns:

comparison result