Add a message encoder/decoder

This commit is contained in:
Mark Haines 2015-02-25 11:20:12 +00:00
parent 8df4d9e9b5
commit ba446e7a12
3 changed files with 287 additions and 0 deletions

View file

@ -0,0 +1,63 @@
#include <cstddef>
#include <cstdint>
namespace axolotl {
/**
* The length of the buffer needed to hold a message.
*/
std::size_t encode_message_length(
std::uint32_t counter,
std::size_t ratchet_key_length,
std::size_t ciphertext_length,
std::size_t mac_length
);
struct MessageWriter {
std::size_t body_length;
std::uint8_t * ratchet_key;
std::uint8_t * ciphertext;
std::uint8_t * mac;
};
struct MessageReader {
std::size_t body_length;
std::uint8_t version;
std::uint32_t counter;
std::size_t ratchet_key_length;
std::size_t ciphertext_length;
std::size_t mac_length;
std::uint8_t const * ratchet_key;
std::uint8_t const * ciphertext;
std::uint8_t const * mac;
};
/**
* Writes the message headers into the output buffer.
* Returns a writer struct populated with pointers into the output buffer.
*/
MessageWriter encode_message(
std::uint8_t version,
std::uint32_t counter,
std::size_t ratchet_key_length,
std::size_t ciphertext_length,
std::uint8_t * output
);
/**
* Reads the message headers from the input buffer.
* Returns a reader struct populated with pointers into the input buffer.
* On failure the returned body_length will be 0.
*/
MessageReader decode_message(
std::uint8_t const * input, std::size_t input_length,
std::size_t mac_length
);
} // namespace axolotl

171
src/message.cpp Normal file
View file

@ -0,0 +1,171 @@
#include "axolotl/message.hh"
namespace {
template<typename T>
std::size_t varint_length(
T value
) {
std::size_t result = 1;
while (value > 128U) {
++result;
value >>= 7;
}
return result;
}
template<typename T>
std::uint8_t * varint_encode(
std::uint8_t * output,
T value
) {
while (value > 128U) {
*(output++) = (0x7F & value) | 0x80;
}
(*output++) = value;
return output;
}
template<typename T>
T varint_decode(
std::uint8_t const * varint_start,
std::uint8_t const * varint_end
) {
T value = 0;
do {
value <<= 7;
value |= 0x7F & *(--varint_end);
} while (varint_end != varint_start);
return value;
}
std::uint8_t const * varint_skip(
std::uint8_t const * input,
std::uint8_t const * input_end
) {
while (input != input_end) {
std::uint8_t tmp = *(input++);
if ((tmp & 0x80) == 0) {
return input;
}
}
return input;
}
std::size_t varstring_length(
std::size_t string_length
) {
return varint_length(string_length) + string_length;
}
static std::size_t const VERSION_LENGTH = 1;
static std::uint8_t const RATCHET_KEY_TAG = 012;
static std::uint8_t const COUNTER_TAG = 020;
static std::uint8_t const CIPHERTEXT_TAG = 042;
} // namespace
std::size_t axolotl::encode_message_length(
std::uint32_t counter,
std::size_t ratchet_key_length,
std::size_t ciphertext_length,
std::size_t mac_length
) {
std::size_t length = VERSION_LENGTH;
length += 1 + varstring_length(ratchet_key_length);
length += 1 + varint_length(counter);
length += 1 + varstring_length(ciphertext_length);
return length + mac_length;
}
axolotl::MessageWriter axolotl::encode_message(
std::uint8_t version,
std::uint32_t counter,
std::size_t ratchet_key_length,
std::size_t ciphertext_length,
std::uint8_t * output
) {
axolotl::MessageWriter result;
std::uint8_t * pos = output;
*(pos++) = version;
*(pos++) = COUNTER_TAG;
pos = varint_encode(pos, counter);
*(pos++) = RATCHET_KEY_TAG;
pos = varint_encode(pos, ratchet_key_length);
result.ratchet_key = pos;
pos += ratchet_key_length;
*(pos++) = CIPHERTEXT_TAG;
pos = varint_encode(pos, ciphertext_length);
result.ciphertext = pos;
pos += ciphertext_length;
result.body_length = pos - output;
result.mac = pos;
return result;
}
axolotl::MessageReader axolotl::decode_message(
std::uint8_t const * input, std::size_t input_length,
std::size_t mac_length
) {
axolotl::MessageReader result;
result.body_length = 0;
std::uint8_t const * pos = input;
std::uint8_t const * end = input + input_length - mac_length;
std::uint8_t flags = 0;
result.mac = end;
result.mac_length = mac_length;
if (pos == end) return result;
result.version = *(pos++);
while (pos != end) {
uint8_t tag = *(pos);
if (tag == COUNTER_TAG) {
++pos;
std::uint8_t const * counter_start = pos;
pos = varint_skip(pos, end);
result.counter = varint_decode<std::uint32_t>(counter_start, pos);
flags |= 1;
} else if (tag == RATCHET_KEY_TAG) {
++pos;
std::uint8_t const * len_start = pos;
pos = varint_skip(pos, end);
std::size_t len = varint_decode<std::size_t>(len_start, pos);
if (len > end - pos) return result;
result.ratchet_key_length = len;
result.ratchet_key = pos;
pos += len;
flags |= 2;
} else if (tag == CIPHERTEXT_TAG) {
++pos;
std::uint8_t const * len_start = pos;
pos = varint_skip(pos, end);
std::size_t len = varint_decode<std::size_t>(len_start, pos);
if (len > end - pos) return result;
result.ciphertext_length = len;
result.ciphertext = pos;
pos += len;
flags |= 4;
} else if (tag & 0x7 == 0) {
pos = varint_skip(pos, end);
pos = varint_skip(pos, end);
} else if (tag & 0x7 == 2) {
std::uint8_t const * len_start = pos;
pos = varint_skip(pos, end);
std::size_t len = varint_decode<std::size_t>(len_start, pos);
if (len > end - pos) return result;
pos += len;
} else {
return result;
}
}
if (flags == 0x7) {
result.body_length = end - input;
}
return result;
}

