https://github.com/sandwichfarm/nostr-watch
A NIP-66 nostr client for browsing nostr relays
https://github.com/sandwichfarm/nostr-watch
nip-66 nostr nostr-relay
Last synced: 3 months ago
JSON representation
A NIP-66 nostr client for browsing nostr relays
- Host: GitHub
- URL: https://github.com/sandwichfarm/nostr-watch
- Owner: sandwichfarm
- License: mit
- Created: 2022-11-24T11:19:11.000Z (almost 3 years ago)
- Default Branch: next
- Last Pushed: 2025-07-19T21:26:44.000Z (3 months ago)
- Last Synced: 2025-07-19T23:54:20.679Z (3 months ago)
- Topics: nip-66, nostr, nostr-relay
- Language: TypeScript
- Homepage: https://next.nostr.watch
- Size: 90.6 MB
- Stars: 192
- Watchers: 4
- Forks: 475
- Open Issues: 71
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
> @nostrwatch is in heavy development. Legacy nostr.watch is **deprecated and no longer maintained**.
[](https://deepwiki.com/sandwichfarm/nostr-watch)
# @nostrwatch
A Typescript stack for monitoring, auditing, describing and validating anything related to nostr relays. `@nostrwatch` is an [OpenSats](http://opensats.org) grant recipient.
# packages
| package | type | description | status | web | nodejs | deno | cli |notes |
|-----------------------------|----------|------------------------------------------------------------------------------------------------------------------|--------|-----|--------|------|------|-------------------------------------------------|
| @nostrwatch/gui | webapp | NIP-66 nostr client. | alpha | ✓ | | | | |
| @nostrwatch/trawler | agent | Scraps all of the known nostr-verse for relays, sanitizes and dedupes them. | alpha | | | ✓ | | rewrite imminent |
| @nostrwatch/relaymon | agent | Persistently checks relays on a regular interval with many configuration options. | alpha | | | ✓ | ✓ | |
| ~@nostrwatch/nocapd~ | agent | ~Persistently checks relays on a regular interval with many configuration options.~ | alpha | | ✓ | | | ~rewrite imminent~ deprecated |
| @nostrwatch/route66 | library | Library that manages NIP-66 aggregation control flow and provides utilities that help conform to NIP-66 | alpha | ✓ | ✓ | | | |
| @nostrwatch/auditor | library | Checks relays against their advertised supported nips and runs a variety of passive validations along the way. | alpha | ✓ | ✓ | | ✓ | |
| @nostrwatch/nocap | library | Extensible library for checking relay liveness via websocket and optionally fetches geodata, SSL, NIP-11 and DNS | alpha | ✓ | ✓ | | | |
| @nostrwatch/schemata | library | JSON-Schemas for low-level protocol JSON, note kinds, protocol messages and NIP-11 information documents. | alpha | ✓ | ✓ | | | |
| @nostrwatch/schemata-js-ajv | library | Library that wraps ajv and @nostrwatch/schemata to simplify validation of nostr json payloads. | alpha | ✓ | ✓ | | | |
| @nostrwatch/websocket | internal | Isomorphic Websocket wrapper | beta | ✓ | ✓ | ✓ | | |
| @nostrwatch/utils | internal | Variety of utilities that are shared between many packages. | beta | ✓ | ✓ | | | |
| @nostwatch/announce | internal | Basic library for monitor 10166 announcement. | alpha | ✓ | ✓ | ✓ | | rewrite imminent |
| @nostrwatch/db | internal | database used by agents (trawler/relaymon) | alpha | | | ✓ | | |
| ~@nostrwatch/nwcache~ | internal | ~LMDB wrapper for agent data~ | beta | | ✓ | ✓ | | ~needs attention~ deprecated |
| @nostrwatch/publisher | internal | Handles publishing of nostr events | alpha | | | | | |
| @nostrwatch/logger | internal | Logger library used throughout all packages | beta | | ✓ | | | will be replaced with logger from @nostrwatch/auditor |
| @nostrwatch/controlflow | internal | Manages backoff and BullMQ queues | beta | | ✓ | | | will be nuked after @nostrwatch/nocapd rewrite. |
| @nostrwatch/seed | internal | Manages seeding of relays from a variety of different sources. | | | | | | |
_nodejs support is being phased out in favor of deno_
# development
`@nostrwatch` will be open to contributions after the agents have been rewritten, contribution guidelines have been established and documents are in place for all apps, agents and libraries