This is a history of NIP changes that potentially break pre-existing implementations, in reverse chronological order.
Breaking Changes
This is a history of NIP changes that potentially break pre-existing implementations, in reverse chronological order.
| Date | Commit | NIP | Change |
|---|---|---|---|
| 2025-01-31 | 6a4b125a | 71 | video events were changed to regular |
| 2024-12-05 | 6d16019e | 46 | message encryption was changed to NIP-44 |
| 2024-11-12 | 2838e3bd | 29 | kind: 12 and kind: 10 were removed (use kind: 1111 instead) |
| 2024-11-12 | 926a51e7 | 46 | NIP-05 login was removed |
| 2024-11-12 | 926a51e7 | 46 | create_account method was removed |
| 2024-11-12 | 926a51e7 | 46 | connect params and result were changed |
| 2024-10-29 | f1e8d2c4 | 46 | bunker URL should use remote-signer-key |
| 2024-10-15 | 1cda2dcc | 71 | some tags were replaced with imeta tag |
| 2024-10-15 | 1cda2dcc | 71 | kind: 34237 was dropped |
| 2024-10-07 | 7bb8997b | 55 | some fields and passing data were changed |
| 2024-08-18 | 3aff37bd | 54 | content should be Asciidoc |
| 2024-07-31 | 3ea2f1a4 | 45 | 444ad28d was reverted |
| 2024-07-30 | 444ad28d | 45 | NIP-45 was deprecated |
| 2024-07-26 | ecee40df | 19 | nrelay was deprecated |
| 2024-07-23 | 0227a2cd | 01 | events should be sorted by id after created_at |
| 2024-06-06 | 58e94b20 | 25 | 8073c848 was reverted |
| 2024-06-06 | a6dfc7b5 | 55 | NIP number was changed |
| 2024-05-25 | 5d1d1c17 | 71 | aes-256-gcm tag was removed |
| 2024-05-07 | 8073c848 | 25 | e-tags were changed to not include entire thread |
| 2024-04-30 | bad88262 | 34 | earliest-unique-commit tag was removed (use r tag instead) |
| 2024-02-25 | 4a171cb0 | 18 | quote repost should use q tag |
| 2024-02-21 | c6cd655c | 46 | Params were stringified |
| 2024-02-16 | cbec02ab | 49 | Password first normalized to NFKC |
| 2024-02-15 | afbb8dd0 | 39 | PGP identity was removed |
| 2024-02-07 | d3dad114 | 46 | Connection token format was changed |
| 2024-01-30 | 1a2b21b6 | 59 | p tag became optional |
| 2023-01-27 | c2f34817 | 47 | optional expiration tag should be honored |
| 2024-01-10 | 3d8652ea | 02, 51 | list entries should be chronological |
| 2023-12-30 | 29869821 | 52 | name tag was removed (use title tag instead) |
| 2023-12-27 | 17c67ef5 | 94 | aes-256-gcm tag was removed |
| 2023-12-03 | 0ba45895 | 01 | WebSocket status code 4000 was replaced by CLOSED message |
| 2023-11-28 | 6de35f9e | 89 | client tag value was changed |
| 2023-11-20 | 7822a8b1 | 51 | kind: 30001 was deprecated |
| 2023-11-20 | 7822a8b1 | 51 | the meaning of kind: 30000 was changed |
| 2023-11-11 | cbdca1e9 | 84 | range tag was removed |
| 2023-11-10 | c945d8bd | 32 | l tag annotations was removed |
| 2023-11-07 | 108b7f16 | 01 | OK message must have 4 items |
| 2023-10-17 | cf672b76 | 03 | block tag was removed |
| 2023-09-29 | 7dc6385f | 57 | optional a tag was included in zap receipt |
| 2023-08-21 | 89915e02 | 11 | min_prefix was removed |
| 2023-08-20 | 37c4375e | 01 | replaceable events with same timestamp should be retained event with lowest id |
| 2023-08-15 | 88ee873c | 15 | countries tag was renamed to regions |
| 2023-08-14 | 72bb8a12 | 12, 16, 20, 33 | NIP-12, 16, 20 and 33 were merged into NIP-01 |
| 2023-08-11 | d87f8617 | 25 | empty content should be considered as "+" |
| 2023-08-01 | 5d63b157 | 57 | zap tag was changed |
| 2023-07-15 | d1814405 | 01 | since and until filters should be since <= created_at <= until |
| 2023-07-12 | a1cd2bd8 | 25 | custom emoji was supported |
| 2023-06-18 | 83cbd3e1 | 11 | image was renamed to icon |
| 2023-04-13 | bf0a0da6 | 15 | different NIP was re-added as NIP-15 |
| 2023-04-09 | fb5b7c73 | 15 | NIP-15 was merged into NIP-01 |
| 2023-03-29 | 599e1313 | 18 | NIP-18 was bring back |
| 2023-03-15 | e1004d3d | 19 | 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.