Struct sapio_secp256k1::SecretKey
source · [−]pub struct SecretKey(_);
Expand description
Secret 256-bit key used as x
in an ECDSA signature.
Examples
Basic usage:
use secp256k1::{rand, Secp256k1, SecretKey};
let secp = Secp256k1::new();
let secret_key = SecretKey::new(&mut rand::thread_rng());
Implementations
sourceimpl SecretKey
impl SecretKey
sourcepub fn display_secret(&self) -> DisplaySecret
pub fn display_secret(&self) -> DisplaySecret
Formats the explicit byte value of the secret key kept inside the type as a little-endian hexadecimal string using the provided formatter.
This is the only method that outputs the actual secret key value, and, thus, should be used with extreme caution.
Examples
let key = secp256k1::ONE_KEY;
// Normal debug hides value (`Display` is not implemented for `SecretKey`).
// E.g., `format!("{:?}", key)` prints "SecretKey(#2518682f7819fb2d)".
// Here we explicitly display the secret value:
assert_eq!(
"0000000000000000000000000000000000000000000000000000000000000001",
format!("{}", key.display_secret())
);
// Also, we can explicitly display with `Debug`:
assert_eq!(
format!("{:?}", key.display_secret()),
format!("DisplaySecret(\"{}\")", key.display_secret())
);
sourceimpl SecretKey
impl SecretKey
sourcepub fn as_mut_ptr(&mut self) -> *mut u8
pub fn as_mut_ptr(&mut self) -> *mut u8
Converts the object to a mutable raw pointer for FFI interfacing
sourceimpl SecretKey
impl SecretKey
sourcepub fn new<R: Rng + ?Sized>(rng: &mut R) -> SecretKey
Available on crate feature rand
only.
pub fn new<R: Rng + ?Sized>(rng: &mut R) -> SecretKey
rand
only.Generates a new random secret key.
Examples
use secp256k1::{rand, SecretKey};
let secret_key = SecretKey::new(&mut rand::thread_rng());
sourcepub fn from_slice(data: &[u8]) -> Result<SecretKey, Error>
pub fn from_slice(data: &[u8]) -> Result<SecretKey, Error>
Converts a SECRET_KEY_SIZE
-byte slice to a secret key.
Examples
use secp256k1::SecretKey;
let sk = SecretKey::from_slice(&[0xcd; 32]).expect("32 bytes, within curve order");
sourcepub fn from_keypair(keypair: &KeyPair) -> Self
pub fn from_keypair(keypair: &KeyPair) -> Self
sourcepub fn secret_bytes(&self) -> [u8; 32]
pub fn secret_bytes(&self) -> [u8; 32]
Returns the secret key as a byte value.
sourcepub fn negate_assign(&mut self)
pub fn negate_assign(&mut self)
Negates one secret key.
sourcepub fn add_assign(&mut self, other: &[u8]) -> Result<(), Error>
pub fn add_assign(&mut self, other: &[u8]) -> Result<(), Error>
Adds one secret key to another, modulo the curve order.
Errors
Returns an error if the resulting key would be invalid or if the tweak was not a 32-byte length slice.
sourcepub fn mul_assign(&mut self, other: &[u8]) -> Result<(), Error>
pub fn mul_assign(&mut self, other: &[u8]) -> Result<(), Error>
Multiplies one secret key by another, modulo the curve order. Will return an error if the resulting key would be invalid or if the tweak was not a 32-byte length slice.
sourcepub fn sign_ecdsa(&self, msg: Message) -> Signature
Available on crate feature global-context
only.
pub fn sign_ecdsa(&self, msg: Message) -> Signature
global-context
only.Constructs an ECDSA signature for msg
using the global SECP256K1
context.
Trait Implementations
sourceimpl<'de> Deserialize<'de> for SecretKey
Available on crate feature serde
only.
impl<'de> Deserialize<'de> for SecretKey
serde
only.sourcefn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error>
fn deserialize<D: Deserializer<'de>>(d: D) -> Result<Self, D::Error>
Deserialize this value from the given Serde deserializer. Read more
sourceimpl Ord for SecretKey
impl Ord for SecretKey
sourceimpl PartialOrd<SecretKey> for SecretKey
impl PartialOrd<SecretKey> for SecretKey
sourcefn partial_cmp(&self, other: &SecretKey) -> Option<Ordering>
fn partial_cmp(&self, other: &SecretKey) -> Option<Ordering>
This method returns an ordering between self
and other
values if one exists. Read more
1.0.0 · sourcefn lt(&self, other: &Rhs) -> bool
fn lt(&self, other: &Rhs) -> bool
This method tests less than (for self
and other
) and is used by the <
operator. Read more
1.0.0 · sourcefn le(&self, other: &Rhs) -> bool
fn le(&self, other: &Rhs) -> bool
This method tests less than or equal to (for self
and other
) and is used by the <=
operator. Read more
impl Copy for SecretKey
impl Eq for SecretKey
Auto Trait Implementations
impl RefUnwindSafe for SecretKey
impl Send for SecretKey
impl Sync for SecretKey
impl Unpin for SecretKey
impl UnwindSafe for SecretKey
Blanket Implementations
sourceimpl<T> BorrowMut<T> for T where
T: ?Sized,
impl<T> BorrowMut<T> for T where
T: ?Sized,
const: unstable · sourcefn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
sourceimpl<T> ToOwned for T where
T: Clone,
impl<T> ToOwned for T where
T: Clone,
type Owned = T
type Owned = T
The resulting type after obtaining ownership.
sourcefn clone_into(&self, target: &mut T)
fn clone_into(&self, target: &mut T)
toowned_clone_into
)Uses borrowed data to replace owned data, usually by cloning. Read more