The JavaScript implementation of the IPFS protocol
\n\n
\n\n\n\n\n
\n\n
\n\n\n\n\n\n\n\n\n\n\n \n
\n\n# ipfs-core \n\n> The IPFS Core API\n\n`ipfs-core` is the implementation of the IPFS Core API. It contains all you need to integrate IPFS into your application.\n\nIf you want to run IPFS as a standalone daemon process, see the [ipfs](https://github.com/ipfs/js-ipfs/tree/master/packages/ipfs) module.\n\n## Lead Maintainer \n\n[Alex Potsides](http://github.com/achingbrain)\n\n## Table of Contents \n\n- [Getting Started](#getting-started)\n- [Next Steps](#next-steps)\n - [Browser CDN](#browser-cdn)\n - [Browser bundle](#browser-bundle)\n- [Want to hack on IPFS?](#want-to-hack-on-ipfs)\n- [License](#license)\n\n## Getting Started\n\nThe `ipfs-core` package contains all the features of `ipfs` but in a lighter package without the CLI or HTTP servers:\n\n```console\n$ npm install ipfs-core\n```\n\nThen start a node in your app:\n\n```javascript\nimport * as IPFS from 'ipfs-core'\n\nconst ipfs = await IPFS.create()\nconst { cid } = await ipfs.add('Hello world')\nconsole.info(cid)\n// QmXXY5ZxbtuYj6DnfApLiGstzPN7fvSyigrRee3hDWPCaf\n```\n\n## Next Steps\n\n* Look into the [examples](/examples) to learn how to spawn an IPFS node in Node.js and in the Browser\n* Read the [Core API docs](https://github.com/ipfs/js-ipfs/tree/master/docs/core-api) to see what you can do with an IPFS node\n* Visit https://dweb-primer.ipfs.io to learn about IPFS and the concepts that underpin it\n* Head over to https://proto.school to take interactive tutorials that cover core IPFS APIs\n* Check out https://docs.ipfs.io for tips, how-tos and more\n* See https://blog.ipfs.io for news and more\n* Need help? Please ask 'How do I?' questions on https://discuss.ipfs.io\n\n### Browser CDN\n\nYou can load IPFS right in your browser by adding the following to your page using the super fast [jsdelivr](https://www.jsdelivr.com) CDN:\n\n```html\n\n\n\n\n\n```\n\nInserting one of the above lines will make an `IpfsCore` object available in the global namespace:\n\n```html\n\n```\n\n### Browser bundle\n\nLearn how to bundle IPFS into your application with webpack, parceljs and browserify in the [examples](https://github.com/ipfs/js-ipfs/tree/master/examples).\n\n## Want to hack on IPFS?\n\n[](https://github.com/ipfs/community/blob/master/CONTRIBUTING.md)\n\nThe IPFS implementation in JavaScript needs your help! There are a few things you can do right now to help out:\n\nRead the [Code of Conduct](https://github.com/ipfs/community/blob/master/code-of-conduct.md) and [JavaScript Contributing Guidelines](https://github.com/ipfs/community/blob/master/CONTRIBUTING_JS.md).\n\n- **Check out existing issues** The [issue list](https://github.com/ipfs/js-ipfs/issues) has many that are marked as ['help wanted'](https://github.com/ipfs/js-ipfs/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3A%22help+wanted%22) or ['difficulty:easy'](https://github.com/ipfs/js-ipfs/issues?q=is%3Aissue+is%3Aopen+sort%3Aupdated-desc+label%3Adifficulty%3Aeasy) which make great starting points for development, many of which can be tackled with no prior IPFS knowledge\n- **Look at the [IPFS Roadmap](https://github.com/ipfs/roadmap)** This are the high priority items being worked on right now\n- **Perform code reviews** More eyes will help\na. speed the project along\nb. ensure quality, and\nc. reduce possible future bugs.\n- **Add tests**. There can never be enough tests.\n- **Join the [Weekly Core Implementations Call](https://github.com/ipfs/team-mgmt/issues/992)** it's where everyone discusses what's going on with IPFS and what's next\n\n## License\n\n[](https://app.fossa.io/projects/git%2Bgithub.com%2Fipfs%2Fjs-ipfs?ref=badge_large)\n\n[](https://github.com/ipfs/js-ipfs/tree/master/packages/interface-ipfs-core)\n","browser":{".":"./cjs/src/index.js","./config/profiles":"./cjs/src/components/config/profiles.js"},"exports":{".":{"import":"./esm/src/index.js","browser":"./esm/src/index.js","require":"./cjs/src/index.js"},"./config/profiles":{"import":"./esm/src/components/config/profiles.js","browser":"./esm/src/components/config/profiles.js","require":"./cjs/src/components/config/profiles.js"}},"gitHead":"484d2559cfe120f01eb9c5dc728d1f7cfbd89730","license":"(Apache-2.0 OR MIT)","scripts":{"lint":"aegir ts -p check && aegir lint","test":"aegir test","build":"run-s build:*","clean":"rimraf ./dist","dep-check":"aegir dep-check -i interface-ipfs-core -i ipfs-core-types -i abort-controller -i npm-run-all --i interface-blockstore","test:node":"aegir test -t node","build:aegir":"aegir build","test:browser":"aegir test -t browser","test:webworker":"aegir test -t webworker","test:bootstrapers":"IPFS_TEST=bootstrapers aegir test -t browser -f test/bootstrapers.js","test:electron-main":"aegir build --esm-tests && aegir test -t electron-main -f ./dist/cjs/node-test/*.spec.js","build:update-version":"node scripts/update-version.js","test:electron-renderer":"aegir build --esm-tests && aegir test -t electron-renderer -f ./dist/cjs/browser-test/*.spec.js"},"_npmUser":{"name":"ipfs-npm-publisher-bot","email":"alex.potsides+ipfs-npm-publisher-bot@protocol.ai"},"homepage":"https://github.com/ipfs/js-ipfs/tree/master/packages/ipfs-core#readme","keywords":["IPFS"],"deprecated":"js-IPFS has been deprecated in favour of Helia - please see https://github.com/ipfs/js-ipfs/issues/4336 for details","repository":{"url":"git+https://github.com/ipfs/js-ipfs.git","type":"git"},"_npmVersion":"lerna/4.0.0/node@v16.13.0+x64 (linux)","description":"JavaScript implementation of the IPFS specification","directories":{},"maintainers":[{"name":"achingbrain","email":"alex@achingbrain.net"},{"name":"ipfs-npm-publisher-bot","email":"alex.potsides+ipfs-npm-publisher-bot@protocol.ai"}],"_nodeVersion":"16.13.0","dependencies":{"dlv":"^1.1.3","ipns":"^0.15.0","pako":"^1.0.2","debug":"^4.1.1","mafmt":"^10.0.0","it-all":"^1.0.4","it-map":"^1.0.4","it-tar":"^4.0.0","libp2p":"^0.33.0","hashlru":"^2.3.0","is-ipfs":"^6.0.1","it-last":"^1.0.4","it-pipe":"^1.1.0","mortice":"^2.0.0","peer-id":"^0.15.1","err-code":"^3.0.1","it-drain":"^1.0.3","it-first":"^1.0.4","it-merge":"^1.0.2","@ipld/car":"^3.1.0","ipfs-repo":"^13.0.4","it-filter":"^1.0.2","multiaddr":"^10.0.0","any-signal":"^2.1.2","ipfs-utils":"^9.0.2","ipfs-unixfs":"^6.0.3","it-parallel":"^1.0.0","it-peekable":"^1.0.2","it-pushable":"^1.4.2","uint8arrays":"^3.0.0","@ipld/dag-pb":"^2.1.3","ipfs-bitswap":"^7.0.1","it-to-buffer":"^2.0.0","multiformats":"^9.4.13","array-shuffle":"^2.0.0","hamt-sharding":"^2.0.0","just-safe-set":"^2.2.1","libp2p-crypto":"^0.19.7","libp2p-record":"^0.10.3","merge-options":"^3.0.4","@ipld/dag-cbor":"^6.0.5","datastore-core":"^6.0.7","is-domain-name":"^1.0.1","parse-duration":"^1.0.0","blockstore-core":"^1.0.2","ipfs-core-types":"^0.8.4-rc.3+484d2559","ipfs-core-utils":"^0.12.2-rc.3+484d2559","datastore-pubsub":"^1.0.0","ipfs-core-config":"^0.1.4-rc.3+484d2559","ipfs-http-client":"^54.0.2-rc.3+484d2559","libp2p-bootstrap":"^0.13.0","multiaddr-to-uri":"^8.0.0","interface-datastore":"^6.0.2","interface-blockstore":"^2.0.2","ipfs-unixfs-exporter":"^7.0.3","ipfs-unixfs-importer":"^9.0.3","@multiformats/murmur3":"^1.0.1","@chainsafe/libp2p-noise":"^4.0.0","native-abort-controller":"^1.0.3","timeout-abort-controller":"^1.1.1","blockstore-datastore-adapter":"^2.0.2","libp2p-delegated-peer-routing":"^0.10.0","libp2p-delegated-content-routing":"^0.11.0"},"eslintConfig":{"extends":"ipfs","parserOptions":{"sourceType":"module"}},"publishConfig":{"directory":"dist"},"typesVersions":{"*":{"*":["types/*","types/src/*"],"types/*":["types/*","types/src/*"]}},"_hasShrinkwrap":false,"leadMaintainer":"Alex Potsides ","readmeFilename":"README.md","devDependencies":{"aegir":"^36.0.1","delay":"^5.0.0","sinon":"^11.1.1","nanoid":"^3.1.23","rimraf":"^3.0.2","go-ipfs":"0.9.1","iso-url":"^1.0.0","p-defer":"^3.0.0","ipfsd-ctl":"^10.0.4","@types/dlv":"^1.1.2","@types/pako":"^1.0.2","npm-run-all":"^4.1.5","@types/rimraf":"^3.0.1","libp2p-gossipsub":"^0.11.1","interface-ipfs-core":"^0.152.2-rc.3+484d2559","interface-blockstore-tests":"^2.0.1"},"_npmOperationalInternal":{"tmp":"tmp/ipfs-core_0.12.2-rc.3_1637746561381_0.6857980343797561","host":"s3://npm-registry-packages"},"_id":"ipfs-core@0.12.2-rc.3","version":"0.12.2-rc.3"}
![\"IPFS](\"https://ipfs.io/ipfs/Qme6KJdKcp85TYbLxuLV7oQzMiLremD7HMoXLZEmgo6Rnh/js-ipfs-sticker.png\")
\n\n![](\"https://img.shields.io/badge/matrix-%23ipfs%3Amatrix.org-blue.svg?style=flat\"){kind=icon}
\n![](\"https://img.shields.io/badge/freenode-%23ipfs-blue.svg?style=flat\"){kind=icon}
\n![](\"https://img.shields.io/discord/475789330380488707?color=blueviolet&label=discord&style=flat\")
![](\"https://img.shields.io/badge/team-mgmt-blue.svg?style=flat\"){kind=icon}
\n![](\"https://img.shields.io/badge/interface--ipfs--core-API%20Docs-blue.svg\"){kind=icon}
\n![](\"https://david-dm.org/ipfs/js-ipfs.svg?style=flat&path=packages/ipfs-core\")
\n![](\"https://img.shields.io/badge/code%20style-standard-brightgreen.svg?style=flat\"){kind=icon}
\n![](\"https://img.shields.io/badge/npm-%3E%3D6.0.0-orange.svg?style=flat\"){kind=icon}
\n![](\"https://img.shields.io/badge/Node.js-%3E%3D10.0.0-orange.svg?style=flat\"){kind=icon}
\n![](\"https://img.shields.io/npm/dm/ipfs.svg\")
\n