docs: document remaining 0.16.0 features
Marcin Rataj committed
Sep 27, 2022 at 21:34 UTC
c4a0656920128fb16e6775acb5159eb0ee3ca11e
1 file changed
+63
docs/changelogs/v0.16.md
+63
@@ -12,6 +12,9 @@ Below is an outline of all that is in this release, so you get a sense of all th
12
- [🔦 Highlights](#-highlights)
13
- [🛣️ More configurable delegated routing system](#️-more-configurable-delegated-routing-system)
14
- [🌍 WebTransport new experimental Transport](#-webtransport-new-experimental-transport)
15
+ - [🗃️ Hardened IPNS record verification](#-hardened-ipns-record-verification)
16
+ - [🌉 Web Gateways now support _redirects files](#-web-gateways-now-support-_redirects-files)
17
+ - [😻 Add files to MFS with ipfs add --to-files](#-add-files-to-mfs-with-ipfs-add---to-files)
18
- [Changelog](#changelog)
19
- [Contributors](#contributors)
20
@@ -117,6 +120,66 @@ Thoses steps are temporary and wont be needed once we make it enabled by default
120
```
121
1. Restart your daemon to apply the config changes.
122
123
+### 🗃️ Hardened IPNS record verification
124
+
125
+Records that do not have a valid IPNS V2 signature, or exceed the max size
126
+limit, will no longer pass verification, and will be ignored by Kubo when
127
+resolving `/ipns/{libp2p-key}` content paths.
128
+
129
+Kubo continues publishing backward-compatible V1+V2 records that can be
130
+resolved by V1-only (go-ipfs <0.9.0) clients.
131
+
132
+More details can be found in _Backward Compatibility_, _Record Creation_, and
133
+_Record Verification_ sections of the [updated IPNS
134
+specification](https://github.com/ipfs/specs/pull/319/files).
135
+
136
+### 🌉 Web Gateways now support `_redirects` files
137
+
138
+This feature enables support for redirects, single-page applications (SPA),
139
+custom 404 pages, and moving to IPFS-backed website hosting
140
+[without breaking existing HTTP links](https://www.w3.org/Provider/Style/URI).
141
+
142
+It is limited to websites hosted in web contexts with unique
143
+[Origins](https://en.wikipedia.org/wiki/Same-origin_policy), such as
144
+[subdomain](https://docs.ipfs.tech/how-to/address-ipfs-on-web/#subdomain-gateway) and
145
+[DNSLink](https://docs.ipfs.tech/how-to/address-ipfs-on-web/#dnslink-gateway) gateways.
146
+Redirect logic is evaluated only if the requested path is not in the DAG.
147
+
148
+See more details and usage examples see
149
+[docs.ipfs.tech: _Redirects, custom 404s, and SPA support_](https://docs.ipfs.tech/how-to/websites-on-ipfs/redirects-and-custom-404s/).
150
+
151
+### 😻 Add files to MFS with `ipfs add --to-files`
152
+
153
+Users no longer need to call `ipfs files cp` after `ipfs add` to create a
154
+reference in [MFS](https://docs.ipfs.tech/concepts/glossary/#mfs), or deal with
155
+low level pins if they do not wish to do so. It is now possible to pass MFS
156
+path in an optional `--to-files` to add data directly to MFS, without creating
157
+a low level pin.
158
+
159
+Before (Kubo <0.16.0):
160
+
161
+
162
+```console
163
+$ ipfs add cat.jpg
164
+QmCID
165
+$ ipfs files cp /ipfs/QmCID /mfs-cats/cat.jpg
166
+$ ipfs pin rm QmCID # removing low level pin, since MFS is protecting from gc
167
+```
168
+
169
+Kubo 0.16.0 collapses the above steps into one:
170
+
171
+```console
172
+$ ipfs add --pin=false cat.jpg --to-files /mfs-cats/
173
+```
174
+
175
+A recursive add to MFS works too (below line will create `/lots-of-cats/` directory in MFS):
176
+
177
+```console
178
+$ ipfs add -r ./lots-of-cats/ --to-files /
179
+```
180
+
181
+For more information, see `ipfs add --help` and `ipfs files --help`.
182
+
183
### Changelog
184
185
<!-- TODO -->