Skip to content

v0.1.0

Latest

Choose a tag to compare

@zxdev zxdev released this 04 Jul 22:57

First release of github.com/netstar-labs/dns — a minimal, zero-dependency DNS wire-format client for Go.

What it does that net.Resolver can't

  • CAA lookups (RFC 8659) — the standard library has no API for them
  • Rcode visibilitySERVFAIL vs REFUSED vs NXDOMAIN are distinct, not hidden behind opaque errors
  • Per-query resolver targeting, DNS-over-TLS (RFC 7858), the AD (DNSSEC-validated) bit, and Extended DNS Errors (RFC 8914)

Single-question queries for A/AAAA/NS/CNAME/PTR/SOA/MX/TXT/CAA over UDP/TCP/DoT, with typed answer records.

Batteries (all stdlib-only)

  • codex — folds a host's lookups into one composite bit flag, with resolver-filtering detection: ZERO_IP, SINKHOLE, FILTERED, and VERDICT (cross-resolver disagreement)
  • pool — resolver-pool failover ladder with @qps pacing
  • cmd/dnscodex — streaming NDJSON CLI
  • sinkhole-gen — refs generator that derives block-page IPs by live observation

Install

go get github.com/netstar-labs/dns@v0.1.0

Benchmarks, architecture, and the threat-signal guide are in docs/. GPL-3.0.