Struct PublicKey

pub struct PublicKey<G: Group> { /* private fields */ }

Public key for ElGamal encryption and related protocols.

Implementation details

We store both the original bytes (which are used in zero-knowledge proofs) and its decompression into a Group element. This increases the memory footprint, but speeds up generating / verifying proofs.

Implementations

impl<G: Group> PublicKey<G>

pub fn encrypt<T, R: CryptoRng + RngCore>( &self, value: T, rng: &mut R, ) -> Ciphertext<G>

where G::Scalar: From<T>,

Encrypts a value for this key.

pub fn encrypt_element<R: CryptoRng + RngCore>( &self, value: G::Element, rng: &mut R, ) -> Ciphertext<G>

Encrypts a group element.

pub fn encrypt_zero<R>( &self, rng: &mut R, ) -> (Ciphertext<G>, LogEqualityProof<G>)

where R: CryptoRng + RngCore,

Encrypts zero value and provides a zero-knowledge proof of encryption correctness.

pub fn verify_zero( &self, ciphertext: Ciphertext<G>, proof: &LogEqualityProof<G>, ) -> Result<(), VerificationError>

Verifies that this is an encryption of a zero value.

Errors

Returns an error if the proof does not verify.

pub fn encrypt_bool<R: CryptoRng + RngCore>( &self, value: bool, rng: &mut R, ) -> (Ciphertext<G>, RingProof<G>)

Encrypts a boolean value (0 or 1) and provides a zero-knowledge proof of encryption correctness.

Examples

See Ciphertext docs for an example of usage.

pub fn verify_bool( &self, ciphertext: Ciphertext<G>, proof: &RingProof<G>, ) -> Result<(), VerificationError>

Verifies a proof of encryption correctness of a boolean value, which was presumably obtained via Self::encrypt_bool().

Errors

Returns an error if the proof does not verify.

Examples

See Ciphertext docs for an example of usage.

pub fn encrypt_range<R: CryptoRng + RngCore>( &self, range: &PreparedRange<G>, value: u64, rng: &mut R, ) -> (Ciphertext<G>, RangeProof<G>)

Encrypts value and provides a zero-knowledge proof that it lies in the specified range.

Panics

Panics if value is out of range.

Examples

See Ciphertext docs for an example of usage.

pub fn verify_range( &self, range: &PreparedRange<G>, ciphertext: Ciphertext<G>, proof: &RangeProof<G>, ) -> Result<(), VerificationError>

Verifies proof that ciphertext encrypts a value lying in range.

The proof should be created with a call to Self::encrypt_range() with the same PreparedRange; otherwise, the proof will not verify.

Errors

Returns an error if the proof does not verify.

impl<G: Group> PublicKey<G>

pub fn from_bytes(bytes: &[u8]) -> Result<Self, PublicKeyConversionError>

Deserializes a public key from bytes.

Errors

Returns an error if bytes has invalid byte size, does not represent a valid group element or represents the group identity.

pub fn as_bytes(&self) -> &[u8]

Returns bytes representing the group element corresponding to this key.

pub fn as_element(&self) -> G::Element

Returns the group element equivalent to this key.

Trait Implementations

impl<G: Group> Add for PublicKey<G>

type Output = PublicKey<G>

The resulting type after applying the + operator.

fn add(self, rhs: Self) -> Self

Performs the + operation.

impl<G: Group> Clone for PublicKey<G>

fn clone(&self) -> Self

Returns a copy of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<G: Group> Debug for PublicKey<G>

fn fmt(&self, formatter: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl<'de, G: Group> Deserialize<'de> for PublicKey<G>

fn deserialize<D>(deserializer: D) -> Result<Self, D::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl<G: Group> From<&SecretKey<G>> for PublicKey<G>

fn from(secret_key: &SecretKey<G>) -> Self

Converts to this type from the input type.

impl<G: Group> Mul<&<G as ScalarOps>::Scalar> for PublicKey<G>

type Output = PublicKey<G>

The resulting type after applying the * operator.

fn mul(self, k: &G::Scalar) -> Self

Performs the * operation.

impl<G: Group> Mul<u64> for PublicKey<G>

type Output = PublicKey<G>

The resulting type after applying the * operator.

fn mul(self, k: u64) -> Self

Performs the * operation.

impl<G> PartialEq for PublicKey<G>

where G: Group,

fn eq(&self, other: &Self) -> bool

Tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &Rhs) -> bool

Tests for !=. The default implementation is almost always sufficient, and should not be overridden without very good reason.

impl<G: Group> Serialize for PublicKey<G>

fn serialize<S>(&self, serializer: S) -> Result<S::Ok, S::Error>

where S: Serializer,

Serialize this value into the given Serde serializer.