ipfs-core-types

ipfs-core-types

IPFS interface definitions used by implementations for API compatibility

Table of Contents

• Background
• Install
• Usage
  • In JSDoc syntax
  • In Typescript
• Validation
• Contribute
  • Want to hack on IPFS?
• License

Background

The primary goal of this module is to define and ensure that IPFS core implementations and their respective client libraries implement the same interface, so that developers can quickly change between a local and a remote node without having to change their applications.

It offers a set of typescript interface definitions that define the IPFS core API. Once your implementation implements those APIs you can use the tests found in the interface-ipfs-core module to validate your implementation.

Install

In JavaScript land:

$ npm install ipfs-core-types

Usage

Install ipfs-core-types as one of the dependencies of your project and use it to ensure your implementations API compatibility:

In JSDoc syntax

/**
 * @implements {import('ipfs-core-types').IPFS}
 */
class MyImpl {
  // your implementation goes here
}

In Typescript

import type { IPFS } from 'ipfs-core-types'
class MyImpl implements IPFS {
  // your implementation goes here
}

Validation

In order to validate API compatibility you can run typescript over your implementation which will point out all the API compatibilities if there are some.

Contribute

Feel free to join in. All welcome. Open an issue!

This repository falls under the IPFS Code of Conduct.

Want to hack on IPFS?

License