{"record":{"id":"748a92acc9f6729e","repo":"Pumpkin-MC/Pumpkin","slug":"packet-length-is-out-of-bounds","errorCode":null,"errorMessage":"packet length is out of bounds","messagePattern":"packet length is out of bounds","errorType":"exception","errorClass":"PacketDecodeError","httpStatus":null,"severity":"error","filePath":"crates/pumpkin-protocol/src/lib.rs","lineNumber":305,"sourceCode":"\n/// Errors that can occur during packet encoding.\n#[derive(Error, Debug)]\npub enum PacketEncodeError {\n    #[error(\"Packet exceeds maximum length: {0}\")]\n    TooLong(usize),\n    #[error(\"Compression failed {0}\")]\n    CompressionFailed(String),\n    #[error(\"Writing packet failed: {0}\")]\n    Message(String),\n}\n\n#[derive(Error, Debug)]\npub enum PacketDecodeError {\n    #[error(\"failed to decode packet ID\")]\n    DecodeID,\n    #[error(\"packet exceeds maximum length\")]\n    TooLong,\n    #[error(\"packet length is out of bounds\")]\n    OutOfBounds,\n    #[error(\"malformed packet length VarInt: {0}\")]\n    MalformedLength(String),\n    #[error(\"failed to decompress packet: {0}\")]\n    FailedDecompression(String), // Updated to include error details\n    #[error(\"packet is uncompressed but greater than the threshold\")]\n    NotCompressed,\n    #[error(\"the connection has closed\")]\n    ConnectionClosed,\n    #[error(\"{0}\")]\n    Message(String),\n}\n\nimpl From<ReadingError> for PacketDecodeError {\n    fn from(value: ReadingError) -> Self {\n        Self::FailedDecompression(value.to_string())\n    }\n}","sourceCodeStart":287,"sourceCodeEnd":323,"githubUrl":"https://github.com/Pumpkin-MC/Pumpkin/blob/8d4639e25a57c15e47448ec327c780d41bbf2356/crates/pumpkin-protocol/src/lib.rs#L287-L323","documentation":"PacketDecodeError guard during framed packet reading: the declared packet length does not fit the bounds allowed by the protocol framing (negative, larger than the configured maximum, or smaller than a valid header). The offending input is the packet length field read from the wire — a corrupted frame or a hostile/misbehaving connection.","triggerScenarios":"Thrown at crates/pumpkin-protocol/src/lib.rs:305 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Close the connection as the stream is unusable","Range-check the length prefix before reading the body","Log the bad length at debug level"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"8d4639e25a57c15e47448ec327c780d41bbf2356","analyzedAt":"2026-09-09T15:32:22.916Z","contentChangedAt":"2026-09-09T15:32:22.916Z","schemaVersion":2},"datasetVersion":"2026-09-15T23:17:13.987Z"}