eos README

The project's README from github.com/EOSIO/eos. As one markdown file: README.md.

EOSIO - The Most Powerful Infrastructure for Decentralized Applications

Build status

Welcome to the EOSIO source code repository! This software enables businesses to rapidly build and deploy high-performance and high-security blockchain-based applications.

Some of the groundbreaking features of EOSIO include:

  1. Free Rate Limited Transactions
  2. Low Latency Block confirmation (0.5 seconds)
  3. Low-overhead Byzantine Fault Tolerant Finality
  4. Designed for optional high-overhead, low-latency BFT finality
  5. Smart contract platform powered by WebAssembly
  6. Designed for Sparse Header Light Client Validation
  7. Scheduled Recurring Transactions
  8. Time Delay Security
  9. Hierarchical Role Based Permissions
  10. Support for Biometric Hardware Secured Keys (e.g. Apple Secure Enclave)
  11. Designed for Parallel Execution of Context Free Validation Logic
  12. Designed for Inter Blockchain Communication

Disclaimer

Block.one is neither launching nor operating any initial public blockchains based upon the EOSIO software. This release refers only to version 1.0 of our open source software. We caution those who wish to use blockchains built on EOSIO to carefully vet the companies and organizations launching blockchains based on EOSIO before disclosing any private keys to their derivative software.

Official Testnet

testnet.eos.io

Supported Operating Systems

EOSIO currently supports the following operating systems:

  1. Amazon Linux 2
  2. CentOS 7
  3. CentOS 7.x
  4. CentOS 8
  5. Ubuntu 16.04
  6. Ubuntu 18.04
  7. Ubuntu 20.04
  8. MacOS 10.14 (Mojave)
  9. MacOS 10.15 (Catalina)

Note: It may be possible to install EOSIO on other Unix-based operating systems. This is not officially supported, though.


Software Installation

If you are new to EOSIO, it is recommended that you install the EOSIO Prebuilt Binaries, then proceed to the Getting Started Guide. If you are an advanced developer, a block producer, or no binaries are available for your platform, you may need to Build EOSIO from source.


Note: If you used our scripts to build/install EOSIO, please run the Uninstall Script before using our prebuilt binary packages.


Prebuilt Binaries

Prebuilt EOSIO software packages are available for the operating systems below. Find and follow the instructions for your OS:

Mac OS X:

Mac OS X Brew Install

brew tap eosio/eosio
brew install eosio

Note: On MacOS 10.15 (Catalina), there is a chance to face the linking error below which prevents successful installation of EOSIO:

Reinstalling 1 broken dependent from source:
eosio/eosio/eosio

The following Homebrew commands will resolve this issue:

brew link eosio

Mac OS X Brew Uninstall

brew remove eosio

Ubuntu Linux:

Ubuntu 20.04 Package Install

wget https://github.com/eosio/eos/releases/download/v2.1.0/eosio_2.1.0-1-ubuntu-20.04_amd64.deb
sudo apt install ./eosio_2.1.0-1-ubuntu-20.04_amd64.deb

Ubuntu 18.04 Package Install

wget https://github.com/eosio/eos/releases/download/v2.1.0/eosio_2.1.0-1-ubuntu-18.04_amd64.deb
sudo apt install ./eosio_2.1.0-1-ubuntu-18.04_amd64.deb

Ubuntu 16.04 Package Install

wget https://github.com/eosio/eos/releases/download/v2.1.0/eosio_2.1.0-1-ubuntu-16.04_amd64.deb
sudo apt install ./eosio_2.1.0-1-ubuntu-16.04_amd64.deb

Ubuntu Package Uninstall

sudo apt remove eosio

RPM-based (CentOS, Amazon Linux, etc.):

RPM Package Install CentOS 7

wget https://github.com/eosio/eos/releases/download/v2.1.0/eosio-2.1.0-1.el7.x86_64.rpm
sudo yum install ./eosio-2.1.0-1.el7.x86_64.rpm

RPM Package Install CentOS 8

wget https://github.com/eosio/eos/releases/download/v2.1.0/eosio-2.1.0-1.el8.x86_64.rpm
sudo yum install ./eosio-2.1.0-1.el8.x86_64.rpm

RPM Package Uninstall

