Package convex.core.data

Class AccountKey

java.lang.Object

convex.core.data.AObject

convex.core.data.ACell

convex.core.data.ACountable<T>

convex.core.data.ABlobLike<CVMLong>

convex.core.data.ABlob

convex.core.data.AArrayBlob

convex.core.data.AccountKey

All Implemented Interfaces:

IValidated, IWriteable, Comparable<ABlob>

public class AccountKey
extends AArrayBlob

Immutable class representing an Ed25519 Public Key for an Account

Using Ed25519:

• AccountKey is the Public Key (32 bytes)

Field Summary

Fields

Modifier and Type	Field	Description
static final int	LENGTH
static final int	LENGTH_BITS

Fields inherited from class convex.core.data.AArrayBlob

length, offset, store

Fields inherited from class convex.core.data.ABlob

contentHash

Fields inherited from class convex.core.data.ACell

cachedRef, EMPTY_ARRAY

Fields inherited from class convex.core.data.AObject

encoding

Method Summary

Modifier and Type	Method	Description
protected long	calcMemorySize()	Calculates the Memory Size for this Cell.
static AccountKey	create(ABlob b)	Creates an AccountKey from a blob.
protected <R extends ACell> Ref<R>	createRef()	Creates a new Ref for this Cell
static AccountKey	dummy(String nonce)	Creates a "Dummy" Address that is not a valid public key, and therefore cannot have valid signed transactions.
int	encode(byte[] bs, int pos)	Writes this Cell's encoding to a byte array, including a tag byte which will be written first.
boolean	equals(AccountKey o)
int	estimatedEncodingSize()	Estimate the encoded data size for this Cell.
static AccountKey	fromChecksumHex(String hexString)	Constructs an AccountKey object from a checksummed hex string.
static AccountKey	fromHex(String hexString)	Constructs an AccountKey object from a hex string.
static AccountKey	fromHexOrNull(AString a)
static AccountKey	fromHexOrNull(String hexString)	Constructs an AccountKey object from a hex string
Blob	getChunk(long i)	Gets a chunk of this Blob, as a canonical Blob up to the maximum chunk size.
int	getEncodingLength()	Method to calculate the encoding length of a Cell.
boolean	isCanonical()	Returns true if this Cell is in a canonical representation for message writing.
boolean	isEmbedded()	Determines if this Cell Represents an embedded object.
static AccountKey	parse(Object o)	Attempts to parse an account key on best efforts basis.
static AccountKey	parse(String s)	Attempts to parse account key.
static AccountKey	readRaw(Blob b, int pos)
static AccountKey	readRaw(ByteBuffer data)
Blob	toCanonical()	Converts this Cell to its canonical version.
String	toChecksumHex()	Converts this AccountKey to a checksummed hex string.
void	validateCell()	Validates the local structure and invariants of this cell.
static AccountKey	wrap(byte[] data)	Wraps the specified bytes as an AccountKey object.
static AccountKey	wrap(byte[] data, int offset)	Wraps the specified bytes as an AccountKey object.

Methods inherited from class convex.core.data.AArrayBlob

append, appendHex, appendSmall, byteAt, byteAtUnchecked, commonHexPrefixLength, compareTo, compareTo, count, encodeRaw, equals, equalsBytes, equalsBytes, getByteBuffer, getBytes, getHexDigit, getInternalArray, getInternalOffset, getRefCount, getTag, hexMatches, hexMatchLength, longAt, longValue, rangeMatches, rangeMatches, shortAt, slice, toExactLong, toFlatBlob, updateDigest, validate

Methods inherited from class convex.core.data.ABlob

computeHash, empty, equals, get, getContentHash, getElementRef, getType, hashCode, hexEquals, hexEquals, hexLength, isCVMValue, isRegularBlob, print, slice, toByteBuffer, toHexString, toHexString

Methods inherited from class convex.core.data.ABlobLike

getBytes

Methods inherited from class convex.core.data.ACountable

isEmpty, size

Methods inherited from class convex.core.data.ACell

announce, announce, attachMemorySize, attachRef, cachedEncoding, cachedHash, createAnnounced, createEncoding, createPersisted, createPersisted, equals, getCanonical, getChildRefs, getEncoding, getHash, getMemorySize, getRef, getRef, isCompletelyEncoded, mark, mark, toCVMString, toString, updateRefs

Methods inherited from class convex.core.data.AObject

attachEncoding, print, print

Methods inherited from class java.lang.Object

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

Field Details

LENGTH

public static final int LENGTH

See Also:

• Constant Field Values

LENGTH_BITS

public static final int LENGTH_BITS

See Also:

• Constant Field Values

Method Details

createRef

protected <R extends ACell> Ref<R> createRef()

Description copied from class: ACell

Creates a new Ref for this Cell

Overrides:

createRef in class ACell

Type Parameters:

R - Type of Cell

Returns:

New Ref instance

wrap

public static AccountKey wrap(byte[] data)

Wraps the specified bytes as an AccountKey object. Warning: underlying bytes are used directly. Use only if no external references to the byte array will be retained.

Parameters:

data - Byte array to wrap as Account Key

Returns:

An Address wrapping the given bytes

wrap

public static AccountKey wrap(byte[] data,
 int offset)

Wraps the specified bytes as an AccountKey object. Warning: underlying bytes are used directly. Use only if no external references to the byte array will be retained.

Parameters:

