Amplified Telos
Sep 6, 2018 · 3 min read

The Amplified Team recently began contributing to the Telos engineering effort. As part of this process, we had to set up the Telos development environment. Although we hit some snags along the way, we figured everything out quickly enough. We now want to help YOU quickly ramp up with Telos, so we’re sharing some tips and tricks for starting your journey with Telos.

For more detailed information about Telos, visit the Telos Foundation’s website or follow their blog.

Getting started

Note: Only specified operating systems can run or compile the project, and Telos currently supports the following: Amazon 2017.09 and higher, Centos 7, Fedora 25 and higher (Fedora 27 recommended), Mint 18, Ubuntu 16.04 (Ubuntu 16.10 recommended), Ubuntu 18.04, MacOS Darwin 10.12 and higher (MacOS 10.13.x recommended)

1.b. git checkout stage2.0

1.c. git submodule update — init — recursive

2.a. ./telos_build.sh

2.b. cd build && sudo make install

  • Change directory back to root of the cloned repo (i.e. where you cloned the repository)
  • Set up your upstream (to be able to get the updates from the main repo)

git remote add upstream https://github.com/Telos-Foundation/telos

git fetch upstream

  • Switch over to the developer branch ( git checkout -b developer )
  • From this point on, continue by using usual Git

Best practices

  • Gnu make (make, cmake, ctest) is used for compilation and testing
  • For building the whole project, use ./telos_build.sh from root
  • To rebuild only parts of it (e.g. if you’re working on unit tests, why would you need to rebuild everything?) run make install in the BUILD/folder_where_Im_working (unittest/contracts/etc.) ← especially useful when working only on a few files and need to check your changes often

Note: This doesn’t always work for all folders (eg. from our experience, changes wouldn’t always save on contracts and we had to run the full project in those cases)

  • ctest .. using the -V argument for detailed output (verbose)
  • You can use build/unittests/unit_test to run specific tests and get more output (check out ./unit_test — h for more details)

Other tips

  • Check up unfamiliar looking syntax first with C++ in your searches. If nothing comes up, it might be either code specific or EOS contract specific
  • Note: There may be functions or variables that are EOS-specific. Don’t forget to check their dev portal if you can’t find their roots anywhere (e.g.: the N() function)
  • Search in project is your friend … best friend!
  • Familiarize yourself with Git if you aren’t already (checking out to previous states, branching, merging, pull requests )
  • If you notice weird behaviors, triple-check and then ask on slack about it : they’ll most likely point you to who worked on the feature so you can have a discussion
  • From experience : in contracts you can use print; in unittests iostream / cout worked better

Additional Resources


About Amplified

Amplified is a team of engineers, designers, and product people. We plan to contribute to the Telos ecosystem as a block producer candidate and also by developing the core blockchain and higher level dapps. Amplified is founded by Ian Panchevre, who is a current MBA student at Stanford. The rest of the Amplified team is located in Romania. Learn more about Amplified by visiting amplified.software.

If you have any questions about the content of this article, or want to connect and chat more broadly about Telos, please reach out to us on Twitter (@AmplifiedTelos), on our Facebook page (fb.me/AmplifiedTelosBP/) or via email (telos@amplified.software).

Amplified Telos

Amplified is a block producer candidate. We aspire to be among the 51 independent entities that maintain and secure the Telos blockchain.

Amplified Telos

Written by

Amplified is a block producer candidate. We aspire to be among the 51 independent entities that maintain and secure the Telos blockchain.

Amplified Telos

Amplified is a block producer candidate. We aspire to be among the 51 independent entities that maintain and secure the Telos blockchain.

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade