use std::io::{Read, Write};
pub use decrypt::DecrypterHalf;
pub use encrypt::EncrypterHalf;
use crate::error::MatchProofsError;
use crate::key::{Proof, SessionKey};
use crate::normalized_string::NormalizedString;
use crate::{PROOF_LENGTH, SESSION_KEY_LENGTH};
use rand::{thread_rng, RngCore};
pub(crate) mod decrypt;
pub(crate) mod encrypt;
mod internal;
pub(crate) use internal::calculate_world_server_proof;
pub const CLIENT_HEADER_LENGTH: u8 =
(std::mem::size_of::<u16>() + std::mem::size_of::<u32>()) as u8;
pub const SERVER_HEADER_LENGTH: u8 =
(std::mem::size_of::<u16>() + std::mem::size_of::<u16>()) as u8;
#[derive(Debug, Clone, Copy, Ord, PartialOrd, Eq, PartialEq, Hash)]
pub struct ServerHeader {
pub size: u16,
pub opcode: u16,
}
#[derive(Debug, Clone, Copy, Ord, PartialOrd, Eq, PartialEq, Hash)]
pub struct ClientHeader {
pub size: u16,
pub opcode: u32,
}
#[derive(Debug, Clone, Ord, PartialOrd, Eq, PartialEq, Hash)]
pub struct HeaderCrypto {
decrypt: DecrypterHalf,
encrypt: EncrypterHalf,
}
impl HeaderCrypto {
pub fn decrypter(&mut self) -> &mut DecrypterHalf {
&mut self.decrypt
}
pub fn encrypter(&mut self) -> &mut EncrypterHalf {
&mut self.encrypt
}
pub fn encrypt(&mut self, data: &mut [u8]) {
self.encrypt.encrypt(data);
}
pub fn write_encrypted_server_header<W: Write>(
&mut self,
write: &mut W,
size: u16,
opcode: u16,
) -> std::io::Result<()> {
self.encrypt
.write_encrypted_server_header(write, size, opcode)
}
pub fn write_encrypted_client_header<W: Write>(
&mut self,
write: &mut W,
size: u16,
opcode: u32,
) -> std::io::Result<()> {
self.encrypt
.write_encrypted_client_header(write, size, opcode)
}
pub fn encrypt_server_header(
&mut self,
size: u16,
opcode: u16,
) -> [u8; SERVER_HEADER_LENGTH as usize] {
self.encrypt.encrypt_server_header(size, opcode)
}
pub fn encrypt_client_header(
&mut self,
size: u16,
opcode: u32,
) -> [u8; CLIENT_HEADER_LENGTH as usize] {
self.encrypt.encrypt_client_header(size, opcode)
}
pub fn decrypt(&mut self, data: &mut [u8]) {
self.decrypt.decrypt(data);
}
pub fn read_and_decrypt_server_header<R: Read>(
&mut self,
reader: &mut R,
) -> std::io::Result<ServerHeader> {
self.decrypt.read_and_decrypt_server_header(reader)
}
pub fn read_and_decrypt_client_header<R: Read>(
&mut self,
reader: &mut R,
) -> std::io::Result<ClientHeader> {
self.decrypt.read_and_decrypt_client_header(reader)
}
pub fn decrypt_server_header(
&mut self,
data: [u8; SERVER_HEADER_LENGTH as usize],
) -> ServerHeader {
self.decrypt.decrypt_server_header(data)
}
pub fn decrypt_client_header(
&mut self,
mut data: [u8; CLIENT_HEADER_LENGTH as usize],
) -> ClientHeader {
self.decrypt(&mut data);
let size: u16 = u16::from_be_bytes([data[0], data[1]]);
let opcode: u32 = u32::from_le_bytes([data[2], data[3], data[4], data[5]]);
ClientHeader { size, opcode }
}
#[allow(clippy::missing_const_for_fn)] pub fn split(self) -> (EncrypterHalf, DecrypterHalf) {
(self.encrypt, self.decrypt)
}
pub(crate) fn new(session_key: [u8; SESSION_KEY_LENGTH as usize]) -> Self {
Self {
decrypt: DecrypterHalf::new(session_key),
encrypt: EncrypterHalf::new(session_key),
}
}
}
#[derive(Debug, Clone, Copy, Ord, PartialOrd, Eq, PartialEq, Hash)]
pub struct ProofSeed {
seed: u32,
}
impl ProofSeed {
pub fn new() -> Self {
Self::default()
}
#[cfg(test)]
fn from_specific_seed(server_seed: u32) -> Self {
Self { seed: server_seed }
}
pub const fn seed(&self) -> u32 {
self.seed
}
pub fn into_proof_and_header_crypto(
self,
username: &NormalizedString,
session_key: [u8; SESSION_KEY_LENGTH as _],
server_seed: u32,
) -> ([u8; PROOF_LENGTH as _], HeaderCrypto) {
let client_proof = calculate_world_server_proof(
username,
&SessionKey::from_le_bytes(session_key),
server_seed,
self.seed,
);
let crypto = HeaderCrypto::new(session_key);
(*client_proof.as_le(), crypto)
}
pub fn into_header_crypto(
self,
username: &NormalizedString,
session_key: [u8; SESSION_KEY_LENGTH as _],
client_proof: [u8; PROOF_LENGTH as _],
client_seed: u32,
) -> Result<HeaderCrypto, MatchProofsError> {
let server_proof = calculate_world_server_proof(
username,
&SessionKey::from_le_bytes(session_key),
self.seed,
client_seed,
);
if server_proof != Proof::from_le_bytes(client_proof) {
return Err(MatchProofsError {
client_proof,
server_proof: *server_proof.as_le(),
});
}
Ok(HeaderCrypto::new(session_key))
}
}
impl Default for ProofSeed {
fn default() -> Self {
Self {
seed: thread_rng().next_u32(),
}
}
}
#[cfg(test)]
mod test {
use std::fs::read_to_string;
use crate::hex::*;
use crate::key::SessionKey;
use crate::normalized_string::NormalizedString;
use crate::tbc_header::{HeaderCrypto, ProofSeed};
use crate::SESSION_KEY_LENGTH;
use std::convert::TryInto;
#[test]
fn verify_seed_proof() {
const FILE: &str = "tests/encryption/calculate_world_server_proof.txt";
let contents = read_to_string(FILE).unwrap();
for line in contents.lines() {
let mut line = line.split_whitespace();
let username = line.next().unwrap();
let session_key = SessionKey::from_be_hex_str(line.next().unwrap());
let server_seed =
u32::from_le_bytes(hex_decode(line.next().unwrap()).try_into().unwrap());
let client_seed = ProofSeed::from_specific_seed(u32::from_le_bytes(
hex_decode(line.next().unwrap()).try_into().unwrap(),
));
let expected: [u8; 20] = hex_decode(line.next().unwrap()).try_into().unwrap();
let (proof, _) = client_seed.into_proof_and_header_crypto(
&username.try_into().unwrap(),
*session_key.as_le(),
server_seed,
);
assert_eq!(expected, proof);
}
}
#[test]
fn verify_client_and_server_agree() {
let session_key = [
239, 107, 150, 237, 174, 220, 162, 4, 138, 56, 166, 166, 138, 152, 188, 146, 96, 151,
1, 201, 202, 137, 231, 87, 203, 23, 62, 17, 7, 169, 178, 1, 51, 208, 202, 223, 26, 216,
250, 9,
];
let username = NormalizedString::new("A").unwrap();
let client_seed = ProofSeed::new();
let client_seed_value = client_seed.seed();
let server_seed = ProofSeed::new();
let (client_proof, mut client_crypto) =
client_seed.into_proof_and_header_crypto(&username, session_key, server_seed.seed());
let mut server_crypto = server_seed
.into_header_crypto(&username, session_key, client_proof, client_seed_value)
.unwrap();
let original_data = hex_decode("3d9ae196ef4f5be4df9ea8b9f4dd95fe68fe58b653cf1c2dbeaa0be167db9b27df32fd230f2eab9bd7e9b2f3fbf335d381ca");
let mut data = original_data.clone();
client_crypto.encrypt(&mut data);
server_crypto.decrypt(&mut data);
assert_eq!(original_data, data);
server_crypto.encrypt(&mut data);
client_crypto.decrypt(&mut data);
assert_eq!(original_data, data);
}
#[test]
fn verify_server_header() {
let session_key = [
99, 131, 9, 219, 107, 35, 248, 24, 247, 161, 213, 174, 25, 135, 70, 253, 173, 103, 149,
186, 85, 162, 130, 144, 129, 83, 118, 179, 93, 82, 160, 128, 165, 215, 35, 125, 224, 8,
156, 140,
];
let client_seed = 1293574611;
let client_proof = [
230, 111, 58, 182, 90, 7, 230, 53, 243, 100, 208, 250, 106, 126, 79, 166, 29, 70, 48, 3,
];
let mut encryption = ProofSeed::from_specific_seed(4181603988)
.into_header_crypto(
&NormalizedString::new("A").unwrap(),
session_key,
client_proof,
client_seed,
)
.unwrap();
let header = encryption.encrypt_server_header(13, 0x1EE);
let expected_header = [0x36, 0xbe, 0x24, 0x58];
assert_eq!(header, expected_header);
let header = encryption.encrypt_server_header(246, 0x3B);
let expected_header = [0x6c, 0x4b, 0xd1, 0x75];
assert_eq!(header, expected_header);
let header = encryption.encrypt_server_header(246, 0x3B);
let expected_header = [0x47, 0x44, 0x54, 0xee];
assert_eq!(header, expected_header);
let header = encryption.encrypt_server_header(22, 0x236);
let expected_header = [0xca, 0x63, 0xd2, 0x21];
assert_eq!(header, expected_header);
let header = encryption.encrypt_server_header(34, 0xFD);
let expected_header = [0x9d, 0xe5, 0xa4, 0xc8];
assert_eq!(header, expected_header);
}
#[test]
fn verify_client_header() {
let session_key = [
99, 131, 9, 219, 107, 35, 248, 24, 247, 161, 213, 174, 25, 135, 70, 253, 173, 103, 149,
186, 85, 162, 130, 144, 129, 83, 118, 179, 93, 82, 160, 128, 165, 215, 35, 125, 224, 8,
156, 140,
];
let client_proof = [
230, 111, 58, 182, 90, 7, 230, 53, 243, 100, 208, 250, 106, 126, 79, 166, 29, 70, 48, 3,
];
let client_seed = 1293574611;
let mut encryption = ProofSeed::from_specific_seed(4181603988)
.into_header_crypto(
&NormalizedString::new("A").unwrap(),
session_key,
client_proof,
client_seed,
)
.unwrap();
let header = [0x36, 0xb7, 0x76, 0xab, 0xbf, 0xe8];
let c = encryption.decrypt_client_header(header);
let expected_size = 4;
let expected_opcode = 55; assert_eq!(c.opcode, expected_opcode);
assert_eq!(c.size, expected_size);
let header = [0xa5, 0x51, 0xaf, 0xb7, 0xe2, 0x7c];
let c = encryption.decrypt_client_header(header);
let expected_size = 8;
let expected_opcode = 0x38C; assert_eq!(c.opcode, expected_opcode);
assert_eq!(c.size, expected_size);
let header = [0x58, 0xe3, 0x51, 0x9e, 0x1a, 0x84];
let c = encryption.decrypt_client_header(header);
let expected_size = 4;
let expected_opcode = 55; assert_eq!(c.opcode, expected_opcode);
assert_eq!(c.size, expected_size);
}
#[test]
fn verify_login() {
let session_key = [
115, 0, 100, 222, 18, 15, 156, 194, 27, 1, 216, 229, 165, 207, 78, 233, 183, 241, 248,
73, 190, 142, 14, 89, 44, 235, 153, 190, 103, 206, 34, 88, 45, 199, 104, 175, 79, 108,
93, 48,
];
let username = NormalizedString::new("A").unwrap();
let server_seed = 0xDEADBEEF;
let client_seed = 1266519981;
let client_proof = [
202, 54, 102, 180, 90, 87, 9, 107, 217, 97, 235, 56, 221, 203, 108, 19, 109, 141, 137,
7,
];
let seed = ProofSeed::from_specific_seed(server_seed);
let encryption = seed.into_header_crypto(&username, session_key, client_proof, client_seed);
assert!(encryption.is_ok());
}
#[test]
fn verify_encrypt_and_decrypt() {
let contents = read_to_string("tests/encryption/calculate_tbc_encrypt_values.txt").unwrap();
for line in contents.lines() {
let mut line = line.split_whitespace();
let session_key = SessionKey::from_be_hex_str(line.next().unwrap());
let mut data = hex_decode(line.next().unwrap());
let expected_client = hex_decode(line.next().unwrap());
let expected_server = hex_decode(line.next().unwrap());
let original_data = data.clone();
let mut client = HeaderCrypto::new(*session_key.as_le());
client.encrypt(&mut data);
assert_eq!(data, expected_client);
let mut server = HeaderCrypto::new(*session_key.as_le());
server.decrypt(&mut data);
assert_eq!(data, original_data);
server.encrypt(&mut data);
assert_eq!(data, expected_server);
client.decrypt(&mut data);
assert_eq!(data, original_data);
}
}
#[test]
fn verify_splitting() {
let contents = read_to_string("tests/encryption/calculate_tbc_encrypt_values.txt").unwrap();
for line in contents.lines() {
let mut line = line.split_whitespace();
let session_key = SessionKey::from_be_hex_str(line.next().unwrap());
let mut data = hex_decode(line.next().unwrap());
let expected_client = hex_decode(line.next().unwrap());
let expected_server = hex_decode(line.next().unwrap());
let original_data = data.clone();
let (mut client_enc, mut client_dec) = HeaderCrypto::new(*session_key.as_le()).split();
client_enc.encrypt(&mut data);
assert_eq!(data, expected_client);
let (mut server_enc, mut server_dec) = HeaderCrypto::new(*session_key.as_le()).split();
server_dec.decrypt(&mut data);
assert_eq!(data, original_data);
server_enc.encrypt(&mut data);
assert_eq!(data, expected_server);
client_dec.decrypt(&mut data);
assert_eq!(data, original_data);
}
}
#[test]
fn verify_trait_helpers() {
let session_key = hex_decode(
"2EFEE7B0C177EBBDFF6676C56EFC2339BE9CAD14BF8B54BB5A86FBF81F6D424AA23CC9A3149FB175",
);
let session_key: [u8; SESSION_KEY_LENGTH as usize] = session_key.try_into().unwrap();
let original_data = [
0x3d, 0x9a, 0xe1, 0x96, 0xef, 0x4f, 0x3d, 0x9a, 0xe1, 0x96, 0x3d, 0x9a, 0xe1, 0x96,
0xef, 0x4f, 0x3d, 0x9a, 0xe1, 0x96,
];
let mut encrypt_data = original_data;
let mut encrypted_data = Vec::new();
let mut decrypt_data = original_data;
let decrypted_data = original_data.clone().to_vec();
let client_proof = [
171, 16, 181, 52, 139, 193, 19, 213, 173, 100, 0, 37, 65, 184, 70, 148, 36, 169, 17,
228,
];
let mut encryption = ProofSeed::from_specific_seed(0xDEADBEEF)
.into_header_crypto(
&NormalizedString::new("A").unwrap(),
session_key,
client_proof,
0,
)
.unwrap();
let mut helper_encryption = ProofSeed::from_specific_seed(0xDEADBEEF)
.into_header_crypto(
&NormalizedString::new("A").unwrap(),
session_key,
client_proof,
0,
)
.unwrap();
encryption
.write_encrypted_client_header(&mut encrypted_data, 0x3d9a, 0x4fef96e1)
.unwrap();
encryption
.write_encrypted_server_header(&mut encrypted_data, 0x3d9a, 0x96e1)
.unwrap();
encrypted_data.append(
&mut encryption
.encrypt_client_header(0x3d9a, 0x4fef96e1)
.to_vec(),
);
encrypted_data.append(&mut encryption.encrypt_server_header(0x3d9a, 0x96e1).to_vec());
helper_encryption.encrypt(&mut encrypt_data);
assert_eq!(encrypted_data, encrypt_data);
encryption.decrypt(&mut decrypt_data);
let c = helper_encryption
.read_and_decrypt_client_header(&mut decrypted_data[0..6].to_vec().as_slice())
.unwrap();
assert_eq!(
c.size,
u16::from_be_bytes(decrypt_data[0..2].try_into().unwrap())
);
assert_eq!(
c.opcode,
u32::from_le_bytes(decrypt_data[2..6].try_into().unwrap())
);
let s = helper_encryption
.read_and_decrypt_server_header(&mut decrypted_data[6..10].to_vec().as_slice())
.unwrap();
assert_eq!(
s.size,
u16::from_be_bytes(decrypt_data[6..8].try_into().unwrap())
);
assert_eq!(
s.opcode,
u16::from_le_bytes(decrypt_data[8..10].try_into().unwrap())
);
let c = helper_encryption.decrypt_client_header(decrypted_data[10..16].try_into().unwrap());
assert_eq!(
c.size,
u16::from_be_bytes(decrypt_data[10..12].try_into().unwrap())
);
assert_eq!(
c.opcode,
u32::from_le_bytes(decrypt_data[12..16].try_into().unwrap())
);
let s = helper_encryption.decrypt_server_header(decrypted_data[16..20].try_into().unwrap());
assert_eq!(
s.size,
u16::from_be_bytes(decrypt_data[16..18].try_into().unwrap())
);
assert_eq!(
s.opcode,
u16::from_le_bytes(decrypt_data[18..20].try_into().unwrap())
);
}
}