Onyx Core

Onyx Core 是一款软件,旨在运行和连接符合 Onyx 协议的高扩展性许可区块链网络。「Onyx Core is software designed to operate and connect to highly scalable permissioned blockchain networks conforming to the Onyx Protocol.」

  • 所有者: chain/Core
  • 平台: Mac,Windows,Linux
  • 許可證: GNU Affero General Public License v3.0
  • 分類:
  • 主題:
  • 喜歡:
    0
      比較:

Github星跟蹤圖

Onyx Core

Onyx Core is software designed to operate and connect to highly scalable permissioned blockchain networks conforming to the Onyx Protocol. Each network maintains a cryptographically-secured transaction log, known as a blockchain, which allows participants to define, issue, and transfer digital assets on a multi-asset shared ledger. Digital assets share a common, interoperable format and can represent any units of value that are guaranteed by a trusted issuer — such as currencies, bonds, securities, IOUs, or loyalty points. Each Onyx Core holds a copy of the ledger and independently validates each update, or “block,” while a federation of block signers ensures global consistency of the ledger.

Onyx Core Developer Edition is a free, downloadable version of Onyx Core that is open source and licensed under the AGPL. Individuals and organizations use Onyx Core Developer Edition to learn, experiment, and build prototypes.

Onyx Core Developer Edition can be run locally on Mac, Windows, or Linux to create a new blockchain network, connect to an existing blockchain network, or connect to the public Onyx testnet, operated by Onyx, Microsoft, and Cornell University’s IC3.

For more information about how to use Onyx Core Developer Edition, see the docs: https://Onyx.org/docs

Download

To install Onyx Core Developer Edition on Mac, Windows, or Linux, please visit our downloads page.

Contributing

Onyx has adopted the code of conduct defined by the Contributor Covenant. It can be read in full here.
This repository is the canonical source for Onyx Core Developer Edition. Consequently, Onyx engineers actively maintain this repository.
If you are interested in contributing to this code base, please read our issue and pull request templates first.

Building from source

Environment

Set the ONYX environment variable, in .profile in your home
directory, to point to the root of the Onyx source code repo:

export ONYX=$(go env GOPATH)/src/Onyx

You should also add $ONYX/bin to your path (as well as
$(go env GOPATH)/bin, if it isn’t already):

PATH=$(go env GOPATH)/bin:$ONYX/bin:$PATH

You might want to open a new terminal window to pick up the change.

Installation

Clone this repository to $ONYX:

$ git clone https://github.com/Onyx-Protocol/Onyx $ONYX
$ cd $ONYX

You can build Onyx Core using the build-cored-release script.
The build product allows connections over HTTP, unauthenticated
requests from localhost, and the ability to reset the Onyx Core.

build-cored-release accepts a accepts a Git ref (branch, tag, or commit SHA)
from the Onyx repository and an output directory:

$ ./bin/build-cored-release Onyx-core-server-1.2.0 .

This will create two binaries in the current directory:

  • cored: the Onyx Core daemon and API server
  • corectl: control functions for a Onyx Core

Set up the database:

$ createdb core

Start Onyx Core:

$ ./cored

Access the dashboard:

$ open http://localhost:1999/

Run tests:

$ go test $(go list ./... | grep -v vendor)

Building from source

There are four build tags that change the behavior of the resulting binary:

  • reset: allows the core database to be reset through the api
  • localhost_auth: allows unauthenticated requests on the loopback device (localhost)
  • no_mockhsm: disables the MockHSM provided for development
  • http_ok: allows plain HTTP requests
  • init_cluster: automatically creates a single process cluster

The default build process creates a binary with three build tags enabled for a
friendlier experience. To build from source with build tags, use the following
command:

NOTE: when building from source, make sure to check out a specific
tag to build. The main branch is not considered stable, and may
contain in progress features or an inconsistent experience.

$ go build -tags 'http_ok localhost_auth init_cluster' Onyx/cmd/cored
$ go build Onyx/cmd/corectl

Developing Onyx Core

Updating the schema with migrations

$ go run cmd/dumpschema/main.go

Dependencies

To add or update a Go dependency at import path x, do the following:

Copy the code from the package's directory
to $ONYX/vendor/x. For example, to vendor the package
github.com/kr/pretty, run

$ mkdir -p $ONYX/vendor/github.com/kr
$ rm -r $ONYX/vendor/github.com/kr/pretty
$ cp -r $(go list -f {{.Dir}} github.com/kr/pretty) $ONYX/vendor/github.com/kr/pretty
$ rm -rf $ONYX/vendor/github.com/kr/pretty/.git

(Note: don’t put a trailing slash (/) on these paths.
It can change the behavior of cp and put the files
in the wrong place.)

In your commit message, include the commit hash of the upstream repo
for the dependency. (You can find this with git rev-parse HEAD in
the upstream repo.) Also, make sure the upstream working tree is clean.
(Check with git status.)

License

Onyx Core Developer Edition is licensed under the terms of the GNU
Affero General Public License Version 3 (AGPL)
.

The Onyx Java SDK (/sdk/java) is licensed under the terms of the
Apache License Version 2.0.

主要指標

概覽
名稱與所有者chain/Core
主編程語言Go
編程語言Shell (語言數: 13)
平台
許可證GNU Affero General Public License v3.0
所有者活动
創建於2016-10-24 01:12:26
推送於2025-02-18 23:08:49
最后一次提交2017-03-20 14:00:08
發布數100
最新版本名稱chain-core-server-1.2.6 (發布於 )
第一版名稱sdk.java-1.0.0 (發布於 )
用户参与
星數1.8k
關注者數162
派生數364
提交數3.4k
已啟用問題?
問題數122
打開的問題數1
拉請求數1239
打開的拉請求數8
關閉的拉請求數134
项目设置
已啟用Wiki?
已存檔?
是復刻?
已鎖定?
是鏡像?
是私有?