README.md

The JavaScript implementation of the IPFS protocol

Upgrading from <=0.40 to 0.48? See the release notes for the list of API changes and the migration guide.

We've come a long way, but this project is still in Alpha, lots of development is happening, APIs might change, beware of 🐉..

Getting started

• Look into the examples to learn how to spawn an IPFS node in Node.js and in the Browser
• Read the Core API docs to see what you can do with an IPFS node
• Visit https://dweb-primer.ipfs.io to learn about IPFS and the concepts that underpin it
• Head over to https://proto.school to take interactive tutorials that cover core IPFS APIs
• Check out https://docs.ipfs.io for tips, how-tos and more

Lead Maintainer

Alex Potsides

Table of Contents

• Getting started
• Documentation
• Structure
• Want to hack on IPFS?
• License

Documentation

• Config
• Core API
• Examples
• Development

Structure

This project is broken into several modules, their purposes are:

• /packages/interface-ipfs-core Tests to ensure adherence of an implementation to the spec
• /packages/ipfs The core implementation
• /packages/ipfs-core-utils Helpers and utilities common to core and the HTTP RPC API client
• /packages/ipfs-http-client A client for the RPC-over-HTTP API presented by both js-ipfs and go-ipfs
• /packages/ipfs-message-port-client A client for the RPC-over-HTTP API presented by both js-ipfs and go-ipfs
• /packages/ipfs-message-port-client A client for the RPC-over-message-port API presented by js-ipfs running in a shared worker
• /packages/ipfs-message-port-protocol Code shared by the message port client & server
• /packages/ipfs-message-port-server The server that receives requests from ipfs-message-port-client

Want to hack on IPFS?

The IPFS implementation in JavaScript needs your help! There are a few things you can do right now to help out:

Read the Code of Conduct and JavaScript Contributing Guidelines.

• Check out existing issues The issue list has many that are marked as 'help wanted' or 'difficulty:easy' which make great starting points for development, many of which can be tackled with no prior IPFS knowledge
• Look at the IPFS Roadmap This are the high priority items being worked on right now
• 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.
• Join the Weekly Core Implementations Call it's where everyone discusses what's going on with IPFS and what's next

License