You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
docs: expand Direct Login section — local bunker, remote bunker, dependency chain
Full three-subsection breakdown on both landing page and README:
local bunker (peer-to-peer, no relay), remote bunker (your relay,
no discovery), and the dependency chain NSE eliminates.
Copy file name to clipboardExpand all lines: README.md
+16-2Lines changed: 16 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -98,7 +98,9 @@ Products like [NostrKey](https://nostrkey.com) use NSE to protect keys in the br
98
98
99
99
## Direct Login — No Relay Required
100
100
101
-
Traditional NIP-46 bunker logins require both sides to connect through a Nostr relay for discovery and message passing. NSE changes that. When the signer is **local** — built into a browser extension or the app itself — signing is a direct, peer-to-peer operation. No relay lookup, no network round-trip, no discovery protocol.
101
+
### Local bunker (no relay needed at all)
102
+
103
+
This is the big one. When NSE is built into the product — say NostrKey browser extension — the signer and the app are on the same device. A web app calls `window.nostr.signEvent()` (NIP-07), the extension uses NSE to decrypt the key, signs, returns. No relay round-trip, no discovery, no latency. The NIP-46 contract is the API shape, but the transport is local — `chrome.runtime` messaging, App Groups on iOS, etc.
102
104
103
105
Think of it like an **SSH key**. The key lives on your device. When a site asks you to prove your identity, the extension decrypts and signs locally. The Nostr network isn't involved in the authentication — only in what you do after.
104
106
@@ -112,7 +114,19 @@ NSE direct login:
112
114
(peer-to-peer, instant, works offline)
113
115
```
114
116
115
-
For **cross-device** signing (phone as bunker for desktop), you still need a relay — but it can be **your own** relay with a known address. No public relay discovery, no hoping a third-party relay stays online. The connection is direct and deterministic, like pointing SSH at a specific host.
117
+
### Remote bunker (your relay, no lookup)
118
+
119
+
When the phone acts as bunker for the desktop (NostrKeep Signer signing for a web app), you still need a relay — but it's **your** relay. `relay.nostrkeep.com` is already built and deployed. Both ends know where to connect because you control the product. No `bunker://` URI parsing, no public relay discovery, no hoping some random relay is online. NSE handles the key protection on the phone, the relay handles the transport.
120
+
121
+
### The dependency chain NSE eliminates
122
+
123
+
Before NSE:
124
+
- You needed a third-party signer (nsecBunker, etc.)
125
+
- Which needed a public relay both sides agreed on
126
+
- Which needed relay discovery or manual `bunker://` URIs
127
+
- And the key was stored in software anyway
128
+
129
+
Now the whole stack is yours: **NSE protects the key, NostrKey/NostrKeep is the signer, your relay is the transport.** Built in by design, not bolted on after.
0 commit comments