Skip to content
A smart contract platform for everyone.
Branch: master
Clone or download
Pull request Compare This branch is 520 commits ahead, 1034 commits behind EOSIO:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.buildkite
.github
CMakeModules
Docker
contracts Merge branch 'developer' into merge/1.4.x Dec 1, 2018
debian
docs
externals
images Relocate wiki images and remove unused Doxyfile. Jun 1, 2018
libraries
plugins
programs
scripts
tests
tools
tutorials
unittests
.gitignore
.gitlab-ci.yml
.gitmodules
CMakeLists.txt
HEADER
LICENSE
README.md
eos.doxygen.in
eosio.version.in
telos_build.sh
telos_install.sh
telos_uninstall.sh
testnet.md
testnet.template

README.md

TELOS - A Smart Contract Platform for Everyone

=======

Welcome to the official Telos repository! This software enables anyone to rapidly build and deploy high-performance and high-security blockchain-based applications.

Telos offers a suite of features including:

  1. Economic disparity solutions such as elimination of whale accounts, inversely weighted voting, and increased token equity.
  2. Developer and Enterprise features such as designation of propietary code and reduced RAM speculation.
  3. Network freeze mitigation by regularly rotating standby BP's into production status to ensure operability and uptime.
  4. Standby and BP payments are straightforward and fair, resulting in a better payment experience.
  5. The Telos Constitution is ratified and enforceable at launch.
  6. ...more features incoming!

For a full explanation of all the proposed Telos features, be sure to read our whitepaper!

Table of Contents

  1. Installation
    1. Grow Installation
    2. Manual Installation
  2. Testnet Contributions
  3. Road Map
  4. Resources

Installation

  1. Clone master branch

    a. git clone https://github.com/Telos-Foundation/telos

    b. git checkout oak-v1.4.5

    c. git submodule update --init --recursive

  2. Inside the telos folder run the following commands:

    a. ./telos_build.sh

    b. sudo ./telos_install.sh

  3. Set up config.ini file

    a. Run nodeos to generate a config file. This will generate a config.ini file in the current directory if none exists.

     nodeos --config-dir ./
    

    b. Determine your Producer name. Please be aware there are restrictions on the allowed characters.

     producer-name = prodname1234
    

    b. Determine your Signature Provider. Run teclos create key, and import your keys into your wallet.

     signature-provider = EOS{public key}=KEY:{private key}
    

    c. Determine your p2p and http endpoints. Choose your own p2p and http ports.

     http-server-address = 0.0.0.0:{http port}
     p2p-listen-endpoint = 0.0.0.0:{p2p port}
     p2p-server-address = {external IP address}:{p2p port}
     p2p-peer-address = testnet.telosfoundation.io:6789
    

    d. Determine your Plugins. The only required plugin is producer_plugin, but other plugins add extended functionality to your nodes.

     plugin = eosio::http_plugin
     plugin = eosio::chain_plugin
     plugin = eosio::chain_api_plugin
     plugin = eosio::history_plugin
     plugin = eosio::history_api_plugin
     plugin = eosio::net_plugin
     plugin = eosio::net_api_plugin
     plugin = eosio::producer_plugin
    
  4. Register Node on Testnet

    a. Navigate to testnet.telosfoundation.io and click on the Register button.

    b. Enter your configuration into the web form.

    c. Copy the command generated by submitting the form.

    d. Run the generated regproducer command on your local node.

    e. Your account is now created and registered as a producer on the testnet.

If you have previously installed EOSIO, please run the eosio_uninstall script (it is in the directory where you cloned EOSIO) before downloading and using the binary releases.

Mac OS X Brew Install

$ brew tap eosio/eosio
$ brew install eosio

Mac OS X Brew Uninstall

$ brew remove eosio

Ubuntu 18.04 Debian Package Install

$ wget https://github.com/eosio/eos/releases/download/v1.4.5/eosio_1.4.5-1-ubuntu-18.04_amd64.deb
$ sudo apt install ./eosio_1.4.5-1-ubuntu-18.04_amd64.deb

Ubuntu 16.04 Debian Package Install

$ wget https://github.com/eosio/eos/releases/download/v1.4.5/eosio_1.4.5-1-ubuntu-16.04_amd64.deb
$ sudo apt install ./eosio_1.4.5-1-ubuntu-16.04_amd64.deb

Debian Package Uninstall

$ sudo apt remove eosio

Centos RPM Package Install

$ wget https://github.com/eosio/eos/releases/download/v1.4.5/eosio-1.4.5-1.el7.x86_64.rpm
$ sudo yum install ./eosio-1.4.5-1.el7.x86_64.rpm

Centos RPM Package Uninstall

$ sudo yum remove eosio.cdt

Fedora RPM Package Install

$ wget https://github.com/eosio/eos/releases/download/v1.4.5/eosio-1.4.5-1.fc27.x86_64.rpm
$ sudo yum install ./eosio-1.4.5-1.fc27.x86_64.rpm

Fedora RPM Package Uninstall

$ sudo yum remove eosio.cdt

Supported Operating Systems

Telos currently supports the following operating systems:

  1. Amazon 2017.09 and higher
  2. Centos 7
  3. Fedora 25 and higher (Fedora 27 recommended)
  4. Mint 18
  5. Ubuntu 16.04 (Ubuntu 16.10 recommended)
  6. Ubuntu 18.04
  7. MacOS Darwin 10.12 and higher (MacOS 10.13.x recommended)

Testnet Contributions

The Telos Testnet is a sandbox for testing newly implemented features and finding bugs within the network. In order to ensure the network behaves as expected, participation in Testnet activites and providing meaningful feedback is encouraged.

  • Voting Voting is an important part of the network, and with Telos' proposed changes to the voting stucture each vote will carry more weight and whales will have significantly less influence on the direction of the network.

  • Claiming Producer/Standby Rewards In order to receive your hard-earned Producer/Standby payout, registered producers will make a call to claimrewards no more than once per day. When claimrewards is called, the calling producer's share of TLOS is calculated and paid to their account. In addition to sending the producer's earned payout, claimrewards will also make a deposit to the Worker Proposal Fund. This deposit is not taken out of the producer's share, but rather from the newly minted tokens from the claimrewards call. For a more in depth explanation of this process, please consult the whitepaper or join a discussion on our many public channels.

Testnet Road Map

The Telos Roadmap is broken into four separate stages. Each stage implements new features outlined in the white paper. Once all the features of a stage have been implemented, tested, and peer reviewed, the group will move onto implementing the next stage. Each stage may contain versions. These versions will contain amendments and features that have yet to be completed and/or tested. Below you will see an outline of the stages.

Resources

  1. Telos Website
  2. Telos Blog
  3. Telos Twitter
  4. Telos Documentation Wiki
  5. Telos Community Telegram Group

Telos 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 Telos software depends in part on how it is used, configured, and deployed. Telos is built upon many third-party libraries such as Binaryen (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, Telos Foundation makes no representation or guarantee that Telos 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 Telos, you do so at your own risk. In no event will Telos Foundation be liable to any party for any damages whatsoever, even if it had been advised of the possibility of damage.

You can’t perform that action at this time.