ILP Fetch

Simple paid HTTP request library for Interledger. Based on node-fetch.

• Usage
  • Example
• Test
• Browser Support

Usage

The ILP Fetch API supports all the options that are present in the node-fetch API.

Two additional fields are added:

• plugin: The ILP plugin used to make payments.
• maxPrice: The maximum, in the plugin's base units, which ILP fetch will send.

Example

The below example will upload a file containing hello world to Unhash (content-addressed storage on top of ILP).

const plugin = require('ilp-plugin')()
const fetch = require('.')

fetch('https://alpha.unhash.io', {
  plugin,
  maxPrice: 100,
  method: 'POST',
  body: 'hello world'
})
  .then(r => r.json())
  .then(json => {
    console.log('json response:', json)
    process.exit(0)
  })
  .catch(e => {
    console.error(e)
    process.exit(1)
  })

Test

First run Moneyd on your machine. Then:

git clone https://github.com/interledgerjs/ilp-fetch.git
cd ilp-fetch
npm install
DEBUG=* node test.js

In the Browser

Because ILP fetch is based around Fetch, it is possible for it to run in the browser. Because of the restricted use of headers and cross-origin requests (and because it is not possible to access moneyd from within a webpage), it may not be useful in an ordinary webpage.

However, in the evironment of an extension it can be useful to make payment-enabled requests. Additionally, an extension should have no problems making cross-origin requests or accessing moneyd.

Just add the following block to your webpack config:

  externals: {
    'node-fetch': 'fetch'
  }