Python 3 bindings for libsignal-protocol-c. The actual c code is integrated using the C Foreign Function Interface for Python package. Similiar as libsignal-protocol-c this library only contains functionality for the cryptographic primitives. In other words local persistency, transport (public storage of public keys, transmission or receipt of messages) and inner message encoding is not part of this library.
DISCLAMER: Incomplete and untrusthworthy. These bindings were used for academic research purposes and should not be used in real world cryptographic applications. For a more mature alternative you may want to consider https://github.com/tgalal/python-axolotl.
> git clone git@github.com:cholin/libsignal-protocol-python.git
> git submodule update --init --recursive
> python -m venv env
> . env/bin/activate
> xargs -L 1 pip install -vv < requirements.txt # enforced order
> python -m pytest
# or to check for memory leaks through valgrind
> PYTHONMALLOC=malloc valgrind --show-leak-kinds=definite --log-file=/tmp/valgrind-output python -m pytest -s -vv --valgrind --valgrind-log=/tmp/valgrind-output
Alice and Bob example code (see tests/test_protocol.py) with an in-memory store:
# create identity for bob (with keys)
bob = SignalProtocol(b'bob')
bob_signed_pre_pub_key = bob.generate_signed_pre_key()
bob_pre_pub_keys = list(bob.generate_pre_keys())
# publish bob's public keys so that Alice can retrieve them
# create identity for alice
alice = SignalProtocol(b'alice')
# alice -> bob (Alice needs Bob's public key parts)
alice_session_bob = alice.session(b'bob', 1)
if not alice_session_bob.initialized:
bob_pub_keys = (bob.registration_id,
bob.identity.public_key, bob_signed_pre_pub_key,
bob_pre_pub_keys[0])
alice_session_bob.process(*bob_pub_keys)
msg = b'foo'
ciphertext = alice_session_bob.encrypt(msg)
assert ciphertext.type == lib.CIPHERTEXT_PREKEY_TYPE
serialized = (lib.CIPHERTEXT_PREKEY_TYPE, ciphertext.serialize())
# transmit serialized over wire
plaintext = bob.session(b'alice', 1).decrypt(*serialized)
assert plaintext.bin() == msg
print(plaintext.bin(), msg)