Struct elliptic_curve::public_key::PublicKey

source · [−]

pub struct PublicKey<C> where
    C: Curve + ProjectiveArithmetic,
    FieldBytes<C>: From<Scalar<C>> + for<'r> From<&'r Scalar<C>>,
    Scalar<C>: PrimeField<Repr = FieldBytes<C>>,
    AffinePoint<C>: Copy + Clone + Debug,  { /* private fields */ }

Expand description

Elliptic curve public keys.

This is a wrapper type for AffinePoint which ensures an inner non-identity point and provides a common place to handle encoding/decoding.

Parsing “SPKI” Keys

X.509 SubjectPublicKeyInfo (SPKI) is a commonly used format for encoding public keys, notably public keys corresponding to PKCS#8 private keys. (especially ones generated by OpenSSL).

Keys in SPKI format are either binary (ASN.1 BER/DER), or PEM encoded (ASCII) and begin with the following:

-----BEGIN PUBLIC KEY-----

To decode an elliptic curve public key from SPKI, enable the pkcs8 feature of this crate (or the pkcs8 feature of a specific RustCrypto elliptic curve crate) and use the [elliptic_curve::pkcs8::FromPublicKey][pkcs8::FromPublicKey] trait to parse it.

When the pem feature of this crate (or a specific RustCrypto elliptic curve crate) is enabled, a [FromStr] impl is also available.

Struct elliptic_curve::public_key::PublicKey

Parsing “SPKI” Keys

Implementations

impl<C> PublicKey<C> where C: Curve + ProjectiveArithmetic, FieldBytes<C>: From<Scalar<C>> + for<'r> From<&'r Scalar<C>>, Scalar<C>: PrimeField<Repr = FieldBytes<C>>, AffinePoint<C>: Copy + Clone + Debug, ProjectivePoint<C>: From<AffinePoint<C>>,

pub fn from_affine(point: AffinePoint<C>) -> Result<Self, Error>

pub fn from_secret_scalar(scalar: &NonZeroScalar<C>) -> Self

pub fn from_sec1_bytes(bytes: &[u8]) -> Result<Self, Error> where Self: TryFrom<EncodedPoint<C>, Error = Error>, UntaggedPointSize<C>: Add<U1> + ArrayLength<u8>, UncompressedPointSize<C>: ArrayLength<u8>,

pub fn as_affine(&self) -> &AffinePoint<C>

pub fn to_projective(&self) -> ProjectivePoint<C>

Trait Implementations

fn as_ref(&self) -> &AffinePoint<C>

impl<C: Clone> Clone for PublicKey<C> where C: Curve + ProjectiveArithmetic, FieldBytes<C>: From<Scalar<C>> + for<'r> From<&'r Scalar<C>>, Scalar<C>: PrimeField<Repr = FieldBytes<C>>, AffinePoint<C>: Copy + Clone + Debug,

fn clone(&self) -> PublicKey<C>

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

impl<C: Debug> Debug for PublicKey<C> where C: Curve + ProjectiveArithmetic, FieldBytes<C>: From<Scalar<C>> + for<'r> From<&'r Scalar<C>>, Scalar<C>: PrimeField<Repr = FieldBytes<C>>, AffinePoint<C>: Copy + Clone + Debug,

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

fn from(public_key: &PublicKey<C>) -> EncodedPoint<C>

fn from(public_key: PublicKey<C>) -> EncodedPoint<C>

fn from_encoded_point(encoded_point: &EncodedPoint<C>) -> Option<Self>

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

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

fn to_encoded_point(&self, compress: bool) -> EncodedPoint<C>

type Error = Error

fn try_from(encoded_point: &EncodedPoint<C>) -> Result<Self, Error>

type Error = Error

fn try_from(encoded_point: EncodedPoint<C>) -> Result<Self, Error>

impl<C> Copy for PublicKey<C> where C: Curve + ProjectiveArithmetic, FieldBytes<C>: From<Scalar<C>> + for<'r> From<&'r Scalar<C>>, Scalar<C>: PrimeField<Repr = FieldBytes<C>>, AffinePoint<C>: Copy + Clone + Debug,

