Skip to content
Trail is a Voting Platform for the Telos Blockchain Network.
C++ CMake Shell
Branch: master
Clone or download
Type Name Latest commit message Commit time
Failed to load latest commit information.
.gitignore updated test script, .gitignore, added require_fee() Aug 5, 2019
.gitmodules extend treasury_basics tests, moved eosio.contracts dependency to lib… Oct 17, 2019
LICENSE.txt update license Aug 15, 2019

Trail Voting Platform

Trail is an on-chain voting platform for the Telos Blockchain Network that offers an extensive suite of voting services for users and developers.

Features and Services

  • Secure Ballot Hosting

    Any user on the Telos Blockchain Network may create and publish a public ballot that is secured and hosted through Trail. During ballot creation, the ballot publisher selects a specfic token to use for counting votes. The default is the standard VOTE token - usable in all Telos Governance ballots, but Trail offers additional services for creating privately managed tokens that ballots can use for counting votes instead.

  • Advanced Voting Methods

    The Trail Voting Platform boasts an extensive set of voting methods and customization options. Voting Methods available include: 1acct1vote, 1tokennvote, 1token1vote, 1tsquare1v, and quadratic. For more information on the different voting methods and how they are used see the Voting Methods section of the Trail Developer Guide.

  • Custom Token Treasuries

    Any user on the Telos Blockchain Network may create a custom token treasury that automatically inherits Trail's entire suite of voting services. These registries can also be customized to allow or disallow specific behaviors like transferring, burning, staking, or reclaiming of tokens.

  • Committee Management Tools

    Trail offers a suite of committee creation and management tools that are available to any active token treasury and its voters. Developers can also hook their external smart contracts into Trail's committee tools to enable complete on-chain management of committees and their members.

  • Traceable Vote Integrity

    Trail's custom rebalance system allows workers to recalculate vote weights when a voter's token balance changes. Workers who perform this service are eligible for payment rewards in proportion to the amount of work they have performed compared to all other workers in the treasury. Future updates will allow for optional identity services to futher enhance voting and platform features.

  • Integrated Payroll System

    All treasuries created on the platform have access to Trail's payroll system, allowing managers to continuously fund operations within their own treasury. Multiple payrolls can be created under a single treasury, each with their own bucket of funds that are released to designated recipients at a customizable rate.

  • Optional Light Ballots

    Light ballots disable the on-chain vote tracking portion of the voting process - this allows for developers to track votes in an off-chain database that is built by an Iris, Demux, or Spectrum style service instead.

    This option enables Trail to power vastly more voting services by saving RAM costs for both the platform and voters, while at the same time retaining the complete traceability and auditability benefits offered by the Telos blockchain.

  • Profitable Worker Services

    Trail has several janitorial actions that incentivize workers on the network to maintain an optimized voting system. Workers are paid proportionally for their work in keeping the platform clean and balanced for all users.

Trail Documentation

Name Description
Developer Guide Breakdown of Trail features for developers interfacing with Trail.
Voter Guide How to become a voter and how voting works.
Treasury Guide How to create and manage Trail Treasuries.
Worker Guide How to become a worker and the types of jobs available for workers to perform.
Contract API Full Action and Table Breakdown.

Join the Firewatch

The Firewatch is a league of voters and developers dedicated to running a secure and optimized voting platform. Firewatch workers may claim a portion of Trail profits proportional to their recent contributions, and may also be eligible for platform-wide leaderboard rewards.

The TRAIL Token

Trail has a platform specific token that is only obtainable by performing various jobs and tasks that help optimize the platform by cleaning expired votes, rebalancing active vote receipts, and completing and interacting with valid ballots.

Proposed Use Cases:

  • Burn in exchange for free Treasury Creation, Ballot Listing, or Committee Registration.
  • Burn in exchange for extension on Payment Claim deadlines.
  • Burn in exchange for listing on Featured table.

Disclaimer: The TRAIL token is not an ICO nor should it be considered for investment or speculative purposes. It is a reward for user assistance in maintaining an efficiently run voting platform and will have evolving purposes as the platform grows.



  • Platform Optimization
  • Firewatch Incentivization

Q4 2019

  • Example Guides
  • External Contract Examples
  • Delegates, Delegate Voting
  • External Token Mirroring

Q1 2020

  • Additional Worker Services
  • Additional Voting Methods

Down Yonder

  • Optional Identity Services


  1. Voting Methods by Eric Pacuit - Stanford Encyclopedia of Philosophy

Contributing to Trail

Trail is an open-source voting platform where contributions and improvements are welcomed by the community.

To make a contribution, simply fork this repo and submit a PR for your changes. In order to avoid duplication of work, it's best to engage with the community first to determine what would be an acceptable addition to the platform.

Discussion happens mostly on Telegram, so feel free to join the Telos Dapp Development chat and pitch your idea!

You can’t perform that action at this time.