orbitdb
- orbitdb ：Peer-to-Peer Databases for the Decentralized Web
| 特性 | 说明 |
|---|---|
| 特点 | 无服务器、分布式、p2p |
| 编程语言 | JavaScript |
| 对其他语言的支持 | A python client for the Orbitdb HTTP API，go-orbit-db， 让我们了解一下谁在使用 js-ipfs！ |
| 是否为区块链 | 不是区块链。使用强最终一致性模型，而非强一致性模型。 |
| 许可 | MIT 软件许可证 |
| 支持的数据库类型 | 事件、文件、键/值、索引键/值 |
| 底层分布式数据结构 | 无冲突复制数据类型 （CRDT）。IPFS pubsub协议自动使各对等方的数据库保持最新。https://www.zxch3n.com/crdt-intro/crdt-intro/ |
安装
node命令
- 安装node
$ npm init --yes # use npm defaults, you can edit this later
$ npm install @orbitdb/core helia
# 这是老版本的安装方式 $ npm install --save orbit-db ipfs # --save 选项的作用是将安装的包添加到 package.json 文件的 dependencies 部分。在较新的 npm 版本中（从 npm 5.0.0 开始），--save 选项是默认的
# Helia 是一种精简、模块化和现代的 IPFS TypeScript 实现，适用于多产的 JS 和浏览器环境。https://helia.io/
cdn方式安装
- OrbitDB 可以使用带有 tag 的分布式 js 文件在浏览器中加载
<script>/path/to/orbitdb.min.js</script>
<script src="https://unpkg.com/ipfs@0.55.1/dist/index.min.js"></script>
<script src="https://unpkg.com/orbit-db@0.26.1/dist/orbitdb.min.js"></script>
创建数据库示例代码
安装所需的依赖
npm install helia @orbitdb/core @chainsafe/libp2p-gossipsub @libp2p/identify libp2p
确保 Node.js 支持 ES 模块
-
import 是 ES6（ECMAScript 2015）引入的模块导入语法，用于从一个模块中引入特定的功能、对象或变量。
-
type: "module"是在package.json文件或 HTML 文件中指定 JavaScript 模块的方式。它告诉 JavaScript 引擎这个文件或所有相关文件应该被当作 ES6 模块来处理。 -
在 Node.js 项目中，可在
package.json文件中指定"type": "module"，这样就可以在项目中使用 ES6 模块语法（即import和export,import和export是 ES6 模块系统的核心，实现在不同的 JavaScript 文件中共享代码。）。 -
打开
package.json文件，添加"type": "module"：
{"name": "my-project","version": "1.0.0","description": "","main": "index.js","type": "module","scripts": {"test": "echo \"Error: no test specified\" && exit 1"},"author": "","license": "ISC","dependencies": {"helia": "^0.1.0","@orbitdb/core": "^0.1.0","@chainsafe/libp2p-gossipsub": "^0.1.0","@libp2p/identify": "^0.1.0","libp2p": "^0.1.0"}
}
创建 JavaScript 文件 index.js。
// index.js
import { createHelia } from 'helia';
import { createOrbitDB } from '@orbitdb/core';
import { gossipsub } from '@chainsafe/libp2p-gossipsub';
import { identify } from '@libp2p/identify';
import { createLibp2p } from 'libp2p';const Libp2pOptions = {services: {pubsub: gossipsub({// necessary to run a single peerallowPublishToZeroTopicPeers: true}),identify: identify()}
};(async function () {const libp2p = await createLibp2p({ ...Libp2pOptions });const ipfs = await createHelia({ libp2p });const orbitdb = await createOrbitDB({ ipfs });// Create / Open a database. Defaults to db type "events". events类型的数据库定义详见https://github.com/orbitdb/orbitdb/blob/main/src/databases/events.jsconst db = await orbitdb.open('hello');const address = db.address;console.log(address);// "/orbitdb/zdpuAkstgbTVGHQmMi5TC84auhJ8rL5qoaNEtXo2d5PHXs2To"// The above address can be used on another peer to open the same database// Listen for updates from peers，任何更新都会触发此监听函数，再运行“Add an entry”部分时会触发db.events.on('update', async entry => {console.log(entry);const all = await db.all();console.log(all);});// Add an entryconst hash = await db.add('world');console.log(hash);// Queryfor await (const record of db.iterator()) {console.log(record);}await db.close();await orbitdb.stop();await ipfs.stop();
})();
自定义events类型的数据库
-
数据库类型
Events，它继承了Database并实现了 OrbitDB 数据库接口。下面是功能总结：add: 将一个事件添加到数据库中，并返回该事件的哈希值。get: 根据给定的哈希值从数据库中获取事件的值。iterator: 异步生成器函数，用于迭代事件。支持多种过滤条件（如哈希值范围和结果数量）。all: 返回所有事件的数组，事件以哈希/值对的形式存储（通过iterator实现）。
运行代码：在终端中运行node index.js
运行结果
PS C:\Users\kingchuxing\Documents\IPFS\orbitdb_enent> node index.js
## console.log(address);的输出
/orbitdb/zdpuB3GgA87irrdJDyvrNvwDNTwQLRxXNWoLrioDEjNeiYvC4## Listen for updates from peers 部分的输出
{id: '/orbitdb/zdpuB3GgA87irrdJDyvrNvwDNTwQLRxXNWoLrioDEjNeiYvC4',payload: { op: 'ADD', key: null, value: 'world' },next: [],refs: [],clock: {id: '021c0174efab4162111ef8c77df934dbdb767cc96449fad014b46cdd9033a53ea1',time: 1},v: 2,key: '021c0174efab4162111ef8c77df934dbdb767cc96449fad014b46cdd9033a53ea1',identity: 'zdpuApdyQ1Nfunra16qqtALnLb8KkPGxWeoMDZyXrKQij1QtT',sig: '3045022100a5166de55326728dd33fccc770fcc117324f02a62e41d4217050af9ecba895ec02202927783b54c79146809351b58d3dba4d9c99fcfc294f1a261cbe3607435d41f9',hash: 'zdpuAkydAnMRxSiyqHaXJgngdpXQK1HYWWNqRiqMtU273GZSe',bytes: Uint8Array(476) [169, 97, 118, 2, 98, 105, 100, 120, 58, 47, 111, 114,98, 105, 116, 100, 98, 47, 122, 100, 112, 117, 66, 51,71, 103, 65, 56, 55, 105, 114, 114, 100, 74, 68, 121,118, 114, 78, 118, 119, 68, 78, 84, 119, 81, 76, 82,120, 88, 78, 87, 111, 76, 114, 105, 111, 68, 69, 106,78, 101, 105, 89, 118, 67, 52, 99, 107, 101, 121, 120,66, 48, 50, 49, 99, 48, 49, 55, 52, 101, 102, 97,98, 52, 49, 54, 50, 49, 49, 49, 101, 102, 56, 99,55, 55, 100, 102,... 376 more items]
}## console.log(hash); 的输出
zdpuAkydAnMRxSiyqHaXJgngdpXQK1HYWWNqRiqMtU273GZSe
[{hash: 'zdpuAkydAnMRxSiyqHaXJgngdpXQK1HYWWNqRiqMtU273GZSe',value: 'world'}
]
## console.log(record) 的输出
{hash: 'zdpuAkydAnMRxSiyqHaXJgngdpXQK1HYWWNqRiqMtU273GZSe',value: 'world'
}
PS C:\Users\kingchuxing\Documents\IPFS\orbitdb_enent>
CG
- 在 HTML 文件中，可通过
type="module"属性来指定一个<script>标签内的 JavaScript 代码是ES模块代码。
<script type="module">import { myFunction } from './myModule.js';myFunction();
</script>
