lightning 0.2.2

A Complete Bitcoin Lightning Library in Rust. Handles the core functionality of the Lightning Network, allowing clients to implement custom wallet, chain interactions, storage and network logic without enforcing a specific runtime.
Documentation
// ring has a garbage API so its use is avoided, but rust-crypto doesn't have RFC-variant poly1305
// Instead, we steal rust-crypto's implementation and tweak it to match the RFC.
//
// This file is licensed under the Apache License, Version 2.0 <LICENSE-APACHE
// or http://www.apache.org/licenses/LICENSE-2.0> or the MIT license
// <LICENSE-MIT or http://opensource.org/licenses/MIT>, at your option.
// You may not use this file except in accordance with one or both of these
// licenses.
//
// This is a port of Andrew Moons poly1305-donna
// https://github.com/floodyberry/poly1305-donna

use super::chacha20::ChaCha20;
use super::fixed_time_eq;
use super::poly1305::Poly1305;

pub struct ChaCha20Poly1305RFC {
	cipher: ChaCha20,
	mac: Poly1305,
	finished: bool,
	data_len: usize,
	aad_len: u64,
}

impl ChaCha20Poly1305RFC {
	#[inline]
	fn pad_mac_16(mac: &mut Poly1305, len: usize) {
		if len % 16 != 0 {
			mac.input(&[0; 16][0..16 - (len % 16)]);
		}
	}
	pub fn new(key: &[u8], nonce: &[u8], aad: &[u8]) -> ChaCha20Poly1305RFC {
		assert!(key.len() == 16 || key.len() == 32);
		assert!(nonce.len() == 12);

		// Ehh, I'm too lazy to *also* tweak ChaCha20 to make it RFC-compliant
		assert!(nonce[0] == 0 && nonce[1] == 0 && nonce[2] == 0 && nonce[3] == 0);

		let mut cipher = ChaCha20::new(key, &nonce[4..]);
		let mut mac_key = [0u8; 64];
		let zero_key = [0u8; 64];
		cipher.process(&zero_key, &mut mac_key);

		#[cfg(not(fuzzing))]
		let mut mac = Poly1305::new(&mac_key[..32]);
		#[cfg(fuzzing)]
		let mut mac = Poly1305::new(&key);
		mac.input(aad);
		ChaCha20Poly1305RFC::pad_mac_16(&mut mac, aad.len());

		ChaCha20Poly1305RFC { cipher, mac, finished: false, data_len: 0, aad_len: aad.len() as u64 }
	}

	pub fn encrypt(&mut self, input: &[u8], output: &mut [u8], out_tag: &mut [u8]) {
		assert!(input.len() == output.len());
		assert!(!self.finished);
		self.cipher.process(input, output);
		self.data_len += input.len();
		self.mac.input(output);
		ChaCha20Poly1305RFC::pad_mac_16(&mut self.mac, self.data_len);
		self.finished = true;
		self.mac.input(&self.aad_len.to_le_bytes());
		self.mac.input(&(self.data_len as u64).to_le_bytes());
		out_tag.copy_from_slice(&self.mac.result());
	}

	pub fn encrypt_full_message_in_place(&mut self, input_output: &mut [u8], out_tag: &mut [u8]) {
		self.encrypt_in_place(input_output);
		self.finish_and_get_tag(out_tag);
	}

	// Encrypt `input_output` in-place. To finish and calculate the tag, use `finish_and_get_tag`
	// below.
	pub(in super::super) fn encrypt_in_place(&mut self, input_output: &mut [u8]) {
		debug_assert!(!self.finished);
		self.cipher.process_in_place(input_output);
		self.data_len += input_output.len();
		self.mac.input(input_output);
	}

	// If we were previously encrypting with `encrypt_in_place`, this method can be used to finish
	// encrypting and calculate the tag.
	pub(in super::super) fn finish_and_get_tag(&mut self, out_tag: &mut [u8]) {
		debug_assert!(!self.finished);
		ChaCha20Poly1305RFC::pad_mac_16(&mut self.mac, self.data_len);
		self.finished = true;
		self.mac.input(&self.aad_len.to_le_bytes());
		self.mac.input(&(self.data_len as u64).to_le_bytes());
		out_tag.copy_from_slice(&self.mac.result());
	}

	/// Decrypt the `input`, checking the given `tag` prior to writing the decrypted contents
	/// into `output`. Note that, because `output` is not touched until the `tag` is checked,
	/// this decryption is *variable time*.
	pub fn variable_time_decrypt(
		&mut self, input: &[u8], output: &mut [u8], tag: &[u8],
	) -> Result<(), ()> {
		assert!(input.len() == output.len());
		assert!(!self.finished);

		self.finished = true;

		self.mac.input(input);

		self.data_len += input.len();
		ChaCha20Poly1305RFC::pad_mac_16(&mut self.mac, self.data_len);
		self.mac.input(&self.aad_len.to_le_bytes());
		self.mac.input(&(self.data_len as u64).to_le_bytes());

		let calc_tag = self.mac.result();
		if fixed_time_eq(&calc_tag, tag) {
			self.cipher.process(input, output);
			Ok(())
		} else {
			Err(())
		}
	}

	pub fn check_decrypt_in_place(
		&mut self, input_output: &mut [u8], tag: &[u8],
	) -> Result<(), ()> {
		self.decrypt_in_place(input_output);
		if self.finish_and_check_tag(tag) {
			Ok(())
		} else {
			Err(())
		}
	}

	/// Decrypt in place, without checking the tag. Use `finish_and_check_tag` to check it
	/// later when decryption finishes.
	///
	/// Should never be `pub` because the public API should always enforce tag checking.
	pub(in super::super) fn decrypt_in_place(&mut self, input_output: &mut [u8]) {
		debug_assert!(!self.finished);
		self.mac.input(input_output);
		self.data_len += input_output.len();
		self.cipher.process_in_place(input_output);
	}

	/// If we were previously decrypting with `just_decrypt_in_place`, this method must be used
	/// to check the tag. Returns whether or not the tag is valid.
	pub(in super::super) fn finish_and_check_tag(&mut self, tag: &[u8]) -> bool {
		debug_assert!(!self.finished);
		self.finished = true;
		ChaCha20Poly1305RFC::pad_mac_16(&mut self.mac, self.data_len);
		self.mac.input(&self.aad_len.to_le_bytes());
		self.mac.input(&(self.data_len as u64).to_le_bytes());

		let calc_tag = self.mac.result();
		if fixed_time_eq(&calc_tag, tag) {
			true
		} else {
			false
		}
	}
}