Merge pull request #9707 from ipfs/changelog-0.19
docs: 0.19 changelog
Piotr Galar committed
Mar 20, 2023 at 11:45 UTC
754264fc08e86ecf777cbaeeee5580b120f84c6c
1 file changed
+48
docs/changelogs/v0.19.md
+48
@@ -7,6 +7,10 @@
7
- [Overview](#overview)
8
- [🔦 Highlights](#-highlights)
9
- [Improving the libp2p resource management integration](#improving-the-libp2p-resource-management-integration)
10
+ - [PubSub message caching improvements](#pubsub-message-caching-improvements)
11
+ - [Gateways](#gateways)
12
+ - [Signed IPNS Record response format](#signed-ipns-record-response-format)
13
+ - [Example fetch and inspect IPNS record](#example-fetch-and-inspect-ipns-record)
14
- [Addition of "autoclient" router type](#addition-of-autoclient-router-type)
15
- [Deprecation of the `ipfs pubsub` commands and matching HTTP endpoints](#deprecation-of-the-ipfs-pubsub-commands-and-matching-http-endpoints)
16
- [📝 Changelog](#-changelog)
@@ -24,6 +28,50 @@ and [0.18.1](https://github.com/ipfs/kubo/blob/master/docs/changelogs/v0.18.md#i
28
- Note: we don't expect most users to need these capablities, but they are there if so.
29
1. [Doc updates](https://github.com/ipfs/kubo/blob/master/docs/libp2p-resource-management.md).
30
31
+#### PubSub message caching improvements
32
+
33
+The PubSub message cache will now [prune messages after TTL is exhausted](https://github.com/ipfs/kubo/blob/master/docs/config.md#pubsubseenmessagesttl), [either based on the last time a message was seen or the first time it was seen](https://github.com/ipfs/kubo/blob/master/docs/config.md#pubsubseenmessagesstrategy).
34
+
35
+#### Gateways
36
+
37
+##### Signed IPNS Record response format
38
+
39
+This release implements [IPIP-351](https://github.com/ipfs/specs/pull/351) and
40
+adds Gateway support for returning signed (verifiable) `ipns-record` (0x0300)
41
+when `/ipns/{libp2p-key}` is requested with either
42
+`Accept: application/vnd.ipfs.ipns-record` HTTP header
43
+or `?format=ipns-record` URL query parameter.
44
+
45
+
46
+The Gateway in Kubo already supported [trustless, verifiable retrieval](https://docs.ipfs.tech/reference/http/gateway/#trustless-verifiable-retrieval) of immutable `/ipfs/` namespace.
47
+With `?format=ipns-record`, light HTTP clients are now able to get the same level of verifiability for IPNS websites.
48
+
49
+Tooling is limited at the moment, but we are working on [go-libipfs](https://github.com/ipfs/go-libipfs/) examples that illustrate the verifiable HTTP client pattern.
50
+
51
+##### Example: fetch IPNS record over HTTP and inspect it with `ipfs name inspect --verify`
52
+
53
+```console
54
+$ FILE_CID=$(echo "Hello IPFS" | ipfs add --cid-version 1 -q)
55
+$ IPNS_KEY=$(ipfs key gen test)
56
+$ ipfs name publish /ipfs/$FILE_CID --key=test --ttl=30m
57
+Published to k51q..dvf1: /ipfs/bafk..z244
58
+$ curl "http://127.0.0.1:8080/ipns/$IPNS_KEY?format=ipns-record" > signed.ipns-record
59
+$ ipfs name inspect --verify $IPNS_KEY < signed.ipns-record
60
+Value: "/ipfs/bafk..."
61
+Validity Type: "EOL"
62
+Validity: 2023-03-09T23:13:34.032977468Z
63
+Sequence: 0
64
+TTL: 1800000000000
65
+PublicKey: ""
66
+Signature V1: "m..."
67
+Signature V2: "m..."
68
+Data: {...}
69
+
70
+Validation results:
71
+ Valid: true
72
+ PublicKey: 12D3...
73
+```
74
+
75
#### Addition of "autoclient" router type
76
A new routing type "autoclient" has been added. This mode is similar to "auto", in that it is a hybrid of content routers (including Kademlia and HTTP routers), but it does not run a DHT server. This is similar to the difference between "dhtclient" and "dht" router types.
77