Skip to content

Security: z23c/z23

Security

.github/SECURITY.md

Security Policy

Supported status

Z23 is pre-v1 and in active stabilization — it is not production-ready, and there are no supported release lines yet. Only the current main branch receives fixes. Do not rely on this build as a mainnet node until the v1 acceptance criteria in docs/MVP.md are met.

Known soft spots are stated plainly in the README status section and in the audit disposition below (for example: off-chain ZMSG P2P messages are currently plaintext on the wire).

Safety and integrity model

Z23 is security-sensitive full-node software, not offensive-security tooling. The repository contains Tor, wallet/key handling, P2P networking, native operator commands, fuzzers, and crash harnesses because those are required to run, inspect, and harden an operator-owned node.

The safety boundary, scanner context, local gates, command authorization, release integrity checks, and reviewer checklist are documented in docs/SECURITY_AND_INTEGRITY.md.

Automated review of pull requests

Every pull request — including from forks — is automatically security-reviewed before it can be merged:

  • pr-security-review.yml runs tools/scripts/pr_security_scan.sh over the PR diff: consensus divergence from zclassicd (docs/CONSENSUS_PARITY_DOCTRINE.md), supply-chain execution (fetch-and-run / decode-and-run / dynamic load / remote installs / new submodules + workflows), committed secrets, and dangerous C calls. A HIGH finding fails the check and blocks the merge.

This is intentionally fork-safe. The scan uses pull_request_target so the workflow and scanner come from the trusted base revision, checks out only the base SHA, and fetches the proposed head as inert Git data. Explicit permissions are read-only, no repository secrets are exposed, and no pull-request script or executable is run. The check result and bounded log are the complete verdict; no write-token comment workflow is involved.

Reporting a vulnerability

Please report vulnerabilities privately via GitHub security advisories on z23c/z23, rather than filing a public issue. If you cannot use advisories, contact the maintainer privately.

There is no bug-bounty program.

Past audits

A third-party security and cryptographic audit was received and triaged in June 2026. The point-by-point disposition record — what was fixed, what was refuted (with citations), and what is deferred and tracked — is folded into "Concrete safeguards".

There aren't any published security advisories