Skip to content

Commit e924363

Browse files
whizzzkidElPaisano
andauthored
fix: 🗑️ Deprecation notice for js-ipfs (#1628)
--------- Co-authored-by: ElPaisano <[email protected]>
1 parent 18e8d00 commit e924363

File tree

2 files changed

+17
-11
lines changed

2 files changed

+17
-11
lines changed

docs/how-to/companion-node-types.md

+15-7
Original file line numberDiff line numberDiff line change
@@ -5,7 +5,7 @@ description: Learn about the available node types in IPFS Companion.
55

66
# Understand node types in IPFS Companion
77

8-
IPFS Companion's preferences screen allows you to choose from several different node types. The available types you'll see in your Companion preferences depends on the browser you're using (i.e. Firefox, Chrome, Brave), but the full list is as follows:
8+
IPFS Companion's preferences screen allows you to choose from different node types. The available types you'll see in your Companion preferences depends on the browser you're using (i.e. Firefox, Chrome, Brave), but the full list is as follows:
99

1010
[[toc]]
1111

@@ -67,6 +67,12 @@ This node type offers the same benefits as an [external](#external) node, with a
6767

6868
## Embedded
6969

70+
::: warning DEPRECATED
71+
72+
js-ipfs has been deprecated in favor of [Helia](https://github.com/ipfs/helia) and will be removed in a future release of IPFS Companion. Improvements to Helia are ongoing, and we hope to have it ready for use in IPFS Companion once critical features like [webRTC Streams](https://github.com/w3c/webextensions/issues/72) are available in Chrome Manifest V3.
73+
74+
:::
75+
7076
An _embedded_ node is a js-ipfs instance running in the browser in-memory, without the need for any external software.
7177

7278
::: warning
@@ -75,6 +81,14 @@ This node type is only for development and experimentation. Most users should us
7581

7682
:::
7783

84+
::: warning Deprecation Notice for Chrome Manifest V3
85+
86+
Chrome Manifest V3 is the new version of the Chrome extension platform that IPFS Companion will support in the near future. Currently, the embedded node type is unavailable in Chrome MV3 and will be removed from the extension in a future release. For further information, see the [tracking issue in GitHub](https://github.com/ipfs/ipfs-companion/issues/1152).
87+
88+
If you're using the embedded node type in Chrome, please switch to the external node type instead.
89+
90+
:::
91+
7892
Power users can provide [custom config](https://github.com/ipfs/js-ipfs#faq) (e.g. to enable experimental pubsub) via the IPFS Companion [Preferences](https://user-images.githubusercontent.com/157609/38084660-0b97c0cc-334e-11e8-9368-823345ced67f.png)
7993

8094
Please note that there are some limitations when running an embedded js-ipfs instance in the browser context using Companion:
@@ -87,12 +101,6 @@ Please note that there are some limitations when running an embedded js-ipfs ins
87101
- Missing relay discovery ([js-ipfs/v0.29.x/examples/circuit-relaying](https://github.com/ipfs/js-ipfs/tree/v0.29.3/examples/circuit-relaying))
88102
- An embedded node _does not run_ when an external node is selected; every time you switch back to the embedded node, a new instance is created on demand, and it can take a few seconds for a newly running node to find peers.
89103

90-
### Embedded + `chrome.sockets` (deprecated)
91-
92-
::: warning
93-
This node type has been deprecated and is no longer supported by Chromium browsers. While this option still appears in IPFS Companion preferences, users of this node type are strongly urged to migrate to a different node type.
94-
:::
95-
96104
## Public
97105

98106
A _public_ node is used as a fallback for gateway functionality when an external node is offline or an embedded node is used. It does not expose the API port. This type of node is not included as an option in Companion's preferences.

docs/install/ipfs-companion.md

+2-4
Original file line numberDiff line numberDiff line change
@@ -15,8 +15,6 @@ For its full functionality to be enabled, IPFS Companion requires a local IPFS n
1515
- [Install IPFS Kubo for Go](../install/command-line.md)
1616
- [Install IPFS for JavaScript](../install/js-ipfs.md)
1717

18-
You can still use IPFS Companion without a local node running, although you will lose some functionality, such as the ability to load websites with DNSLink via a gateway.
19-
2018
## Install
2119

2220
The easiest way to install IPFS Companion is through your browser's specific extensions and add-ons store:
@@ -34,15 +32,15 @@ IPFS Companion supercharges your browser for the DWeb with features including th
3432

3533
IPFS Companion detects and tests requests for IPFS-like paths, such as `/ipfs/{cid}` or `/ipns/{peerid_or_host-with-dnslink}`, on any website. If a path is a valid IPFS address, it is redirected to load from your local gateway, which converts data from one protocol to another. The gateway at `localhost` will also automatically switch to a subdomain to provide a unique origin for each website. Providing a unique origin accommodates operations that are restricted to content that shares the same protocol, domain, and port, also known as [same-origin content](https://en.wikipedia.org/wiki/Same-origin_policy#:~:text=In%20computing%2C%20the%20same%2Dorigin,pages%20have%20the%20same%20origin).
3634

37-
> `https://ipfs.io/ipfs/QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR`
35+
> `https://ipfs.io/ipfs/QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR`
3836
> `http://localhost:8080/ipfs/QmbWqxBEKC3P8tqsKc98xmWNzrzDtRLMiMPL8wBuTGsMnR`
3937
> `http://bafybeigdyrzt5sfp7udm7hu76uh7y26nf3efuylqabf3oclgtqy55fbzdi.ipfs.localhost:8080`
4038
4139
### Detect DNSLink-enabled URLs
4240

4341
IPFS Companion detects DNSLink info in the DNS records of websites. DNSLink is a simple protocol that links content and serviceability from DNS and leverages the DNS distributed architecture. See [Glossary > DNSLink](../concepts/glossary.md#dnslink). If a site uses DNSLink, IPFS Companion redirects the HTTP request to your local gateway:
4442

45-
> `http://docs.ipfs.tech`
43+
> `http://docs.ipfs.tech`
4644
> `http://localhost:8080/ipns/docs.ipfs.tech``http://docs.ipfs.tech.ipns.localhost:8080/`
4745
4846
### Detect pages with `x-ipfs-path` headers

0 commit comments

Comments
 (0)