mc_headless_auth 0.1.1

Headless Minecraft Server Authentication
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85

use std::any::Any;

use crossbeam::channel::SendError;
use rsa::pkcs8::spki;
use simdnbt::owned::NbtTag;
use thiserror::Error;

use crate::{channel_message::ChannelMessage, minecraft::packet::Packet};

/// Top-level Error structure  
#[derive(Debug, Error)]
pub enum MCHAError {
    #[error("No UUID from LoginStart(username:{0})")]
    NoUuid(String),
    #[error("Failed to send channel message: {0:?}")]
    SendError(#[from] SendError<ChannelMessage>),
    #[error("Failed to join thread: {0:?}")]
    ThreadError(Box<dyn Any + Send + 'static>),
    #[error("Tried to shutdown server when no server is running")]
    NoServerRunning,
    #[error("{0:?}")]
    ServerError(#[from] ServerError),
}

/// Errors that happen in the Minecraft server on each connection  
///
/// Use [`Server::on_error`](crate::Server::on_error) to retreive these errors.  
#[derive(Debug, Error)]
pub enum ServerError {
    #[error("Failed to create a packet type: {0:?}")]
    TypeError(#[from] TypeError),
    #[error("Failed to encode public key: {0:?}")]
    DerError(#[from] der::Error),
    #[error("{0:?}")]
    SpkiError(#[from] spki::Error),
    #[error("{0:?}")]
    RsaError(#[from] rsa::Error),
    #[error("{0:?}")]
    ReqwestError(#[from] reqwest::Error),
    #[error("{0:?}")]
    SerdeJsonError(#[from] serde_json::Error),
    #[error("{0:?}")]
    ImageError(#[from] image::ImageError),
    #[error("Failed to shutdown stream: {0:?}")]
    FailedToShutdownStream(std::io::Error),
    #[error("Failed to create aes encryptor/decryptor: {0:?}")]
    InvalidLength(aes::cipher::InvalidLength),
    #[error("Failed to send channel message: {0:?}")]
    SendError(#[from] SendError<ChannelMessage>),
    #[error("Verify Tokens during Authentication were mismatched, sample: {0:?} != {1:?}")]
    MismatchedVerifyTokens(Vec<u8>, Vec<u8>),
    #[error("Usernames were different during Authentication: {0} != {1}")]
    MismatchedUsernames(String, String),
    #[error("Invalid NbtTag for message, must be either Compound, List(Compound) or String: {0:?}")]
    InvalidMessageNbtTag(NbtTag),
    #[error("Intent in handshake is unknown: {0}")]
    UnknownHandshakeIntent(i32),
}

/// Errors related to writing and reading packets and their data types  
#[derive(Debug, Error)]
pub enum TypeError {
    #[error("VarInt is too big, remaining value: {0}")]
    OversizedVarInt(i32),
    #[error("Packet is too big: {0} > {}", Packet::PACKET_LIMIT)]
    PacketSizeExceedsLimit(i32),
    #[error("Expected packet id: {0}, but got {1}")]
    UnexpectedPacketId(i32, i32),
    #[error("Packet in beta legacy was too big: {0} != {0}")]
    BetaLegacyPacketIsTooBig(u16, u16),

    #[error("Chunk tail was not empty when encrypting/decrypting packet, len:{0}")]
    ChunkTailIsNotEmpty(usize),

    #[error("Failed to read stream: {0:?}")]
    ReadError(std::io::Error),
    #[error("Failed to write to stream: {0:?}")]
    WriteError(std::io::Error),

    #[error("Failed to decompress packet: {0:?}")]
    DecompressError(miniz_oxide::inflate::DecompressError),

    #[error("{0:?}")]
    Utf8Error(#[from] std::string::FromUtf8Error),
}