tableflip/window.ipfs-fallback

Name: window.ipfs-fallback

Owner: TABLEFLIP

Description: Get window.ipfs with fallback to CDN if unavailable

Created: 2018-04-04 14:55:13.0

Updated: 2018-05-14 07:39:05.0

Pushed: 2018-05-11 12:35:09.0

Homepage: null

Size: 118

Language: JavaScript

GitHub Committers

User	Most Recent Commit	# Commits

Other Committers

User	Email	Most Recent Commit	# Commits

README

window.ipfs-fallback

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

rt getIpfs from 'window.ipfs-fallback'

t ipfs = await getIpfs()

ole.log(await ipfs.id())

API

getIpfs([options])

If window.ipfs is available, the promise is resolved with that node.

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