History

David Baker 122867c45c WebAssembly support! Quite a lot going on in this PR: * Updates to support recent emscripten, switching to WASM which is now the default * Use emscripten's MODULARIZE option rather than wrapping it ourself, since doing so in pre-post js doesn't work anymore. * Most changes are moving the emscripten runtime functions to top-level calls rather than in the Module object. * Get rid of duplicated NULL_BYTE_PADDING_LENGTH * Fix ciphertext_length used without being declared * Fix things that caused the closure compiler to error, eg. using OLM_OPTIONS without a declaration. * Wait until module is inited to do OLM_ERROR = olm_error() The main BREAKING CHANGE here is that the module now needs to initialise asyncronously (because it has to load the wasm file). require()ing olm now gives a function which needs to be called to create an instance. The resulting object has a promise-like then() method that can be used to detect when the module is ready. (We could use MODULARIZE_INSTANCE to return the module directly as before, rather than the function, but then we don't get the .then() method).		2018-09-21 16:01:51 +01:00
..
demo	Return the message index when decrypting group messages.	2016-10-20 09:58:55 +01:00
test	WebAssembly support!	2018-09-21 16:01:51 +01:00
.gitignore	WebAssembly support!	2018-09-21 16:01:51 +01:00
README.md	Javascript bindings for group sessions	2016-05-25 17:48:01 +01:00
olm_inbound_group_session.js	WebAssembly support!	2018-09-21 16:01:51 +01:00
olm_outbound_group_session.js	WebAssembly support!	2018-09-21 16:01:51 +01:00
olm_pk.js	WebAssembly support!	2018-09-21 16:01:51 +01:00
olm_post.js	WebAssembly support!	2018-09-21 16:01:51 +01:00
olm_pre.js	WebAssembly support!	2018-09-21 16:01:51 +01:00
package.json	prepare 2.3.0	2018-07-04 15:24:44 -04:00

README.md

Olm

Example:

var alice = new Olm.Account();
var bob = new Olm.Account();
alice.create();
bob.create();
bob.generate_one_time_keys(1);

var bobs_id_keys = JSON.parse(bob.identity_keys());
var bobs_id_key = bobs_id_keys.curve25519;
var bobs_ot_keys = JSON.parse(bob.one_time_keys());
for (key in bobs_ot_keys.curve25519) {
    var bobs_ot_key = bobs_ot_keys.curve25519[key];
}

alice_session = new Olm.Session();
alice_session.create_outbound(alice, bobs_id_key, bobs_ot_key);
alice_message = a_session.encrypt("Hello");

bob_session.create_inbound(bob, bob_message);
var plaintext = bob_session.decrypt(message_1.type, bob_message);
bob.remove_one_time_keys(bob_session);

Group chat:

var outbound_session = new Olm.OutboundGroupSession();
outbound_session.create();

// exchange these over a secure channel
var session_id = group_session.session_id();
var session_key = group_session.session_key();
var message_index = group_session.message_index();

var inbound_session = new Olm.InboundGroupSession();
inbound_session.create(message_index, session_key);

var ciphertext = outbound_session.encrypt("Hello");
var plaintext = inbound_session.decrypt(ciphertext);