PapaTutuWawa/omemo_dart
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity
A Dart implementation of the cryptography needed for OMEMO 0.8.3.
73 Commits 2 Branches 14 Tags 375 KiB
Dart 99.2%
Nix 0.8%
ad3f1d4579
Go to file
Alexander "PapaTutuWawa ad3f1d4579 release: Publish to polynom.me
2022-08-09 15:51:22 +02:00
example docs: Add note about events to the example 2022-08-09 15:49:40 +02:00
lib docs: Add an example 2022-08-09 15:48:26 +02:00
protobuf wip: Add the basics for the Double Ratchet 2022-08-02 18:13:14 +02:00
test fix: Allow empty OMEMO messages to bypass trust 2022-08-09 14:45:04 +02:00
.gitignore Initial commit 2022-06-30 14:00:18 +02:00
.gitlint refactor: Move data classes into their own files 2022-08-08 17:43:15 +02:00
analysis_options.yaml wip: Add the basics for the Double Ratchet 2022-08-02 18:13:14 +02:00
CHANGELOG.md Initial commit 2022-06-30 14:00:18 +02:00
flake.lock refactor: Clean up the X3DH implementation 2022-08-02 15:03:58 +02:00
flake.nix wip: Add the basics for the Double Ratchet 2022-08-02 18:13:14 +02:00
LICENSE.md ENABLE X3DH WITH ED25519 KEYS 2022-08-01 23:20:31 +02:00
pubspec.yaml release: Publish to polynom.me 2022-08-09 15:51:22 +02:00
README.md docs: Add protobuf as a dev dependency 2022-08-07 17:02:06 +02:00

README.md

omemo_dart

omemo_dart is a Dart library to help developers of Dart/Flutter XMPP clients to implement OMEMO in its newest version - currently 0.8.3.

The library provides an implementation of the X3DH key exchange, the Double Ratchet with the OMEMO 0.8.3 specific ENCRYPT, DECRYPT and KDF_* functions and a very high-level OmemoSessionManager that manages all Double Ratchet sessions and provides a clean and simple interface for encrypting a message for all known Ratchet sessions we have with a user.

This library also has no dependency on any XMPP library. omemo_dart instead defines an intermediary format for the required data that you, the user, will need to transform to and from the stanza format of your preferred XMPP library yourself.

Important Notes

  • Please note that this library has not been audited for its security! Use at your own risk!
  • This library is not tested with other implementations of OMEMO 0.8.3 as I do not know of any client implementing spec compliant OMEMO 0.8.3. It does, however, work with itself.

Contributing

Due to issues with protobuf, omemo_dart reimplements the Protobuf encoding for the required OMEMO messages. As such, protobuf is only a dependency for testing that the serialisation and deserialisation of the custom implementation.

When submitting a PR, please run the linter using dart analyze and make sure that all tests still pass using dart test.

To ensure uniform commit message formatting, please also use gitlint to lint your commit messages' formatting.

License

Licensed under the MIT license.

See LICENSE.