crypto

Documentation

Index

• Constants
• Variables
• func CalculateSharedKey(priv PrivateKey, pub PublicKey) ([]byte, error)
• func GenerateTLSCertificate(privateKey PrivateKey) (*tls.Certificate, error)
• type KeyAlgorithm
• type KeyUsage
• type PrivateKey
  • func CalculateEphemeralSharedKey(pub PublicKey) (PrivateKey, []byte, error)
  • func NewEd25519PrivateKey(keyType KeyUsage) (PrivateKey, error)
  • func NewEd25519PrivateKeyFromSeed(seed []byte, keyType KeyUsage) PrivateKey
  • func NewSharedKey(priv PrivateKey, pub PublicKey) (PrivateKey, []byte, error)
  • func (k PrivateKey) IsEmpty() bool
  • func (k PrivateKey) MarshalJSON() ([]byte, error)
  • func (k PrivateKey) MarshalString() (string, error)
  • func (k PrivateKey) MarshalText() ([]byte, error)
  • func (k PrivateKey) PublicKey() PublicKey
  • func (k PrivateKey) Sign(message []byte) []byte
  • func (k PrivateKey) String() string
  • func (k *PrivateKey) UnmarshalJSON(s []byte) error
  • func (k *PrivateKey) UnmarshalString(s string) error
  • func (k *PrivateKey) UnmarshalText(s []byte) error
• type PublicKey
  • func NewEd25519PublicKeyFromRaw(raw ed25519.PublicKey, keyType KeyUsage) PublicKey
  • func (k PublicKey) Equals(w PublicKey) bool
  • func (k PublicKey) IsEmpty() bool
  • func (k PublicKey) MarshalJSON() ([]byte, error)
  • func (k PublicKey) MarshalString() (string, error)
  • func (k PublicKey) MarshalText() ([]byte, error)
  • func (k PublicKey) String() string
  • func (k *PublicKey) UnmarshalJSON(s []byte) error
  • func (k *PublicKey) UnmarshalString(s string) error
  • func (k *PublicKey) UnmarshalText(s []byte) error
  • func (k PublicKey) Verify(message []byte, signature []byte) error

Constants

const (
	// P256 curve
	P256 string = "P-256"
	// P384 curve
	P384 string = "P-384"
	// P521 curve
	P521 string = "P-521"
)

const (
	ErrUnsupportedKeyAlgorithm = errors.Error("key algorithm not supported")
	ErrInvalidSignature        = errors.Error("invalid signature")
)

const (
	Ed25519Private KeyAlgorithm = 0x1300 // well known value
	Ed25519Public  KeyAlgorithm = 0xED   // well known value

	PeerKey     KeyUsage = 0x6E00 // codec code for nimona _peer_ key
	IdentityKey KeyUsage = 0x6E01 // codec code for nimona _identity_ key
)

Variables

var (
	EmptyPublicKey  = PublicKey{}
	EmptyPrivateKey = PrivateKey{}
)

Functions

func CalculateSharedKey

func CalculateSharedKey(
	priv PrivateKey,
	pub PublicKey,
) ([]byte, error)

CalculateSharedKey calculates a shared secret given a private an public key

func GenerateTLSCertificate

func GenerateTLSCertificate(privateKey PrivateKey) (*tls.Certificate, error)

GenerateTLSCertificate for TLS serverset

Types

type KeyAlgorithm

type KeyAlgorithm uint64

type KeyUsage

type KeyUsage uint64

type PrivateKey

type PrivateKey struct {
	Usage     KeyUsage
	Algorithm KeyAlgorithm
	RawKey    ed25519.PrivateKey
}

func CalculateEphemeralSharedKey

func CalculateEphemeralSharedKey(
	pub PublicKey,
) (PrivateKey, []byte, error)

CalculateEphemeralSharedKey creates a new ec25519 key pair, calculates a shared secret given a public key, and returns the created public key and secret

func NewEd25519PrivateKey

func NewEd25519PrivateKey(keyType KeyUsage) (PrivateKey, error)

func NewEd25519PrivateKeyFromSeed

func NewEd25519PrivateKeyFromSeed(
	seed []byte,
	keyType KeyUsage,
) PrivateKey

func NewSharedKey

func NewSharedKey(
	priv PrivateKey,
	pub PublicKey,
) (PrivateKey, []byte, error)

NewSharedKey calculates a shared secret given a private and a public key, and returns it

func (PrivateKey) IsEmpty

func (k PrivateKey) IsEmpty() bool

func (PrivateKey) MarshalJSON

func (k PrivateKey) MarshalJSON() ([]byte, error)

func (PrivateKey) MarshalString

func (k PrivateKey) MarshalString() (string, error)

func (PrivateKey) MarshalText

func (k PrivateKey) MarshalText() ([]byte, error)

func (PrivateKey) PublicKey

func (k PrivateKey) PublicKey() PublicKey

func (PrivateKey) Sign

func (k PrivateKey) Sign(message []byte) []byte

func (PrivateKey) String

func (k PrivateKey) String() string

func (*PrivateKey) UnmarshalJSON

func (k *PrivateKey) UnmarshalJSON(s []byte) error

func (*PrivateKey) UnmarshalString

func (k *PrivateKey) UnmarshalString(s string) error

func (*PrivateKey) UnmarshalText

func (k *PrivateKey) UnmarshalText(s []byte) error

type PublicKey

type PublicKey struct {
	Usage     KeyUsage
	Algorithm KeyAlgorithm
	RawKey    ed25519.PublicKey
}

func NewEd25519PublicKeyFromRaw

func NewEd25519PublicKeyFromRaw(
	raw ed25519.PublicKey,
	keyType KeyUsage,
) PublicKey

func (PublicKey) Equals

func (k PublicKey) Equals(w PublicKey) bool

func (PublicKey) IsEmpty

func (k PublicKey) IsEmpty() bool

func (PublicKey) MarshalJSON

func (k PublicKey) MarshalJSON() ([]byte, error)

func (PublicKey) MarshalString

func (k PublicKey) MarshalString() (string, error)

func (PublicKey) MarshalText

func (k PublicKey) MarshalText() ([]byte, error)

func (PublicKey) String

func (k PublicKey) String() string

func (*PublicKey) UnmarshalJSON

func (k *PublicKey) UnmarshalJSON(s []byte) error

func (*PublicKey) UnmarshalString

func (k *PublicKey) UnmarshalString(s string) error

func (*PublicKey) UnmarshalText

func (k *PublicKey) UnmarshalText(s []byte) error

func (PublicKey) Verify

func (k PublicKey) Verify(message []byte, signature []byte) error