mirror of
https://github.com/orbitdb/orbitdb.git
synced 2025-05-19 21:36:37 +00:00
Update README
This commit is contained in:
parent
55edb848e3
commit
33f23c70eb
16
README.md
16
README.md
@ -4,6 +4,8 @@
|
|||||||
|
|
||||||
Distributed, peer-to-peer Key-Value Store and Event Log on IPFS.
|
Distributed, peer-to-peer Key-Value Store and Event Log on IPFS.
|
||||||
|
|
||||||
|
This is the Javascript implementation and it works both in **Node.js** and **Browsers**.
|
||||||
|
|
||||||
- Stores all data in IPFS, including the database index
|
- Stores all data in IPFS, including the database index
|
||||||
- Aggregation happens on client side and data is eventually consistent
|
- Aggregation happens on client side and data is eventually consistent
|
||||||
- Uses a LWW-element-set [CRDT](https://en.wikipedia.org/wiki/Conflict-free_replicated_data_type) and (sort of) Vector Clocks for partial ordering
|
- Uses a LWW-element-set [CRDT](https://en.wikipedia.org/wiki/Conflict-free_replicated_data_type) and (sort of) Vector Clocks for partial ordering
|
||||||
@ -19,6 +21,15 @@ npm install orbit-db
|
|||||||
```
|
```
|
||||||
|
|
||||||
## Examples
|
## Examples
|
||||||
|
### Browser examples
|
||||||
|
In order to run the browser example, you need to have a local IPFS daemon running. Start it with the following command:
|
||||||
|
```
|
||||||
|
API_ORIGIN=* ipfs daemon
|
||||||
|
```
|
||||||
|
|
||||||
|
Then open `examples/browser.html`. See the example code [here](https://github.com/haadcode/orbit-db/blob/master/examples/browser.html).
|
||||||
|
|
||||||
|
### Node.js examples
|
||||||
Before running the examples, install dependencies with:
|
Before running the examples, install dependencies with:
|
||||||
```
|
```
|
||||||
npm install
|
npm install
|
||||||
@ -71,15 +82,18 @@ _See usage example below_
|
|||||||
## Usage
|
## Usage
|
||||||
```javascript
|
```javascript
|
||||||
const async = require('asyncawait/async');
|
const async = require('asyncawait/async');
|
||||||
|
const ipfsAPI = require('ipfs-api');
|
||||||
const OrbitClient = require('./OrbitClient');
|
const OrbitClient = require('./OrbitClient');
|
||||||
|
|
||||||
// orbit-server
|
// orbit-server
|
||||||
const host = 'localhost';
|
const host = 'localhost';
|
||||||
const port = 3333;
|
const port = 3333;
|
||||||
|
|
||||||
|
const ipfs = ipfsAPI();
|
||||||
|
|
||||||
async(() => {
|
async(() => {
|
||||||
// Connect
|
// Connect
|
||||||
const orbit = OrbitClient.connect(host, port, username, password);
|
const orbit = OrbitClient.connect(host, port, username, password, ipfs);
|
||||||
|
|
||||||
const channelName = 'hello-world';
|
const channelName = 'hello-world';
|
||||||
const db = orbit.channel(channelName);
|
const db = orbit.channel(channelName);
|
||||||
|
Loading…
x
Reference in New Issue
Block a user