README_zh_cn.md

A ⭐️ is welcome!

English | 中文

什么是DB3 Network

DB3 Network是一款开源的去中心化的firebase替代品，在DB3 Network上面可以低成本快速构建复杂的去中心化数据应用。

为什么需要DB3 Network

在没有db3 network情况下，如果你想构建一个复杂的去中心化数据应用，比如去中心社交，你有两种选择

1. 用中心化的数据库架构，比如使用firestore或者mongodb来存储和读取数据
2. 用以太坊或者其他公链来存储数据，用thegraph来索引数据，通过区块链能够保证数据去中心化，用thegraph可以提供快速的链上查询功能

第一个方案可以非常轻易的开发出复杂应用，但是因为引入了中心化架构，会打破去中心带来的好处；第二个方案可以实现真正的去中心化，但是开发成本很高，所以在有db3 network之后你可以方便的开发出既能保证去中心化，还能有复杂数据逻辑的去中心化应用

功能列表

Schemaless

你可以存储任何json文档数据，而不用做任何修改

高性能

去中心会大大降低性能，而db3 网络在通过以下功能去解决性能问题

• Merkdb 是一款通过高效证明和查询的存储引擎
• Query session 可以保证的在提供查询性能同时，还能保证给查询服务者提供查询激励

数据可编程

db3 network提供类typescript的编程语言来开发智能合约

加密原生数据拥有权

db3 network里面每一行数据都有自己唯一的归属权, 每一行数据只有拥有者通过自己的私钥才能去修改

有以太坊保证安全

DB3 network 是基于以太坊的一个2层网络， 这样所有的资产的安全性可以由以太坊保证安全

快速开始

启动一个本地网络

git clone https://github.com/dbpunk-labs/db3.git
cd db3 && bash install_env.sh && cargo build
# start localnet
cd tools &&  sh start_localnet.sh

使用控制台

• 启动控制台

./target/debug/db3 console
db3>-$ new-db
database address                           | transaction id
--------------------------------------------+----------------------------------------------
0xa9f5c8170aad7a0f924d89c6edacae6db24ef57d | 0ALy/hH7CQe9lv294K6dOxGP14xWHsbRs+/pXBZa8oU=

• 现实数据库信息

db3>-$ show-db --addr 0x7e16cb6524e2fc21ae9bf2d7ee18b05767b9dc33
 database address                           | sender address                             | releated transactions                        | collections
--------------------------------------------+--------------------------------------------+----------------------------------------------+-------------
 0x7e16cb6524e2fc21ae9bf2d7ee18b05767b9dc33 | 0x96bdb8e20fbd831fcb37dde9f81930a82ab5436b | EMYw64xlI2q4v1MShoKw3T60asNbWJ9//ca75M3JO3Q= |

• 添加一个collection

db3>$ new-collection --addr 0xcfb524677673af15edebbec018b16d42d87b1251 --name books --index '{"name":"idx1","fields":[{"field_path":"test1","value_mode":{"Order":1}}]}'
send add collection done with tx
3V7r7VRg+9zUXeGNmqRR0YdVXWtBSl4sk+Z50h9BrOc=

• 查看collection

db3>-$ show-collection --addr 0xcfb524677673af15edebbec018b16d42d87b1251
 name  | index
-------+----------------------------------------------------------------------------
 books | {"name":"idx1","fields":[{"field_path":"test1","value_mode":{"Order":1}}]}

• create a document
• get a document
• list documents
• query documents by index

使用db3.js构建dapp

/*
|----------------------------|
| use db3js open a database  |
|----------------------------|
*/

// build sign function
const sign = await getSign()

// build database factory
const dbFactory = new DB3Factory({
    node: 'http://127.0.0.1:26659',
    sign,
    nonce
})

// open database with a address
const db = dbFactory.open("0x5ca8d43c15fb366d80e221d11a34894eb0975da6")

for more please go to db3.js

项目贡献

• 点赞转发⭐️ . Together, we can make db3 network better!

db3 网络内部实现

架构图

更多技术细节

• mutation
• query session
• dvm
• merkdb

其他去中心化数据

• the graph, 去中心化索引
• Locutus, 去中心kv数据库
• ceramic network, 去中心化数据网络
• kwil, 去中心的支持SQL的数据库
• spaceandtime, 去中心化数据仓库
• OrbitDB ，一个无服务的p2p数据库

Thanks support

I stood on the shoulders of giants and did only simple things. Thank you for your attention.

Protocol Labs

Filecoin

License

Apache License, Version 2.0 (LICENSE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)

Contribution

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions. See CONTRIBUTING.md.