Ontology

Version V0.6.0

Welcome to Ontology's source code library!

Ontology is dedicated to creating a freely configurable, componentized, interoperability across chains, high-performance, and horizontally scalable blockchain infrastructure system. Ontology makes deploying and calling Decentralization applications even more easier.

The code is currently alpha-quality, but in the rapid development process. The master code may be unstable, stable versions can be downloaded in the release page.

The public test network described in the page below, and we sincerely welcome and hope more developers to join Ontology.

Features

• Scalable Lightweight Universal Smart Contract
• Scalable WASM Contract support
• Crosschain Interactive Protocol (Processing)
• Multiple Encryption Algorithm Support
• Highly optimized transaction processing speed
• P2P Link Layer Encryption (optional module)
• Multiple Consensus Algorithm Support (VBFT/DBFT/RBFT/SBFT)
• quick block generation time

Contents

• Build development environment
• Deployment and test
  • Get ontology
    • Get from source code
  • Create ONT wallet file
  • Server Deployment
    • Single-host deployment configuration
    • Multi-hosts deployment configuration
    • Deploy nodes on public test network
    • Inplement
• Examples
• Contributing
• Open source community
  • Site
• License

Build development environment

The requirements to build ontology are:

• Golang version 1.9 or later
• Glide (a third-party package management tool)
• Properly configured Go language environment
• Golang supported operating systems

Deployment and test

Get ontology

Get from source code

Clone the ontology repository into the appropriate $GOPATH/src directory.

$ git clone https://github.com/ontio/ontology.git

Fetch the dependent third-party packages with glide.

$ cd ontology
$ glide install

Build the source code with make.

$ make

After building the source code sucessfully, you should see two executable programs:

• ontology: the node program
• nodectl: command line program for node control

Create ONT wallet file

create ontology wallet

ont supports multiple encryption methods for generating accounts, but can set a default in config.json such as SHA256withECDSA,

Create wallet cmd：

$ ./nodectl wallet --create --name wallet.dat --password passwordtest --encrypt=SHA512withEdDSA

Note: Set wallet password by parameter -p.

To show the wallet info：

$ ./nodectl wallet --list account

public key:    1202021401156f187ec23ce631a489c3fa17f292171009c6c3162ef642406d3d09c74d
hex address:  018f0dcf09ec2f0040e6e8d7e54635dba40f7d63
base58 address:       TA7T3p6ikRG5s2pAaehUH2XvRCCzvsFmwE

$ ./nodectl wallet --list account -b
ont: 248965536

* with -b cmd will show the ont amount this account have.

ONT supported crypto( with ):

• SHA224withECDSA
• SHA256withECDSA
• SHA384withECDSA
• SHA512withECDSA
• SHA3-224withECDSA
• SHA3-256withECDSA
• SHA3-384withECDSA
• SHA3-512withECDSA
• RIPEMD160withECDSA
• SM3withSM2
• SHA512withEdDSA

Server Deployment

To run ontology successfully, nodes can be deployed by the following two way:

• Single-host deployment
• Multi-hosts deployment
  • Deploy nodes on public test network

Single-host deployment configuration

Create a directory on the host and store the following files in the directory:

• Default configuration file config.json
• node programontology
• node control programnodectl
• wallet filewallet.dat, copy the contents of the configuration file config-solo.config in the root directory to config.json and start the node.

Here's a example of Single-host configuration:

• directory structure `

$ tree
└── ontology
    ├── config.json
    ├── ontology
    ├── nodectl
    └── wallet.dat

Multi-hosts deployment configuration

We can perform a quick deployment by modifying the default configuration file config.json.

1. Copy related file into target host，including：

   • default configuration fileconfig.json
   • node programontology
   • node control programnodectl

2. Set the network connection port number for each node(recommend using the default port configuration, instead of modifying)

   • NodePortis P2P connection port number（default: 20338）
   • HttpJsonPort and HttpLocalPort are RPC port number（default: 20336，20337）

3. Seed nodes configuration

   • Select at least one seed node out of 4 hosts and fill seed node address into the SeelList of each configuration file, format is Seed node IP address + Seed node NodePort

4. Create wallet file

   • Through command line program，on each host create wallet wallet.dat needed for node implement.

     $ ./nodectl wallet -c -p password

     Note：Set wallet password by parameter -p.

5. Bookkeepers configuration

   • While creating wallet for each node, the public key information of the wallet will be displayed. Fill in the public key information of all nodes in the Bookkeepers field of each node's configuration file.

     Note：The public key information for each node's wallet can also be viewed via the command line program:

     $ ./nodectl wallet -l -p password

Now multi-hosts configuration is cpmpleted, directory structure of each node is as follow:

$ ls
config.json ontology nodectl wallet.dat

A configuration file fragment is as follows, refer to the config.json file in the root directory.

Deploy nodes on public test network

Start with the following configuration file to connect to ont the current test network.

$ cat config.json
{
  "Configuration": {
    "Magic": 7630401,
    "Version": 23,
    "SeedList": [
	   "139.219.108.204:20338",
	   "139.219.111.50:20338",
	   "139.219.69.70:20338",
	   "40.125.165.118:20338"
    ],
    "Bookkeepers": [
"1202021c6750d2c5d99813997438cee0740b04a73e42664c444e778e001196eed96c9d",
"12020339541a43af2206358714cf6bd385fc9ac8b5df554fec5497d9e947d583f985fc",
"120203bdf0d966f98ff4af5c563c4a3e2fe499d98542115e1ffd75fbca44b12c56a591",
"1202021401156f187ec23ce631a489c3fa17f292171009c6c3162ef642406d3d09c74d"
    ],
    "HttpRestPort": 20334,
    "HttpWsPort":20335,
    "HttpJsonPort": 20336,
    "HttpLocalPort": 20337,
    "NodePort": 20338,
    "NodeConsensusPort": 20339,
    "PrintLevel": 1,
    "IsTLS": false,
    "MaxTransactionInBlock": 60000,
    "MultiCoreNum": 4
  }
}

Inplement

Run each node program in any order and enter the node's wallet password after the Password: prompt appears

$ ./ontology
$ - Input your wallet password

Run ./nodectl --h for details.

Examples

Contract

Smart Contract guide

ONT transfer sample

 ./nodectl transfer --contract ff00000000000000000000000000000000000001 --value 10 --from 0181beb9cfba23c777421eaf57e357e0fc331cbf --to 01f3aecd2ba7a5b704fbd5bac673e141d5109e3e

 contract:contract address； - from: transfer from； - to: transfer to； - value: amount；

Contributing

Please open a pull request with signed-off commits. We appreciate your help! You can also send your codes as emails to the developer mailing list. You're welcomed to join the Ontology mailing list or developer forum.

Besides, please provide detailed submission information when you want to contribute code for this project. The format is as follows:

Header line: explain the commit in one line (use the imperative)

Body of commit message is a few lines of text, explaining things in more detail, possibly giving some background about the issue being fixed, etc etc.

The body of the commit message can be several paragraphs, and please do proper word-wrap and keep columns shorter than about 74 characters or so. That way "git log" will show things nicely even when it's indented.

Make sure you explain your solution and why you're doing what you're doing, as opposed to describing what you're doing. Reviewers and your future self can read the patch, but might not understand why a particular solution was implemented.

Reported-by: whoever-reported-it Signed-off-by: Your Name youremail@yourhost.com

Open source community

Site

• https://ont.io/

License

The Ontology library is licensed under the GNU Lesser General Public License v3.0, read the LICENSE file in the root directory of the project for details.