53
tests/test_message.cpp Normal file
View file

@ -0,0 +1,53 @@
#include "axolotl/message.hh"
#include "unittest.hh"
int main() {
std::uint8_t message1[36] = "\x03\n\nratchetkey\x10\x01\"\nciphertexthmacsha2";
std::uint8_t message2[36] = "\x03\x10\x01\n\nratchetkey\"\nciphertexthmacsha2";
std::uint8_t ratchetkey[11] = "ratchetkey";
std::uint8_t ciphertext[11] = "ciphertext";
std::uint8_t hmacsha2[9] = "hmacsha2";
{ /* Message decode test */
TestCase test_case("Message decode test");
axolotl::MessageReader reader(axolotl::decode_message(message1, 35, 8));
assert_equals(std::size_t(27), reader.body_length);
assert_equals(std::uint8_t(3), reader.version);
assert_equals(std::uint32_t(1), reader.counter);
assert_equals(std::size_t(10), reader.ratchet_key_length);
assert_equals(std::size_t(10), reader.ciphertext_length);
assert_equals(std::size_t(8), reader.mac_length);
assert_equals(ratchetkey, reader.ratchet_key, 10);
assert_equals(ciphertext, reader.ciphertext, 10);
assert_equals(hmacsha2, reader.mac, 8);
} /* Message decode test */
{ /* Message encode test */
TestCase test_case("Message encode test");
std::size_t length = axolotl::encode_message_length(1, 10, 10, 8);
assert_equals(std::size_t(35), length);
std::uint8_t output[length];
axolotl::MessageWriter writer(axolotl::encode_message(3, 1, 10, 10, output));
assert_equals(std::size_t(27), writer.body_length);
std::memcpy(writer.ratchet_key, ratchetkey, 10);
std::memcpy(writer.ciphertext, ciphertext, 10);
std::memcpy(writer.mac, hmacsha2, 8);
assert_equals(message2, output, 35);
} /* Message encode test */
}