1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
|
package websocket
import (
"html/template"
"net/http"
)
var indexTemplate = template.Must(template.New("index").Parse(`<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>muxstr</title>
<style>
body {
font-family: 'Courier New', Courier, monospace;
background: #f5f0e8;
color: #000;
max-width: 720px;
margin: 40px auto;
padding: 0 20px;
line-height: 1.6;
}
h1 {
font-size: 18px;
font-weight: normal;
margin: 20px 0 10px 0;
}
h2 {
font-size: 16px;
font-weight: normal;
margin: 30px 0 10px 0;
}
h3 {
font-size: 14px;
font-weight: normal;
margin: 20px 0 5px 0;
}
p, li {
font-size: 13px;
}
a {
color: #00e;
text-decoration: underline;
}
a:visited {
color: #551a8b;
}
hr {
border: none;
border-top: 1px solid #000;
margin: 30px 0;
}
pre {
font-size: 12px;
line-height: 1.4;
overflow-x: auto;
}
code {
font-family: 'Courier New', Courier, monospace;
font-size: 13px;
}
.hash {
color: #666;
font-size: 11px;
}
ul {
padding-left: 20px;
}
.logo-container {
margin: 20px 0 30px 0;
}
.logo-container svg {
width: 100%;
height: auto;
display: block;
}
</style>
</head>
<body>
<div class="logo-container">
<svg viewBox="0 0 1120 300" xmlns="http://www.w3.org/2000/svg">
<rect width="1120" height="300" fill="#c97556"/>
<text x="560" y="200" font-family="Arial, Helvetica, sans-serif" font-size="180" font-weight="bold" fill="#f5f0e8" text-anchor="middle">muxstr</text>
</svg>
</div>
<p>Muxstr is a Nostr relay providing gRPC, HTTP/JSON, and WebSocket interfaces.</p>
<hr>
<h2>Connection Endpoints</h2>
<h3>gRPC (Native Binary)</h3>
<p><code>{{.GrpcAddr}}</code></p>
<p>High-performance binary protocol using Protocol Buffers over HTTP/2.</p>
<h3>HTTP/JSON</h3>
<p><code>{{.HttpAddr}}/nostr.v1.NostrRelay/*</code></p>
<p>Browser-compatible HTTP interface. Standard JSON over HTTP/1.1 or HTTP/2. CORS enabled.</p>
<h3>WebSocket (Nostr Protocol)</h3>
<p><code>{{.WsAddr}}/</code></p>
<p>Standard Nostr protocol implementation (NIP-01) compatible with all Nostr clients.</p>
<hr>
<h2>Supported NIPs</h2>
<ul>
<li><strong>NIP-01</strong> - Basic protocol flow (EVENT, REQ, CLOSE)</li>
<li><strong>NIP-09</strong> - Event deletion</li>
<li><strong>NIP-11</strong> - Relay information document</li>
</ul>
<hr>
<h2>Implementation Details</h2>
<p><strong>Storage:</strong> SQLite with Write-Ahead Logging<br>
<strong>Event Format:</strong> Binary-first (Protocol Buffers + compressed JSON)<br>
<strong>Validation:</strong> Full cryptographic signature and event ID verification<br>
<strong>Subscriptions:</strong> Real-time event streaming with filter matching<br>
<strong>Deletion:</strong> Hard delete (events are permanently removed)</p>
<hr>
<h2>Technical Notes</h2>
<p>Events are stored in binary format using Protocol Buffers alongside compressed canonical JSON. This dual-storage approach provides both performance (binary queries) and compatibility (JSON export).</p>
<p>The relay validates all events before storage:</p>
<pre>1. Verify event ID matches SHA256(canonical_json)
2. Verify schnorr signature against pubkey
3. Store in SQLite with indexed queries</pre>
<p>Subscriptions use a shared manager across all three protocols. An event published via gRPC will be immediately broadcast to WebSocket subscribers and vice versa.</p>
<hr>
<p><small>This relay is free open-source software. <a href="https://code.northwest.io/muxstr.git/">Source code</a></small></p>
</body>
</html>`))
type IndexData struct {
GrpcAddr string
HttpAddr string
WsAddr string
}
func (h *Handler) ServeIndex(w http.ResponseWriter, r *http.Request, data IndexData) {
w.Header().Set("Content-Type", "text/html; charset=utf-8")
indexTemplate.Execute(w, data)
}
|
