Index

nip66 ¶

NIP-66 Relay Monitoring and Discovery models.

Implements NIP-66 -- relay capability testing and monitoring data collection. Each test type (RTT, SSL, GEO, NET, DNS, HTTP) has its own data model, logs model, and metadata container. Raw data is sanitized through parse() methods and validated into typed, frozen Pydantic models. Invalid fields or wrong types are silently dropped.

Model hierarchy:

Nip66                                        Top-level container
+-- relay: Relay                             Source relay reference
+-- generated_at: int                        Unix timestamp
+-- rtt: Nip66RttMetadata                    Round-trip time probes
|   +-- data: Nip66RttData
|   +-- logs: Nip66RttMultiPhaseLogs          (open/read/write results)
+-- ssl: Nip66SslMetadata                    SSL/TLS certificate
|   +-- data: Nip66SslData
|   +-- logs: Nip66SslLogs
+-- geo: Nip66GeoMetadata                    Geolocation (GeoIP)
|   +-- data: Nip66GeoData
|   +-- logs: Nip66GeoLogs
+-- net: Nip66NetMetadata                    Network/ASN info
|   +-- data: Nip66NetData
|   +-- logs: Nip66NetLogs
+-- dns: Nip66DnsMetadata                    DNS resolution
|   +-- data: Nip66DnsData
|   +-- logs: Nip66DnsLogs
+-- http: Nip66HttpMetadata                  HTTP server headers
    +-- data: Nip66HttpData
    +-- logs: Nip66HttpLogs

Note

Each test produces a separate RelayMetadata record with a distinct MetadataType variant (NIP66_RTT, NIP66_SSL, NIP66_GEO, NIP66_NET, NIP66_DNS, NIP66_HTTP). Tests are executed concurrently via asyncio.gather in Nip66.create.