Skip to content

lingxiyang/xuperchain

 
 

Repository files navigation

XuperChain

Build Status Go Report Card GolangCI License Release

What is XuperChain

XuperChain, the first open source project of XuperChain Lab, introduces a underlying solution to build the super alliance network. Based on the dynamic kernel of xupercore. You can use xuberchain as a blockchain infrastructure to build a compliant blockchain network.

XuperChain is the underlying solution for union networks with following highlight features:

  • Dynamic kernel

    • Based on the dynamic kernel technology, the free extension kernel components without kernel code intrusion and lightweight extension customized kernel engine are implemented to meet the needs of blockchain implementation for various scenarios.
    • It provides a comprehensive and high-performance implementation of standard kernel components.
    • Comprehensively reduce the cost of blockchain research and development, and open a new era of one click chain development.
  • High Performance

    • Creative XuperModel technology makes contract execution and verification run parallelly.
    • TDPoS ensures quick consensus in a large scale network.
    • WASM VM using AOT technology.
  • Solid Security

    • Contract account protected by multiple private keys ensures assets safety.
    • Flexible authorization system supports weight threshold, AK sets and could be easily extended.
  • High Scalability

    • Robust P2P network supports a large scale network with thousands of nodes.
    • Branch management on ledger makes automatic convergence consistency and supports global deployment.
  • Multi-Language Support: Support pluggable multi-language contract VM using XuperBridge technology.

  • Flexibility: Modular and pluggable design provides high flexibility for users to build their blockchain solutions for various business scenarios.

Contact

E-mail: xchain-help@baidu.com

Quick start

Requirements

  • OS Support: Linux and Mac OS
  • Go 1.12.x or later
  • GCC 4.8.x or later
  • Git

Build

Clone the repository

git clone https://github.com/xuperchain/xuperchain

Note: master branch contains latest features but might be unstable. for production use, please checkout our release branch. the latest release branch is v3.7.

Enter the xuperchain folder and build the code:

cd xuperchain
make

Note that if you are using Go 1.11 or later, go modules are used to download 3rd-party dependencies by default. You can also disable go modules and use the prepared dependencies under vendor folder.

Run test:

make test

Run

Run single node blockchain

There is an output folder if build successfully. Enter the output folder, create a default chain & start blockchains:

cd ./output
sh control.sh start

By doing this, a blockchain named "xuper" is created, you can find the data of this blockchain at ./data/blockchain/xuper/.

By default, the xuper chain will produce a block every 3 seconds, try the following command to see the trunkHeight of chain and make sure it's growing.

./bin/xchain-cli status

Run multi nodes blockchain

Generate multi nodes. Before running the following command, make sure you have run make to make the code.

make testnet

Enter the testnet directory, and then start three nodes separately (make sure the port is not used)

cd ./testnet/node1
sh ./control.sh start
cd ../node2
sh ./control.sh start
cd ../node3
sh ./control.sh start

Observe the status of each node

./bin/xchain-cli status -H :37101
./bin/xchain-cli status -H :37102
./bin/xchain-cli status -H :37103

Documentation

We have new documentation of Chinese version at XuperChain Chinese Docs, the English version is comming soon.

How to Contribute

We encourage you to contribute to XuperChain.

Please review the Contribution guidelines for information on how to get started contributing to the project.

License

XuperChain is under the Apache License, Version 2.0.

=====

中文说明

XuperChain是什么?

XuperChain是超级链体系下的第一个开源项目,是构建超级联盟网络的底层方案。基于XuperCore动态内核实现的。您可以使用XuperChain,作为区块链基础设施,构建合规的区块链网络。 。

核心特点

  • 动态内核

    • 基于动态内核技术,实现无内核代码侵入的自由扩展内核核心组件和轻量级的扩展订制内核引擎,满足面向各类场景的区块链实现的需要。
    • 提供了全面的、高性能的标准内核组件实现。
    • 全面降低区块链研发成本,开启一键发链新时代。
  • 高性能

    • 原创的XuperModel模型,真正实现了智能合约的并发执行和验证。
    • TDPOS算法确保大规模节点下的快速共识。
    • 使用AOT加速的WASM虚拟机,合约运行速度接近native程序。
  • 更安全

    • 多私钥保护的账户体系。
    • 鉴权支持权重累计、集合运算等灵活的策略。
  • 易扩展

    • 鲁棒的P2P网络,支持广域网超大规模节点。
    • 底层账本支持分叉管理,自动收敛一致性,实现真正全球化部署。
  • 多语言开发智能合约

    • 通过原创的XuperBridge技术,可插拔多语言虚拟机。
  • 高灵活性

    • 可插拔、插件化的设计使得用户可以方便选择适合自己业务场景的解决方案。

快速试用

环境配置

  • 操作系统:支持Linux以及Mac OS
  • 开发语言:Go 1.12.x及以上
  • 编译器:GCC 4.8.x及以上
  • 版本控制工具:Git

构建

克隆XuperChain仓库

git clone https://github.com/xuperchain/xuperchain

注意: master 分支是日常开发分支,会包含最新的功能,但是 不稳定。生产环境请使用最新的已发布分支,最新的已发布分支是v3.10

编译

cd xuperchain
make

跑单测

make test

单机版xchain

cd ./output
sh ./control.sh start
./bin/xchain-cli status

多节点xchain

生成多节点。 在运行下面的命令之前,请确保已经运行make去编译代码。

make testnet

进入testnet目录,分别启动三个节点(确保端口未被占用)。

cd ./testnet/node1
sh ./control.sh start
cd ../node2
sh ./control.sh start
cd ../node3
sh ./control.sh start

观察每个节点状态

./bin/xchain-cli status -H :37101
./bin/xchain-cli status -H :37102
./bin/xchain-cli status -H :37103

文档

关于XuperChain更详细、更深入的使用方法链接请查看XuperChain文档库

如何参与开发

  1. 阅读源代码,了解我们当前的开发方向
  2. 找到自己感兴趣的功能或模块
  3. 进行开发,开发完成后自测功能是否正确,并运行make & make test
  4. 发起pull request
  5. 更多详情请参见链接

许可证

XuperChain使用的许可证是Apache 2.0

联系我们

商务合作,请Email:xchain-help@baidu.com, 来源请注明Github。 如果你对XuperChain开源技术及应用感兴趣,欢迎添加“百度超级链·小助手“微信,回复“技术论坛进群”,加入“百度超级链开发者社区”,与百度资深工程师深度交流!微信二维码如下:

微信二维码

About

A highly flexible blockchain architecture with great transaction performance.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • Go 94.8%
  • Shell 4.7%
  • Other 0.5%