Skip to main content

@webframp/network

v2026.04.22.1

DNS and network probing model that generates diverse diagnostic events.

Tools Required

  • dig (DNS lookups)
  • whois (domain registration info)
  • traceroute (network path tracing)
  • openssl (TLS certificate inspection)

Usage

# Create the network probe model
swamp model create @webframp/network net-probe

# DNS lookup
swamp model method run net-probe dns_lookup --input domain=example.com
swamp model method run net-probe dns_lookup --input domain=example.com --input recordType=MX

# HTTP check
swamp model method run net-probe http_check --input url=https://example.com

# WHOIS lookup
swamp model method run net-probe whois_lookup --input domain=example.com

# TLS certificate check
swamp model method run net-probe cert_check --input host=example.com

# Traceroute
swamp model method run net-probe traceroute --input host=example.com

# Port scan
swamp model method run net-probe port_check --input host=example.com --input ports=[80,443,8080]

Methods

  • dns_lookup - Run dig to resolve DNS records for a domain
  • http_check - Fetch a URL and record status, headers, timing, and redirects
  • whois_lookup - Query WHOIS for domain registration details
  • cert_check - Inspect TLS certificate subject, issuer, and validity dates
  • traceroute - Trace network path to a host
  • port_check - Test TCP connectivity on specific ports

Repository

https://github.com/webframp/swamp-extensions

Labels

networkdnshttpdiagnosticsops

Contents

Quality score

How well-documented and verifiable this extension is.

100%

Grade A

  • Has README or module doc2/2earned
  • README has a code example1/1earned
  • README is substantive1/1earned
  • Most symbols documented1/1earned
  • No slow types1/1earned
  • Has description1/1earned
  • At least one platform tag (or universal)1/1earned
  • Two or more platform tags (or universal)1/1earned
  • License declared1/1earned
  • Verified public repository2/2earned

Install

$ swamp extension pull @webframp/network

@webframp/networkv2026.04.12.1network/probe.ts
dns_lookupRun dig to resolve DNS records for a domain
ArgumentTypeDescription
domainstringDomain name to look up
http_checkFetch a URL and record status code, headers, timing, and redirect chain
ArgumentTypeDescription
urlstringURL to check
whois_lookupQuery WHOIS for domain registration details
ArgumentTypeDescription
domainstringDomain name to look up
cert_checkInspect TLS certificate subject, issuer, and validity dates
ArgumentTypeDescription
hoststringHostname to check
portnumberTLS port to connect to
tracerouteTrace network path to a host
ArgumentTypeDescription
hoststringTarget host to trace
port_checkTest TCP connectivity on specific ports
ArgumentTypeDescription
hoststringTarget host to scan

Resources

dns_records(15m)— DNS lookup results for a domain
http_checks(10m)— HTTP endpoint check results
whois_info(24h)— WHOIS registration data for a domain
cert_info(1h)— TLS certificate details for a host
traceroute(30m)— Network path trace to a host
port_scan(10m)— TCP port connectivity results