Class SymmetricKey

An AES-GCM symmetric key. Unlike PrivateKey and PublicKey that are involved in an asymmetric key cryptography, it uses the same SymmetricKey for both encrypting a plaintext and decrypting a ciphertext.

Inheritance
System.Object
SymmetricKey
Namespace: Libplanet.Crypto
Assembly: Libplanet.Crypto.dll
Syntax
public class SymmetricKey : IEquatable<SymmetricKey>

Constructors

| Improve this Doc View Source

SymmetricKey(Byte[])

Creates a SymmetricKey instance from the given array (i.e., key), which encodes a valid AES-GCM symmetric key.

Declaration
public SymmetricKey(byte[] key)
Parameters
Type Name Description
System.Byte[] key

A valid array that encodes an AES-GCM symmetric key.
Remarks

A valid array for a SymmetricKey can be encoded using ToByteArray() method.

See Also

Properties

| Improve this Doc View Source

ByteArray

An immutable array encoding of this key.

Declaration
public ImmutableArray<byte> ByteArray { get; }
Property Value
Type Description
ImmutableArray<System.Byte>
Remarks

This is immutable. For a mutable array, call ToByteArray() method.

See Also

Methods

| Improve this Doc View Source

Decrypt(Byte[], Int32)

Converts a ciphertext which was encrypted with the same key to the plain message.

Declaration
public byte[] Decrypt(byte[] ciphertext, int nonSecretLength = 0)
Parameters
Type Name Description
System.Byte[] ciphertext

The encrypted data.
System.Int32 nonSecretLength

The length of nonSecret data. (See also Encrypt(Byte[], Byte[]) method's the second parameter, which is optional.) 0 by default.
Returns
Type Description
System.Byte[]

The plain data the ciphertext encrypted. It returns null if the ciphertext is invalid (this behavior will be eventually changed in the future to throw an exception instead).
Remarks

Although the parameter name ciphertext has the word “text”, both a ciphertext and a returned message are a string, not a Unicode .

See Also
| Improve this Doc View Source

Encrypt(Byte[], Byte[])

Converts a plain message to a ciphertext which can be decrypted with the same key.

Declaration
public byte[] Encrypt(byte[] message, byte[] nonSecret = null)
Parameters
Type Name Description
System.Byte[] message

A binary data to be encrypted.
System.Byte[] nonSecret

An extra data not to be encrypted, but to be just transmitted as is. The default value is null, which means empty.
Returns
Type Description
System.Byte[]

A ciphertext that was encrypted from the message and can be decrypted with the same key. (Although the word “ciphertext” has the word “text”, a returned ciphertext is not a Unicode , but a array.)
See Also
| Improve this Doc View Source

Equals(SymmetricKey)

An AES-GCM symmetric key. Unlike PrivateKey and PublicKey that are involved in an asymmetric key cryptography, it uses the same SymmetricKey for both encrypting a plaintext and decrypting a ciphertext.

Declaration
public bool Equals(SymmetricKey other)
Parameters
Type Name Description
SymmetricKey other
Returns
Type Description
System.Boolean
| Improve this Doc View Source

Equals(Nullable<Object>)

An AES-GCM symmetric key. Unlike PrivateKey and PublicKey that are involved in an asymmetric key cryptography, it uses the same SymmetricKey for both encrypting a plaintext and decrypting a ciphertext.

Declaration
public override bool Equals(object? obj)
Parameters
Type Name Description
System.Nullable<System.Object> obj
Returns
Type Description
System.Boolean
| Improve this Doc View Source

GetHashCode()

An AES-GCM symmetric key. Unlike PrivateKey and PublicKey that are involved in an asymmetric key cryptography, it uses the same SymmetricKey for both encrypting a plaintext and decrypting a ciphertext.

Declaration
public override int GetHashCode()
Returns
Type Description
System.Int32
| Improve this Doc View Source

ToByteArray()

Gets a mutable array which encodes this key.

Declaration
public byte[] ToByteArray()
Returns
Type Description
System.Byte[]

A new mutable array which encodes this key. Since it is created every time the method is called, any mutation on that does not affect this SymmetricKey object.
See Also

Operators

| Improve this Doc View Source

Equality(SymmetricKey, SymmetricKey)

An AES-GCM symmetric key. Unlike PrivateKey and PublicKey that are involved in an asymmetric key cryptography, it uses the same SymmetricKey for both encrypting a plaintext and decrypting a ciphertext.

Declaration
public static bool operator ==(SymmetricKey left, SymmetricKey right)
Parameters
Type Name Description
SymmetricKey left
SymmetricKey right
Returns
Type Description
System.Boolean
| Improve this Doc View Source

Inequality(SymmetricKey, SymmetricKey)

An AES-GCM symmetric key. Unlike PrivateKey and PublicKey that are involved in an asymmetric key cryptography, it uses the same SymmetricKey for both encrypting a plaintext and decrypting a ciphertext.

Declaration
public static bool operator !=(SymmetricKey left, SymmetricKey right)
Parameters
Type Name Description
SymmetricKey left
SymmetricKey right
Returns
Type Description
System.Boolean