sudo yum remove eosio

Uninstall Script

To uninstall the EOSIO built/installed binaries and dependencies, run:

./scripts/eosio_uninstall.sh

Documentation

  1. Nodeos
  2. Cleos
  3. Keosd

Resources

  1. Website
  2. Blog
  3. Developer Portal
  4. StackExchange for Q&A
  5. Community Telegram Group
  6. Developer Telegram Group
  7. White Paper
  8. Roadmap

Getting Started

Instructions detailing the process of getting the software, building it, running a simple test network that produces blocks, account creation and uploading a sample contract to the blockchain can be found in the Getting Started Guide.

Contributing

Contributing Guide

Code of Conduct

License

EOSIO is released under the open source MIT license and is offered “AS IS” without warranty of any kind, express or implied. Any security provided by the EOSIO software depends in part on how it is used, configured, and deployed. EOSIO is built upon many third-party libraries such as WABT (Apache License) and WAVM (BSD 3-clause) which are also provided “AS IS” without warranty of any kind. Without limiting the generality of the foregoing, Block.one makes no representation or guarantee that EOSIO or any third-party libraries will perform as intended or will be free of errors, bugs or faulty code. Both may fail in large or small ways that could completely or partially limit functionality or compromise computer systems. If you use or implement EOSIO, you do so at your own risk. In no event will Block.one be liable to any party for any damages whatsoever, even if it had been advised of the possibility of damage.

Important

See LICENSE for copyright and license terms.

All repositories and other materials are provided subject to the terms of this IMPORTANT notice and you must familiarize yourself with its terms. The notice contains important information, limitations and restrictions relating to our software, publications, trademarks, third-party resources, and forward-looking statements. By accessing any of our repositories and other materials, you accept and agree to the terms of the notice.

eos (EOSIO/eos)

Searching Database…

11.2K ·GitHub
archived
这是什么东西?EOSIO 是一个开源的智能合约平台,也就是区块链软件,可以让企业构建和部署高性能、高安全性的去中心化应用。
这是我自己在本地搭建运行的,还是一项在线服务?需要你自己以节点软件的形式运行。这个安装包包含 nodeos(区块链节点)、keosd(密钥和钱包管理工具)以及 cleos——两者的命令行界面。
我怎么把它跑起来?安装预编译的二进制文件——macOS 上用 Homebrew,Ubuntu 上用 .deb 包,CentOS 或 Amazon Linux 上用 RPM——然后按照 Getting Started Guide 操作。有经验的用户也可以从源码自行构建。
EOSIO 还在开发吗?没有了——这个仓库已经归档,代码不会再有更新。另外,Block.one 从未基于它推出过公链:README 提醒你,在把密钥托付给某条链的运营方之前,一定要先核实对方的底细。
它支持哪些操作系统?官方支持 Amazon Linux 2、CentOS 7 和 8、Ubuntu 16.04、18.04 和 20.04,以及 macOS 10.14-10.15。其他基于 Unix 的系统也许能运行,但不提供支持;Windows 不受支持。
这个许可证允许我做什么?MIT 许可证——可以自由使用、修改和再分发。但它按'现状'提供,不含任何担保,Block.one 也不承担任何责任,即使是导致计算机系统受损的故障也不例外。
和其他区块链相比,它的速度怎么样?区块 0.5 秒即可确认,并采用低开销的拜占庭容错(finality)机制,设计上还支持验证逻辑的并行执行——对区块链来说,这是少见的高性能表现。
我能在不承担任何风险的情况下试用吗?可以。官方在 testnet.eos.io 提供了测试网,Getting Started Guide 还会带你搭建一个简单的本地测试网络,可以出块、创建账户并部署一个示例合约。
除了速度快,它还有哪些亮点功能?免费的限额交易、定时循环交易、延时安全机制、分层的基于角色的权限管理、生物识别硬件级安全密钥(如 Apple Secure Enclave),以及内置的跨区块链通信。
智能合约在上面是怎么运行的?这个平台基于 WebAssembly:合约以 Wasm 形式执行,构建过程依赖第三方的 WebAssembly 工具 WABT 和 WAVM。
Creator
EOSIO
Size
303 MB
Stars
11.2K
Age
9y
Commits · 90 Days