mleku
e0a95ca1cd
- Replaced all instances of p256k1signer with the new p8k.Signer across various modules, including event creation, policy handling, and database interactions. - Updated related test cases and benchmarks to ensure compatibility with the new signer interface. - Bumped version to v0.25.0 to reflect these significant changes and improvements in cryptographic operations.
46 lines
2.1 KiB
Go
46 lines
2.1 KiB
Go
// Package signer defines server for management of signatures, used to
|
|
// abstract the signature algorithm from the usage.
|
|
package signer
|
|
|
|
// I is an interface for a key pair for signing, created to abstract between a CGO fast BIP-340
|
|
// signature library and the slower btcec library.
|
|
type I interface {
|
|
// Generate creates a fresh new key pair from system entropy, and ensures it is even (so
|
|
// ECDH works).
|
|
Generate() (err error)
|
|
// InitSec initialises the secret (signing) key from the raw bytes, and also
|
|
// derives the public key because it can.
|
|
InitSec(sec []byte) (err error)
|
|
// InitPub initializes the public (verification) key from raw bytes, this is
|
|
// expected to be an x-only 32 byte pubkey.
|
|
InitPub(pub []byte) (err error)
|
|
// Sec returns the secret key bytes.
|
|
Sec() []byte
|
|
// Pub returns the public key bytes (x-only schnorr pubkey).
|
|
Pub() []byte
|
|
// Sign creates a signature using the stored secret key.
|
|
Sign(msg []byte) (sig []byte, err error)
|
|
// Verify checks a message hash and signature match the stored public key.
|
|
Verify(msg, sig []byte) (valid bool, err error)
|
|
// Zero wipes the secret key to prevent memory leaks.
|
|
Zero()
|
|
// ECDH returns a shared secret derived using Elliptic Curve Diffie-Hellman on
|
|
// the I secret and provided pubkey. Returns the 32-byte x-coordinate of the shared point.
|
|
ECDH(pub []byte) (secret []byte, err error)
|
|
// ECDHRaw returns the raw shared secret point (x-coordinate only, 32 bytes) without hashing.
|
|
// This is needed for protocols like NIP-44 that do their own key derivation.
|
|
ECDHRaw(pub []byte) (sharedX []byte, err error)
|
|
}
|
|
|
|
// Gen is an interface for nostr BIP-340 key generation.
|
|
type Gen interface {
|
|
// Generate gathers entropy and derives pubkey bytes for matching, this returns the 33 byte
|
|
// compressed form for checking the oddness of the Y coordinate.
|
|
Generate() (pubBytes []byte, err error)
|
|
// Negate flips the public key Y coordinate between odd and even.
|
|
Negate()
|
|
// KeyPairBytes returns the raw bytes of the secret and public key, this returns the 32 byte
|
|
// X-only pubkey.
|
|
KeyPairBytes() (secBytes, cmprPubBytes []byte)
|
|
}
|