mirror of
https://github.com/fiatjaf/khatru.git
synced 2025-03-25 17:21:43 +01:00
73 lines
2.8 KiB
Markdown
73 lines
2.8 KiB
Markdown
|
---
|
||
|
|
outline: deep
|
||
|
|
---
|
||
|
|
|
||
|
|
# Mixing a `khatru` relay with other HTTP handlers
|
||
|
|
|
||
|
|
If you already have a web server with all its HTML handlers or a JSON HTTP API or anything like that, something like:
|
||
|
|
|
||
|
|
```go
|
||
|
|
func main() {
|
||
|
|
mux := http.NewServeMux()
|
||
|
|
|
||
|
|
mux.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir("./static"))))
|
||
|
|
mux.HandleFunc("/.well-known/nostr.json", handleNIP05)
|
||
|
|
mux.HandleFunc("/page/{page}", handlePage)
|
||
|
|
mux.HandleFunc("/", handleHomePage)
|
||
|
|
|
||
|
|
log.Printf("listening at http://0.0.0.0:8080")
|
||
|
|
http.ListenAndServe("0.0.0.0:8080", mux)
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
Then you can easily inject a relay or two there in alternative paths if you want:
|
||
|
|
|
||
|
|
```diff
|
||
|
|
mux := http.NewServeMux()
|
||
|
|
|
||
|
|
+ relay1 := khatru.NewRelay()
|
||
|
|
+ relay2 := khatru.NewRelay()
|
||
|
|
+ // and so on
|
||
|
|
|
||
|
|
mux.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir("./static"))))
|
||
|
|
mux.HandleFunc("/.well-known/nostr.json", handleNIP05)
|
||
|
|
mux.HandleFunc("/page/{page}", handlePage)
|
||
|
|
mux.HandleFunc("/", handleHomePage)
|
||
|
|
+ mux.Handle("/relay1", relay1)
|
||
|
|
+ mux.Handle("/relay2", relay2)
|
||
|
|
+ // and so forth
|
||
|
|
|
||
|
|
log.Printf("listening at http://0.0.0.0:8080")
|
||
|
|
```
|
||
|
|
|
||
|
|
Imagine each of these relay handlers is different, each can be using a different eventstore and have different policies for writing and reading.
|
||
|
|
|
||
|
|
## Exposing a relay interface at the root
|
||
|
|
|
||
|
|
If you want to expose your relay at the root path `/` that is also possible. You can just use it as the `mux` directly:
|
||
|
|
|
||
|
|
```go
|
||
|
|
func main() {
|
||
|
|
relay := khatru.NewRelay()
|
||
|
|
// ... -- relay configuration steps (omitted for brevity)
|
||
|
|
|
||
|
|
mux := relay.Router() // the relay comes with its own http.ServeMux inside
|
||
|
|
|
||
|
|
mux.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir("./static"))))
|
||
|
|
mux.HandleFunc("/.well-known/nostr.json", handleNIP05)
|
||
|
|
mux.HandleFunc("/page/{page}", handlePage)
|
||
|
|
mux.HandleFunc("/", handleHomePage)
|
||
|
|
|
||
|
|
log.Printf("listening at http://0.0.0.0:8080")
|
||
|
|
http.ListenAndServe("0.0.0.0:8080", mux)
|
||
|
|
}
|
||
|
|
```
|
||
|
|
|
||
|
|
Every [`khatru.Relay`](https://pkg.go.dev/github.com/fiatjaf/khatru#Relay) instance comes with its own ['http.ServeMux`](https://pkg.go.dev/net/http#ServeMux) inside. It ensures all requests are handled normally, but intercepts the requests that are pertinent to the relay operation, specifically the WebSocket requests, and the [NIP-11](https://nips.nostr.com/11) and the [NIP-86](https://nips.nostr.com/86) HTTP requests.
|
||
|
|
|
||
|
|
## Exposing multiple relays at the same path or at the root
|
||
|
|
|
||
|
|
That's also possible, as long as you have a way of differentiating each HTTP request that comes at the middleware level and associating it with a `khatru.Relay` instance in the background.
|
||
|
|
|
||
|
|
See [dynamic](dynamic) for an example that does that using the subdomain. [`countries`](https://git.fiatjaf.com/countries) does it using the requester country implied from its IP address.
|