ratchet

Feb 13, 2023

retracted

Changes in this version

+ var ErrInconsistentState = errors.New("Ratchet: the state is inconsistent")

Feb 6, 2021

retracted

Changes in this version

+ const PQRatchetPublicKeyInHeaderOffset

+ var ErrCSIDHInvalidPublicKey = errors.New("Ratchet: CSIDH public key validation failure")

+ var ErrCSIDHPrivateExport = errors.New("Ratchet: CSIDH: failed to export private key")

+ var ErrCSIDHPrivateImport = errors.New("Ratchet: CSIDH: failed to import private key")

+ var ErrCSIDHPublicExport = errors.New("Ratchet: CSIDH: failed to export public key")

+ var ErrCSIDHPublicImport = errors.New("Ratchet: CSIDH: failed to import public key")

+ var ErrCSIDHSharedSecret = errors.New("Ratchet: failed to compute shared secret from PQDH0")

+ var ErrFailedToLoadPQRatchet = errors.New("Ratchet: failed to load PQ Ratchet from state")

+ var ErrImportPQDh0 = errors.New("Ratchet: failed to import PQ DH0 from exchange blob")

type Ratchet

+ func (r *Ratchet) Save() (data []byte, err error)

Jan 31, 2021

retracted

Changes in this version

type KeyExchange

+ func (k *KeyExchange) Wipe()

type Ratchet

+ func NewRatchetFromBytes(rand io.Reader, data []byte) (*Ratchet, error)

type SignedKeyExchange

+ func (s *SignedKeyExchange) Wipe()

Oct 28, 2020

retracted

Changes in this version

+ var ErrCannotDecrypt = errors.New("Ratchet: cannot decrypt")

+ var ErrCorruptMessage = errors.New("Ratchet: corrupt message")

+ var ErrDuplicateOrDelayed = errors.New("Ratchet: duplicate message or message delayed longer than tolerance")

+ var ErrEchoedDHValues = errors.New("Ratchet: peer echoed our own DH values back")

+ var ErrFailedToInitializeRatchet = errors.New("Ratchet: failed to initialize")

+ var ErrHandshakeAlreadyComplete = errors.New("Ratchet: handshake already complete")

+ var ErrIncorrectHeaderSize = errors.New("Ratchet: incorrect header size")

+ var ErrInvalidKeyExchange = errors.New("Ratchet: peer's key exchange is invalid")

+ var ErrInvalidPubkey = errors.New("Ratchet: invalid public key")

+ var ErrInvalidPublicIdentityKey = errors.New("Ratchet: invalid public identity key")

+ var ErrInvalidSignature = errors.New("Ratchet: invalid signature")

+ var ErrInvalidSignatureLength = errors.New("Ratchet: invalid signature length")

+ var ErrKeyExchangeKeysNotIsomorphicallyEqual = errors.New("Ratchet: key exchange and identity public keys must be isomorphically equal")

+ var ErrMessageExceedsReorderingLimit = errors.New("Ratchet: message exceeds reordering limit")

+ var ErrNextEncryptedMessageWithoutRatchetFlag = errors.New(...)

+ var ErrOldFormKeyExchange = errors.New("Ratchet: peer using old-form key exchange")

+ var ErrRatchetHeaderTooSmall = errors.New("Ratchet: header too small to be valid")

+ var ErrSerialisedKeyLength = errors.New("Ratchet: bad serialised key length")

Oct 4, 2020

retracted

Changes in this version

+ const MaxMissingMessages

Oct 3, 2020

retracted

Changes in this version

type SavedKeys

+ func (s *SavedKeys) MarshalBinary() ([]byte, error)

+ func (s *SavedKeys) UnmarshalBinary(data []byte) error

Apr 19, 2020

retracted

Changes in this version

+ func DestroyRatchet(r *Ratchet)

type Ratchet

+ func InitRatchet(rand io.Reader) (*Ratchet, error)

+ type State struct

+ MyIdentityPrivate []byte

+ MyIdentityPublic []byte

+ MySigningPrivate []byte

+ MySigningPublic []byte

+ NextRecvHeaderKey []byte

+ NextSendHeaderKey []byte

+ PrevSendCount uint32

+ Private0 []byte

+ Private1 []byte

+ Ratchet bool

+ RecvChainKey []byte

+ RecvCount uint32

+ RecvHeaderKey []byte

+ RecvRatchetPublic []byte

+ RootKey []byte

+ SavedKeys []*SavedKeys

+ SendChainKey []byte

+ SendCount uint32

+ SendHeaderKey []byte

+ SendRatchetPrivate []byte

+ TheirIdentityPublic []byte

+ TheirSigningPublic []byte

May 7, 2019

retracted

Changes in this version

+ const DoubleRatchetOverhead

+ const RatchetKeyMaxLifetime

+ type KeyExchange struct

+ Dh []byte

+ Dh1 []byte

+ IdentityPublic []byte

+ PublicKey []byte

+ type MessageKey struct

+ CreationTime int64

+ Key []byte

+ Num uint32

+ type Ratchet struct

+ MyIdentityPrivate [32]byte

+ MyIdentityPublic [32]byte

+ MySigningPrivate [64]byte

+ MySigningPublic [32]byte

+ Now func() time.Time

+ TheirIdentityPublic [32]byte

+ TheirSigningPublic [32]byte

+ func New(rand io.Reader) (*Ratchet, error)

+ func (r *Ratchet) CompleteKeyExchange(kx *KeyExchange) error

+ func (r *Ratchet) CreateKeyExchange() (*SignedKeyExchange, error)

+ func (r *Ratchet) Decrypt(ciphertext []byte) ([]byte, error)

+ func (r *Ratchet) Encrypt(out, msg []byte) []byte

+ func (r *Ratchet) FillKeyExchange(kx *KeyExchange) error

+ func (r *Ratchet) Marshal(now time.Time, lifetime time.Duration) *RatchetState

+ func (r *Ratchet) MarshalBinary() (data []byte, err error)

+ func (r *Ratchet) ProcessKeyExchange(signedKeyExchange *SignedKeyExchange) error

+ func (r *Ratchet) Unmarshal(s *RatchetState) error

+ func (r *Ratchet) UnmarshalBinary(data []byte) error

+ type RatchetState struct

+ MyIdentityPrivate []byte

+ MyIdentityPublic []byte

+ MySigningPrivate []byte

+ MySigningPublic []byte

+ NextRecvHeaderKey []byte

+ NextSendHeaderKey []byte

+ PrevSendCount uint32

+ Private0 []byte

+ Private1 []byte

+ Ratchet bool

+ RecvChainKey []byte

+ RecvCount uint32

+ RecvHeaderKey []byte

+ RecvRatchetPublic []byte

+ RootKey []byte

+ SavedKeys []*SavedKeys

+ SendChainKey []byte

+ SendCount uint32

+ SendHeaderKey []byte

+ SendRatchetPrivate []byte

+ TheirIdentityPublic []byte

+ TheirSigningPublic []byte

+ type SavedKeys struct

+ HeaderKey []byte

+ MessageKeys []*MessageKey

+ type SignedKeyExchange struct

+ Signature []byte

+ Signed []byte