diff options
| author | dtonon <github@dtonon.com> | 2024-08-29 16:25:15 +0200 |
|---|---|---|
| committer | dtonon <github@dtonon.com> | 2024-08-29 16:37:02 +0200 |
| commit | da34c57e99dbf6cadfb3b4176b7c4ff33ac5674c (patch) | |
| tree | a78154f1572da9cc1a7bba221112e1eecdcf865d /05.md | |
| parent | fade0164f52033314bf0a5ef9bd63c2483afae9b (diff) | |
NIP-05: add identification vs verification note
Diffstat (limited to '05.md')
| -rw-r--r-- | 05.md | 13 |
1 files changed, 9 insertions, 4 deletions
| @@ -58,6 +58,15 @@ A client may implement support for finding users' public keys from _internet ide | |||
| 58 | 58 | ||
| 59 | ## Notes | 59 | ## Notes |
| 60 | 60 | ||
| 61 | ### Identification, not verification | ||
| 62 | |||
| 63 | The NIP-05 is not intended to _verify_ a user, but only to _identify_ them, for the purpose of facilitating the exchange of a contact or their search. | ||
| 64 | Exceptions are people who own (e.g., a company) or are connected (e.g., a project) to a well-known domain, who can exploit NIP-05 as an attestation of their relationship with it, and thus to the organization behind it, thereby gaining an element of trust. | ||
| 65 | |||
| 66 | ### User discovery implementation suggestion | ||
| 67 | |||
| 68 | A client can use this to allow users to search other profiles. If a client has a search box or something like that, a user may be able to type "bob@example.com" there and the client would recognize that and do the proper queries to obtain a pubkey and suggest that to the user. | ||
| 69 | |||
| 61 | ### Clients must always follow public keys, not NIP-05 addresses | 70 | ### Clients must always follow public keys, not NIP-05 addresses |
| 62 | 71 | ||
| 63 | For example, if after finding that `bob@bob.com` has the public key `abc...def`, the user clicks a button to follow that profile, the client must keep a primary reference to `abc...def`, not `bob@bob.com`. If, for any reason, the address `https://bob.com/.well-known/nostr.json?name=bob` starts returning the public key `1d2...e3f` at any time in the future, the client must not replace `abc...def` in his list of followed profiles for the user (but it should stop displaying "bob@bob.com" for that user, as that will have become an invalid `"nip05"` property). | 72 | For example, if after finding that `bob@bob.com` has the public key `abc...def`, the user clicks a button to follow that profile, the client must keep a primary reference to `abc...def`, not `bob@bob.com`. If, for any reason, the address `https://bob.com/.well-known/nostr.json?name=bob` starts returning the public key `1d2...e3f` at any time in the future, the client must not replace `abc...def` in his list of followed profiles for the user (but it should stop displaying "bob@bob.com" for that user, as that will have become an invalid `"nip05"` property). |
| @@ -66,10 +75,6 @@ For example, if after finding that `bob@bob.com` has the public key `abc...def`, | |||
| 66 | 75 | ||
| 67 | Keys must be returned in hex format. Keys in NIP-19 `npub` format are only meant to be used for display in client UIs, not in this NIP. | 76 | Keys must be returned in hex format. Keys in NIP-19 `npub` format are only meant to be used for display in client UIs, not in this NIP. |
| 68 | 77 | ||
| 69 | ### User Discovery implementation suggestion | ||
| 70 | |||
| 71 | A client can also use this to allow users to search other profiles. If a client has a search box or something like that, a user may be able to type "bob@example.com" there and the client would recognize that and do the proper queries to obtain a pubkey and suggest that to the user. | ||
| 72 | |||
| 73 | ### Showing just the domain as an identifier | 78 | ### Showing just the domain as an identifier |
| 74 | 79 | ||
| 75 | Clients may treat the identifier `_@domain` as the "root" identifier, and choose to display it as just the `<domain>`. For example, if Bob owns `bob.com`, he may not want an identifier like `bob@bob.com` as that is redundant. Instead, Bob can use the identifier `_@bob.com` and expect Nostr clients to show and treat that as just `bob.com` for all purposes. | 80 | Clients may treat the identifier `_@domain` as the "root" identifier, and choose to display it as just the `<domain>`. For example, if Bob owns `bob.com`, he may not want an identifier like `bob@bob.com` as that is redundant. Instead, Bob can use the identifier `_@bob.com` and expect Nostr clients to show and treat that as just `bob.com` for all purposes. |