Struct PublicKey 

pub struct PublicKey { /* private fields */ }

Public key for verifying Chio signatures.

Internally this is a sum over the supported SigningAlgorithms. The common case (Ed25519) preserves the historical 32-byte encoding and bare hex serialization. Non-Ed25519 variants use a self-describing hex prefix (p256:<hex> / p384:<hex>) so the wire format unambiguously identifies the algorithm without a separate envelope field.

Implementations

impl PublicKey

pub fn from_bytes(bytes: &[u8; 32]) -> Result<PublicKey, Error>

Create from raw bytes (32 bytes). Produces an Ed25519 key.

pub fn from_p256_sec1(bytes: &[u8]) -> Result<PublicKey, Error>

Create a P-256 public key from uncompressed SEC1-encoded bytes (65 bytes beginning with 0x04).

The bytes are validated only for length and leading-byte format; full curve-point validation is delegated to the verifier at first use.

pub fn from_p384_sec1(bytes: &[u8]) -> Result<PublicKey, Error>

Create a P-384 public key from uncompressed SEC1-encoded bytes (97 bytes beginning with 0x04).

pub fn from_hex(hex_str: &str) -> Result<PublicKey, Error>

Create from hex-encoded bytes (with optional 0x prefix).

The string may carry a p256: or p384: prefix to select an ECDSA key. A bare hex string is interpreted as Ed25519 for backward compatibility with existing artifacts.

pub fn algorithm(&self) -> SigningAlgorithm

Which algorithm this public key belongs to.

pub fn verify(&self, message: &[u8], signature: &Signature) -> bool

Verify a signature against a message.

Returns false when algorithms differ between key and signature, or when the cryptographic check fails. Never panics.

pub fn verify_canonical<T>( &self, value: &T, signature: &Signature, ) -> Result<bool, Error>

where T: Serialize,

Verify a signature over the canonical JSON form of a serializable value.

pub fn to_hex(&self) -> String

Hex encoding, with algorithm prefix for non-Ed25519 keys.

Ed25519 keys render as a bare 64-character lowercase hex string, byte-identical to the historical format. P-256 keys render as p256:<130-char hex> (uncompressed SEC1). P-384 keys render as p384:<194-char hex>.

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

Raw 32-byte Ed25519 representation.

This accessor is intentionally Ed25519-only. Non-Ed25519 callers must use Self::to_hex or another algorithm-aware representation instead of coercing P-256 / P-384 material into a lossy 32-byte placeholder.

Panics

Panics when called on a non-Ed25519 key so Ed25519-only consumers fail closed instead of silently collapsing distinct keys onto the same bytes.

Trait Implementations

impl Clone for PublicKey

fn clone(&self) -> PublicKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PublicKey

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for PublicKey

fn deserialize<D>( deserializer: D, ) -> Result<PublicKey, <D as Deserializer<'de>>::Error>

where D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl PartialEq for PublicKey

fn eq(&self, other: &PublicKey) -> 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 Serialize for PublicKey

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

where S: Serializer,

Serialize this value into the given Serde serializer.

impl Eq for PublicKey