Borehole · Project · free tier
xtls/xray-core
Free reading: not for reliance
556767e · 2,123 commits · 1,190 files
Read 2026-11-03

xtls/xray-core: technical due diligence, read from its repository

What Borehole read in xtls/xray-core's code and history at 556767e: its licence, security advisories, releases, review practice, tests, dependencies and operations. Every finding cites the file and line it rests on. The full report also covers the team and asks the questions the code cannot answer.

DimensionRating
Architecture & Codebase — including AI provenancestrong
Engineering Process & SDLC Maturitystrong
Product & Engineering Maturitystrong
Security & Reliability Posturestrong
Observability & Operationsnot assessable
Fit with the Acquirernot assessable

Architecture & Codebase — including AI provenance

strong
01.6

infra/conf/transport_finalmask.go is 1,308 lines, 13× this codebase's median file

adequate

The median source file here is 97 lines. 6 files exceed 1,000 lines, the largest being 1,308. Size is not a defect on its own — some problems genuinely live in one place — but these are where merge conflicts, review fatigue and single-owner knowledge concentrate, and they are the first thing that slows an inheriting engineer down.

Evidence
infra/conf/transport_finalmask.go:1 — 1,308 lines (13× median)
proxy/tun/tcp_lightweight.go:1 — 1,262 lines (13× median)
infra/conf/transport_method.go:1 — 1,089 lines (11× median)
transport/internet/hysteria/congestion/bbr/bbr_sender.go:1 — 1,089 lines (11× median)
proxy/tun/tun_freebsd.go:1 — 1,037 lines (10× median)

Engineering Process & SDLC Maturity

strong
02.6

Almost no process scaffolding exists in the repository

adequate

Of five ordinary markers — CI workflows, CODEOWNERS, a pull-request template, pre-commit hooks, contribution guidance — 1 is present: CI workflows. Branch protection itself is a GitHub setting rather than a file, so this is a reading of proxies and not of the rules themselves. What it does establish is that the process is not written down anywhere a new engineer would find it.

Evidence
1 of 5 markers present across 1,190 tracked files

Product & Engineering Maturity

strong

No finding.

Security & Reliability Posture

strong
05.27

The build runs third-party code it does not pin

adequate

6 third-party CI actions are referenced by a tag or branch rather than a commit, so they run whatever that tag points to on the day. Tags have been moved to malicious commits in real supply-chain attacks, and a piped script is whatever the server returns that minute. Pinning to a commit is the fix, and it is small.

Evidence
.github/workflows/docker.yml:79 — action pinned by tag
.github/workflows/docker.yml:82 — action pinned by tag
05.65

1 advisory against this project in the last 24 months, 1 high or critical

adequate

The newest was published on 2026-07-10. A project that publishes advisories is telling its users about its fixes, and the count and pace say how much security work it carries. None of them affects the surveyed version.

Evidence
2026-07-10: GHSA-5wf9-h793-w73c (high), fixed in 1.260327.1-0.20260710210335-64fada32b5b9: Xray-core: Pinning a CA certificate via pinnedPeerCertSha256 can lead to the success of MITM attacks

Observability & Operations

not assessable

Not rated: only 5 of 16 checks could reach a conclusion here; the rest do not apply to this repository or could not read it.

Fit with the Acquirer

not assessable

Not rated: structurally not assessable from a repository.

Read more, or read your own

The full report on xtls/xray-core: every dimension, the questions for the room, and the audit log.

Survey a repository: free on public repositories. Private code is read on your own machine by a collector whose source you can read first.