Pinion is a lightweight pinning service that supports both IPFS content and orbit-db stores. It relies solely on ipfs-pubsub-peer-monitor, orbit-db, and js-ipfs-http-client to communicate with an IPFS node.
Pinion can:
- Pin IPFS content
- Pin orbit-db store content
- Keep listening to updates from any given orbit-db store
To install pinion, run:
yarn add global @colony/pinionor
npm i -g @colony/pinionAnd then run pinion passing an IPFS node endpoint and a pinning room:
PINION_ROOM=YOUR_PINNING_ROOM pinionIn this configuration we're assuming some sensible defaults. See below.
Pinion can be configured by either passing in the configuration programatically to its constructor (with the only required value being the room, see defaults in the example):
import Pinion from 'Pinion';
const pinner = new Pinion('YOUR_PINNING_ROOM', {
ipfsRepo: './ipfs',
ipfsPrivateKey: 'CAA...',
maxOpenStores: 100,
orbitDBDir: './orbitdb',
});Or using environment variables when running it from the command line:
PINION_IPFS_CONFIG_FILE=./ipfsConfig.production.json PINION_ROOM=YOUR_PINNING_ROOM PINION_IPFS_REPO=./ipfs PINION_IPFS_PRIVATE_KEY="CAA..." PINION_MAX_OPEN_STORES=100 PINION_ORBIT_DB_DIR=./orbitdb pinion(required)
The IPFS pubsub room pinion is going to join and listen to new messages to.
(optional)
You can also specify the limit of how many stores you wanna keep open simultaneously by passing in an environment variable MAX_OPEN_STORES. The stores will be automatically allocated using a LRU algorithm. The limit is by default set to 100 stores.
(optional)
Define a config file to use (see ipfsConfig.production.example.json for an example).
(optional)
The private key that is used to initialize the IPFS repo. Will generate a random key when omitted.
(optional)
You can specify the an IPFS repo path of your preference. The default is ./ipfs.
(optional)
You can specify the orbit-db path option so stores data are kept in the place of your preference. The default is ./orbitdb
Pinion is still on its infancy and you might need debug info or a more detailed output to figure out if it misbehaves. To run it on verbose/debug mode, please also set an environment var like so DEBUG='pinner:*'.
Opens a store, loads it and keep listening to it until it's being cleaned up by the LRU cache.
address- An orbit-db-store address.
{
type: 'REPLICATE',
payload: { address: '/orbitdb/Qma=/my-store' },
};Request the IPFS node to pin the content hash.
ipfsHash- An IPFS multihash. Emits apinnedHashevent passing the ipfs hash back.
{
type: 'PIN_HASH',
payload: { ipfsHash: 'Qma=...' },
};Published when the pinner has opened a store and it's ready. It will contain the count of heads that the pinner has for this store.
{
type: 'HAVE_HEADS',
to: '/orbitdb/Qma=/my-store',
payload: {
address: '/orbitdb/Qma=/my-store/<signature>',
count: 100,
timestamp: 10010203993
},
}Published when the pinner has started, or in response to an ANNOUNCE_CLIENT message.
{
type: 'ANNOUNCE_PINNER',
payload: {
ipfsId: 'Qm...',
},
}We welcome all contributions to Pinion. You can help by testing, suggesting new features, improving performance or documentation.
Please read our Contributing Guidelines for how to get started.
Start an ipfs node on localhost on port 4001. You can use the commands provided in the package.json using either yarn ipfsd-go or yarn ipfsd-js (Docker has to be running on your system).
Then, in another terminal window do:
yarn test
Pinion is MIT licensed
![dependabot[bot] avatar](https://avatars.githubusercontent.com/in/29110?v=4 "dependabot[bot]")
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent