Class PublicKey

A public part of a key pair involved in ECDSA, the digital signature algorithm on which the Libplanet is based. It can be used to verify signatures created with the corresponding PrivateKey and to encrypt messages for someone possessing the corresponding PrivateKey. This can be distributed publicly, hence the name.

Note that it uses secp256k1 as the parameters of the elliptic curve, which is same to Bitcoin and Ethereum. It means public keys generated for Bitcoin/Ethereum can be used by Libplanet-backed games/apps too.

Inheritance

Object

PublicKey

Namespace: Libplanet.Crypto

Assembly: Libplanet.dll

Syntax

public class PublicKey : object

Remarks

Every PublicKey object is immutable.

Constructors

PublicKey(Byte[])

Creates a PublicKey instance from the given array (i.e., publicKey), which encodes a valid ECDSA public key.

Declaration

public PublicKey(byte[] publicKey)

Parameters

Type	Name	Description
Byte[]	publicKey	A valid array that encodes an ECDSA public key. It can be either compressed or not.

Remarks

A valid array for a PublicKey can be encoded using Format(Boolean) method.

See Also

Format(Boolean)

Methods

Encrypt(Byte[])

Converts a plain message to a ciphertext which can be decrypted with the corresponding PrivateKey.

Declaration

public byte[] Encrypt(byte[] message)

Parameters

Type	Name	Description
Byte[]	message	A binary data to be encrypted.

Returns

Type	Description
Byte[]	A ciphertext that was encrypted from the message and can be decrypted with the corresponding PrivateKey. (Although the word “ciphertext” has the word “text”, a returned ciphertext is not a Unicode , but a array.)

See Also

Decrypt(Byte[])

Format(Boolean)

Encodes this public key into a array representation.

Declaration

public byte[] Format(bool compress)

Parameters

Type	Name	Description
Boolean	compress	Returns a short length representation if it is true. This option does not lose any information.

Returns

Type	Description
Byte[]	An encoded array representation. It can recover a PublicKey object again using its constructor (i.e., PublicKey(Byte[])) regardless of compression.

See Also

PublicKey(Byte[])

Verify(Byte[], Byte[])

Verifies whether a signature was created from a message with the corresponding PrivateKey.

Declaration

public bool Verify(byte[] message, byte[] signature)

Parameters

Type	Name	Description
Byte[]	message	A plain message that the signature was created from. That is, a data which was passed as an argument to Sign(Byte[]).
Byte[]	signature	A signature that was created from the message. That is, a data which was returned by Sign(Byte[]).

Returns

Type	Description
Boolean	true if the signature was created from the message with the corresponding PrivateKey. Otherwise false.

Operators

Equality(PublicKey, PublicKey)

Declaration

public static bool operator ==(PublicKey left, PublicKey right)

Parameters

Type	Name	Description
PublicKey	left
PublicKey	right

Returns

Type	Description
Boolean

Inequality(PublicKey, PublicKey)

Declaration

public static bool operator !=(PublicKey left, PublicKey right)

Parameters

Type	Name	Description
PublicKey	left
PublicKey	right

Returns

Type	Description
Boolean

Extension Methods

AddressExtensions.ToAddress(PublicKey)

See Also

PrivateKey

Address