delphi

package module

v0.0.4 Latest Latest Go to latest Published: Nov 2, 2024 License: MIT Imports: 14 Imported by: 6

Details

Valid go.mod file
Redistributable license
Tagged version
Stable version
Learn more about best practices

Repository

github.com/sean9999/go-delphi

Links

Open Source Insights

README ¶

Go Delphi

Delphi provides primitives needed for Oracles to handle cryptic messages.

Documentation ¶

Index ¶

Constants
Variables
func KeyFromBytes(b []byte) key
func NewKey(randy io.Reader) key
func NewKeyPair(randy io.Reader) keyPair
func NewPrincipal(randy io.Reader) *principal
func NewSubKey(randy io.Reader) subKey
type Certifier
type Cipherer
type CryptOpts
type Decrypter
type Encrypter
type EncrypterOpts
type Message
- func NewMessage(randy io.Reader, plainTxt []byte) *Message
- func (msg *Message) Digest(hash hash.Hash) ([]byte, error)
- func (msg *Message) Encrypt(randy io.Reader, encrypter Encrypter, opts EncrypterOpts) error
- func (msg *Message) Encrypted() bool
- func (m *Message) Ephemeral() crypto.PublicKey
- func (m *Message) From() crypto.PublicKey
- func (m *Message) MarshalBinary() ([]byte, error)
- func (msg *Message) Plain() bool
- func (msg *Message) Sign(randy io.Reader, signer crypto.Signer) error
- func (m *Message) Signatory() crypto.PublicKey
- func (m *Message) Signature() []byte
- func (m *Message) To() crypto.PublicKey
- func (m *Message) UnmarshalBinary(p []byte) error
- func (msg *Message) Valid() bool
type Nonce
- func NewNonce(randy io.Reader) Nonce
- func (nonce Nonce) Bytes() []byte
- func (nonce Nonce) IsZero() bool
type Principal
type Verifier

Constants ¶

View Source

const ByteSize = 128

View Source

const GLOBAL_SALT = "oracle/v1"

View Source

const NonceSize = chacha20poly1305.NonceSize

Variables ¶

View Source

var ErrBadKey = errors.New("bad key")

View Source

var ErrDecryptionFailed = errors.New("decryption failed")

View Source

var ErrDelphi = errors.New("delphi")

View Source

var ErrEncryptionFailed = errors.New("encryption failed")

View Source

var ErrNoEphemeralKey = errors.New("no ephemeral key")

View Source

var ErrNotImplemented = errors.New("not implemented")

View Source

var UniversalNonce []byte = make([]byte, chacha20poly1305.NonceSize)

Functions ¶

func KeyFromBytes ¶ added in v0.0.3

func KeyFromBytes(b []byte) key

func NewKey ¶ added in v0.0.4

func NewKey(randy io.Reader) key

func NewKeyPair ¶ added in v0.0.4

func NewKeyPair(randy io.Reader) keyPair

func NewPrincipal ¶

func NewPrincipal(randy io.Reader) *principal

func NewSubKey ¶ added in v0.0.4

func NewSubKey(randy io.Reader) subKey

Types ¶

type Certifier ¶

type Certifier interface {
	crypto.PrivateKey
	crypto.Signer
	Verifier
}

a Certifier can produce and verify signatures

type Cipherer ¶

type Cipherer interface {
	crypto.PrivateKey
	Encrypter
}

a Cipherer can encrypt and decrypt a [message]

type CryptOpts ¶

type CryptOpts struct {
	Nonce []byte
	AAED  []byte
}

type Decrypter ¶ added in v0.0.4

type Decrypter interface {
	Decrypt(*Message, ed25519.PrivateKey, crypto.DecrypterOpts) error
}

type Encrypter ¶

type Encrypter interface {
	Encrypt(io.Reader, *Message, EncrypterOpts) error
}

type EncrypterOpts ¶ added in v0.0.4

type EncrypterOpts = any

type Message ¶

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

func NewMessage ¶

func NewMessage(randy io.Reader, plainTxt []byte) *Message

func (*Message) Digest ¶ added in v0.0.3

func (msg *Message) Digest(hash hash.Hash) ([]byte, error)

func (*Message) Encrypt ¶

func (msg *Message) Encrypt(randy io.Reader, encrypter Encrypter, opts EncrypterOpts) error

msg.Encrypt(Encrypter) is another way of doing encrypter.Encrypt(*Message)

func (*Message) Encrypted ¶ added in v0.0.4

func (msg *Message) Encrypted() bool

func (*Message) Ephemeral ¶ added in v0.0.4

func (m *Message) Ephemeral() crypto.PublicKey

func (*Message) From ¶

func (m *Message) From() crypto.PublicKey

func (*Message) MarshalBinary ¶ added in v0.0.4

func (m *Message) MarshalBinary() ([]byte, error)

func (*Message) Plain ¶ added in v0.0.4

func (msg *Message) Plain() bool

func (*Message) Sign ¶ added in v0.0.3

func (msg *Message) Sign(randy io.Reader, signer crypto.Signer) error

msg.Sign(Signer) is another way of doing signer.Sign(*Message)

func (*Message) Signatory ¶ added in v0.0.4

func (m *Message) Signatory() crypto.PublicKey

func (*Message) Signature ¶

func (m *Message) Signature() []byte

func (*Message) To ¶

func (m *Message) To() crypto.PublicKey

func (*Message) UnmarshalBinary ¶

func (m *Message) UnmarshalBinary(p []byte) error

func (*Message) Valid ¶ added in v0.0.4

func (msg *Message) Valid() bool

type Nonce ¶ added in v0.0.3

type Nonce [NonceSize]byte

func NewNonce ¶ added in v0.0.4

func NewNonce(randy io.Reader) Nonce

func (Nonce) Bytes ¶ added in v0.0.4

func (nonce Nonce) Bytes() []byte

func (Nonce) IsZero ¶ added in v0.0.3

func (nonce Nonce) IsZero() bool

type Principal ¶

type Principal interface {
	Cipherer
	Certifier
	encoding.BinaryMarshaler
	encoding.BinaryUnmarshaler
}

a Principal is a holder of a public/private key-pair that can perform encryption, decryption, signing, and verifying operations.

type Verifier ¶

type Verifier interface {
	Verify(pub crypto.PublicKey, digest []byte, sig []byte) bool
}

a Verifier can verify that a signature is valid

Source Files ¶

View all Source files

?	: This menu
/	: Search site
f or F	: Jump to
y or Y	: Canonical URL