Struct nostr_types::PrivateKey

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

This is a private key which is to be kept secret and is used to prove identity

Implementations

impl PrivateKey

pub fn export_encrypted( &self, password: &str, log2_rounds: u8 ) -> Result<EncryptedPrivateKey, Error>

Export in a (non-portable) encrypted form. This does not downgrade the security of the key, but you are responsible to keep it encrypted. You should not attempt to decrypt it, only use import_encrypted() on it, or something similar in another library/client which also respects key security.

This currently exports into EncryptedPrivateKey version 2.

We recommend you zeroize() the password you pass in after you are done with it.

pub fn import_encrypted( encrypted: &EncryptedPrivateKey, password: &str ) -> Result<PrivateKey, Error>

Import an encrypted private key which was exported with export_encrypted().

We recommend you zeroize() the password you pass in after you are done with it.

This is backwards-compatible with keys that were exported with older code.

impl PrivateKey

pub fn shared_secret( &self, other: &PublicKey, algo: ContentEncryptionAlgorithm ) -> [u8; 32]

Get the shared secret

pub fn encrypt( &self, other: &PublicKey, plaintext: &str, algo: ContentEncryptionAlgorithm ) -> Result<String, Error>

Encrypt

pub fn decrypt( &self, other: &PublicKey, ciphertext: &str ) -> Result<String, Error>

Decrypt (detects encryption version)

pub fn decrypt_nip04( &self, other: &PublicKey, ciphertext: &str ) -> Result<Vec<u8>, Error>

Decrypt NIP-04 only

pub fn decrypt_nip44( &self, other: &PublicKey, ciphertext: &str ) -> Result<String, Error>

Decrypt NIP-44 only, version is detected

impl PrivateKey

pub fn new() -> PrivateKey

Generate a new PrivateKey (which can be used to get the PublicKey)

pub fn generate() -> PrivateKey

Generate a new PrivateKey (which can be used to get the PublicKey)

pub fn public_key(&self) -> PublicKey

Get the PublicKey matching this PrivateKey

pub fn key_security(&self) -> KeySecurity

Get the security level of the private key

pub fn as_hex_string(&mut self) -> String

Render into a hexadecimal string

WARNING: This weakens the security of your key. Your key will be marked with KeySecurity::Weak if you execute this.

pub fn try_from_hex_string(v: &str) -> Result<PrivateKey, Error>

Create from a hexadecimal string

This creates a key with KeySecurity::Weak. Use generate() or import_encrypted() for KeySecurity::Medium

pub fn as_bech32_string(&mut self) -> String

Export as a bech32 encoded string

WARNING: This weakens the security of your key. Your key will be marked with KeySecurity::Weak if you execute this.

pub fn try_from_bech32_string(s: &str) -> Result<PrivateKey, Error>

Import from a bech32 encoded string

This creates a key with KeySecurity::Weak. Use generate() or import_encrypted() for KeySecurity::Medium

pub fn as_secret_key(&self) -> SecretKey

As a secp256k1::SecretKey

pub fn sign_id(&self, id: Id) -> Result<Signature, Error>

Sign a 32-bit hash

pub fn sign(&self, message: &[u8]) -> Result<Signature, Error>

Sign a message (this hashes with SHA-256 first internally)

Trait Implementations

impl Default for PrivateKey

fn default() -> Self

Returns the “default value” for a type.

impl Drop for PrivateKey

fn drop(&mut self)

Executes the destructor for this type.