Auto Trait Implementations

impl<C> RefUnwindSafe for PublicKey<C> where <<C as ProjectiveArithmetic>::ProjectivePoint as Curve>::AffineRepr: RefUnwindSafe,

impl<C> Send for PublicKey<C> where <<C as ProjectiveArithmetic>::ProjectivePoint as Curve>::AffineRepr: Send,

impl<C> Sync for PublicKey<C> where <<C as ProjectiveArithmetic>::ProjectivePoint as Curve>::AffineRepr: Sync,

impl<C> Unpin for PublicKey<C> where <<C as ProjectiveArithmetic>::ProjectivePoint as Curve>::AffineRepr: Unpin,

impl<C> UnwindSafe for PublicKey<C> where <<C as ProjectiveArithmetic>::ProjectivePoint as Curve>::AffineRepr: UnwindSafe,

Blanket Implementations

impl<T> Any for T where T: 'static + ?Sized,

pub fn type_id(&self) -> TypeId

impl<A, T> AsBits<T> for A where A: AsRef<[T]>, T: BitStore + BitMemory,

pub fn as_bits<O>(&self) -> &BitSlice<O, T> where O: BitOrder,

impl<T> Borrow<T> for T where T: ?Sized,

pub fn borrow(&self) -> &T

impl<T> BorrowMut<T> for T where T: ?Sized,

pub fn borrow_mut(&mut self) -> &mut T

impl<T> Conv for T

fn conv<T>(self) -> T where Self: Into<T>,

impl<T> FmtForward for T

fn fmt_binary(self) -> FmtBinary<Self> where Self: Binary,

fn fmt_display(self) -> FmtDisplay<Self> where Self: Display,

fn fmt_lower_exp(self) -> FmtLowerExp<Self> where Self: LowerExp,

fn fmt_lower_hex(self) -> FmtLowerHex<Self> where Self: LowerHex,

fn fmt_octal(self) -> FmtOctal<Self> where Self: Octal,

fn fmt_pointer(self) -> FmtPointer<Self> where Self: Pointer,

fn fmt_upper_exp(self) -> FmtUpperExp<Self> where Self: UpperExp,

fn fmt_upper_hex(self) -> FmtUpperHex<Self> where Self: UpperHex,

impl<T> From<T> for T

pub fn from(t: T) -> T

impl<T, U> Into<U> for T where U: From<T>,

pub fn into(self) -> U

impl<T> Pipe for T

fn pipe<R>(self, func: impl FnOnce(Self) -> R) -> R

impl<T> PipeAsRef for T

fn pipe_as_ref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R where Self: AsRef<T>, T: 'a, R: 'a,

