2022-05-01 10:48:57 +00:00
# NIPs
2023-04-13 22:30:44 +00:00
NIPs stand for **Nostr Implementation Possibilities** .
They exist to document what may be implemented by [Nostr ](https://github.com/fiatjaf/nostr )-compatible _relay_ and _client_ software.
2022-05-01 10:48:57 +00:00
2023-04-13 22:30:23 +00:00
---
- [List ](#list )
- [Event Kinds ](#event-kinds )
- [Event Kind Ranges ](#event-kind-ranges )
- [Message Types ](#message-types )
- [Client to Relay ](#client-to-relay )
- [Relay to Client ](#relay-to-client )
- [Standardized Tags ](#standardized-tags )
- [Criteria for acceptance of NIPs ](#criteria-for-acceptance-of-nips )
- [License ](#license )
---
## List
2022-05-01 11:02:54 +00:00
- [NIP-01: Basic protocol flow description ](01.md )
- [NIP-02: Contact List and Petnames ](02.md )
- [NIP-03: OpenTimestamps Attestations for Events ](03.md )
- [NIP-04: Encrypted Direct Message ](04.md )
- [NIP-05: Mapping Nostr keys to DNS-based internet identifiers ](05.md )
- [NIP-06: Basic key derivation from mnemonic seed phrase ](06.md )
2022-05-06 23:54:45 +00:00
- [NIP-07: `window.nostr` capability for web browsers ](07.md )
2023-04-13 22:31:09 +00:00
- [NIP-08: Handling Mentions ](08.md ) --- **unrecommended** : deprecated in favor of [NIP-27 ](27.md )
2022-05-01 11:02:54 +00:00
- [NIP-09: Event Deletion ](09.md )
2023-02-13 12:00:09 +00:00
- [NIP-10: Conventions for clients' use of `e` and `p` tags in text events ](10.md )
2022-05-01 11:02:54 +00:00
- [NIP-11: Relay Information Document ](11.md )
- [NIP-12: Generic Tag Queries ](12.md )
2022-05-05 17:45:27 +00:00
- [NIP-13: Proof of Work ](13.md )
2022-05-29 13:58:34 +00:00
- [NIP-14: Subject tag in text events. ](14.md )
2023-04-21 04:04:48 +00:00
- [NIP-15: Nostr Marketplace (for resilient marketplaces) ](15.md )
2022-05-29 13:58:34 +00:00
- [NIP-16: Event Treatment ](16.md )
2023-03-25 14:58:31 +00:00
- [NIP-18: Reposts ](18.md )
2022-12-17 16:16:13 +00:00
- [NIP-19: bech32-encoded entities ](19.md )
2022-11-10 18:07:13 +00:00
- [NIP-20: Command Results ](20.md )
2023-01-24 13:23:00 +00:00
- [NIP-21: `nostr:` URL scheme ](21.md )
2023-02-13 12:00:09 +00:00
- [NIP-22: Event `created_at` Limits ](22.md )
- [NIP-23: Long-form Content ](23.md )
2022-07-30 16:34:04 +00:00
- [NIP-25: Reactions ](25.md )
2022-11-28 20:31:50 +00:00
- [NIP-26: Delegated Event Signing ](26.md )
2023-03-22 13:13:04 +00:00
- [NIP-27: Text Note References ](27.md )
2022-09-11 00:52:09 +00:00
- [NIP-28: Public Chat ](28.md )
2023-01-04 13:26:08 +00:00
- [NIP-33: Parameterized Replaceable Events ](33.md )
2022-12-01 23:41:15 +00:00
- [NIP-36: Sensitive Content ](36.md )
2023-03-10 16:43:39 +00:00
- [NIP-39: External Identities in Profiles ](39.md )
2022-12-17 16:16:13 +00:00
- [NIP-40: Expiration Timestamp ](40.md )
2023-01-02 19:49:37 +00:00
- [NIP-42: Authentication of clients to relays ](42.md )
2023-01-04 04:11:17 +00:00
- [NIP-45: Counting results ](45.md )
2023-02-23 01:11:55 +00:00
- [NIP-46: Nostr Connect ](46.md )
2023-01-27 10:47:12 +00:00
- [NIP-50: Keywords filter ](50.md )
2023-03-09 17:16:57 +00:00
- [NIP-51: Lists ](51.md )
2023-02-07 21:15:38 +00:00
- [NIP-56: Reporting ](56.md )
2023-02-14 13:27:06 +00:00
- [NIP-57: Lightning Zaps ](57.md )
2023-02-25 15:17:33 +00:00
- [NIP-58: Badges ](58.md )
2023-02-07 19:52:35 +00:00
- [NIP-65: Relay List Metadata ](65.md )
2023-02-23 21:25:55 +00:00
- [NIP-78: Application-specific data ](78.md )
2023-04-24 17:57:37 +00:00
- [NIP-94: File Metadata ](94.md )
2022-05-01 10:48:57 +00:00
## Event Kinds
2023-03-09 17:16:57 +00:00
2023-04-13 22:33:02 +00:00
| kind | description | NIP |
| ------- | -------------------------- | ----------- |
| `0` | Metadata | [1 ](01.md ) |
| `1` | Short Text Note | [1 ](01.md ) |
| `2` | Recommend Relay | [1 ](01.md ) |
| `3` | Contacts | [2 ](02.md ) |
| `4` | Encrypted Direct Messages | [4 ](04.md ) |
| `5` | Event Deletion | [9 ](09.md ) |
| `6` | Reposts | [18 ](18.md ) |
| `7` | Reaction | [25 ](25.md ) |
| `8` | Badge Award | [58 ](58.md ) |
| `40` | Channel Creation | [28 ](28.md ) |
| `41` | Channel Metadata | [28 ](28.md ) |
| `42` | Channel Message | [28 ](28.md ) |
| `43` | Channel Hide Message | [28 ](28.md ) |
| `44` | Channel Mute User | [28 ](28.md ) |
2023-04-25 09:23:32 +00:00
| `1063` | File Metadata | [94 ](94.md ) |
2023-04-13 22:33:02 +00:00
| `1984` | Reporting | [56 ](56.md ) |
| `9734` | Zap Request | [57 ](57.md ) |
| `9735` | Zap | [57 ](57.md ) |
| `10000` | Mute List | [51 ](51.md ) |
| `10001` | Pin List | [51 ](51.md ) |
| `10002` | Relay List Metadata | [65 ](65.md ) |
| `22242` | Client Authentication | [42 ](42.md ) |
| `24133` | Nostr Connect | [46 ](46.md ) |
| `30000` | Categorized People List | [51 ](51.md ) |
| `30001` | Categorized Bookmark List | [51 ](51.md ) |
| `30008` | Profile Badges | [58 ](58.md ) |
| `30009` | Badge Definition | [58 ](58.md ) |
| `30017` | Create or update a stall | [15 ](15.md ) |
| `30018` | Create or update a product | [15 ](15.md ) |
| `30023` | Long-form Content | [23 ](23.md ) |
| `30078` | Application-specific Data | [78 ](78.md ) |
2023-04-13 22:29:39 +00:00
### Event Kind Ranges
| range | description | NIP |
| ---------------- | -------------------------------- | ----------- |
| `1000` --`9999` | Regular Events | [16 ](16.md ) |
| `10000` --`19999` | Replaceable Events | [16 ](16.md ) |
| `20000` --`29999` | Ephemeral Events | [16 ](16.md ) |
| `30000` --`39999` | Parameterized Replaceable Events | [33 ](33.md ) |
2022-10-08 11:02:13 +00:00
## Message types
### Client to Relay
2023-04-13 22:28:57 +00:00
| type | description | NIP |
| ------- | --------------------------------------------------- | ----------- |
| `AUTH` | used to send authentication events | [42 ](42.md ) |
| `CLOSE` | used to stop previous subscriptions | [1 ](01.md ) |
| `COUNT` | used to request event counts | [45 ](45.md ) |
| `EVENT` | used to publish events | [1 ](01.md ) |
| `REQ` | used to request events and subscribe to new updates | [1 ](01.md ) |
2022-10-08 11:02:13 +00:00
### Relay to Client
2023-04-13 22:28:57 +00:00
| type | description | NIP |
| -------- | ------------------------------------------------------- | ----------- |
| `AUTH` | used to send authentication challenges | [42 ](42.md ) |
| `COUNT` | used to send requested event counts to clients | [45 ](45.md ) |
| `EOSE` | used to notify clients all stored events have been sent | [1 ](01.md ) |
| `EVENT` | used to send events requested to clients | [1 ](01.md ) |
| `NOTICE` | used to send human-readable messages to clients | [1 ](01.md ) |
| `OK` | used to notify clients if an EVENT was successful | [20 ](20.md ) |
2022-10-08 11:02:13 +00:00
Please update these lists when proposing NIPs introducing new event kinds.
2022-05-02 12:30:30 +00:00
2023-04-13 22:28:38 +00:00
When experimenting with kinds, keep in mind the classification introduced by [NIP-16 ](16.md ) and [NIP-33 ](33.md ).
2022-07-11 18:40:58 +00:00
2023-01-25 16:20:36 +00:00
## Standardized Tags
2023-04-14 22:57:52 +00:00
| name | value | other parameters | NIP |
| ----------------- | ------------------------------------ | -------------------- | ------------------------ |
| `a` | coordinates to an event | relay URL | [33 ](33.md ), [23 ](23.md ) |
| `d` | identifier | -- | [33 ](33.md ) |
| `e` | event id (hex) | relay URL, marker | [1 ](01.md ), [10 ](10.md ) |
| `g` | geohash | -- | [12 ](12.md ) |
| `i` | identity | proof | [39 ](39.md ) |
| `p` | pubkey (hex) | relay URL | [1 ](01.md ) |
| `r` | a reference (URL, etc) | -- | [12 ](12.md ) |
| `t` | hashtag | -- | [12 ](12.md ) |
| `amount` | millisats | -- | [57 ](57.md ) |
| `bolt11` | `bolt11` invoice | -- | [57 ](57.md ) |
| `challenge` | challenge string | -- | [42 ](42.md ) |
| `content-warning` | reason | -- | [36 ](36.md ) |
| `delegation` | pubkey, conditions, delegation token | -- | [26 ](26.md ) |
| `description` | badge description | -- | [58 ](58.md ) |
| `description` | invoice description | -- | [57 ](57.md ) |
| `expiration` | unix timestamp (string) | -- | [40 ](40.md ) |
| `image` | image URL | dimensions in pixels | [23 ](23.md ), [58 ](58.md ) |
| `lnurl` | `bech32` encoded `lnurl` | -- | [57 ](57.md ) |
| `name` | badge name | -- | [58 ](58.md ) |
| `nonce` | random | -- | [13 ](13.md ) |
| `preimage` | hash of `bolt11` invoice | -- | [57 ](57.md ) |
| `published_at` | unix timestamp (string) | -- | [23 ](23.md ) |
| `relay` | relay url | -- | [42 ](42.md ) |
| `relays` | relay list | -- | [57 ](57.md ) |
| `subject` | subject | -- | [14 ](14.md ) |
| `summary` | article summary | -- | [23 ](23.md ) |
| `thumb` | badge thumbnail | dimensions in pixels | [58 ](58.md ) |
| `title` | article title | -- | [23 ](23.md ) |
| `zap` | profile name | type of value | [57 ](57.md ) |
2023-01-25 16:20:36 +00:00
2022-05-02 12:30:30 +00:00
## Criteria for acceptance of NIPs
2023-01-02 10:16:59 +00:00
1. They should be implemented in at least two clients and one relay -- when applicable.
2022-05-02 12:30:30 +00:00
2. They should make sense.
2022-11-29 14:41:46 +00:00
3. They should be optional and backwards-compatible: care must be taken such that clients and relays that choose to not implement them do not stop working when interacting with the ones that choose to.
2023-01-02 10:16:59 +00:00
4. There should be no more than one way of doing the same thing.
5. Other rules will be made up when necessary.
2022-05-02 12:30:30 +00:00
## License
All NIPs are public domain.