Skip to content

fix(photon-targeting): correct off-by-one bounds checks in Packet decode methods#2528

Open
JosephTLockwood wants to merge 1 commit into
PhotonVision:mainfrom
JosephTLockwood:fix/packet-decode-bounds
Open

fix(photon-targeting): correct off-by-one bounds checks in Packet decode methods#2528
JosephTLockwood wants to merge 1 commit into
PhotonVision:mainfrom
JosephTLockwood:fix/packet-decode-bounds

Conversation

@JosephTLockwood

Copy link
Copy Markdown
Contributor

Description

Packet's decode methods guarded each read with readPos + (N - 1) instead of readPos + N, so a decode that needs the last N bytes could read one byte past the end of the buffer. decodeByte with readPos == length throws ArrayIndexOutOfBoundsException — the crash reported in #2376 on 2026.2.2 (Packet.decodeByte, "Index 34 out of bounds for length 34").

Each guard is corrected to readPos + N, and PacketTest adds boundary cases for every decode method (exact-fit decode succeeds; one byte short returns the default instead of throwing).

Closes #2376

Meta

Merge checklist:

  • Pull Request title is a short, imperative summary of proposed changes
  • The description documents the what and why
  • If this PR addresses a bug, a regression test for it is added

…ode methods

Every decode method under-counted the bytes it was about to read:
decodeByte/decodeBoolean checked for zero remaining bytes instead of one,
decodeShort for one instead of two, decodeInt/decodeFloat for three
instead of four, and decodeLong/decodeDouble for seven instead of eight.
A packet truncated at exactly the boundary would read past the end of
the array and throw ArrayIndexOutOfBoundsException instead of returning
the documented default value.

Fix the arithmetic only - the return-default-on-underflow contract is
unchanged. Boundary tests cover each decoder at exact-fit and
one-byte-short, including reads at a non-zero readPos.
@JosephTLockwood JosephTLockwood requested a review from a team as a code owner July 6, 2026 00:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

PhotonVision hit an array out of bound exception with 2026.2.2

1 participant