fn pipe_as_mut<'a, T, R>(&'a mut self, func: impl FnOnce(&'a mut T) -> R) -> R where Self: AsMut<T>, T: 'a, R: 'a,

impl<T> PipeBorrow for T

fn pipe_borrow<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R where Self: Borrow<T>, T: 'a, R: 'a,

fn pipe_borrow_mut<'a, T, R>( &'a mut self, func: impl FnOnce(&'a mut T) -> R) -> R where Self: BorrowMut<T>, T: 'a, R: 'a,

impl<T> PipeDeref for T

fn pipe_deref<'a, R>(&'a self, func: impl FnOnce(&'a Self::Target) -> R) -> R where Self: Deref, R: 'a,

fn pipe_deref_mut<'a, R>( &'a mut self, func: impl FnOnce(&'a mut Self::Target) -> R) -> R where Self: DerefMut, R: 'a,

impl<T> PipeRef for T

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R where R: 'a,

fn pipe_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R where R: 'a,

impl<T> Same<T> for T

type Output = T

impl<T> Tap for T

fn tap<F, R>(self, func: F) -> Self where F: FnOnce(&Self) -> R,

fn tap_dbg<F, R>(self, func: F) -> Self where F: FnOnce(&Self) -> R,

fn tap_mut<F, R>(self, func: F) -> Self where F: FnOnce(&mut Self) -> R,

fn tap_mut_dbg<F, R>(self, func: F) -> Self where F: FnOnce(&mut Self) -> R,

impl<T, U> TapAsRef<U> for T where U: ?Sized,

fn tap_ref<F, R>(self, func: F) -> Self where Self: AsRef<T>, F: FnOnce(&T) -> R,

impl<C> PublicKey<C> where
C: Curve + ProjectiveArithmetic,
FieldBytes<C>: From<Scalar<C>> + for<'r> From<&'r Scalar<C>>,
Scalar<C>: PrimeField<Repr = FieldBytes<C>>,
AffinePoint<C>: Copy + Clone + Debug,
ProjectivePoint<C>: From<AffinePoint<C>>,

pub fn from_sec1_bytes(bytes: &[u8 ]) -> Result<Self, Error> where
Self: TryFrom<EncodedPoint<C>, Error = Error>,
UntaggedPointSize<C>: Add<U1> + ArrayLength<u8>,
UncompressedPointSize<C>: ArrayLength<u8>,

impl<C: Clone> Clone for PublicKey<C> where
C: Curve + ProjectiveArithmetic,
FieldBytes<C>: From<Scalar<C>> + for<'r> From<&'r Scalar<C>>,
Scalar<C>: PrimeField<Repr = FieldBytes<C>>,
AffinePoint<C>: Copy + Clone + Debug,

impl<C: Debug> Debug for PublicKey<C> where
C: Curve + ProjectiveArithmetic,
FieldBytes<C>: From<Scalar<C>> + for<'r> From<&'r Scalar<C>>,
Scalar<C>: PrimeField<Repr = FieldBytes<C>>,
AffinePoint<C>: Copy + Clone + Debug,

impl<C> Copy for PublicKey<C> where
C: Curve + ProjectiveArithmetic,
FieldBytes<C>: From<Scalar<C>> + for<'r> From<&'r Scalar<C>>,
Scalar<C>: PrimeField<Repr = FieldBytes<C>>,
AffinePoint<C>: Copy + Clone + Debug,

impl<C> RefUnwindSafe for PublicKey<C> where
<<C as ProjectiveArithmetic>::ProjectivePoint as Curve>::AffineRepr: RefUnwindSafe,

impl<C> Send for PublicKey<C> where
<<C as ProjectiveArithmetic>::ProjectivePoint as Curve>::AffineRepr: Send,

impl<C> Sync for PublicKey<C> where
<<C as ProjectiveArithmetic>::ProjectivePoint as Curve>::AffineRepr: Sync,

impl<C> Unpin for PublicKey<C> where
<<C as ProjectiveArithmetic>::ProjectivePoint as Curve>::AffineRepr: Unpin,

impl<C> UnwindSafe for PublicKey<C> where
<<C as ProjectiveArithmetic>::ProjectivePoint as Curve>::AffineRepr: UnwindSafe,

impl<T> Any for T where
T: 'static + ?Sized,

impl<A, T> AsBits<T> for A where
A: AsRef<[T]>,
T: BitStore + BitMemory,

pub fn as_bits<O>(&self) -> &BitSlice<O, T> where
O: BitOrder,

impl<T> Borrow<T> for T where
T: ?Sized,

impl<T> BorrowMut<T> for T where
T: ?Sized,

fn conv<T>(self) -> T where
Self: Into<T>,

fn fmt_binary(self) -> FmtBinary<Self> where
Self: Binary,

fn fmt_display(self) -> FmtDisplay<Self> where
Self: Display,

fn fmt_lower_exp(self) -> FmtLowerExp<Self> where
Self: LowerExp,

fn fmt_lower_hex(self) -> FmtLowerHex<Self> where
Self: LowerHex,

fn fmt_octal(self) -> FmtOctal<Self> where
Self: Octal,

fn fmt_pointer(self) -> FmtPointer<Self> where
Self: Pointer,

fn fmt_upper_exp(self) -> FmtUpperExp<Self> where
Self: UpperExp,

fn fmt_upper_hex(self) -> FmtUpperHex<Self> where
Self: UpperHex,

impl<T, U> Into<U> for T where
U: From<T>,

fn pipe_as_ref<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R where
Self: AsRef<T>,
T: 'a,
R: 'a,

fn pipe_as_mut<'a, T, R>(&'a mut self, func: impl FnOnce(&'a mut T) -> R) -> R where
Self: AsMut<T>,
T: 'a,
R: 'a,

fn pipe_borrow<'a, T, R>(&'a self, func: impl FnOnce(&'a T) -> R) -> R where
Self: Borrow<T>,
T: 'a,
R: 'a,

fn pipe_borrow_mut<'a, T, R>(
&'a mut self,
func: impl FnOnce(&'a mut T) -> R
) -> R where
Self: BorrowMut<T>,
T: 'a,
R: 'a,

fn pipe_deref<'a, R>(&'a self, func: impl FnOnce(&'a Self::Target) -> R) -> R where
Self: Deref,
R: 'a,

fn pipe_deref_mut<'a, R>(
&'a mut self,
func: impl FnOnce(&'a mut Self::Target) -> R
) -> R where
Self: DerefMut,
R: 'a,

fn pipe_ref<'a, R>(&'a self, func: impl FnOnce(&'a Self) -> R) -> R where
R: 'a,

fn pipe_mut<'a, R>(&'a mut self, func: impl FnOnce(&'a mut Self) -> R) -> R where
R: 'a,

fn tap<F, R>(self, func: F) -> Self where
F: FnOnce(&Self) -> R,

fn tap_dbg<F, R>(self, func: F) -> Self where
F: FnOnce(&Self) -> R,

fn tap_mut<F, R>(self, func: F) -> Self where
F: FnOnce(&mut Self) -> R,

fn tap_mut_dbg<F, R>(self, func: F) -> Self where
F: FnOnce(&mut Self) -> R,

impl<T, U> TapAsRef<U> for T where
U: ?Sized,

fn tap_ref<F, R>(self, func: F) -> Self where
Self: AsRef<T>,
F: FnOnce(&T) -> R,

fn tap_ref_dbg<F, R>(self, func: F) -> Self where
Self: AsRef<T>,
F: FnOnce(&T) -> R,

fn tap_ref_mut<F, R>(self, func: F) -> Self where
Self: AsMut<T>,
F: FnOnce(&mut T) -> R,

fn tap_ref_mut_dbg<F, R>(self, func: F) -> Self where
Self: AsMut<T>,
F: FnOnce(&mut T) -> R,

impl<T, U> TapBorrow<U> for T where
U: ?Sized,

fn tap_borrow<F, R>(self, func: F) -> Self where
Self: Borrow<T>,
F: FnOnce(&T) -> R,

fn tap_borrow_dbg<F, R>(self, func: F) -> Self where
Self: Borrow<T>,
F: FnOnce(&T) -> R,

fn tap_borrow_mut<F, R>(self, func: F) -> Self where
Self: BorrowMut<T>,
F: FnOnce(&mut T) -> R,

fn tap_borrow_mut_dbg<F, R>(self, func: F) -> Self where
Self: BorrowMut<T>,
F: FnOnce(&mut T) -> R,

fn tap_deref<F, R>(self, func: F) -> Self where
Self: Deref,
F: FnOnce(&Self::Target) -> R,

fn tap_deref_dbg<F, R>(self, func: F) -> Self where
Self: Deref,
F: FnOnce(&Self::Target) -> R,

fn tap_deref_mut<F, R>(self, func: F) -> Self where
Self: DerefMut,
F: FnOnce(&mut Self::Target) -> R,

fn tap_deref_mut_dbg<F, R>(self, func: F) -> Self where
Self: DerefMut,
F: FnOnce(&mut Self::Target) -> R,

fn try_conv<T>(self) -> Result<T, Self::Error> where
Self: TryInto<T>,

impl<T, U> TryFrom<U> for T where
U: Into<T>,

impl<T, U> TryInto<U> for T where
U: TryFrom<T>,