mirror of
https://github.com/nostr-protocol/nips.git
synced 2025-12-09 08:38:50 +00:00
Compare commits
2 Commits
canonical-
...
nips/302
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
0dd66f0661 | ||
|
|
3bbbe3ad71 |
2
01.md
2
01.md
@@ -81,7 +81,7 @@ This NIP defines 3 standard tags that can be used across all event kinds with th
|
|||||||
- for a parameterized replaceable event: `["a", <kind integer>:<32-bytes lowercase hex of a pubkey>:<d tag value>, <recommended relay URL, optional>]`
|
- for a parameterized replaceable event: `["a", <kind integer>:<32-bytes lowercase hex of a pubkey>:<d tag value>, <recommended relay URL, optional>]`
|
||||||
- for a non-parameterized replaceable event: `["a", <kind integer>:<32-bytes lowercase hex of a pubkey>:, <recommended relay URL, optional>]`
|
- for a non-parameterized replaceable event: `["a", <kind integer>:<32-bytes lowercase hex of a pubkey>:, <recommended relay URL, optional>]`
|
||||||
|
|
||||||
As a convention, all single-letter (only english alphabet letters: a-z, A-Z) key tags are expected to be indexed by relays, such that it is possible, for example, to query or subscribe to events that reference the event `"5c83da77af1dec6d7289834998ad7aafbd9e2191396d75ec3cc27f5a77226f36"` by using the `{"#e": ["5c83da77af1dec6d7289834998ad7aafbd9e2191396d75ec3cc27f5a77226f36"]}` filter.
|
As a convention, all single-letter (only english alphabet letters: a-z, A-Z) key tags are expected to be indexed by relays, such that it is possible, for example, to query or subscribe to events that reference the event `"5c83da77af1dec6d7289834998ad7aafbd9e2191396d75ec3cc27f5a77226f36"` by using the `{"#e": "5c83da77af1dec6d7289834998ad7aafbd9e2191396d75ec3cc27f5a77226f36"}` filter.
|
||||||
|
|
||||||
### Kinds
|
### Kinds
|
||||||
|
|
||||||
|
|||||||
2
04.md
2
04.md
@@ -1,4 +1,4 @@
|
|||||||
> __Warning__ `unrecommended`: deprecated in favor of [NIP-17](17.md)
|
> __Warning__ `unrecommended`: deprecated in favor of [NIP-44](44.md)
|
||||||
|
|
||||||
NIP-04
|
NIP-04
|
||||||
======
|
======
|
||||||
|
|||||||
4
05.md
4
05.md
@@ -35,7 +35,7 @@ It will make a GET request to `https://example.com/.well-known/nostr.json?name=b
|
|||||||
}
|
}
|
||||||
````
|
````
|
||||||
|
|
||||||
or with the **recommended** `"relays"` attribute:
|
or with the **optional** `"relays"` attribute:
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
@@ -50,7 +50,7 @@ or with the **recommended** `"relays"` attribute:
|
|||||||
|
|
||||||
If the pubkey matches the one given in `"names"` (as in the example above) that means the association is right and the `"nip05"` identifier is valid and can be displayed.
|
If the pubkey matches the one given in `"names"` (as in the example above) that means the association is right and the `"nip05"` identifier is valid and can be displayed.
|
||||||
|
|
||||||
The recommended `"relays"` attribute may contain an object with public keys as properties and arrays of relay URLs as values. When present, that can be used to help clients learn in which relays the specific user may be found. Web servers which serve `/.well-known/nostr.json` files dynamically based on the query string SHOULD also serve the relays data for any name they serve in the same reply when that is available.
|
The optional `"relays"` attribute may contain an object with public keys as properties and arrays of relay URLs as values. When present, that can be used to help clients learn in which relays the specific user may be found. Web servers which serve `/.well-known/nostr.json` files dynamically based on the query string SHOULD also serve the relays data for any name they serve in the same reply when that is available.
|
||||||
|
|
||||||
## Finding users from their NIP-05 identifier
|
## Finding users from their NIP-05 identifier
|
||||||
|
|
||||||
|
|||||||
2
07.md
2
07.md
@@ -20,8 +20,6 @@ Aside from these two basic above, the following functions can also be implemente
|
|||||||
async window.nostr.getRelays(): { [url: string]: {read: boolean, write: boolean} } // returns a basic map of relay urls to relay policies
|
async window.nostr.getRelays(): { [url: string]: {read: boolean, write: boolean} } // returns a basic map of relay urls to relay policies
|
||||||
async window.nostr.nip04.encrypt(pubkey, plaintext): string // returns ciphertext and iv as specified in nip-04 (deprecated)
|
async window.nostr.nip04.encrypt(pubkey, plaintext): string // returns ciphertext and iv as specified in nip-04 (deprecated)
|
||||||
async window.nostr.nip04.decrypt(pubkey, ciphertext): string // takes ciphertext and iv as specified in nip-04 (deprecated)
|
async window.nostr.nip04.decrypt(pubkey, ciphertext): string // takes ciphertext and iv as specified in nip-04 (deprecated)
|
||||||
async window.nostr.nip44.encrypt(pubkey, plaintext): string // returns ciphertext as specified in nip-44
|
|
||||||
async window.nostr.nip44.decrypt(pubkey, ciphertext): string // takes ciphertext as specified in nip-44
|
|
||||||
```
|
```
|
||||||
|
|
||||||
### Implementation
|
### Implementation
|
||||||
|
|||||||
26
11.md
26
11.md
@@ -37,7 +37,7 @@ Detailed plain-text information about the relay may be contained in the `descrip
|
|||||||
|
|
||||||
### Pubkey
|
### Pubkey
|
||||||
|
|
||||||
An administrative contact may be listed with a `pubkey`, in the same format as Nostr events (32-byte hex for a `secp256k1` public key). If a contact is listed, this provides clients with a recommended address to send encrypted direct messages (See [NIP-17](17.md)) to a system administrator. Expected uses of this address are to report abuse or illegal content, file bug reports, or request other technical assistance.
|
An administrative contact may be listed with a `pubkey`, in the same format as Nostr events (32-byte hex for a `secp256k1` public key). If a contact is listed, this provides clients with a recommended address to send encrypted direct messages (See `NIP-04`) to a system administrator. Expected uses of this address are to report abuse or illegal content, file bug reports, or request other technical assistance.
|
||||||
|
|
||||||
Relay operators have no obligation to respond to direct messages.
|
Relay operators have no obligation to respond to direct messages.
|
||||||
|
|
||||||
@@ -60,30 +60,6 @@ The relay MAY choose to publish its software version as a string attribute. The
|
|||||||
Extra Fields
|
Extra Fields
|
||||||
------------
|
------------
|
||||||
|
|
||||||
### Virtual Relays
|
|
||||||
|
|
||||||
Some relays want to expose "virtual" addresses to the same underlying dataset or other types of weird functionality. A basic example is a relay that may serve all notes under its `/` path, but only Italian notes under its `/it` path and only Japanese notes under its `/jp` path. In this case clients may use the virtual (`/jp` etc) paths when browsing the relay, for example; but in other situations, like when selecting relays for building a feed for some specific profile, clients should just want to connect to `/`.
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"virtual_path": {
|
|
||||||
"is": true,
|
|
||||||
"canonical": "/",
|
|
||||||
"alternatives": [
|
|
||||||
{"path": "/jp", "description": "only stuff in Japanese"},
|
|
||||||
{"path": "/it", "description": "only stuff in Italian"},
|
|
||||||
{"path": "/fr", "description": "whatever"},
|
|
||||||
{"path": "/pt", "description": "blergh"}
|
|
||||||
]
|
|
||||||
},
|
|
||||||
...
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
- `is`: this is `true` when the current path queried is a virtual path.
|
|
||||||
- `canonical`: this is the path that should be used when the client doesn't care about the virtual.
|
|
||||||
- `alternatives`: optionally, if a relay wants to announce its virtual paths, this may be useful sometimes.
|
|
||||||
|
|
||||||
### Server Limitations
|
### Server Limitations
|
||||||
|
|
||||||
These are limitations imposed by the relay on clients. Your client
|
These are limitations imposed by the relay on clients. Your client
|
||||||
|
|||||||
164
17.md
164
17.md
@@ -1,164 +0,0 @@
|
|||||||
NIP-17
|
|
||||||
======
|
|
||||||
|
|
||||||
Private Direct Messages
|
|
||||||
-----------------------
|
|
||||||
|
|
||||||
`draft` `optional`
|
|
||||||
|
|
||||||
This NIP defines an encrypted direct messaging scheme using [NIP-44](44.md) encryption and [NIP-59](59.md) seals and gift wraps.
|
|
||||||
|
|
||||||
## Direct Message Kind
|
|
||||||
|
|
||||||
Kind `14` is a chat message. `p` tags identify one or more receivers of the message.
|
|
||||||
|
|
||||||
```js
|
|
||||||
{
|
|
||||||
"id": "<usual hash>",
|
|
||||||
"pubkey": "<sender-pubkey>",
|
|
||||||
"created_at": now(),
|
|
||||||
"kind": 14,
|
|
||||||
"tags": [
|
|
||||||
["p", "<receiver-1-pubkey>", "<relay-url>"],
|
|
||||||
["p", "<receiver-2-pubkey>", "<relay-url>"],
|
|
||||||
["e", "<kind-14-id>", "<relay-url>", "reply"] // if this is a reply
|
|
||||||
["subject", "<conversation-title>"],
|
|
||||||
...
|
|
||||||
],
|
|
||||||
"content": "<message-in-plain-text>",
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
`.content` MUST be plain text. Fields `id` and `created_at` are required.
|
|
||||||
|
|
||||||
Tags that mention, quote and assemble threading structures MUST follow [NIP-10](10.md).
|
|
||||||
|
|
||||||
Kind `14`s MUST never be signed. If it is signed, the message might leak to relays and become **fully public**.
|
|
||||||
|
|
||||||
## Chat Rooms
|
|
||||||
|
|
||||||
The set of `pubkey` + `p` tags defines a chat room. If a new `p` tag is added or a current one is removed, a new room is created with clean message history.
|
|
||||||
|
|
||||||
Clients SHOULD render messages of the same room in a continuous thread.
|
|
||||||
|
|
||||||
An optional `subject` tag defines the current name/topic of the conversation. Any member can change the topic by simply submitting a new `subject` to an existing `pubkey` + `p`-tags room. There is no need to send `subject` in every message. The newest `subject` in the thread is the subject of the conversation.
|
|
||||||
|
|
||||||
## Encrypting
|
|
||||||
|
|
||||||
Following [NIP-59](59.md), the **unsigned** `kind:14` chat message must be sealed (`kind:13`) and then gift-wrapped (`kind:1059`) to each receiver and the sender individually.
|
|
||||||
|
|
||||||
```js
|
|
||||||
{
|
|
||||||
"id": "<usual hash>",
|
|
||||||
"pubkey": randomPublicKey,
|
|
||||||
"created_at": randomTimeUpTo2DaysInThePast(),
|
|
||||||
"kind": 1059, // gift wrap
|
|
||||||
"tags": [
|
|
||||||
["p", receiverPublicKey, "<relay-url>"] // receiver
|
|
||||||
],
|
|
||||||
"content": nip44Encrypt(
|
|
||||||
{
|
|
||||||
"id": "<usual hash>",
|
|
||||||
"pubkey": senderPublicKey,
|
|
||||||
"created_at": randomTimeUpTo2DaysInThePast(),
|
|
||||||
"kind": 13, // seal
|
|
||||||
"tags": [], // no tags
|
|
||||||
"content": nip44Encrypt(unsignedKind14, senderPrivateKey, receiverPublicKey),
|
|
||||||
"sig": "<signed by senderPrivateKey>"
|
|
||||||
},
|
|
||||||
randomPrivateKey, receiverPublicKey
|
|
||||||
),
|
|
||||||
"sig": "<signed by randomPrivateKey>"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
The encryption algorithm MUST use the latest version of [NIP-44](44.md).
|
|
||||||
|
|
||||||
Clients MUST verify if pubkey of the `kind:13` is the same pubkey on the `kind:14`, otherwise any sender can impersonate others by simply changing the pubkey on `kind:14`.
|
|
||||||
|
|
||||||
Clients SHOULD randomize `created_at` in up to two days in the past in both the seal and the gift wrap to make sure grouping by `created_at` doesn't reveal any metadata.
|
|
||||||
|
|
||||||
The gift wrap's `p`-tag can be the receiver's main pubkey or an alias key created to receive DMs without exposing the receiver's identity.
|
|
||||||
|
|
||||||
Clients CAN offer disappearing messages by setting an `expiration` tag in the gift wrap of each receiver or by not generating a gift wrap to the sender's public key
|
|
||||||
|
|
||||||
## Publishing
|
|
||||||
|
|
||||||
Kind `10050` indicates the user's preferred relays to receive DMs. The event MUST include a list of `relay` tags with relay URIs.
|
|
||||||
|
|
||||||
```js
|
|
||||||
{
|
|
||||||
"kind": 10050,
|
|
||||||
"tags": [
|
|
||||||
["relay", "wss://inbox.nostr.wine"],
|
|
||||||
["relay", "wss://myrelay.nostr1.com"],
|
|
||||||
],
|
|
||||||
"content": "",
|
|
||||||
//...other fields
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Clients SHOULD publish kind `14` events to the `10050`-listed relays. If that is not found that indicates the user is not ready to receive messages under this NIP and clients shouldn't try.
|
|
||||||
|
|
||||||
## Relays
|
|
||||||
|
|
||||||
It's advisable that relays do not serve `kind:14` to clients other than the ones tagged in them.
|
|
||||||
|
|
||||||
It's advisable that users choose relays that conform to these practices.
|
|
||||||
|
|
||||||
Clients SHOULD guide users to keep `kind:10050` lists small (1-3 relays) and SHOULD spread it to as many relays as viable.
|
|
||||||
|
|
||||||
## Benefits & Limitations
|
|
||||||
|
|
||||||
This NIP offers the following privacy and security features:
|
|
||||||
|
|
||||||
1. **No Metadata Leak**: Participant identities, each message's real date and time, event kinds, and other event tags are all hidden from the public. Senders and receivers cannot be linked with public information alone.
|
|
||||||
2. **No Public Group Identifiers**: There is no public central queue, channel or otherwise converging identifier to correlate or count all messages in the same group.
|
|
||||||
3. **No Moderation**: There are no group admins: no invitations or bans.
|
|
||||||
4. **No Shared Secrets**: No secret must be known to all members that can leak or be mistakenly shared
|
|
||||||
5. **Fully Recoverable**: Messages can be fully recoverable by any client with the user's private key
|
|
||||||
6. **Optional Forward Secrecy**: Users and clients can opt-in for "disappearing messages".
|
|
||||||
7. **Uses Public Relays**: Messages can flow through public relays without loss of privacy. Private relays can increase privacy further, but they are not required.
|
|
||||||
8. **Cold Storage**: Users can unilaterally opt-in to sharing their messages with a separate key that is exclusive for DM backup and recovery.
|
|
||||||
|
|
||||||
The main limitation of this approach is having to send a separate encrypted event to each receiver. Group chats with more than 100 participants should find a more suitable messaging scheme.
|
|
||||||
|
|
||||||
## Implementation
|
|
||||||
|
|
||||||
Clients implementing this NIP should by default only connect to the set of relays found in their `kind:10050` list. From that they should be able to load all messages both sent and received as well as get new live updates, making it for a very simple and lightweight implementation that should be fast.
|
|
||||||
|
|
||||||
When sending a message to anyone, clients must then connect to the relays in the receiver's `kind:10050` and send the events there, but can disconnect right after unless more messages are expected to be sent (e.g. the chat tab is still selected). Clients should also send a copy of their outgoing messages to their own `kind:10050` relay set.
|
|
||||||
|
|
||||||
## Examples
|
|
||||||
|
|
||||||
This example sends the message `Hola, que tal?` from `nsec1w8udu59ydjvedgs3yv5qccshcj8k05fh3l60k9x57asjrqdpa00qkmr89m` to `nsec12ywtkplvyq5t6twdqwwygavp5lm4fhuang89c943nf2z92eez43szvn4dt`.
|
|
||||||
|
|
||||||
The two final GiftWraps, one to the receiver and the other to the sender, are:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"id":"2886780f7349afc1344047524540ee716f7bdc1b64191699855662330bf235d8",
|
|
||||||
"pubkey":"8f8a7ec43b77d25799281207e1a47f7a654755055788f7482653f9c9661c6d51",
|
|
||||||
"created_at":1703128320,
|
|
||||||
"kind":1059,
|
|
||||||
"tags":[
|
|
||||||
[ "p", "918e2da906df4ccd12c8ac672d8335add131a4cf9d27ce42b3bb3625755f0788"]
|
|
||||||
],
|
|
||||||
"content":"AsqzdlMsG304G8h08bE67dhAR1gFTzTckUUyuvndZ8LrGCvwI4pgC3d6hyAK0Wo9gtkLqSr2rT2RyHlE5wRqbCOlQ8WvJEKwqwIJwT5PO3l2RxvGCHDbd1b1o40ZgIVwwLCfOWJ86I5upXe8K5AgpxYTOM1BD+SbgI5jOMA8tgpRoitJedVSvBZsmwAxXM7o7sbOON4MXHzOqOZpALpS2zgBDXSAaYAsTdEM4qqFeik+zTk3+L6NYuftGidqVluicwSGS2viYWr5OiJ1zrj1ERhYSGLpQnPKrqDaDi7R1KrHGFGyLgkJveY/45y0rv9aVIw9IWF11u53cf2CP7akACel2WvZdl1htEwFu/v9cFXD06fNVZjfx3OssKM/uHPE9XvZttQboAvP5UoK6lv9o3d+0GM4/3zP+yO3C0NExz1ZgFmbGFz703YJzM+zpKCOXaZyzPjADXp8qBBeVc5lmJqiCL4solZpxA1865yPigPAZcc9acSUlg23J1dptFK4n3Tl5HfSHP+oZ/QS/SHWbVFCtq7ZMQSRxLgEitfglTNz9P1CnpMwmW/Y4Gm5zdkv0JrdUVrn2UO9ARdHlPsW5ARgDmzaxnJypkfoHXNfxGGXWRk0sKLbz/ipnaQP/eFJv/ibNuSfqL6E4BnN/tHJSHYEaTQ/PdrA2i9laG3vJti3kAl5Ih87ct0w/tzYfp4SRPhEF1zzue9G/16eJEMzwmhQ5Ec7jJVcVGa4RltqnuF8unUu3iSRTQ+/MNNUkK6Mk+YuaJJs6Fjw6tRHuWi57SdKKv7GGkr0zlBUU2Dyo1MwpAqzsCcCTeQSv+8qt4wLf4uhU9Br7F/L0ZY9bFgh6iLDCdB+4iABXyZwT7Ufn762195hrSHcU4Okt0Zns9EeiBOFxnmpXEslYkYBpXw70GmymQfJlFOfoEp93QKCMS2DAEVeI51dJV1e+6t3pCSsQN69Vg6jUCsm1TMxSs2VX4BRbq562+VffchvW2BB4gMjsvHVUSRl8i5/ZSDlfzSPXcSGALLHBRzy+gn0oXXJ/447VHYZJDL3Ig8+QW5oFMgnWYhuwI5QSLEyflUrfSz+Pdwn/5eyjybXKJftePBD9Q+8NQ8zulU5sqvsMeIx/bBUx0fmOXsS3vjqCXW5IjkmSUV7q54GewZqTQBlcx+90xh/LSUxXex7UwZwRnifvyCbZ+zwNTHNb12chYeNjMV7kAIr3cGQv8vlOMM8ajyaZ5KVy7HpSXQjz4PGT2/nXbL5jKt8Lx0erGXsSsazkdoYDG3U",
|
|
||||||
"sig":"a3c6ce632b145c0869423c1afaff4a6d764a9b64dedaf15f170b944ead67227518a72e455567ca1c2a0d187832cecbde7ed478395ec4c95dd3e71749ed66c480"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"id":"162b0611a1911cfcb30f8a5502792b346e535a45658b3a31ae5c178465509721",
|
|
||||||
"pubkey":"626be2af274b29ea4816ad672ee452b7cf96bbb4836815a55699ae402183f512",
|
|
||||||
"created_at":1702711587,
|
|
||||||
"kind":1059,
|
|
||||||
"tags":[
|
|
||||||
[ "p", "44900586091b284416a0c001f677f9c49f7639a55c3f1e2ec130a8e1a7998e1b"]
|
|
||||||
],
|
|
||||||
"content":"AsTClTzr0gzXXji7uye5UB6LYrx3HDjWGdkNaBS6BAX9CpHa+Vvtt5oI2xJrmWLen+Fo2NBOFazvl285Gb3HSM82gVycrzx1HUAaQDUG6HI7XBEGqBhQMUNwNMiN2dnilBMFC3Yc8ehCJT/gkbiNKOpwd2rFibMFRMDKai2mq2lBtPJF18oszKOjA+XlOJV8JRbmcAanTbEK5nA/GnG3eGUiUzhiYBoHomj3vztYYxc0QYHOx0WxiHY8dsC6jPsXC7f6k4P+Hv5ZiyTfzvjkSJOckel1lZuE5SfeZ0nduqTlxREGeBJ8amOykgEIKdH2VZBZB+qtOMc7ez9dz4wffGwBDA7912NFS2dPBr6txHNxBUkDZKFbuD5wijvonZDvfWq43tZspO4NutSokZB99uEiRH8NAUdGTiNb25m9JcDhVfdmABqTg5fIwwTwlem5aXIy8b66lmqqz2LBzJtnJDu36bDwkILph3kmvaKPD8qJXmPQ4yGpxIbYSTCohgt2/I0TKJNmqNvSN+IVoUuC7ZOfUV9lOV8Ri0AMfSr2YsdZ9ofV5o82ClZWlWiSWZwy6ypa7CuT1PEGHzywB4CZ5ucpO60Z7hnBQxHLiAQIO/QhiBp1rmrdQZFN6PUEjFDloykoeHe345Yqy9Ke95HIKUCS9yJurD+nZjjgOxZjoFCsB1hQAwINTIS3FbYOibZnQwv8PXvcSOqVZxC9U0+WuagK7IwxzhGZY3vLRrX01oujiRrevB4xbW7Oxi/Agp7CQGlJXCgmRE8Rhm+Vj2s+wc/4VLNZRHDcwtfejogjrjdi8p6nfUyqoQRRPARzRGUnnCbh+LqhigT6gQf3sVilnydMRScEc0/YYNLWnaw9nbyBa7wFBAiGbJwO40k39wj+xT6HTSbSUgFZzopxroO3f/o4+ubx2+IL3fkev22mEN38+dFmYF3zE+hpE7jVxrJpC3EP9PLoFgFPKCuctMnjXmeHoiGs756N5r1Mm1ffZu4H19MSuALJlxQR7VXE/LzxRXDuaB2u9days/6muP6gbGX1ASxbJd/ou8+viHmSC/ioHzNjItVCPaJjDyc6bv+gs1NPCt0qZ69G+JmgHW/PsMMeL4n5bh74g0fJSHqiI9ewEmOG/8bedSREv2XXtKV39STxPweceIOh0k23s3N6+wvuSUAJE7u1LkDo14cobtZ/MCw/QhimYPd1u5HnEJvRhPxz0nVPz0QqL/YQeOkAYk7uzgeb2yPzJ6DBtnTnGDkglekhVzQBFRJdk740LEj6swkJ",
|
|
||||||
"sig":"c94e74533b482aa8eeeb54ae72a5303e0b21f62909ca43c8ef06b0357412d6f8a92f96e1a205102753777fd25321a58fba3fb384eee114bd53ce6c06a1c22bab"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
7
18.md
7
18.md
@@ -20,10 +20,9 @@ reposted.
|
|||||||
|
|
||||||
## Quote Reposts
|
## Quote Reposts
|
||||||
|
|
||||||
Quote reposts are `kind 1` events with an embedded `q` tag of the note being
|
Quote reposts are `kind 1` events with an embedded `e` tag
|
||||||
quote reposted. The `q` tag ensures quote reposts are not pulled and included
|
(see [NIP-08](08.md) and [NIP-27](27.md)). Because a quote repost includes
|
||||||
as replies in threads. It also allows you to easily pull and count all of the
|
an `e` tag, it may show up along replies to the reposted note.
|
||||||
quotes for a post.
|
|
||||||
|
|
||||||
## Generic Reposts
|
## Generic Reposts
|
||||||
|
|
||||||
|
|||||||
1
24.md
1
24.md
@@ -16,7 +16,6 @@ These are extra fields not specified in NIP-01 that may be present in the string
|
|||||||
- `display_name`: an alternative, bigger name with richer characters than `name`. `name` should always be set regardless of the presence of `display_name` in the metadata.
|
- `display_name`: an alternative, bigger name with richer characters than `name`. `name` should always be set regardless of the presence of `display_name` in the metadata.
|
||||||
- `website`: a web URL related in any way to the event author.
|
- `website`: a web URL related in any way to the event author.
|
||||||
- `banner`: an URL to a wide (~1024x768) picture to be optionally displayed in the background of a profile screen.
|
- `banner`: an URL to a wide (~1024x768) picture to be optionally displayed in the background of a profile screen.
|
||||||
- `bot`: a boolean to clarify that the content is entirely or partially the result of automation, such as with chatbots or newsfeeds.
|
|
||||||
|
|
||||||
### Deprecated fields
|
### Deprecated fields
|
||||||
|
|
||||||
|
|||||||
14
28.md
14
28.md
@@ -23,11 +23,11 @@ Client-centric moderation gives client developers discretion over what types of
|
|||||||
|
|
||||||
Create a public chat channel.
|
Create a public chat channel.
|
||||||
|
|
||||||
In the channel creation `content` field, Client SHOULD include basic channel metadata (`name`, `about`, `picture` and `relays` as specified in kind 41).
|
In the channel creation `content` field, Client SHOULD include basic channel metadata (`name`, `about`, `picture` as specified in kind 41).
|
||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"content": "{\"name\": \"Demo Channel\", \"about\": \"A test channel.\", \"picture\": \"https://placekitten.com/200/200\", \"relays\": [\"wss://nos.lol\", \"wss://nostr.mom\"]}",
|
"content": "{\"name\": \"Demo Channel\", \"about\": \"A test channel.\", \"picture\": \"https://placekitten.com/200/200\"}",
|
||||||
...
|
...
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
@@ -46,7 +46,6 @@ Clients SHOULD support basic metadata fields:
|
|||||||
- `name` - string - Channel name
|
- `name` - string - Channel name
|
||||||
- `about` - string - Channel description
|
- `about` - string - Channel description
|
||||||
- `picture` - string - URL of channel picture
|
- `picture` - string - URL of channel picture
|
||||||
- `relays` - array - List of relays to download and broadcast events to
|
|
||||||
|
|
||||||
Clients MAY add additional metadata fields.
|
Clients MAY add additional metadata fields.
|
||||||
|
|
||||||
@@ -54,7 +53,7 @@ Clients SHOULD use [NIP-10](10.md) marked "e" tags to recommend a relay.
|
|||||||
|
|
||||||
```json
|
```json
|
||||||
{
|
{
|
||||||
"content": "{\"name\": \"Updated Demo Channel\", \"about\": \"Updating a test channel.\", \"picture\": \"https://placekitten.com/201/201\", \"relays\": [\"wss://nos.lol\", \"wss://nostr.mom\"]}",
|
"content": "{\"name\": \"Updated Demo Channel\", \"about\": \"Updating a test channel.\", \"picture\": \"https://placekitten.com/201/201\"}",
|
||||||
"tags": [["e", <channel_create_event_id>, <relay-url>]],
|
"tags": [["e", <channel_create_event_id>, <relay-url>]],
|
||||||
...
|
...
|
||||||
}
|
}
|
||||||
@@ -133,11 +132,12 @@ Clients MAY hide event 42s for users other than the user who sent the event 44.
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
## Relay recommendations
|
## NIP-10 relay recommendations
|
||||||
|
|
||||||
Clients SHOULD use the relay URLs of the metadata events.
|
For [NIP-10](10.md) relay recommendations, clients generally SHOULD use the relay URL of the original (oldest) kind 40 event.
|
||||||
|
|
||||||
|
Clients MAY recommend any relay URL. For example, if a relay hosting the original kind 40 event for a channel goes offline, clients could instead fetch channel data from a backup relay, or a relay that clients trust more than the original relay.
|
||||||
|
|
||||||
Clients MAY use any relay URL. For example, if a relay hosting the original kind 40 event for a channel goes offline, clients could instead fetch channel data from a backup relay, or a relay that clients trust more than the original relay.
|
|
||||||
|
|
||||||
Motivation
|
Motivation
|
||||||
----------
|
----------
|
||||||
|
|||||||
197
29.md
197
29.md
@@ -1,197 +0,0 @@
|
|||||||
NIP-29
|
|
||||||
======
|
|
||||||
|
|
||||||
Relay-based Groups
|
|
||||||
------------------
|
|
||||||
|
|
||||||
`draft` `optional`
|
|
||||||
|
|
||||||
This NIP defines a standard for groups that are only writable by a closed set of users. They can be public for reading by external users or not.
|
|
||||||
|
|
||||||
Groups are identified by a random string of any length that serves as an _id_.
|
|
||||||
|
|
||||||
There is no way to create a group, what happens is just that relays (most likely when asked by users) will create rules around some specific ids so these ids can serve as an actual group, henceforth messages sent to that group will be subject to these rules.
|
|
||||||
|
|
||||||
Normally a group will originally belong to one specific relay, but the community may choose to move the group to other relays or even fork the group so it exists in different forms -- still using the same _id_ -- across different relays.
|
|
||||||
|
|
||||||
## Relay-generated events
|
|
||||||
|
|
||||||
Relays are supposed to generate the events that describe group metadata and group admins. These are parameterized replaceable events signed by the relay keypair directly, with the group _id_ as the `d` tag.
|
|
||||||
|
|
||||||
## Group identifier
|
|
||||||
|
|
||||||
A group may be identified by a string in the format `<host>'<group-id>`. For example, a group with _id_ `abcdef` hosted at the relay `wss://groups.nostr.com` would be identified by the string `groups.nostr.com'abcdef`.
|
|
||||||
|
|
||||||
## The `h` tag
|
|
||||||
|
|
||||||
Events sent by users to groups (chat messages, text notes, moderation events etc) must have an `h` tag with the value set to the group _id_.
|
|
||||||
|
|
||||||
## Timeline references
|
|
||||||
|
|
||||||
In order to not be used out of context, events sent to these groups may contain references to previous events seen from the same relay in the `previous` tag. The choice of which previous events to pick belongs to the clients. The references are to be made using the first 8 characters (4 bytes) of any event in the last 50 events seen by the user in the relay, excluding events by themselves. There can be any number of references (including zero), but it's recommended that clients include at least 3 and that relays enforce this.
|
|
||||||
|
|
||||||
This is a hack to prevent messages from being broadcasted to external relays that have forks of one group out of context. Relays are expected to reject any events that contain timeline references to events not found in their own database. Clients should also check these to keep relays honest about them.
|
|
||||||
|
|
||||||
## Late publication
|
|
||||||
|
|
||||||
Relays should prevent late publication (messages published now with a timestamp from days or even hours ago) unless they are open to receive a group forked or moved from another relay.
|
|
||||||
|
|
||||||
## Event definitions
|
|
||||||
|
|
||||||
- *text root note* (`kind:11`)
|
|
||||||
|
|
||||||
This is the basic unit of a "microblog" root text note sent to a group.
|
|
||||||
|
|
||||||
```js
|
|
||||||
"kind": 11,
|
|
||||||
"content": "hello my friends lovers of pizza",
|
|
||||||
"tags": [
|
|
||||||
["h", "<group-id>"],
|
|
||||||
["previous", "<event-id-first-chars>", "<event-id-first-chars>", ...]
|
|
||||||
]
|
|
||||||
...
|
|
||||||
```
|
|
||||||
|
|
||||||
- *threaded text reply* (`kind:12`)
|
|
||||||
|
|
||||||
This is the basic unit of a "microblog" reply note sent to a group. It's the same as `kind:11`, except for the fact that it must be used whenever it's in reply to some other note (either in reply to a `kind:11` or a `kind:12`). `kind:12` events SHOULD use NIP-10 markers, leaving an empty relay url:
|
|
||||||
|
|
||||||
* `["e", "<kind-11-root-id>", "", "root"]`
|
|
||||||
* `["e", "<kind-12-event-id>", "", "reply"]`
|
|
||||||
|
|
||||||
- *chat message* (`kind:9`)
|
|
||||||
|
|
||||||
This is the basic unit of a _chat message_ sent to a group.
|
|
||||||
|
|
||||||
```js
|
|
||||||
"kind": 9,
|
|
||||||
"content": "hello my friends lovers of pizza",
|
|
||||||
"tags": [
|
|
||||||
["h", "<group-id>"],
|
|
||||||
["previous", "<event-id-first-chars>", "<event-id-first-chars>", ...]
|
|
||||||
]
|
|
||||||
...
|
|
||||||
```
|
|
||||||
|
|
||||||
- *chat message threaded reply* (`kind:10`)
|
|
||||||
|
|
||||||
Similar to `kind:12`, this is the basic unit of a chat message sent to a group. This is intended for in-chat threads that may be hidden by default. Not all in-chat replies MUST use `kind:10`, only when the intention is to create a hidden thread that isn't part of the normal flow of the chat (although clients are free to display those by default too).
|
|
||||||
|
|
||||||
`kind:10` SHOULD use NIP-10 markers, just like `kind:12`.
|
|
||||||
|
|
||||||
- *join request* (`kind:9021`)
|
|
||||||
|
|
||||||
Any user can send one of these events to the relay in order to be automatically or manually added to the group. If the group is `open` the relay will automatically issue a `kind:9000` in response adding this user. Otherwise group admins may choose to query for these requests and act upon them.
|
|
||||||
|
|
||||||
```js
|
|
||||||
{
|
|
||||||
"kind": 9021,
|
|
||||||
"content": "optional reason",
|
|
||||||
"tags": [
|
|
||||||
["h", "<group-id>"]
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
- *moderation events* (`kinds:9000-9020`) (optional)
|
|
||||||
|
|
||||||
Clients can send these events to a relay in order to accomplish a moderation action. Relays must check if the pubkey sending the event is capable of performing the given action. The relay may discard the event after taking action or keep it as a moderation log.
|
|
||||||
|
|
||||||
```js
|
|
||||||
{
|
|
||||||
"kind": 90xx,
|
|
||||||
"content": "optional reason",
|
|
||||||
"tags": [
|
|
||||||
["h", "<group-id>"],
|
|
||||||
["previous", ...]
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Each moderation action uses a different kind and requires different arguments, which are given as tags. These are defined in the following table:
|
|
||||||
|
|
||||||
| kind | name | tags |
|
|
||||||
| --- | --- | --- |
|
|
||||||
| 9000 | `add-user` | `p` (pubkey hex) |
|
|
||||||
| 9001 | `remove-user` | `p` (pubkey hex) |
|
|
||||||
| 9002 | `edit-metadata` | `name`, `about`, `picture` (string) |
|
|
||||||
| 9003 | `add-permission` | `p` (pubkey), `permission` (name) |
|
|
||||||
| 9004 | `remove-permission` | `p` (pubkey), `permission` (name) |
|
|
||||||
| 9005 | `delete-event` | `e` (id hex) |
|
|
||||||
| 9006 | `edit-group-status` | `public` or `private`, `open` or `closed` |
|
|
||||||
|
|
||||||
- *group metadata* (`kind:39000`) (optional)
|
|
||||||
|
|
||||||
This event defines the metadata for the group -- basically how clients should display it. It must be generated and signed by the relay in which is found. Relays shouldn't accept these events if they're signed by anyone else.
|
|
||||||
|
|
||||||
If the group is forked and hosted in multiple relays, there will be multiple versions of this event in each different relay and so on.
|
|
||||||
|
|
||||||
```js
|
|
||||||
{
|
|
||||||
"kind": 39000,
|
|
||||||
"content": "",
|
|
||||||
"tags": [
|
|
||||||
["d", "<group-id>"],
|
|
||||||
["name", "Pizza Lovers"],
|
|
||||||
["picture", "https://pizza.com/pizza.png"],
|
|
||||||
["about", "a group for people who love pizza"],
|
|
||||||
["public"], // or ["private"]
|
|
||||||
["open"] // or ["closed"]
|
|
||||||
]
|
|
||||||
...
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
`name`, `picture` and `about` are basic metadata for the group for display purposes. `public` signals the group can be _read_ by anyone, while `private` signals that only AUTHed users can read. `open` signals that anyone can request to join and the request will be automatically granted, while `closed` signals that members must be pre-approved or that requests to join will be manually handled.
|
|
||||||
|
|
||||||
- *group admins* (`kind:39001`) (optional)
|
|
||||||
|
|
||||||
Similar to the group metadata, this event is supposed to be generated by relays that host the group.
|
|
||||||
|
|
||||||
Each admin gets a label that is only used for display purposes, and a list of permissions it has are listed afterwards. These permissions can inform client building UI, but ultimately are evaluated by the relay in order to become effective.
|
|
||||||
|
|
||||||
The list of capabilities, as defined by this NIP, for now, is the following:
|
|
||||||
|
|
||||||
- `add-user`
|
|
||||||
- `edit-metadata`
|
|
||||||
- `delete-event`
|
|
||||||
- `remove-user`
|
|
||||||
- `add-permission`
|
|
||||||
- `remove-permission`
|
|
||||||
- `edit-group-status`
|
|
||||||
|
|
||||||
```js
|
|
||||||
{
|
|
||||||
"kind": 39001,
|
|
||||||
"content": "list of admins for the pizza lovers group",
|
|
||||||
"tags": [
|
|
||||||
["d", "<group-id>"],
|
|
||||||
["p", "<pubkey1-as-hex>", "ceo", "add-user", "edit-metadata", "delete-event", "remove-user"],
|
|
||||||
["p", "<pubkey2-as-hex>", "secretary", "add-user", "delete-event"]
|
|
||||||
]
|
|
||||||
...
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
- *group members* (`kind:39002`) (optional)
|
|
||||||
|
|
||||||
Similar to *group admins*, this event is supposed to be generated by relays that host the group.
|
|
||||||
|
|
||||||
It's a NIP-51-like list of pubkeys that are members of the group. Relays might choose to not to publish this information or to restrict what pubkeys can fetch it.
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"kind": 39002,
|
|
||||||
"content": "list of members for the pizza lovers group",
|
|
||||||
"tags": [
|
|
||||||
["d", "<group-id>"],
|
|
||||||
["p", "<admin1>"],
|
|
||||||
["p", "<member-pubkey1>"],
|
|
||||||
["p", "<member-pubkey2>"],
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## Storing the list of groups a user belongs to
|
|
||||||
|
|
||||||
A definition for kind `10009` was included in [NIP-51](51.md) that allows clients to store the list of groups a user wants to remember being in.
|
|
||||||
59
302.md
Normal file
59
302.md
Normal file
@@ -0,0 +1,59 @@
|
|||||||
|
NIP-302
|
||||||
|
=========
|
||||||
|
|
||||||
|
Relay Pools
|
||||||
|
-----------
|
||||||
|
|
||||||
|
`draft` `optional`
|
||||||
|
|
||||||
|
# Introduction
|
||||||
|
|
||||||
|
This NIP introduces a system for the creation, management, and utilization of relay pools.
|
||||||
|
|
||||||
|
# Specification
|
||||||
|
|
||||||
|
## Creating a Relay Pool
|
||||||
|
|
||||||
|
Users initiate a relay pool by creating a Nostr event with `kind` 30010.
|
||||||
|
- The `content` field is the description of the relay pool.
|
||||||
|
- A `d` tag has the name of the relay pool (e.g. awesome-pool) as value.
|
||||||
|
- At least one `r` tag MUST be present with the third value as `"pool"`. These pool addresses are URLs clients can connect to.
|
||||||
|
- Zero or more `r` tags with third value as `"member"`, empty string, or missing signify a relay pool member.
|
||||||
|
- Zero or more `auth-required` tags with one of the following values: `nip-42` or `nip-98`. Clients wishing to connect to Relay Pools with an `auth-required` tag MUST support at least one of the NIPs before initiating a connection.
|
||||||
|
|
||||||
|
## Updating the Relay Pool
|
||||||
|
|
||||||
|
To update the relay member list of a relay pool, pool addresses, a new event of kind 30010 with the same `d` tag MUST be published.
|
||||||
|
Pool addresses and member relays are added or removed at any time.
|
||||||
|
|
||||||
|
## Joining a Relay Pool
|
||||||
|
|
||||||
|
Relay operators wishing to join a relay pool publish a Relay Pool Join Request event with `kind` 8000:
|
||||||
|
- `p` tag referencing the pubkey of the Relay Pool (event kind 30010).
|
||||||
|
- `a` tag addressing the kind 30010 event.
|
||||||
|
- a single `r` tag with the relay address (e.g., wss://cool-relay.cool-domain.com).
|
||||||
|
|
||||||
|
## Inclusion in the Relay Pool
|
||||||
|
|
||||||
|
Relay Pool Operators MAY include new member relays by updating the Relay Pool event and adding their `r` tag from the kind 8000 event.
|
||||||
|
|
||||||
|
### Leaving a Relay Pool
|
||||||
|
|
||||||
|
Member Relay Operators can request removal from a relay pool by publishing an Event Deletion (kind 5) referencing their Relay Pool Join Request event (kind 8000).
|
||||||
|
Upon receiving a kind 5 event, the Relay Pool Operator SHOULD issue a new event of kind 30010, removing the `r` tag that references the parting relay.
|
||||||
|
|
||||||
|
# Verification
|
||||||
|
|
||||||
|
Relay Pool Operators MAY require further steps as part of the application process (e.g. proof of work (mined event), payment or out-of-channel communication).
|
||||||
|
Relay Pool Operators MAY respond with kind 1 note to Relay Pool Join Requests events by referencing the event kind 8000 and/or tagging the requester's pubkey.
|
||||||
|
A Relay Pool is only successfully joined once a new Relay Pool event is published including the `r` tag from the Relay Pool Join Request.
|
||||||
|
|
||||||
|
# Client Connection
|
||||||
|
|
||||||
|
Clients can discover relay pools by subscribing to events of kind 30010.
|
||||||
|
Clients MUST connect directly to the relay pool addresses in order to be routed to member relays.
|
||||||
|
Relay Pools SHOULD distribute client connections among Relay Pool Members using a fair algorithm.
|
||||||
|
|
||||||
|
## Proxying and Authentication
|
||||||
|
Relay Pools MAY serve incoming WebSockets connections either by passthrough or by redirect.
|
||||||
|
Relay Pools that require authentication (e.g. for paid relay pools) MUST support either [NIP-42](42.md), [NIP-98](98.md) or both.
|
||||||
151
34.md
151
34.md
@@ -1,151 +0,0 @@
|
|||||||
NIP-34
|
|
||||||
======
|
|
||||||
|
|
||||||
`git` stuff
|
|
||||||
-----------
|
|
||||||
|
|
||||||
`draft` `optional`
|
|
||||||
|
|
||||||
This NIP defines all the ways code collaboration using and adjacent to [`git`](https://git-scm.com/) can be done using Nostr.
|
|
||||||
|
|
||||||
## Repository announcements
|
|
||||||
|
|
||||||
Git repositories are hosted in Git-enabled servers, but their existence can be announced using Nostr events, as well as their willingness to receive patches, bug reports and comments in general.
|
|
||||||
|
|
||||||
```jsonc
|
|
||||||
{
|
|
||||||
"kind": 30617,
|
|
||||||
"content": "",
|
|
||||||
"tags": [
|
|
||||||
["d", "<repo-id>"], // usually kebab-case short name
|
|
||||||
["name", "<human-readable project name>"],
|
|
||||||
["description", "brief human-readable project description>"],
|
|
||||||
["web", "<url for browsing>", ...], // a webpage url, if the git server being used provides such a thing
|
|
||||||
["clone", "<url for git-cloning>", ...], // a url to be given to `git clone` so anyone can clone it
|
|
||||||
["relays", "<relay-url>", ...] // relays that this repository will monitor for patches and issues
|
|
||||||
["earliest-unique-commit", "<commit-id>"] // usually root commit but a recent commit for forks
|
|
||||||
["r", "<earliest-unique-commit-id>"] // so clients can subscribe to all events related to a local git repo
|
|
||||||
["maintainers", "<other-recognized-maintainer>", ...]
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
The tags `web`, `clone`, `relays`, `maintainers` can have multiple values.
|
|
||||||
|
|
||||||
Except `d`, all tags are optional.
|
|
||||||
|
|
||||||
## Patches
|
|
||||||
|
|
||||||
Patches can be sent by anyone to any repository. Patches to a specific repository SHOULD be sent to the relays specified in that repository's announcement event's `"relays"` tag. Patch events SHOULD include an `a` tag pointing to that repository's announcement address.
|
|
||||||
|
|
||||||
Patches in a patch set SHOULD include a NIP-10 `e` `reply` tag pointing to the previous patch.
|
|
||||||
|
|
||||||
The first patch revision in a patch revision SHOULD include a NIP-10 `e` `reply` to the original root patch.
|
|
||||||
|
|
||||||
```jsonc
|
|
||||||
{
|
|
||||||
"kind": 1617,
|
|
||||||
"content": "<patch>", // contents of <git format-patch>
|
|
||||||
"tags": [
|
|
||||||
["a", "30617:<base-repo-owner-pubkey>:<base-repo-id>"],
|
|
||||||
["r", "<earliest-unique-commit-id-of-repo>"] // so clients can subscribe to all patches sent to a local git repo
|
|
||||||
["p", "<repository-owner>"],
|
|
||||||
["p", "<other-user>"], // optionally send the patch to another user to bring it to their attention
|
|
||||||
|
|
||||||
["t", "root"], // ommited for additional patches in a series
|
|
||||||
// for the first patch in a revision
|
|
||||||
["t", "root-revision"],
|
|
||||||
|
|
||||||
// optional tags for when it is desirable that the merged patch has a stable commit id
|
|
||||||
// these fields are necessary for ensuring that the commit resulting from applying a patch
|
|
||||||
// has the same id as it had in the proposer's machine -- all these tags can be omitted
|
|
||||||
// if the maintainer doesn't care about these things
|
|
||||||
["commit", "<current-commit-id>"],
|
|
||||||
["r", "<current-commit-id>"] // so clients can find existing patches for a specific commit
|
|
||||||
["parent-commit", "<parent-commit-id>"],
|
|
||||||
["commit-pgp-sig", "-----BEGIN PGP SIGNATURE-----..."], // empty string for unsigned commit
|
|
||||||
["committer", "<name>", "<email>", "<timestamp>", "<timezone offset in minutes>"],
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
The first patch in a series MAY be a cover letter in the format produced by `git format-patch`.
|
|
||||||
|
|
||||||
## Issues
|
|
||||||
|
|
||||||
Issues are Markdown text that is just human-readable conversational threads related to the repository: bug reports, feature requests, questions or comments of any kind. Like patches, these SHOULD be sent to the relays specified in that repository's announcement event's `"relays"` tag.
|
|
||||||
|
|
||||||
```jsonc
|
|
||||||
{
|
|
||||||
"kind": 1621,
|
|
||||||
"content": "<markdown text>",
|
|
||||||
"tags": [
|
|
||||||
["a", "30617:<base-repo-owner-pubkey>:<base-repo-id>"],
|
|
||||||
["p", "<repository-owner>"]
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## Replies
|
|
||||||
|
|
||||||
Replies are also Markdown text. The difference is that they MUST be issued as replies to either a `kind:1621` _issue_ or a `kind:1617` _patch_ event. The threading of replies and patches should follow NIP-10 rules.
|
|
||||||
|
|
||||||
```jsonc
|
|
||||||
{
|
|
||||||
"kind": 1622,
|
|
||||||
"content": "<markdown text>",
|
|
||||||
"tags": [
|
|
||||||
["a", "30617:<base-repo-owner-pubkey>:<base-repo-id>", "<relay-url>"],
|
|
||||||
["e", "<issue-or-patch-id-hex>", "", "root"],
|
|
||||||
|
|
||||||
// other "e" and "p" tags should be applied here when necessary, following the threading rules of NIP-10
|
|
||||||
["p", "<patch-author-pubkey-hex>", "", "mention"],
|
|
||||||
["e", "<previous-reply-id-hex>", "", "reply"],
|
|
||||||
// ...
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## Status
|
|
||||||
|
|
||||||
Root Patches and Issues have a Status that defaults to 'Open' and can be set by issuing Status events.
|
|
||||||
|
|
||||||
```jsonc
|
|
||||||
{
|
|
||||||
"kind": 1630, // Open
|
|
||||||
"kind": 1631, // Applied / Merged for Patches; Resolved for Issues
|
|
||||||
"kind": 1632, // Closed
|
|
||||||
"kind": 1633, // Draft
|
|
||||||
"content": "<markdown text>",
|
|
||||||
"tags": [
|
|
||||||
["e", "<issue-or-original-root-patch-id-hex>", "", "root"],
|
|
||||||
["e", "<accepted-revision-root-id-hex>", "", "reply"], // for when revisions applied
|
|
||||||
["p", "<repository-owner>"],
|
|
||||||
["p", "<root-event-author>"],
|
|
||||||
["p", "<revision-author>"],
|
|
||||||
|
|
||||||
// optional for improved subscription filter efficency
|
|
||||||
["a", "30617:<base-repo-owner-pubkey>:<base-repo-id>", "<relay-url>"],
|
|
||||||
["r", "<earliest-unique-commit-id-of-repo>"]
|
|
||||||
|
|
||||||
// optional for `1631` status
|
|
||||||
["e", "<applied-or-merged-patch-event-id>", "", "mention"], // for each
|
|
||||||
// when merged
|
|
||||||
["merge-commit", "<merge-commit-id>"]
|
|
||||||
["r", "<merge-commit-id>"]
|
|
||||||
// when applied
|
|
||||||
["applied-as-commits", "<commit-id-in-master-branch>", ...]
|
|
||||||
["r", "<applied-commit-id>"] // for each
|
|
||||||
]
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
The Status event with the largest created_at date is valid.
|
|
||||||
|
|
||||||
The Status of a patch-revision defaults to either that of the root-patch, or `1632` (Closed) if the root-patch's Status is `1631` and the patch-revision isn't tagged in the `1631` event.
|
|
||||||
|
|
||||||
|
|
||||||
## Possible things to be added later
|
|
||||||
|
|
||||||
- "branch merge" kind (specifying a URL from where to fetch the branch to be merged)
|
|
||||||
- inline file comments kind (we probably need one for patches and a different one for merged files)
|
|
||||||
264
46.md
264
46.md
@@ -1,226 +1,98 @@
|
|||||||
# NIP-46 - Nostr Remote Signing
|
NIP-46
|
||||||
|
======
|
||||||
|
|
||||||
## Rationale
|
Nostr Connect
|
||||||
|
-------------
|
||||||
|
|
||||||
Private keys should be exposed to as few systems - apps, operating systems, devices - as possible as each system adds to the attack surface.
|
`draft` `optional`
|
||||||
|
|
||||||
This NIP describes a method for 2-way communication between a remote signer and a Nostr client. The remote signer could be, for example, a hardware device dedicated to signing Nostr events, while the client is a normal Nostr client.
|
This NIP describes a method for 2-way communication between a **remote signer** and a normal Nostr client. The remote signer could be, for example, a hardware device dedicated to signing Nostr events, while the client is a normal Nostr client.
|
||||||
|
|
||||||
## Terminology
|
## Signer Discovery
|
||||||
|
|
||||||
- **Local keypair**: A local public and private key-pair used to encrypt content and communicate with the remote signer. Usually created by the client application.
|
The client always starts by generating a random key which is used to communicate with the signer, then it one of the methods below is used to allow the client to know what is the signer public key for the session and which relays to use.
|
||||||
- **Remote user pubkey**: The public key that the user wants to sign as. The remote signer has control of the private key that matches this public key.
|
|
||||||
- **Remote signer pubkey**: This is the public key of the remote signer itself. This is needed in both `create_account` command because you don't yet have a remote user pubkey.
|
|
||||||
|
|
||||||
All pubkeys specified in this NIP are in hex format.
|
### Started by the signer (nsecBunker)
|
||||||
|
|
||||||
## Initiating a connection
|
The remote signer generates a connection token in the form
|
||||||
|
|
||||||
To initiate a connection between a client and a remote signer there are a few different options.
|
|
||||||
|
|
||||||
### Direct connection initiated by remote signer
|
|
||||||
|
|
||||||
This is most common in a situation where you have your own nsecbunker or other type of remote signer and want to connect through a client that supports remote signing.
|
|
||||||
|
|
||||||
The remote signer would provide a connection token in the form:
|
|
||||||
|
|
||||||
```
|
```
|
||||||
bunker://<remote-user-pubkey>?relay=<wss://relay-to-connect-on>&relay=<wss://another-relay-to-connect-on>&secret=<optional-secret-value>
|
bunker://<hex-pubkey>?relay=wss://...&relay=wss://...&secret=<optional-secret>
|
||||||
```
|
```
|
||||||
|
|
||||||
This token is pasted into the client by the user and the client then uses the details to connect to the remote signer via the specified relay(s).
|
The user copies that token and pastes it in the client UI somehow. Then the client can send events of kind `24133` to the specified relays and wait for responses from the remote signer.
|
||||||
|
|
||||||
### Direct connection initiated by the client
|
### Started by the client
|
||||||
|
|
||||||
In this case, basically the opposite direction of the first case, the client provides a connection token (or encodes the token in a QR code) and the signer initiates a connection to the client via the specified relay(s).
|
The client generates a QR code in the following form (URL-encoded):
|
||||||
|
|
||||||
```
|
```
|
||||||
nostrconnect://<local-keypair-pubkey>?relay=<wss://relay-to-connect-on>&metadata=<json metadata in the form: {"name":"...", "url": "...", "description": "..."}>
|
nostrconnect://<client-key-hex>?relay=wss://...&metadata={"name":"...", "url": "...", "description": "..."}
|
||||||
```
|
```
|
||||||
|
|
||||||
## The flow
|
The signer scans the QR code and sends a `connect` message to the client in the specified relays.
|
||||||
|
|
||||||
1. Client creates a local keypair. This keypair doesn't need to be communicated to the user since it's largely disposable (i.e. the user doesn't need to see this pubkey). Clients might choose to store it locally and they should delete it when the user logs out.
|
## Event payloads
|
||||||
2. Client gets the remote user pubkey (either via a `bunker://` connection string or a NIP-05 login-flow; shown below)
|
|
||||||
3. Clients use the local keypair to send requests to the remote signer by `p`-tagging and encrypting to the remote user pubkey.
|
|
||||||
4. The remote signer responds to the client by `p`-tagging and encrypting to the local keypair pubkey.
|
|
||||||
|
|
||||||
### Example flow for signing an event
|
Event payloads are [NIP-04](04.md)-encrypted JSON blobs that look like JSONRPC messages (their format is specified inside the `.content` of the event formats below).
|
||||||
|
|
||||||
- Remote user pubkey (e.g. signing as) `fa984bd7dbb282f07e16e7ae87b26a2a7b9b90b7246a44771f0cf5ae58018f52`
|
Events sent by the client to the remote signer have the following format:
|
||||||
- Local pubkey is `eff37350d839ce3707332348af4549a96051bd695d3223af4aabce4993531d86`
|
|
||||||
|
|
||||||
#### Signature request
|
```js
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
{
|
||||||
"kind": 24133,
|
"pubkey": "<client-key-hex>"
|
||||||
"pubkey": "eff37350d839ce3707332348af4549a96051bd695d3223af4aabce4993531d86",
|
"kind": 24133,
|
||||||
"content": nip04({
|
"tags": [
|
||||||
"id": <random_string>,
|
["p", "<signer-key-hex>"]
|
||||||
"method": "sign_event",
|
],
|
||||||
"params": [json_stringified(<{
|
"content": "nip04_encrypted_json({id: <random-string>, method: <see-below>, params: [array_of_strings]})",
|
||||||
content: "Hello, I'm signing remotely",
|
...
|
||||||
pubkey: "fa984bd7dbb282f07e16e7ae87b26a2a7b9b90b7246a44771f0cf5ae58018f52",
|
|
||||||
// ...the rest of the event data
|
|
||||||
}>)]
|
|
||||||
}),
|
|
||||||
"tags": [["p", "fa984bd7dbb282f07e16e7ae87b26a2a7b9b90b7246a44771f0cf5ae58018f52"]], // p-tags the remote user pubkey
|
|
||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Response event
|
And the events the remote signer sends to the client have the following format:
|
||||||
|
|
||||||
```json
|
```js
|
||||||
{
|
"pubkey": "<signer-key-hex>"
|
||||||
"kind": 24133,
|
"kind": 24133,
|
||||||
"pubkey": "fa984bd7dbb282f07e16e7ae87b26a2a7b9b90b7246a44771f0cf5ae58018f52",
|
"tags": [
|
||||||
"content": nip04({
|
["p", "<client-key-hex>"]
|
||||||
"id": <random_string>,
|
],
|
||||||
"result": json_stringified(<signed-event>)
|
"content": "nip04_encrypted_json({id: <request-id>, result: <string>, error: <reason-string>})",
|
||||||
}),
|
...
|
||||||
"tags": [["p", "eff37350d839ce3707332348af4549a96051bd695d3223af4aabce4993531d86"]], // p-tags the local keypair pubkey
|
|
||||||
}
|
|
||||||
```
|
```
|
||||||
|
|
||||||
#### Diagram
|
The signer key will always be the key of the user who controls the signer device.
|
||||||
|
|
||||||

|
### Methods
|
||||||
|
|
||||||
## Request Events `kind: 24133`
|
- **connect**
|
||||||
|
- params: [`pubkey`, `secret`]
|
||||||
```json
|
- result: `"ack"`
|
||||||
{
|
- **get_public_key**
|
||||||
"id": <id>,
|
- params: []
|
||||||
"kind": 24133,
|
- result: `pubkey-hex`
|
||||||
"pubkey": <local_keypair_pubkey>,
|
- **sign_event**
|
||||||
"content": <nip04(<request>)>,
|
- params: [`event`]
|
||||||
"tags": [["p", <remote_user_pubkey>]], // NB: in the `create_account` event, the remote signer pubkey should be `p` tagged.
|
- result: `json_string(event_with_pubkey_id_and_signature)`
|
||||||
"created_at": <unix timestamp in seconds>
|
- **get_relays**
|
||||||
}
|
- params: []
|
||||||
```
|
- result: `json_string({[url: string]: {read: boolean, write: boolean}})`
|
||||||
|
- **nip04_encrypt**
|
||||||
The `content` field is a JSON-RPC-like message that is [NIP-04](https://github.com/nostr-protocol/nips/blob/master/04.md) encrypted and has the following structure:
|
- params: [`third-party-pubkey`, `plaintext`]
|
||||||
|
- result: `nip04-ciphertext`
|
||||||
```json
|
- **nip04_decrypt**
|
||||||
{
|
- params: [`third-party-pubkey`, `nip04-ciphertext`]
|
||||||
"id": <random_string>,
|
- result: `plaintext`
|
||||||
"method": <method_name>,
|
- **nip44_get_key**
|
||||||
"params": [array_of_strings]
|
- params: [`third-party-pubkey`]
|
||||||
}
|
- result: `nip44-conversation-key`
|
||||||
```
|
- **nip44_encrypt**
|
||||||
|
- params: [`third-party-pubkey`, `plaintext`]
|
||||||
- `id` is a random string that is a request ID. This same ID will be sent back in the response payload.
|
- result: `nip44-ciphertext`
|
||||||
- `method` is the name of the method/command (detailed below).
|
- **nip44_decrypt**
|
||||||
- `params` is a positional array of string parameters.
|
- params: [`third-party-pubkey`, `nip44-ciphertext`]
|
||||||
|
- result: `plaintext`
|
||||||
### Methods/Commands
|
- **ping**
|
||||||
|
- params: []
|
||||||
Each of the following are methods that the client sends to the remote signer.
|
- result: `"pong"`
|
||||||
|
|
||||||
| Command | Params | Result |
|
|
||||||
| ------------------------ | ------------------------------------------------- | ---------------------------------------------------------------------- |
|
|
||||||
| `connect` | `[<remote_user_pubkey>, <optional_secret>, <optional_requested_permissions>]` | "ack" |
|
|
||||||
| `sign_event` | `[<json_stringified_event_to_sign>]` | `json_stringified(<signed_event>)` |
|
|
||||||
| `ping` | `[]` | "pong" |
|
|
||||||
| `get_relays` | `[]` | `json_stringified({<relay_url>: {read: <boolean>, write: <boolean>}})` |
|
|
||||||
| `get_public_key` | `[]` | `<hex-pubkey>` |
|
|
||||||
| `nip04_encrypt` | `[<third_party_pubkey>, <plaintext_to_encrypt>]` | `<nip04_ciphertext>` |
|
|
||||||
| `nip04_decrypt` | `[<third_party_pubkey>, <nip04_ciphertext_to_decrypt>]` | `<plaintext>` |
|
|
||||||
| `nip44_encrypt` | `[<third_party_pubkey>, <plaintext_to_encrypt>]` | `<nip44_ciphertext>` |
|
|
||||||
| `nip44_decrypt` | `[<third_party_pubkey>, <nip44_ciphertext_to_decrypt>]` | `<plaintext>` |
|
|
||||||
|
|
||||||
### Requested permissions
|
|
||||||
|
|
||||||
The `connect` method may be provided with `optional_requested_permissions` for user convenience. The permissions are a comma-separated list of `method[:params]`, i.e. `nip04_encrypt,sign_event:4` meaning permissions to call `nip04_encrypt` and to call `sign_event` with `kind:4`. Optional parameter for `sign_event` is the kind number, parameters for other methods are to be defined later.
|
|
||||||
|
|
||||||
## Response Events `kind:24133`
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"id": <id>,
|
|
||||||
"kind": 24133,
|
|
||||||
"pubkey": <remote_signer_pubkey>,
|
|
||||||
"content": <nip04(<response>)>,
|
|
||||||
"tags": [["p", <local_keypair_pubkey>]],
|
|
||||||
"created_at": <unix timestamp in seconds>
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
The `content` field is a JSON-RPC-like message that is [NIP-04](https://github.com/nostr-protocol/nips/blob/master/04.md) encrypted and has the following structure:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"id": <request_id>,
|
|
||||||
"result": <results_string>,
|
|
||||||
"error": <optional_error_string>
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
- `id` is the request ID that this response is for.
|
|
||||||
- `results` is a string of the result of the call (this can be either a string or a JSON stringified object)
|
|
||||||
- `error`, _optionally_, it is an error in string form, if any. Its presence indicates an error with the request.
|
|
||||||
|
|
||||||
### Auth Challenges
|
|
||||||
|
|
||||||
An Auth Challenge is a response that a remote signer can send back when it needs the user to authenticate via other means. This is currently used in the OAuth-like flow enabled by signers like [Nsecbunker](https://github.com/kind-0/nsecbunkerd/). The response `content` object will take the following form:
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"id": <request_id>,
|
|
||||||
"result": "auth_url",
|
|
||||||
"error": <URL_to_display_to_end_user>
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
Clients should display (in a popup or new tab) the URL from the `error` field and then subscribe/listen for another response from the remote signer (reusing the same request ID). This event will be sent once the user authenticates in the other window (or will never arrive if the user doesn't authenticate). It's also possible to add a `redirect_uri` url parameter to the auth_url, which is helpful in situations when a client cannot open a new window or tab to display the auth challenge.
|
|
||||||
|
|
||||||
#### Example event signing request with auth challenge
|
|
||||||
|
|
||||||

|
|
||||||
|
|
||||||
## Remote Signer Commands
|
|
||||||
|
|
||||||
Remote signers might support additional commands when communicating directly with it. These commands follow the same flow as noted above, the only difference is that when the client sends a request event, the `p`-tag is the pubkey of the remote signer itself and the `content` payload is encrypted to the same remote signer pubkey.
|
|
||||||
|
|
||||||
### Methods/Commands
|
|
||||||
|
|
||||||
Each of the following are methods that the client sends to the remote signer.
|
|
||||||
|
|
||||||
| Command | Params | Result |
|
|
||||||
| ---------------- | ------------------------------------------ | ------------------------------------ |
|
|
||||||
| `create_account` | `[<username>, <domain>, <optional_email>, <optional_requested_permissions>]` | `<newly_created_remote_user_pubkey>` |
|
|
||||||
|
|
||||||
## Appendix
|
|
||||||
|
|
||||||
### NIP-05 Login Flow
|
|
||||||
|
|
||||||
Clients might choose to present a more familiar login flow, so users can type a NIP-05 address instead of a `bunker://` string.
|
|
||||||
|
|
||||||
When the user types a NIP-05 the client:
|
|
||||||
|
|
||||||
- Queries the `/.well-known/nostr.json` file from the domain for the NIP-05 address provided to get the user's pubkey (this is the **remote user pubkey**)
|
|
||||||
- In the same `/.well-known/nostr.json` file, queries for the `nip46` key to get the relays that the remote signer will be listening on.
|
|
||||||
- Now the client has enough information to send commands to the remote signer on behalf of the user.
|
|
||||||
|
|
||||||
### OAuth-like Flow
|
|
||||||
|
|
||||||
#### Remote signer discovery via NIP-89
|
|
||||||
|
|
||||||
In this last case, most often used to fascilitate an OAuth-like signin flow, the client first looks for remote signers that have announced themselves via NIP-89 application handler events.
|
|
||||||
|
|
||||||
First the client will query for `kind: 31990` events that have a `k` tag of `24133`.
|
|
||||||
|
|
||||||
These are generally shown to a user, and once the user selects which remote signer to use and provides the remote user pubkey they want to use (via npub, pubkey, or nip-05 value), the client can initiate a connection. Note that it's on the user to select the remote signer that is actually managing the remote key that they would like to use in this case. If the remote user pubkey is managed on another remote signer, the connection will fail.
|
|
||||||
|
|
||||||
In addition, it's important that clients validate that the pubkey of the announced remote signer matches the pubkey of the `_` entry in the `/.well-known/nostr.json` file of the remote signer's announced domain.
|
|
||||||
|
|
||||||
Clients that allow users to create new accounts should also consider validating the availability of a given username in the namespace of remote signer's domain by checking the `/.well-known/nostr.json` file for existing usernames. Clients can then show users feedback in the UI before sending a `create_account` event to the remote signer and receiving an error in return. Ideally, remote signers would also respond with understandable error messages if a client tries to create an account with an existing username.
|
|
||||||
|
|
||||||
#### Example Oauth-like flow to create a new user account with Nsecbunker
|
|
||||||
|
|
||||||
Coming soon...
|
|
||||||
|
|
||||||
## References
|
|
||||||
|
|
||||||
- [NIP-04 - Encryption](https://github.com/nostr-protocol/nips/blob/master/04.md)
|
|
||||||
|
|||||||
34
49.md
34
49.md
@@ -12,17 +12,17 @@ This NIP defines a method by which clients can encrypt (and decrypt) a user's pr
|
|||||||
Symmetric Encryption Key derivation
|
Symmetric Encryption Key derivation
|
||||||
-----------------------------------
|
-----------------------------------
|
||||||
|
|
||||||
PASSWORD = Read from the user. The password should be unicode normalized to NFKC format to ensure that the password can be entered identically on other computers/clients.
|
PASSWORD = read from the user
|
||||||
|
|
||||||
LOG\_N = Let the user or implementer choose one byte representing a power of 2 (e.g. 18 represents 262,144) which is used as the number of rounds for scrypt. Larger numbers take more time and more memory, and offer better protection:
|
LOG\_N = Let the user or implementer choose one byte representing a power of 2 (e.g. 18 represents 262,144) which is used as the number of rounds for scrypt. Larger numbers take more time and more memory, and offer better protection:
|
||||||
|
|
||||||
| LOG_N | MEMORY REQUIRED | APPROX TIME ON FAST COMPUTER |
|
| LOG\_N | MEMORY REQUIRED | APPROX TIME ON FAST COMPUTER |
|
||||||
|-------|-----------------|----------------------------- |
|
|--------|-----------------|----------------------------- |
|
||||||
| 16 | 64 MiB | 100 ms |
|
| 16 | 64 MiB | 100 ms |
|
||||||
| 18 | 256 MiB | |
|
| 18 | 256 MiB | |
|
||||||
| 20 | 1 GiB | 2 seconds |
|
| 20 | 1 GiB | 2 seconds |
|
||||||
| 21 | 2 GiB | |
|
| 21 | 2 GiB | |
|
||||||
| 22 | 4 GiB | |
|
| 22 | 4 GiB | |
|
||||||
|
|
||||||
SALT = 16 random bytes
|
SALT = 16 random bytes
|
||||||
|
|
||||||
@@ -78,22 +78,6 @@ The decryption process operates in the reverse.
|
|||||||
Test Data
|
Test Data
|
||||||
---------
|
---------
|
||||||
|
|
||||||
## Password Unicode Normalization
|
|
||||||
|
|
||||||
The following password input: "ÅΩẛ̣"
|
|
||||||
- Unicode Codepoints: U+212B U+2126 U+1E9B U+0323
|
|
||||||
- UTF-8 bytes: [0xE2, 0x84, 0xAB, 0xE2, 0x84, 0xA6, 0xE1, 0xBA, 0x9B, 0xCC, 0xA3]
|
|
||||||
|
|
||||||
Should be converted into the unicode normalized NFKC format prior to use in scrypt: "ÅΩẛ̣"
|
|
||||||
- Unicode Codepoints: U+00C5 U+03A9 U+1E69
|
|
||||||
- UTF-8 bytes: [0xC3, 0x85, 0xCE, 0xA9, 0xE1, 0xB9, 0xA9]
|
|
||||||
|
|
||||||
## Encryption
|
|
||||||
|
|
||||||
The encryption process is non-deterministic due to the random nonce.
|
|
||||||
|
|
||||||
## Decryption
|
|
||||||
|
|
||||||
The following encrypted private key:
|
The following encrypted private key:
|
||||||
|
|
||||||
`ncryptsec1qgg9947rlpvqu76pj5ecreduf9jxhselq2nae2kghhvd5g7dgjtcxfqtd67p9m0w57lspw8gsq6yphnm8623nsl8xn9j4jdzz84zm3frztj3z7s35vpzmqf6ksu8r89qk5z2zxfmu5gv8th8wclt0h4p`
|
`ncryptsec1qgg9947rlpvqu76pj5ecreduf9jxhselq2nae2kghhvd5g7dgjtcxfqtd67p9m0w57lspw8gsq6yphnm8623nsl8xn9j4jdzz84zm3frztj3z7s35vpzmqf6ksu8r89qk5z2zxfmu5gv8th8wclt0h4p`
|
||||||
@@ -102,6 +86,8 @@ When decrypted with password='nostr' and log_n=16 yields the following hex-encod
|
|||||||
|
|
||||||
`3501454135014541350145413501453fefb02227e449e57cf4d3a3ce05378683`
|
`3501454135014541350145413501453fefb02227e449e57cf4d3a3ce05378683`
|
||||||
|
|
||||||
|
The reverse process is non-deterministic due to the random nonce.
|
||||||
|
|
||||||
Discussion
|
Discussion
|
||||||
----------
|
----------
|
||||||
|
|
||||||
|
|||||||
4
50.md
4
50.md
@@ -47,7 +47,3 @@ Relays SHOULD exclude spam from search results by default if they support some f
|
|||||||
|
|
||||||
Relay MAY support these extensions:
|
Relay MAY support these extensions:
|
||||||
- `include:spam` - turn off spam filtering, if it was enabled by default
|
- `include:spam` - turn off spam filtering, if it was enabled by default
|
||||||
- `domain:<domain>` - include only events from users whose valid nip05 domain matches the domain
|
|
||||||
- `language:<two letter ISO 639-1 language code>` - include only events of a specified language
|
|
||||||
- `sentiment:<negative/neutral/positive>` - include only events of a specific sentiment
|
|
||||||
- `nsfw:<true/false>` - include or exclude nsfw events (default: true)
|
|
||||||
|
|||||||
26
51.md
26
51.md
@@ -29,7 +29,6 @@ For example, _mute list_ can contain the public keys of spammers and bad actors
|
|||||||
| Public chats | 10005 | [NIP-28](28.md) chat channels the user is in | `"e"` (kind:40 channel definitions) |
|
| Public chats | 10005 | [NIP-28](28.md) chat channels the user is in | `"e"` (kind:40 channel definitions) |
|
||||||
| Blocked relays | 10006 | relays clients should never connect to | `"relay"` (relay URLs) |
|
| Blocked relays | 10006 | relays clients should never connect to | `"relay"` (relay URLs) |
|
||||||
| Search relays | 10007 | relays clients should use when performing search queries | `"relay"` (relay URLs) |
|
| Search relays | 10007 | relays clients should use when performing search queries | `"relay"` (relay URLs) |
|
||||||
| Simple groups | 10009 | [NIP-29](29.md) groups the user is in | `"group"` ([NIP-29](29.md) group ids + mandatory relay URL) |
|
|
||||||
| Interests | 10015 | topics a user may be interested in and pointers | `"t"` (hashtags) and `"a"` (kind:30015 interest set) |
|
| Interests | 10015 | topics a user may be interested in and pointers | `"t"` (hashtags) and `"a"` (kind:30015 interest set) |
|
||||||
| Emojis | 10030 | user preferred emojis and pointers to emoji sets | `"emoji"` (see [NIP-30](30.md)) and `"a"` (kind:30030 emoji set) |
|
| Emojis | 10030 | user preferred emojis and pointers to emoji sets | `"emoji"` (see [NIP-30](30.md)) and `"a"` (kind:30030 emoji set) |
|
||||||
|
|
||||||
@@ -50,7 +49,6 @@ Aside from their main identifier, the `"d"` tag, sets can optionally have a `"ti
|
|||||||
| Curation sets | 30005 | groups of videos picked by users as interesting and/or belonging to the same category | `"a"` (kind:34235 videos) |
|
| Curation sets | 30005 | groups of videos picked by users as interesting and/or belonging to the same category | `"a"` (kind:34235 videos) |
|
||||||
| Interest sets | 30015 | interest topics represented by a bunch of "hashtags" | `"t"` (hashtags) |
|
| Interest sets | 30015 | interest topics represented by a bunch of "hashtags" | `"t"` (hashtags) |
|
||||||
| Emoji sets | 30030 | categorized emoji groups | `"emoji"` (see [NIP-30](30.md)) |
|
| Emoji sets | 30030 | categorized emoji groups | `"emoji"` (see [NIP-30](30.md)) |
|
||||||
| Release artifact sets | 30063 | groups of files of a software release | `"e"` (kind:1063 [file metadata](94.md) events), `"i"` (application identifier, typically reverse domain notation), `"version"` |
|
|
||||||
|
|
||||||
## Deprecated standard lists
|
## Deprecated standard lists
|
||||||
|
|
||||||
@@ -105,30 +103,6 @@ Some clients have used these lists in the past, but they should work on transiti
|
|||||||
}
|
}
|
||||||
```
|
```
|
||||||
|
|
||||||
### A _release artifact set_ of an Example App
|
|
||||||
|
|
||||||
```json
|
|
||||||
{
|
|
||||||
"id": "567b41fc9060c758c4216fe5f8d3df7c57daad7ae757fa4606f0c39d4dd220ef",
|
|
||||||
"pubkey": "d6dc95542e18b8b7aec2f14610f55c335abebec76f3db9e58c254661d0593a0c",
|
|
||||||
"created_at": 1695327657,
|
|
||||||
"kind": 30063,
|
|
||||||
"tags": [
|
|
||||||
["d", "ak8dy3v7"],
|
|
||||||
["i", "com.example.app"],
|
|
||||||
["version", "0.0.1"],
|
|
||||||
["title", "Example App"],
|
|
||||||
["image", "http://cdn.site/p/com.example.app/icon.png"],
|
|
||||||
["e", "d78ba0d5dce22bfff9db0a9e996c9ef27e2c91051de0c4e1da340e0326b4941e"], // Windows exe
|
|
||||||
["e", "f27e2c91051de0c4e1da0d5dce22bfff9db0a9340e0326b4941ed78bae996c9e"], // MacOS dmg
|
|
||||||
["e", "9d24ddfab95ba3ff7c03fbd07ad011fff245abea431fb4d3787c2d04aad02332"], // Linux AppImage
|
|
||||||
["e", "340e0326b340e0326b4941ed78ba340e0326b4941ed78ba340e0326b49ed78ba"] // PWA
|
|
||||||
],
|
|
||||||
"content": "Example App is a decentralized marketplace for apps",
|
|
||||||
"sig": "a9a4e2192eede77e6c9d24ddfab95ba3ff7c03fbd07ad011fff245abea431fb4d3787c2d04aad001cb039cb8de91d83ce30e9a94f82ac3c5a2372aa1294a96bd"
|
|
||||||
}
|
|
||||||
```
|
|
||||||
|
|
||||||
## Encryption process pseudocode
|
## Encryption process pseudocode
|
||||||
|
|
||||||
```scala
|
```scala
|
||||||
|
|||||||
9
56.md
9
56.md
@@ -4,12 +4,10 @@ NIP-56
|
|||||||
Reporting
|
Reporting
|
||||||
---------
|
---------
|
||||||
|
|
||||||
`optional`
|
`draft` `optional`
|
||||||
|
|
||||||
A report is a `kind 1984` event that signals to users and relays that
|
A report is a `kind 1984` note that is used to report other notes for spam,
|
||||||
some referenced content is objectionable. The definition of objectionable is
|
illegal and explicit content.
|
||||||
obviously subjective and all agents on the network (users, apps, relays, etc.)
|
|
||||||
may consume and take action on them as they see fit.
|
|
||||||
|
|
||||||
The `content` MAY contain additional information submitted by the entity
|
The `content` MAY contain additional information submitted by the entity
|
||||||
reporting the content.
|
reporting the content.
|
||||||
@@ -30,7 +28,6 @@ being reported, which consists of the following report types:
|
|||||||
- `illegal` - something which may be illegal in some jurisdiction
|
- `illegal` - something which may be illegal in some jurisdiction
|
||||||
- `spam` - spam
|
- `spam` - spam
|
||||||
- `impersonation` - someone pretending to be someone else
|
- `impersonation` - someone pretending to be someone else
|
||||||
- `other` - for reports that don't fit in the above categories
|
|
||||||
|
|
||||||
Some report tags only make sense for profile reports, such as `impersonation`
|
Some report tags only make sense for profile reports, such as `impersonation`
|
||||||
|
|
||||||
|
|||||||
6
58.md
6
58.md
@@ -83,7 +83,7 @@ Clients SHOULD attempt to render the most appropriate badge thumbnail according
|
|||||||
["name", "Medal of Bravery"],
|
["name", "Medal of Bravery"],
|
||||||
["description", "Awarded to users demonstrating bravery"],
|
["description", "Awarded to users demonstrating bravery"],
|
||||||
["image", "https://nostr.academy/awards/bravery.png", "1024x1024"],
|
["image", "https://nostr.academy/awards/bravery.png", "1024x1024"],
|
||||||
["thumb", "https://nostr.academy/awards/bravery_256x256.png", "256x256"]
|
["thumb", "https://nostr.academy/awards/bravery_256x256.png", "256x256"],
|
||||||
],
|
],
|
||||||
...
|
...
|
||||||
}
|
}
|
||||||
@@ -99,7 +99,7 @@ Clients SHOULD attempt to render the most appropriate badge thumbnail according
|
|||||||
"tags": [
|
"tags": [
|
||||||
["a", "30009:alice:bravery"],
|
["a", "30009:alice:bravery"],
|
||||||
["p", "bob", "wss://relay"],
|
["p", "bob", "wss://relay"],
|
||||||
["p", "charlie", "wss://relay"]
|
["p", "charlie", "wss://relay"],
|
||||||
],
|
],
|
||||||
...
|
...
|
||||||
}
|
}
|
||||||
@@ -117,7 +117,7 @@ Honorable Bob The Brave:
|
|||||||
["a", "30009:alice:bravery"],
|
["a", "30009:alice:bravery"],
|
||||||
["e", "<bravery badge award event id>", "wss://nostr.academy"],
|
["e", "<bravery badge award event id>", "wss://nostr.academy"],
|
||||||
["a", "30009:alice:honor"],
|
["a", "30009:alice:honor"],
|
||||||
["e", "<honor badge award event id>", "wss://nostr.academy"]
|
["e", "<honor badge award event id>", "wss://nostr.academy"],
|
||||||
],
|
],
|
||||||
...
|
...
|
||||||
}
|
}
|
||||||
|
|||||||
2
65.md
2
65.md
@@ -19,7 +19,7 @@ The `.content` is not used.
|
|||||||
["r", "wss://alicerelay.example.com"],
|
["r", "wss://alicerelay.example.com"],
|
||||||
["r", "wss://brando-relay.com"],
|
["r", "wss://brando-relay.com"],
|
||||||
["r", "wss://expensive-relay.example2.com", "write"],
|
["r", "wss://expensive-relay.example2.com", "write"],
|
||||||
["r", "wss://nostr-relay.example.com", "read"]
|
["r", "wss://nostr-relay.example.com", "read"],
|
||||||
],
|
],
|
||||||
"content": "",
|
"content": "",
|
||||||
...other fields
|
...other fields
|
||||||
|
|||||||
2
92.md
2
92.md
@@ -41,5 +41,3 @@ after the file is uploaded and included in the post.
|
|||||||
|
|
||||||
When pasting URLs during post composition, the client MAY download the file
|
When pasting URLs during post composition, the client MAY download the file
|
||||||
and add this metadata before the post is sent.
|
and add this metadata before the post is sent.
|
||||||
|
|
||||||
The client MAY ignore `imeta` tags that do not match the URL in the event content.
|
|
||||||
|
|||||||
9
96.md
9
96.md
@@ -82,7 +82,14 @@ it must use the "api_url" field instead.
|
|||||||
|
|
||||||
### List of Supporting File Storage Servers
|
### List of Supporting File Storage Servers
|
||||||
|
|
||||||
See https://github.com/aljazceru/awesome-nostr#nip-96-file-storage-servers.
|
| Name | Domain |
|
||||||
|
| ------------- | ------------------------- |
|
||||||
|
| nostrcheck.me | https://nostrcheck.me |
|
||||||
|
| nostrage | https://nostrage.com |
|
||||||
|
| sove | https://sove.rent |
|
||||||
|
| nostr.build | https://nostr.build |
|
||||||
|
| sovbit | https://files.sovbit.host |
|
||||||
|
| void.cat | https://void.cat |
|
||||||
|
|
||||||
## Upload
|
## Upload
|
||||||
|
|
||||||
|
|||||||
47
BREAKING.md
47
BREAKING.md
@@ -1,47 +0,0 @@
|
|||||||
# Breaking Changes
|
|
||||||
|
|
||||||
This is a history of NIP changes that potentially break pre-existing implementations, in
|
|
||||||
reverse chronological order.
|
|
||||||
|
|
||||||
| Date | Commit | NIP | Change |
|
|
||||||
| ----------- | --------- | -------- | ------ |
|
|
||||||
| 2024-02-25 | [4a171cb0](https://github.com/nostr-protocol/nips/commit/4a171cb0) | [NIP-18](18.md) | quote repost should use `q` tag |
|
|
||||||
| 2024-02-10 | [c6cd655c](https://github.com/nostr-protocol/nips/commit/c6cd655c) | [NIP-46](46.md) | Params were stringified |
|
|
||||||
| 2024-02-16 | [cbec02ab](https://github.com/nostr-protocol/nips/commit/cbec02ab) | [NIP-49](49.md) | Password first normalized to NFKC |
|
|
||||||
| 2024-02-15 | [afbb8dd0](https://github.com/nostr-protocol/nips/commit/afbb8dd0) | [NIP-39](39.md) | PGP identity was removed |
|
|
||||||
| 2024-02-07 | [d3dad114](https://github.com/nostr-protocol/nips/commit/d3dad114) | [NIP-46](46.md) | Connection token format was changed |
|
|
||||||
| 2024-01-30 | [1a2b21b6](https://github.com/nostr-protocol/nips/commit/1a2b21b6) | [NIP-59](59.md) | 'p' tag became optional |
|
|
||||||
| 2023-01-27 | [c2f34817](https://github.com/nostr-protocol/nips/commit/c2f34817) | [NIP-47](47.md) | optional expiration tag should be honored |
|
|
||||||
| 2024-01-10 | [3d8652ea](https://github.com/nostr-protocol/nips/commit/3d8652ea) | [NIP-02](02.md) | list entries should be chronological |
|
|
||||||
| 2024-01-10 | [3d8652ea](https://github.com/nostr-protocol/nips/commit/3d8652ea) | [NIP-51](51.md) | list entries should be chronological |
|
|
||||||
| 2023-12-30 | [29869821](https://github.com/nostr-protocol/nips/commit/29869821) | [NIP-52](52.md) | 'name' tag was removed (use 'title' tag instead) |
|
|
||||||
| 2023-12-27 | [17c67ef5](https://github.com/nostr-protocol/nips/commit/17c67ef5) | [NIP-94](94.md) | 'aes-256-gcm' tag was removed |
|
|
||||||
| 2023-12-03 | [0ba45895](https://github.com/nostr-protocol/nips/commit/0ba45895) | [NIP-01](01.md) | WebSocket status code `4000` was replaced by 'CLOSED' message |
|
|
||||||
| 2023-11-28 | [6de35f9e](https://github.com/nostr-protocol/nips/commit/6de35f9e) | [NIP-89](89.md) | 'client' tag value was changed |
|
|
||||||
| 2023-11-20 | [7822a8b1](https://github.com/nostr-protocol/nips/commit/7822a8b1) | [NIP-51](51.md) | `kind: 30000` and `kind: 30001` were deprecated |
|
|
||||||
| 2023-11-11 | [cbdca1e9](https://github.com/nostr-protocol/nips/commit/cbdca1e9) | [NIP-84](84.md) | 'range' tag was removed |
|
|
||||||
| 2023-11-07 | [108b7f16](https://github.com/nostr-protocol/nips/commit/108b7f16) | [NIP-01](01.md) | 'OK' message must have 4 items |
|
|
||||||
| 2023-10-17 | [cf672b76](https://github.com/nostr-protocol/nips/commit/cf672b76) | [NIP-03](03.md) | 'block' tag was removed |
|
|
||||||
| 2023-09-29 | [7dc6385f](https://github.com/nostr-protocol/nips/commit/7dc6385f) | [NIP-57](57.md) | optional 'a' tag was included in `zap receipt` |
|
|
||||||
| 2023-08-21 | [89915e02](https://github.com/nostr-protocol/nips/commit/89915e02) | [NIP-11](11.md) | 'min_prefix' was removed |
|
|
||||||
| 2023-08-20 | [37c4375e](https://github.com/nostr-protocol/nips/commit/37c4375e) | [NIP-01](01.md) | replaceable events with same timestamp should be retained event with lowest id |
|
|
||||||
| 2023-08-15 | [88ee873c](https://github.com/nostr-protocol/nips/commit/88ee873c) | [NIP-15](15.md) | 'countries' tag was renamed to 'regions' |
|
|
||||||
| 2023-08-14 | [72bb8a12](https://github.com/nostr-protocol/nips/commit/72bb8a12) | [NIP-12](12.md) | NIP-12, 16, 20 and 33 were merged into NIP-01 |
|
|
||||||
| 2023-08-14 | [72bb8a12](https://github.com/nostr-protocol/nips/commit/72bb8a12) | [NIP-16](16.md) | NIP-12, 16, 20 and 33 were merged into NIP-01 |
|
|
||||||
| 2023-08-14 | [72bb8a12](https://github.com/nostr-protocol/nips/commit/72bb8a12) | [NIP-20](20.md) | NIP-12, 16, 20 and 33 were merged into NIP-01 |
|
|
||||||
| 2023-08-14 | [72bb8a12](https://github.com/nostr-protocol/nips/commit/72bb8a12) | [NIP-33](33.md) | NIP-12, 16, 20 and 33 were merged into NIP-01 |
|
|
||||||
| 2023-08-11 | [d87f8617](https://github.com/nostr-protocol/nips/commit/d87f8617) | [NIP-25](25.md) | empty `content` should be considered as "+" |
|
|
||||||
| 2023-08-01 | [5d63b157](https://github.com/nostr-protocol/nips/commit/5d63b157) | [NIP-57](57.md) | 'zap' tag was changed |
|
|
||||||
| 2023-07-15 | [d1814405](https://github.com/nostr-protocol/nips/commit/d1814405) | [NIP-01](01.md) | `since` and `until` filters should be `since <= created_at <= until` |
|
|
||||||
| 2023-07-12 | [a1cd2bd8](https://github.com/nostr-protocol/nips/commit/a1cd2bd8) | [NIP-25](25.md) | custom emoji was supported |
|
|
||||||
| 2023-06-18 | [83cbd3e1](https://github.com/nostr-protocol/nips/commit/83cbd3e1) | [NIP-11](11.md) | 'image' was renamed to 'icon' |
|
|
||||||
| 2023-04-13 | [bf0a0da6](https://github.com/nostr-protocol/nips/commit/bf0a0da6) | [NIP-15](15.md) | different NIP was re-added as NIP-15 |
|
|
||||||
| 2023-04-09 | [fb5b7c73](https://github.com/nostr-protocol/nips/commit/fb5b7c73) | [NIP-15](15.md) | NIP-15 was merged into NIP-01 |
|
|
||||||
| 2023-03-15 | [e1004d3d](https://github.com/nostr-protocol/nips/commit/e1004d3d) | [NIP-19](19.md) | `1: relay` was changed to optionally |
|
|
||||||
|
|
||||||
Breaking changes prior to 2023-03-01 are not yet documented.
|
|
||||||
|
|
||||||
## NOTES
|
|
||||||
|
|
||||||
- If it isn't clear that a change is breaking or not, we list it.
|
|
||||||
- The date is the date it was merged, not necessarily the date of the commit.
|
|
||||||
42
README.md
42
README.md
@@ -15,7 +15,6 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
|
|||||||
- [Criteria for acceptance of NIPs](#criteria-for-acceptance-of-nips)
|
- [Criteria for acceptance of NIPs](#criteria-for-acceptance-of-nips)
|
||||||
- [Is this repository a centralizing factor?](#is-this-repository-a-centralizing-factor)
|
- [Is this repository a centralizing factor?](#is-this-repository-a-centralizing-factor)
|
||||||
- [How this repository works](#how-this-repository-works)
|
- [How this repository works](#how-this-repository-works)
|
||||||
- [Breaking Changes](#breaking-changes)
|
|
||||||
- [License](#license)
|
- [License](#license)
|
||||||
|
|
||||||
---
|
---
|
||||||
@@ -25,7 +24,7 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
|
|||||||
- [NIP-01: Basic protocol flow description](01.md)
|
- [NIP-01: Basic protocol flow description](01.md)
|
||||||
- [NIP-02: Follow List](02.md)
|
- [NIP-02: Follow List](02.md)
|
||||||
- [NIP-03: OpenTimestamps Attestations for Events](03.md)
|
- [NIP-03: OpenTimestamps Attestations for Events](03.md)
|
||||||
- [NIP-04: Encrypted Direct Message](04.md) --- **unrecommended**: deprecated in favor of [NIP-17](17.md)
|
- [NIP-04: Encrypted Direct Message](04.md) --- **unrecommended**: deprecated in favor of [NIP-44](44.md)
|
||||||
- [NIP-05: Mapping Nostr keys to DNS-based internet identifiers](05.md)
|
- [NIP-05: Mapping Nostr keys to DNS-based internet identifiers](05.md)
|
||||||
- [NIP-06: Basic key derivation from mnemonic seed phrase](06.md)
|
- [NIP-06: Basic key derivation from mnemonic seed phrase](06.md)
|
||||||
- [NIP-07: `window.nostr` capability for web browsers](07.md)
|
- [NIP-07: `window.nostr` capability for web browsers](07.md)
|
||||||
@@ -36,7 +35,6 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
|
|||||||
- [NIP-13: Proof of Work](13.md)
|
- [NIP-13: Proof of Work](13.md)
|
||||||
- [NIP-14: Subject tag in text events](14.md)
|
- [NIP-14: Subject tag in text events](14.md)
|
||||||
- [NIP-15: Nostr Marketplace (for resilient marketplaces)](15.md)
|
- [NIP-15: Nostr Marketplace (for resilient marketplaces)](15.md)
|
||||||
- [NIP-17: Private Direct Messages](17.md)
|
|
||||||
- [NIP-18: Reposts](18.md)
|
- [NIP-18: Reposts](18.md)
|
||||||
- [NIP-19: bech32-encoded entities](19.md)
|
- [NIP-19: bech32-encoded entities](19.md)
|
||||||
- [NIP-21: `nostr:` URI scheme](21.md)
|
- [NIP-21: `nostr:` URI scheme](21.md)
|
||||||
@@ -46,11 +44,9 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
|
|||||||
- [NIP-26: Delegated Event Signing](26.md)
|
- [NIP-26: Delegated Event Signing](26.md)
|
||||||
- [NIP-27: Text Note References](27.md)
|
- [NIP-27: Text Note References](27.md)
|
||||||
- [NIP-28: Public Chat](28.md)
|
- [NIP-28: Public Chat](28.md)
|
||||||
- [NIP-29: Relay-based Groups](29.md)
|
|
||||||
- [NIP-30: Custom Emoji](30.md)
|
- [NIP-30: Custom Emoji](30.md)
|
||||||
- [NIP-31: Dealing with Unknown Events](31.md)
|
- [NIP-31: Dealing with Unknown Events](31.md)
|
||||||
- [NIP-32: Labeling](32.md)
|
- [NIP-32: Labeling](32.md)
|
||||||
- [NIP-34: `git` stuff](34.md)
|
|
||||||
- [NIP-36: Sensitive Content](36.md)
|
- [NIP-36: Sensitive Content](36.md)
|
||||||
- [NIP-38: User Statuses](38.md)
|
- [NIP-38: User Statuses](38.md)
|
||||||
- [NIP-39: External Identities in Profiles](39.md)
|
- [NIP-39: External Identities in Profiles](39.md)
|
||||||
@@ -82,6 +78,7 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
|
|||||||
- [NIP-96: HTTP File Storage Integration](96.md)
|
- [NIP-96: HTTP File Storage Integration](96.md)
|
||||||
- [NIP-98: HTTP Auth](98.md)
|
- [NIP-98: HTTP Auth](98.md)
|
||||||
- [NIP-99: Classified Listings](99.md)
|
- [NIP-99: Classified Listings](99.md)
|
||||||
|
- [NIP-302: Relay Pools](302.md)
|
||||||
|
|
||||||
## Event Kinds
|
## Event Kinds
|
||||||
| kind | description | NIP |
|
| kind | description | NIP |
|
||||||
@@ -95,12 +92,6 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
|
|||||||
| `6` | Repost | [18](18.md) |
|
| `6` | Repost | [18](18.md) |
|
||||||
| `7` | Reaction | [25](25.md) |
|
| `7` | Reaction | [25](25.md) |
|
||||||
| `8` | Badge Award | [58](58.md) |
|
| `8` | Badge Award | [58](58.md) |
|
||||||
| `9` | Group Chat Message | [29](29.md) |
|
|
||||||
| `10` | Group Chat Threaded Reply | [29](29.md) |
|
|
||||||
| `11` | Group Thread | [29](29.md) |
|
|
||||||
| `12` | Group Thread Reply | [29](29.md) |
|
|
||||||
| `13` | Seal | [59](59.md) |
|
|
||||||
| `14` | Direct Message | [17](17.md) |
|
|
||||||
| `16` | Generic Repost | [18](18.md) |
|
| `16` | Generic Repost | [18](18.md) |
|
||||||
| `40` | Channel Creation | [28](28.md) |
|
| `40` | Channel Creation | [28](28.md) |
|
||||||
| `41` | Channel Metadata | [28](28.md) |
|
| `41` | Channel Metadata | [28](28.md) |
|
||||||
@@ -110,13 +101,8 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
|
|||||||
| `1021` | Bid | [15](15.md) |
|
| `1021` | Bid | [15](15.md) |
|
||||||
| `1022` | Bid confirmation | [15](15.md) |
|
| `1022` | Bid confirmation | [15](15.md) |
|
||||||
| `1040` | OpenTimestamps | [03](03.md) |
|
| `1040` | OpenTimestamps | [03](03.md) |
|
||||||
| `1059` | Gift Wrap | [59](59.md) |
|
|
||||||
| `1063` | File Metadata | [94](94.md) |
|
| `1063` | File Metadata | [94](94.md) |
|
||||||
| `1311` | Live Chat Message | [53](53.md) |
|
| `1311` | Live Chat Message | [53](53.md) |
|
||||||
| `1617` | Patches | [34](34.md) |
|
|
||||||
| `1621` | Issues | [34](34.md) |
|
|
||||||
| `1622` | Replies | [34](34.md) |
|
|
||||||
| `1630`-`1633` | Status | [34](34.md) |
|
|
||||||
| `1971` | Problem Tracker | [nostrocket][nostrocket] |
|
| `1971` | Problem Tracker | [nostrocket][nostrocket] |
|
||||||
| `1984` | Reporting | [56](56.md) |
|
| `1984` | Reporting | [56](56.md) |
|
||||||
| `1985` | Label | [32](32.md) |
|
| `1985` | Label | [32](32.md) |
|
||||||
@@ -124,7 +110,7 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
|
|||||||
| `5000`-`5999` | Job Request | [90](90.md) |
|
| `5000`-`5999` | Job Request | [90](90.md) |
|
||||||
| `6000`-`6999` | Job Result | [90](90.md) |
|
| `6000`-`6999` | Job Result | [90](90.md) |
|
||||||
| `7000` | Job Feedback | [90](90.md) |
|
| `7000` | Job Feedback | [90](90.md) |
|
||||||
| `9000`-`9030` | Group Control Events | [29](29.md) |
|
| `8000` | Relay Pool Join Request | [302](302.md) |
|
||||||
| `9041` | Zap Goal | [75](75.md) |
|
| `9041` | Zap Goal | [75](75.md) |
|
||||||
| `9734` | Zap Request | [57](57.md) |
|
| `9734` | Zap Request | [57](57.md) |
|
||||||
| `9735` | Zap | [57](57.md) |
|
| `9735` | Zap | [57](57.md) |
|
||||||
@@ -137,10 +123,8 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
|
|||||||
| `10005` | Public chats list | [51](51.md) |
|
| `10005` | Public chats list | [51](51.md) |
|
||||||
| `10006` | Blocked relays list | [51](51.md) |
|
| `10006` | Blocked relays list | [51](51.md) |
|
||||||
| `10007` | Search relays list | [51](51.md) |
|
| `10007` | Search relays list | [51](51.md) |
|
||||||
| `10009` | User groups | [51](51.md), [29](29.md) |
|
|
||||||
| `10015` | Interests list | [51](51.md) |
|
| `10015` | Interests list | [51](51.md) |
|
||||||
| `10030` | User emoji list | [51](51.md) |
|
| `10030` | User emoji list | [51](51.md) |
|
||||||
| `10050` | Relay list to receive DMs | [17](17.md) |
|
|
||||||
| `10096` | File storage server list | [96](96.md) |
|
| `10096` | File storage server list | [96](96.md) |
|
||||||
| `13194` | Wallet Info | [47](47.md) |
|
| `13194` | Wallet Info | [47](47.md) |
|
||||||
| `21000` | Lightning Pub RPC | [Lightning.Pub][lnpub] |
|
| `21000` | Lightning Pub RPC | [Lightning.Pub][lnpub] |
|
||||||
@@ -156,6 +140,7 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
|
|||||||
| `30004` | Curation sets | [51](51.md) |
|
| `30004` | Curation sets | [51](51.md) |
|
||||||
| `30008` | Profile Badges | [58](58.md) |
|
| `30008` | Profile Badges | [58](58.md) |
|
||||||
| `30009` | Badge Definition | [58](58.md) |
|
| `30009` | Badge Definition | [58](58.md) |
|
||||||
|
| `30010` | Relay Pool | [302](302.md) |
|
||||||
| `30015` | Interest sets | [51](51.md) |
|
| `30015` | Interest sets | [51](51.md) |
|
||||||
| `30017` | Create or update a stall | [15](15.md) |
|
| `30017` | Create or update a stall | [15](15.md) |
|
||||||
| `30018` | Create or update a product | [15](15.md) |
|
| `30018` | Create or update a product | [15](15.md) |
|
||||||
@@ -164,13 +149,11 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
|
|||||||
| `30023` | Long-form Content | [23](23.md) |
|
| `30023` | Long-form Content | [23](23.md) |
|
||||||
| `30024` | Draft Long-form Content | [23](23.md) |
|
| `30024` | Draft Long-form Content | [23](23.md) |
|
||||||
| `30030` | Emoji sets | [51](51.md) |
|
| `30030` | Emoji sets | [51](51.md) |
|
||||||
| `30063` | Release artifact sets | [51](51.md) |
|
|
||||||
| `30078` | Application-specific Data | [78](78.md) |
|
| `30078` | Application-specific Data | [78](78.md) |
|
||||||
| `30311` | Live Event | [53](53.md) |
|
| `30311` | Live Event | [53](53.md) |
|
||||||
| `30315` | User Statuses | [38](38.md) |
|
| `30315` | User Statuses | [38](38.md) |
|
||||||
| `30402` | Classified Listing | [99](99.md) |
|
| `30402` | Classified Listing | [99](99.md) |
|
||||||
| `30403` | Draft Classified Listing | [99](99.md) |
|
| `30403` | Draft Classified Listing | [99](99.md) |
|
||||||
| `30617` | Repository announcements | [34](34.md) |
|
|
||||||
| `31922` | Date-Based Calendar Event | [52](52.md) |
|
| `31922` | Date-Based Calendar Event | [52](52.md) |
|
||||||
| `31923` | Time-Based Calendar Event | [52](52.md) |
|
| `31923` | Time-Based Calendar Event | [52](52.md) |
|
||||||
| `31924` | Calendar | [52](52.md) |
|
| `31924` | Calendar | [52](52.md) |
|
||||||
@@ -178,7 +161,6 @@ They exist to document what may be implemented by [Nostr](https://github.com/nos
|
|||||||
| `31989` | Handler recommendation | [89](89.md) |
|
| `31989` | Handler recommendation | [89](89.md) |
|
||||||
| `31990` | Handler information | [89](89.md) |
|
| `31990` | Handler information | [89](89.md) |
|
||||||
| `34550` | Community Definition | [72](72.md) |
|
| `34550` | Community Definition | [72](72.md) |
|
||||||
| `39000-9` | Group metadata events | [29](29.md) |
|
|
||||||
|
|
||||||
[nostrocket]: https://github.com/nostrocket/NIPS/blob/main/Problems.md
|
[nostrocket]: https://github.com/nostrocket/NIPS/blob/main/Problems.md
|
||||||
[lnpub]: https://github.com/shocknet/Lightning.Pub/blob/master/proto/autogenerated/client.md
|
[lnpub]: https://github.com/shocknet/Lightning.Pub/blob/master/proto/autogenerated/client.md
|
||||||
@@ -223,19 +205,18 @@ Please update these lists when proposing NIPs introducing new event kinds.
|
|||||||
| `l` | label, label namespace | annotations | [32](32.md) |
|
| `l` | label, label namespace | annotations | [32](32.md) |
|
||||||
| `L` | label namespace | -- | [32](32.md) |
|
| `L` | label namespace | -- | [32](32.md) |
|
||||||
| `m` | MIME type | -- | [94](94.md) |
|
| `m` | MIME type | -- | [94](94.md) |
|
||||||
| `q` | event id (hex) | relay URL | [18](18.md) |
|
|
||||||
| `r` | a reference (URL, etc) | petname | |
|
| `r` | a reference (URL, etc) | petname | |
|
||||||
| `r` | relay url | marker | [65](65.md) |
|
| `r` | relay url | marker | [65](65.md) |
|
||||||
| `t` | hashtag | -- | |
|
| `t` | hashtag | -- | |
|
||||||
| `alt` | summary | -- | [31](31.md) |
|
| `alt` | summary | -- | [31](31.md) |
|
||||||
| `amount` | millisatoshis, stringified | -- | [57](57.md) |
|
| `amount` | millisatoshis, stringified | -- | [57](57.md) |
|
||||||
|
| `auth-required` | either nip-42 or nip-98 | -- | [302](302.md) |
|
||||||
| `bolt11` | `bolt11` invoice | -- | [57](57.md) |
|
| `bolt11` | `bolt11` invoice | -- | [57](57.md) |
|
||||||
| `challenge` | challenge string | -- | [42](42.md) |
|
| `challenge` | challenge string | -- | [42](42.md) |
|
||||||
| `client` | name, address | relay URL | [89](89.md) |
|
| `client` | name, address | relay URL | [89](89.md) |
|
||||||
| `clone` | git clone URL | -- | [34](34.md) |
|
|
||||||
| `content-warning` | reason | -- | [36](36.md) |
|
| `content-warning` | reason | -- | [36](36.md) |
|
||||||
| `delegation` | pubkey, conditions, delegation token | -- | [26](26.md) |
|
| `delegation` | pubkey, conditions, delegation token | -- | [26](26.md) |
|
||||||
| `description` | description | -- | [34](34.md), [57](57.md), [58](58.md) |
|
| `description` | invoice/badge description | -- | [57](57.md), [58](58.md) |
|
||||||
| `emoji` | shortcode, image URL | -- | [30](30.md) |
|
| `emoji` | shortcode, image URL | -- | [30](30.md) |
|
||||||
| `encrypted` | -- | -- | [90](90.md) |
|
| `encrypted` | -- | -- | [90](90.md) |
|
||||||
| `expiration` | unix timestamp (string) | -- | [40](40.md) |
|
| `expiration` | unix timestamp (string) | -- | [40](40.md) |
|
||||||
@@ -244,20 +225,19 @@ Please update these lists when proposing NIPs introducing new event kinds.
|
|||||||
| `imeta` | inline metadata | -- | [92](92.md) |
|
| `imeta` | inline metadata | -- | [92](92.md) |
|
||||||
| `lnurl` | `bech32` encoded `lnurl` | -- | [57](57.md) |
|
| `lnurl` | `bech32` encoded `lnurl` | -- | [57](57.md) |
|
||||||
| `location` | location string | -- | [52](52.md), [99](99.md) |
|
| `location` | location string | -- | [52](52.md), [99](99.md) |
|
||||||
| `name` | name | -- | [34](34.md), [58](58.md) |
|
| `name` | badge name | -- | [58](58.md) |
|
||||||
| `nonce` | random | -- | [13](13.md) |
|
| `nonce` | random | -- | [13](13.md) |
|
||||||
| `preimage` | hash of `bolt11` invoice | -- | [57](57.md) |
|
| `preimage` | hash of `bolt11` invoice | -- | [57](57.md) |
|
||||||
| `price` | price | currency, frequency | [99](99.md) |
|
| `price` | price | currency, frequency | [99](99.md) |
|
||||||
| `proxy` | external ID | protocol | [48](48.md) |
|
| `proxy` | external ID | protocol | [48](48.md) |
|
||||||
| `published_at` | unix timestamp (string) | -- | [23](23.md) |
|
| `published_at` | unix timestamp (string) | -- | [23](23.md) |
|
||||||
| `relay` | relay url | -- | [42](42.md), [17](17.md) |
|
| `relay` | relay url | -- | [42](42.md) |
|
||||||
| `relays` | relay list | -- | [57](57.md) |
|
| `relays` | relay list | -- | [57](57.md) |
|
||||||
| `server` | file storage server url | -- | [96](96.md) |
|
| `server` | file storage server url | -- | [96](96.md) |
|
||||||
| `subject` | subject | -- | [14](14.md), [17](17.md) |
|
| `subject` | subject | -- | [14](14.md) |
|
||||||
| `summary` | article summary | -- | [23](23.md) |
|
| `summary` | article summary | -- | [23](23.md) |
|
||||||
| `thumb` | badge thumbnail | dimensions in pixels | [58](58.md) |
|
| `thumb` | badge thumbnail | dimensions in pixels | [58](58.md) |
|
||||||
| `title` | article title | -- | [23](23.md) |
|
| `title` | article title | -- | [23](23.md) |
|
||||||
| `web` | webpage URL | -- | [34](34.md) |
|
|
||||||
| `zap` | pubkey (hex), relay URL | weight | [57](57.md) |
|
| `zap` | pubkey (hex), relay URL | weight | [57](57.md) |
|
||||||
|
|
||||||
## Criteria for acceptance of NIPs
|
## Criteria for acceptance of NIPs
|
||||||
@@ -282,10 +262,6 @@ Standards may emerge in two ways: the first way is that someone starts doing som
|
|||||||
|
|
||||||
These two ways of standardizing things are supported by this repository. Although the second is preferred, an effort will be made to codify standards emerged outside this repository into NIPs that can be later referenced and easily understood and implemented by others -- but obviously as in any human system discretion may be applied when standards are considered harmful.
|
These two ways of standardizing things are supported by this repository. Although the second is preferred, an effort will be made to codify standards emerged outside this repository into NIPs that can be later referenced and easily understood and implemented by others -- but obviously as in any human system discretion may be applied when standards are considered harmful.
|
||||||
|
|
||||||
## Breaking Changes
|
|
||||||
|
|
||||||
[Breaking Changes](BREAKING.md)
|
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
All NIPs are public domain.
|
All NIPs are public domain.
|
||||||
|
|||||||
Reference in New Issue
Block a user