Categorygithub.com/openbazaar/libsignal
modulepackage
0.0.0-20160508053942-9e252af863c5
Repository: https://github.com/openbazaar/libsignal.git
Documentation: pkg.go.dev

# README

libsignal [WIP]

This go library is an implementation of the signal asynchronous messaging protocol modified for use in OpenBazaar.

Modifications include:

  • Removed all communication with the signal servers. This library only handles session state management, encryption, and decryption. It's up to you to implement a transport for the ciphertext.
  • Removed prekey transport. Again, you need to implement a method of getting Alice's prekey bundle to Bob so that Bob can send the first message.
  • Removed message metadata. Messages are not tagged with the recipient ID. This allows them to be stored on untrusted servers without leaking metadata. The cost, however, is that to decrypt a message one must iterative over all open sessions to decrypt the message. Assuming the number of sessions a user keeps open at any given time is relatively small, this shouldn't have scaling issues. It may be possible to improve the efficiency here by tagging each message with a shared secret that ratchets forward, but at the cost of more complexity.
  • [TODO] Identity keys switched to RSA (which is what OpenBazaar/IPFS uses).

# Packages

No description provided by the author
No description provided by the author

# Functions

ContactIdentityKey returns the serialized public key of the given contact.
No description provided by the author
MyIdentityKey returns our serialized public identity key.
No description provided by the author
No description provided by the author

# Variables

No description provided by the author
No description provided by the author
ErrInvalidMACForMessage signals an incoming message with invalid MAC.
ErrInvalidMACForMessage signals an incoming message with invalid MAC.
ErrStoreBadMAC occurs when MAC verification fails on the records stored using password based encryption.
MessageTypeNotImplementedError is raised in the unlikely event that an unhandled protocol message type is received.

# Structs

No description provided by the author
No description provided by the author
UnknownContactError is returned when an unknown group id is encountered.