Struct PublicKey 

pub struct PublicKey { /* private fields */ }

A secp256k1 public key (a point on the curve).

Uses composition with Point, following Rust conventions. The TS SDK uses class inheritance (PublicKey extends Point); we mirror the public API names.

Implementations

impl PublicKey

pub fn from_point(point: Point) -> Self

Create a PublicKey from a Point.

pub fn from_private_key(key: &PrivateKey) -> Self

Derive a public key from a private key.

pub fn from_string(s: &str) -> Result<Self, PrimitivesError>

Parse a public key from a hex string (compressed or uncompressed DER).

Compressed: 33 bytes (66 hex chars), starts with 02 or 03 Uncompressed: 65 bytes (130 hex chars), starts with 04

pub fn from_der_bytes(bytes: &[u8]) -> Result<Self, PrimitivesError>

Parse a public key from DER-encoded bytes.

pub fn to_der(&self) -> Vec<u8>

Encode the public key in compressed DER format (33 bytes).

Format: prefix(1) || x(32) prefix = 0x02 if y is even, 0x03 if y is odd

pub fn to_der_hex(&self) -> String

Encode the public key in compressed DER format as a hex string.

pub fn to_der_uncompressed(&self) -> Vec<u8>

Encode the public key in uncompressed DER format (65 bytes).

Format: 0x04 || x(32) || y(32)

pub fn to_hash(&self) -> Vec<u8>

Hash the compressed public key with hash160 (RIPEMD-160(SHA-256)).

Returns 20 bytes – the public key hash used in P2PKH addresses.

pub fn to_address(&self, prefix: &[u8]) -> String

Derive a P2PKH Bitcoin address from this public key.

Format: Base58Check(prefix || hash160(compressed_der)) Default prefix [0x00] for mainnet.

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

Verify a message signature using this public key.

The message is hashed with SHA-256 before verification.

pub fn derive_shared_secret( &self, private_key: &PrivateKey, ) -> Result<Point, PrimitivesError>

Compute ECDH shared secret: private_key.bn * self.point.

Returns the resulting point on the curve.

pub fn derive_child( &self, private_key: &PrivateKey, invoice_number: &str, ) -> Result<PublicKey, PrimitivesError>

Derive a child public key using Type-42 key derivation (BRC-42).

Computes: child_point = self.point + G * HMAC-SHA256(shared_secret_compressed, invoice_number) where shared_secret = private_key * self.

pub fn point(&self) -> &Point

Access the underlying Point.

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

Formats the value using the given formatter.

impl PartialEq for PublicKey

fn eq(&self, other: &Self) -> 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.