Skip to content
This repository has been archived by the owner on May 13, 2020. It is now read-only.

Latest commit

 

History

History
50 lines (27 loc) · 2.27 KB

README.md

File metadata and controls

50 lines (27 loc) · 2.27 KB

Deprecated

This library has been deprecated and replaced with more flexible ipfs-provider.

This library will not be maintained.


window.ipfs-fallback

Build Status dependencies Status JavaScript Style Guide

Get window.ipfs with fallback to CDN if unavailable

The IPFS Companion web extension provides a window.ipfs object to web pages you visit.

This module will detects the presence of window.ipfs and automatically falls back to downloading the latest version of IPFS from https://unpkg.com/ipfs/dist/index.min.js if it's unavailable. Note: can be configured to fallback to IPFS API.

Usage

import getIpfs from 'window.ipfs-fallback'

const ipfs = await getIpfs()

console.log(await ipfs.id())

API

getIpfs([options])

If window.ipfs is available, the promise is resolved with that node and default or customized capabilities.

  • options.permissions - (Object) Options to pass to override default behavior of window.ipfs

If window.ipfs is unavailable, a <script src="https://unpkg.com/ipfs/dist/index.min.js" /> is inserted into the document and when the script has loaded a new IPFS node is created and the promise is resolved.

  • options.cdn - (String) URL of a CDN to load IPFS from. Use this option if you want to use a different CDN, or request a specific version, or a non-minifed version
  • options.ipfs - (Object) Options to pass to the fallback IPFS constructor
  • options.api - (Boolean) Fallback to IPFS API (https://unpkg.com/ipfs-api/dist/index.min.js by default)

Contribute

Feel free to dive in! Open an issue or submit PRs.

License

MIT © Alan Shaw