IPFS Multiplexer Library

> A multiplexer library, built on top of js-ipfs-http-client and implementing the interface-ipfs-core.

Lead Maintainer

- IPFS Multiplexer Library
- Lead Maintainer
- Table of Contents
- Install
- Importing the module and usage
- Importing helper functions
- In a web browser
- Custom Headers
- Usage
- API
- Files
- Graph
- Additional Options
- Development
- Testing
- Contribute
- Historical context

Install

This module uses node.js, and can be installed through npm:

``bash npm install --save ipfs-multiplexer`

We support both the Current and Active LTS versions of Node.js. Please see nodejs.org for what these currently are.

`$3`

`javascript import IpfsMultiplexer from 'ipfs-multiplexer';

const ipfsMultiplexer = new IpfsMultiplexer();

// Optionally, you can add your own nodes to the list of available nodes ipfsMultiplexer.addGateway({ host: 'localhost', port: 5001, protocol: 'http', });

ipfsMultiplexer.get('Qmaisz6NMhDB51cCvNWa1GMS7LU1pAxdF4Ld6Ft9kZEP2a') .then(console.log) .catch(console.error);`

`$3`

`javascript import { testGateway } from 'ipfs-multiplexer';

testGateway({ host: 'localhost', port: 5001, protocol: 'http', }) .then(() => { // Everything went fine console.log('The gateway is up'); }) .catch(err => { // The error thrown by the gateway during test request console.error(err); });`

`$3`

through Browserify

Same as in Node.js, you just have to browserify the code before serving it. See the browserify repo for how to do that.

See the example provided by js-ipfs-http-client in the examples folder to get a boilerplate.

through webpack

See the example provided by js-ipfs-http-client in the examples folder to get an idea on how to use a package with webpack.

`$3`

If you wish to send custom headers with each request made by this library, for example, the Authorization header. You can use the config to do so:

`javascript ipfsMultiplexer.addGateway({ host: 'localhost', port: 5001, protocol: 'http', headers: { authorization: 'Bearer ' + TOKEN, }, });`

`Usage`

`$3`

![IPFS Core API Compatible](https://github.com/ipfs/interface-ipfs-core)

> js-ipfs-http-client follows the spec defined by interface-ipfs-core, which concerns the interface to expect from IPFS implementations. This interface is a currently active endeavor. You can use it today to consult the methods available.

> IMPORTANTE NOTE: Due to the nature of a multiplexer, the commands from the Network and Node Management categories are not available. Please refere to these links to see which part of the API is not available.

#### Files

- Regular Files API - [ipfs.add(data, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#add) - [ipfs.addPullStream([options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#addpullstream) - [ipfs.addReadableStream([options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#addreadablestream) -ipfs.addFromStream(stream)- [ipfs.addFromFs(path, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#addfromfs) - [ipfs.addFromURL(url, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#addfromurl) - [ipfs.cat(ipfsPath, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#cat) - [ipfs.catPullStream(ipfsPath, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#catpullstream) - [ipfs.catReadableStream(ipfsPath, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#catreadablestream) - [ipfs.get(ipfsPath, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#get) - [ipfs.getPullStream(ipfsPath, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#getpullstream) - [ipfs.getReadableStream(ipfsPath, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#getreadablestream) -ipfs.ls(ipfsPath)-ipfs.lsPullStream(ipfsPath)-ipfs.lsReadableStream(ipfsPath)- MFS (mutable file system) specific

_Explore the Mutable File System through interactive coding challenges in our ProtoSchool tutorial._

- [ipfs.files.cp([from, to])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#filescp) - [ipfs.files.flush([path])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#filesflush) - [ipfs.files.ls([path], [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#filesls) - [ipfs.files.mkdir(path, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#filesmkdir) - [ipfs.files.mv([from, to])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#filesmv) - [ipfs.files.read(path, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#filesread) - [ipfs.files.readPullStream(path, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#filesreadpullstream) - [ipfs.files.readReadableStream(path, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#filesreadreadablestream) - [ipfs.files.rm(path, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#filesrm) - [ipfs.files.stat(path, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#filesstat) - [ipfs.files.write(path, content, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/FILES.md#fileswrite)

- block

- [ipfs.block.get(cid, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/BLOCK.md#blockget) - [ipfs.block.put(block, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/BLOCK.md#blockput) -ipfs.block.stat(cid)

- refs - [ipfs.refs(ipfsPath, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/REFS.md#refs) - [ipfs.refsReadableStream(ipfsPath, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/REFS.md#refsreadablestream) - [ipfs.refsPullStream(ipfsPath, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/REFS.md#refspullstream) -ipfs.refs.local()-ipfs.refs.localReadableStream()-ipfs.refs.localPullStream()

#### Graph

- dag

_Explore the DAG API through interactive coding challenges in our ProtoSchool tutorial._

- [ipfs.dag.get(cid, [path], [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/DAG.md#dagget) - [ipfs.dag.put(dagNode, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/DAG.md#dagput) - [ipfs.dag.tree(cid, [path], [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/DAG.md#dagtree)

- object

- [ipfs.object.data(multihash, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/OBJECT.md#objectdata) - [ipfs.object.get(multihash, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/OBJECT.md#objectget) - [ipfs.object.links(multihash, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/OBJECT.md#objectlinks) - [ipfs.object.new([template])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/OBJECT.md#objectnew) - [ipfs.object.patch.addLink(multihash, DAGLink, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/OBJECT.md#objectpatchaddlink) - [ipfs.object.patch.appendData(multihash, data, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/OBJECT.md#objectpatchappenddata) - [ipfs.object.patch.rmLink(multihash, DAGLink, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/OBJECT.md#objectpatchrmlink) - [ipfs.object.patch.setData(multihash, data, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/OBJECT.md#objectpatchsetdata) - [ipfs.object.put(obj, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/OBJECT.md#objectput) - [ipfs.object.stat(multihash, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/OBJECT.md#objectstat)

- pin

- [ipfs.pin.add(hash, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/PIN.md#pinadd) - [ipfs.pin.ls([hash], [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/PIN.md#pinls) - [ipfs.pin.rm(hash, [options])](https://github.com/ipfs/interface-ipfs-core/blob/master/SPEC/PIN.md#pinrm)

- refs -ipfs.refs.local()

#### Additional Options

All core API methods take _additional_ options specific to the HTTP API:

- headers- An object or Headers instance that can be used to set custom HTTP headers. Note that this option can also be configured globally via the constructor options. -timeout - A number or string specifying a timeout for the request. If the timeout is reached before data is received a TimeoutError is thrown. If a number is specified it is interpreted as milliseconds, if a string is passed, it is intepreted according to parse-duration. Note that this option can also be configured globally via the constructor options. -searchParams - An object or URLSearchParams instance that can be used to add additional query parameters to the query string sent with each request.

> NOTE: The signal property thas is described here is not available with this package, because it is used to abort the requests that have not arrived by the time where the multiplexer already has a valid response.

`Development`

`$3`

We run tests by executing npm testin a terminal window. This will run Node.js test. > NOTE: While because the package conforms with theinterface-ipfs-core spec because it extends js-ipfs-http-client, the tests provided by the interface module are yet to be added to this package's tests.

`Contribute`

ipfs-multiplexer is a work in progress. As such, there's a few things you can do right now to help out:

- Check out the existing issues! - Perform code reviews. More eyes will help a) speed the project along b) ensure quality and c) reduce possible future bugs. - Add tests. There can never be enough tests. Note that interface tests exist insideinterface-ipfs-core. - Contribute to the js-ipfs-http-client repository by checking out issues, performing code reviews, adding tests or by contributing to their FAQ repository. Rememberipfs-multiplexer is based on js-ipfs-http-client, so every improvement it gets, helps make this package better.

`Historical context`

This module started as part of docsit-client` when we tried to speed up the IPFS operations of our documents, but we realized that it had so much more potential as an independent package.

IPFS Multiplexer Library

> A multiplexer library, built on top of js-ipfs-http-client and implementing the interface-ipfs-core.

Lead Maintainer

Iñaki Arango.

Install

This module uses node.js, and can be installed through npm:

``bash npm install --save ipfs-multiplexer`

We support both the Current and Active LTS versions of Node.js. Please see nodejs.org for what these currently are.

`$3`

`javascript import IpfsMultiplexer from 'ipfs-multiplexer';

const ipfsMultiplexer = new IpfsMultiplexer();

// Optionally, you can add your own nodes to the list of available nodes ipfsMultiplexer.addGateway({ host: 'localhost', port: 5001, protocol: 'http', });

ipfsMultiplexer.get('Qmaisz6NMhDB51cCvNWa1GMS7LU1pAxdF4Ld6Ft9kZEP2a') .then(console.log) .catch(console.error);`

`$3`

`javascript import { testGateway } from 'ipfs-multiplexer';

`$3`

through Browserify

Same as in Node.js, you just have to browserify the code before serving it. See the browserify repo for how to do that.

See the example provided by js-ipfs-http-client in the examples folder to get a boilerplate.

through webpack

See the example provided by js-ipfs-http-client in the examples folder to get an idea on how to use a package with webpack.

`$3`

If you wish to send custom headers with each request made by this library, for example, the Authorization header. You can use the config to do so:

`javascript ipfsMultiplexer.addGateway({ host: 'localhost', port: 5001, protocol: 'http', headers: { authorization: 'Bearer ' + TOKEN, }, });`

`Usage`

`$3`

![IPFS Core API Compatible](https://github.com/ipfs/interface-ipfs-core)

#### Files

_Explore the Mutable File System through interactive coding challenges in our ProtoSchool tutorial._

- block

#### Graph

- dag

_Explore the DAG API through interactive coding challenges in our ProtoSchool tutorial._

- object

- pin

- refs -ipfs.refs.local()

#### Additional Options

All core API methods take _additional_ options specific to the HTTP API:

`Development`

`$3`

`Contribute`

ipfs-multiplexer is a work in progress. As such, there's a few things you can do right now to help out:

`Historical context`

This module started as part of docsit-client` when we tried to speed up the IPFS operations of our documents, but we realized that it had so much more potential as an independent package.