data - Data array containing address bytes.

offset - Offset into byte array

Returns:

An Address wrapping the given bytes

create

public static AccountKey create(ABlob b)

Creates an AccountKey from a blob. Must have correct length.

Parameters:

b - Blob to wrap as Account Key

Returns:

AccountKey instance, or null if not valid

dummy

public static AccountKey dummy(String nonce)

Creates a "Dummy" Address that is not a valid public key, and therefore cannot have valid signed transactions. To do this, a short hex nonce is repeated to fill the entire address length. This construction makes it possible to examine an Address and assess whether it is (plausibly) a dummy address.

Parameters:

nonce - Hex string to repeat to produce a visible dummy address

Returns:

An Address that cannot be used to sign transactions.

equals

public boolean equals(AccountKey o)

fromHex

public static AccountKey fromHex(String hexString)

Constructs an AccountKey object from a hex string. Throws an exception if string is not valid

Parameters:

hexString - Hex String

Returns:

An AccountKey constructed from the hex string

parse

public static AccountKey parse(Object o)

Attempts to parse an account key on best efforts basis.

Parameters:

o - Any object expected to represent an Account Key

Returns:

AccountKey instance, or null if not possible to parse

parse

public static AccountKey parse(String s)

Attempts to parse account key. Handles leading/trailing whitespace and optional 0x

Parameters:

s - String containing account key

Returns:

AccountKey, or null if not possible to parse

fromHexOrNull

public static AccountKey fromHexOrNull(String hexString)

Constructs an AccountKey object from a hex string

Parameters:

hexString - Hex String

Returns:

An AccountKey constructed from the hex string, or null if not a valid hex string

fromHexOrNull

public static AccountKey fromHexOrNull(AString a)

fromChecksumHex

public static AccountKey fromChecksumHex(String hexString)

Constructs an AccountKey object from a checksummed hex string. Throws an exception if checksum is not valid

Parameters:

hexString - Hex String

Returns:

An AccountKey constructed from the hex string

toChecksumHex

public String toChecksumHex()

Converts this AccountKey to a checksummed hex string.

Returns:

A String containing the checksummed hex representation of this Address

readRaw

public static AccountKey readRaw(ByteBuffer data)

readRaw

public static AccountKey readRaw(Blob b,
 int pos)

encode

public int encode(byte[] bs,
 int pos)

Description copied from class: ACell

Writes this Cell's encoding to a byte array, including a tag byte which will be written first. Cell must be canonical, or else an error may occur.

Specified by:

encode in interface IWriteable

Specified by:

encode in class ACell

Parameters:

bs - A byte array to which to write the encoding

pos - The offset into the byte array

Returns:

New position after writing

estimatedEncodingSize

public int estimatedEncodingSize()

Description copied from interface: IWriteable

Estimate the encoded data size for this Cell. Used for quickly sizing buffers. Implementations should try to return a size that is highly likely to contain the entire object when encoded, including the tag byte. Should not traverse soft Refs, i.e. must be usable on arbitrary partial data structures

Returns:

The estimated size for the binary representation of this object.

getEncodingLength

public int getEncodingLength()

Description copied from class: ACell

Method to calculate the encoding length of a Cell. May be overridden to avoid creating encodings during memory size calculations. This reduces hashing!

Overrides:

getEncodingLength in class ACell

Returns:

Exact encoding length of this Cell

getChunk

public Blob getChunk(long i)

Description copied from class: ABlob

Gets a chunk of this Blob, as a canonical Blob up to the maximum chunk size. Returns empty Blob if and only if referencing the end of a Blob with fully packed chunks

Specified by:

getChunk in class ABlob

Parameters:

i - Index of chunk

Returns:

A Blob containing the specified chunk data.

validateCell

public void validateCell()
                  throws InvalidDataException

Description copied from class: ACell

Validates the local structure and invariants of this cell. Called by validate() super implementation. Should validate directly contained data, but should not validate all other structure of this cell. In particular, should not traverse potentially missing child Refs.

Overrides:

validateCell in class AArrayBlob

Throws:

InvalidDataException - If the Cell is invalid

isEmbedded

public boolean isEmbedded()

Description copied from class: ACell

Determines if this Cell Represents an embedded object. Embedded objects are encoded directly into the encoding of the containing Cell (avoiding the need for a hashed reference). Subclasses should override this if they have a cheap O(1) way to determine if they are embedded or otherwise.

Overrides:

isEmbedded in class ACell

Returns:

true if Cell is embedded, false otherwise

calcMemorySize

protected long calcMemorySize()

Description copied from class: ACell

Calculates the Memory Size for this Cell. Requires any child Refs to be either Direct or of persisted status at minimum, or you might get a MissingDataException

Overrides:

calcMemorySize in class ACell

Returns:

Memory Size of this Cell

isCanonical

public boolean isCanonical()

Description copied from class: ACell

Returns true if this Cell is in a canonical representation for message writing. Non-canonical objects may be used on a temporary internal basis, they must always be converted to canonical representations for external use (e.g. Encoding).

Specified by:

isCanonical in class ACell

Returns:

true if the object is in canonical format, false otherwise

toCanonical

public Blob toCanonical()

Description copied from class: ACell

Converts this Cell to its canonical version. Must return this Cell if already canonical, may be O(n) in size of value otherwise.

Specified by:

toCanonical in class ABlob

Returns:

Canonical version of Cell