encryption

README

Code copied from https://github.com/paulmillr/nip44/tree/e7aed61aaf77240ac10c325683eed14b22e7950f/go.

Documentation

Index

• Constants
• Variables
• func ComputeSharedSecret(pkh, skh string) (sharedSecret []byte, err error)
• func Decrypt(b64ciphertextWrapped string, conversationKey []byte) (plaintext string, err error)
• func DecryptNip4(content string, key []byte) (msg []byte, err error)
• func Encrypt(plaintext string, conversationKey []byte, applyOptions ...func(opts *Opts)) (cipherString string, err error)
• func EncryptNip4(msg string, key []byte) (ct []byte, err error)
• func GenerateConversationKey(pkh, skh string) (ck []byte, err error)
• func WithCustomNonce(salt []byte) func(opts *Opts)
• type Opts

Constants

const (
	MinPlaintextSize = 0x0001 // 1b msg => padded to 32b
	MaxPlaintextSize = 0xffff // 65535 (64kb-1) => padded to 64kb
)

Variables

var WithCustomSalt = WithCustomNonce

Deprecated: use WithCustomNonce instead of WithCustomSalt, so the naming is less confusing

Functions

func ComputeSharedSecret

func ComputeSharedSecret(pkh, skh string) (sharedSecret []byte, err error)

ComputeSharedSecret returns a shared secret key used to encrypt messages. The private and public keys should be hex encoded. Uses the Diffie-Hellman key exchange (ECDH) (RFC 4753).

func Decrypt

func Decrypt(b64ciphertextWrapped string, conversationKey []byte) (plaintext string, err error)

func DecryptNip4

func DecryptNip4(content string, key []byte) (msg []byte, err error)

DecryptNip4 decrypts a content string using the shared secret key. The inverse operation to message -> EncryptNip4(message, key).

Deprecated: upgrade to using Decrypt with the NIP-44 algorithm.

func Encrypt

func Encrypt(plaintext string, conversationKey []byte,
	applyOptions ...func(opts *Opts)) (cipherString string,
	err error)

func EncryptNip4

func EncryptNip4(msg string, key []byte) (ct []byte, err error)

EncryptNip4 encrypts message with key using aes-256-cbc. key should be the shared secret generated by ComputeSharedSecret.

Returns: base64(encrypted_bytes) + "?iv=" + base64(initialization_vector).

Deprecated: upgrade to using Decrypt with the NIP-44 algorithm.

func GenerateConversationKey

func GenerateConversationKey(pkh, skh string) (ck []byte, err error)

func WithCustomNonce

func WithCustomNonce(salt []byte) func(opts *Opts)

Types

type Opts

type Opts struct {
	// contains filtered or unexported fields
}