Package convex.core.crypto

Class Ed25519Signature

java.lang.Object

convex.core.data.AObject

convex.core.data.ACell

convex.core.data.ACountable<CVMLong>

convex.core.data.ABlobLike<CVMLong>

convex.core.data.ABlob

convex.core.data.AArrayBlob

convex.core.crypto.ASignature

convex.core.crypto.Ed25519Signature

All Implemented Interfaces:

IValidated, IWriteable, Comparable<ABlobLike<?>>

public class Ed25519Signature
extends ASignature

Immutable data value class representing an Ed25519 digital signature.

Field Summary

Fields

Modifier and Type	Field	Description
static final int	SIGNATURE_LENGTH	Length in bytes of an Ed25519 signature
static final Ed25519Signature	ZERO	A Signature containing zero bytes (not valid)

Fields inherited from class convex.core.data.AArrayBlob

contentHash, offset, store

Fields inherited from class convex.core.data.ABlob

count

Fields inherited from class convex.core.data.ACell

cachedRef, memorySize

Fields inherited from class convex.core.data.AObject

encoding

Constructor Summary

Constructors

Constructor	Description
Ed25519Signature(byte[] data, int pos)

Method Summary

Modifier and Type	Method	Description
int	estimatedEncodingSize()	Estimate the encoded data size for this Cell.
Blob	getChunk(long i)	Gets a chunk of this Blob, as a canonical flat Blob up to the maximum Blob chunk size.
boolean	isCanonical()	Returns true if this Cell is in a canonical representation.
static Ed25519Signature	read(ByteBuffer bb)	Read a signature from a ByteBuffer.
static ASignature	readRaw(Blob b, int pos)
static Ed25519Signature	readRaw(ByteBuffer bb)	Read signature raw data from a ByteBuffer.
Ed25519Signature	toCanonical()	Converts this Cell to a canonical version.
AString	toCVMString(long limit)	Returns the CVM String representation of this Cell.
void	validateCell()	Validates the local structure and invariants of this cell.
boolean	verify(AArrayBlob message, AccountKey publicKey)	Checks if the signature is valid for a given message hash
static Ed25519Signature	wrap(byte[] signature)	Creates a Signature instance with specific bytes
static Ed25519Signature	wrap(byte[] data, int pos)	Creates a Signature instance with specific bytes

Methods inherited from class convex.core.crypto.ASignature

equals, fromBlob, fromHex, isEmbedded

Methods inherited from class convex.core.data.AArrayBlob

append, appendHex, appendSmall, byteAt, byteAtUnchecked, calcMemorySize, compareTo, compareTo, encodeRaw, equalsBytes, equalsBytes, getByteBuffer, getBytes, getContentHash, getHexDigit, getInternalArray, getInternalOffset, getRef, getRefCount, hexMatch, hexMatch, hexMatches, isChunkPacked, isFullyPacked, longAt, longValue, rangeMatches, rangeMatches, read, shortAt, slice, toFlatBlob, updateDigest, updateRefs, validate

Methods inherited from class convex.core.data.ABlob

computeHash, count, empty, encode, equals, get, getElementRef, getTag, getType, hashCode, isCVMValue, print, read, replaceSlice, size, slice, toBlob, toByteBuffer

Methods inherited from class convex.core.data.ABlobLike

getBytes, hexEquals, hexLength, isDataValue, toHexString, toHexString

Methods inherited from class convex.core.data.ACountable

isEmpty

Methods inherited from class convex.core.data.ACell

attachMemorySize, attachRef, cachedEncoding, cachedHash, createEncoding, createRef, equals, genericEquals, getCanonical, getChildRefs, getEncoding, getEncodingLength, getHash, getMemorySize, getMemorySize, getRef, toString

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

SIGNATURE_LENGTH

public static final int SIGNATURE_LENGTH

Length in bytes of an Ed25519 signature

See Also:

• Constant Field Values

ZERO

public static final Ed25519Signature ZERO

A Signature containing zero bytes (not valid)

Constructor Details

Ed25519Signature

public Ed25519Signature(byte[] data,
 int pos)

Method Details

wrap

public static Ed25519Signature wrap(byte[] signature)

Creates a Signature instance with specific bytes

Parameters:

signature - Bytes for signature

Returns:

Signature instance

wrap

public static Ed25519Signature wrap(byte[] data,
 int pos)

Creates a Signature instance with specific bytes

Parameters:

data - Bytes for signature

Returns:

Signature instance

isCanonical

public boolean isCanonical()

Description copied from class: ACell

Returns true if this Cell is in a canonical representation. Non-canonical objects may be used on a temporary internal basis, they should be converted to canonical representations for general purpose use.

Specified by:

isCanonical in class ACell

Returns:

true if the object is in canonical format, false otherwise

toCanonical

public Ed25519Signature toCanonical()

Description copied from class: ACell

Converts this Cell to a canonical version. Must return this Cell if already canonical, may be O(n) in size of value otherwise. Callers should usually use getCanonical(), which caches canonical instances once created

Specified by:

toCanonical in class ABlob

Returns:

Canonical version of Cell

read

public static Ed25519Signature read(ByteBuffer bb)
                             throws BadFormatException

Read a signature from a ByteBuffer. Assumes tag already read.

Parameters:

bb - ByteBuffer to read from

Returns:

Signature instance

Throws:

BadFormatException - If encoding is invalid

readRaw

public static Ed25519Signature readRaw(ByteBuffer bb)
                                throws BadFormatException

Read signature raw data from a ByteBuffer. Assumes tag and count already read if present.

Parameters:

bb - ByteBuffer to read from

Returns:

Signature instance

Throws:

BadFormatException - If encoding is invalid

readRaw

public static ASignature readRaw(Blob b,
 int pos)

toCVMString

public AString toCVMString(long limit)

Description copied from class: ACell

Returns the CVM String representation of this Cell. Normally, this is as printed, but may be different for some types. SHOULD return null in O(1) time if the length of the CVM String can be proved to exceed the limit. MUST complete in O(limit) time and space otherwise The String representation is intended to be a easy-to-read textual representation of the Cell's data content.

Overrides:

toCVMString in class ACell

Parameters:

limit - Limit of CVM String length in UTF-8 bytes

Returns:

CVM String, or null if limit exceeded

verify

public boolean verify(AArrayBlob message,
 AccountKey publicKey)

Description copied from class: ASignature

Checks if the signature is valid for a given message hash

Specified by:

verify in class ASignature

Parameters:

message - Message to verify

publicKey - Public key of signer

Returns:

True if signature is valid, false otherwise

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

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.

getChunk

public Blob getChunk(long i)

Description copied from class: ABlob

Gets a chunk of this Blob, as a canonical flat Blob up to the maximum Blob 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.