Struct PublicKey 

pub struct PublicKey(/* private fields */);

A validated age public key.

PublicKey is a thin wrapper around a String that ensures the contained key starts with "age1". The validation is performed at construction time via new, which delegates to validate_age_prefix.

Security

While this type guarantees the "age1" prefix, it does not perform full Bech32 decoding or curve validation. The actual cryptographic checks are left to the age crate when the key is used for encryption.

Examples

use age_setup::PublicKey;

let pk = PublicKey::new("age1mykey".into())?;
println!("Public key: {}", pk);          // uses Display
println!("Exposed value: {}", pk.expose());

Implementations

impl PublicKey

pub fn new(raw: String) -> Result<Self>

Creates a new PublicKey after validating the raw string.

The string must be non‑empty and start with "age1" (case‑sensitive). Validation is performed by [validate_age_prefix].

Errors

Returns Error::Validation if the key does not meet the prefix requirement.

Examples

let valid = PublicKey::new("age1abcdef".into()).unwrap();
assert_eq!(valid.expose(), "age1abcdef");

let invalid = PublicKey::new("not-a-key".into());
assert!(invalid.is_err());

pub fn expose(&self) -> &str

Returns the raw string representation of the public key.

The returned &str is safe to display, share, or use as an age recipient.

Examples

let pk = PublicKey::new("age1test".into()).unwrap();
assert_eq!(pk.expose(), "age1test");

Trait Implementations

impl AsRef<str> for PublicKey

Allows PublicKey to be used where a &str is expected.

fn print_key(key: &impl AsRef<str>) {
    println!("{}", key.as_ref());
}
let pk = PublicKey::new("age1foo".into()).unwrap();
print_key(&pk);

fn as_ref(&self) -> &str

Converts this type into a shared reference of the (usually inferred) input type.

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

Formats the value using the given formatter.

impl Display for PublicKey

The public key is printed in the format age1....

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

Formats the value using the given formatter.