Struct PrivateKey 

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

A Schnorr private key over the ECgFp5 scalar field.

The wrapped Scalar is canonical (< n). Intentionally non-Copy so the type cannot be silently duplicated past a future Drop/zeroize owner; the Debug impl is redacted so accidental logging cannot leak the secret limbs. Memory zeroization of secret material is deferred to the live signing wire-up (Phase G), where the long-lived key store will own the PrivateKey and apply zeroize on drop.

Implementations

impl PrivateKey

pub fn from_scalar(s: Scalar) -> Self

Wrap a canonical scalar as a private key. The caller is responsible for ensuring s is canonical and uniformly random in 1..n.

pub fn from_le_bytes_reduce(bytes: [u8; 40]) -> Self

Decode a private key from 40 little-endian bytes, reducing modulo the group order if necessary (matching the Go reference’s scalar decoder).

pub fn as_scalar(&self) -> Scalar

Borrow the underlying canonical scalar.

pub fn to_le_bytes(&self) -> [u8; 40]

Canonical 40-byte little-endian encoding of the private scalar.

pub fn public_key(&self) -> PublicKey

Derive the matching public key as pk = (sk * G).encode().

Routes through the constant-time scalar mul so the secret scalar’s limbs do not leak via timing.

pub fn sign(&self, hashed_msg: Fp5, k: Scalar) -> Signature

Sign a pre-hashed message under the supplied per-signature nonce k.

hashed_msg is the Fp5 digest produced by the caller (typically via crate::signing::hash::hash_to_quintic_extension over the message field elements, or via crate::signing::tx::sign_tx which folds the body and attribute hashes). k MUST be drawn uniformly at random from a cryptographic RNG, MUST NOT be zero (a zero nonce trivially reveals sk from the resulting signature), and MUST NOT repeat across distinct signatures under the same key (a repeated nonce reveals sk from any two signatures sharing it). Matching the Go reference SchnorrSignHashedMessage2, the caller-contract is enforced by the caller — no runtime k != 0 check is performed inside sign.

Trait Implementations

impl Clone for PrivateKey

fn clone(&self) -> PrivateKey

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for PrivateKey

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

Formats the value using the given formatter.