Image for post
Image for post

Telos User’s Guide — Tutorial: Telos Works

How to vote for and submit work proposals

GoodBlock
GoodBlock
Feb 23, 2019 · 10 min read

UPDATE 7 Feb. 2020: The Telos Worker Proposal System is now referred to as “Telos Works”

Telos Works is the way that Telos users can guide and pay for the development, promotion and growth of the Telos network. Telos is the first EOS.IO blockchain with a functional worker proposal system (WPS) and one of the only projects in the blockchain world where all users can vote to determine how network funds are used. This voting means that the Telos users direct how the chain will grow by what proposals it chooses to fund. (Telos users also guide the growth of the network through Ratify/Amend* proposals that modify the text of governance documents.)

This article uses examples from Sqrl wallet, which includes Telos Decide advanced voting features in its interface. Please use the latest version of Sqrl (these examples require version 1.0.4 or higher) and only download Sqrl from the link provided on the Telos Foundation website (https://telosfoundation.io).

*UPDATE 7 Feb. 2020: Ratify/Amend is now called ‘Telos Amend’

Opening the Proposals voting page

Select the Proposals tab to open the Proposals tab page.

Image for post
Image for post

Voting for proposals

Each proposal contains information about:

  • When the voting period begins and ends
  • The amount of TLOS requested and for how many cycles
  • The Requesting Account, which submitted the proposal
  • The worker proposal deposit paid for the account
  • The number of Yes, No and Abstain votes the proposal has received
  • A link to the description of the worker proposal stored on IPFS

Each proposal also has Yes, No and Abstain voting buttons.

Image for post
Image for post

Understanding a Work proposal

Voting Begins/Ends

Amount Requested and Cycles

A proposal may include numerous cycles. Each cycle is a 5 million block voting period that begins immediately upon the closing of the preceding cycle. The submitter will receive the entire requested payment each time a billing cycle ends with the proposal in a position of having been accepted within that cycle. (The standard is a simple majority of Yes votes over No votes and at least 5% of eligible voting tokens cast as Yes, No or Abstain votes.) For example, if a proposer wanted to receive a regular payment of 10,000 TLOS every month for their ongoing work for half a year, they would submit a proposal for 10,000 TLOS in 6 cycles.

Requesting Account

Work Proposal Fee

Yes, No and Abstain Votes

IPFS Proposal Link

To vote for a proposal:

To vote against a proposal:

To abstain on a proposal:

To change or remove your vote from a proposal:

It is not possible to completely remove your vote from a proposal. You can click the Abstain button at the bottom of the proposal to make your vote not count towards either Yes or No votes, however, it will still contribute to the overall voting weight of a proposal.

Image for post
Image for post

Submitting a Telos Works Proposal

A work proposal can be anything from a blank page to a complex pitch deck. Ideally a proposal will state, at a minimum:
- How much is being requested
- Who it will go to
- What deliverables are being proposed
- Important details about the deliverables
- A timeframe for delivery
- Steps the presenter is taking to ensure successful completion of the project
Voters will not only need to believe in the idea, but the person or team carrying it out.

It is quite likely that a Telos Works proposal with a good idea may be quickly followed on by other, similar proposals that offer to do largely the same thing, but with teams that purport to be better, faster, less expensive, using better methods, or having more community trust. This is a natural outcome of the open proposal system that Telos uses. While some may view this as copying an idea, the bigger picture is that the Telos community benefits from this competition by different teams to provide different approaches to solving common problems. More proposals means more options and opportunities for the community to get the solution that they feel is best for Telos.

The proposal

Remember that Telos is a global community and presenting your proposal in multiple languages is likely to help your success. People can’t be expected to vote for proposals they can’t read.

The submission and claiming process

  1. Submitting the proposal, ensuring the account has enough funds for the submission deposit.
  2. Starting the voting period
  3. Reclaiming the deposit
  4. Claiming payment for an accepted proposal
  5. Claiming payments for additional cycles, if applicable

To submit your work proposal:

On the Proposals Portal page, click the Submit New Proposal button. This brings up the Submit New Worker Proposal dialog box.

Image for post
Image for post

Under Proposal Title, enter the name that you want your proposal to be listed under.

Click the Choose File button and select the proposal file from your computer to upload.

Under Requested Amount (TLOS), type the number of TLOS you are requesting per voting cycle (29 days). Amounts should be numeric and end in a decimal followed by exactly 4 digits.

Under Recipient, type the name of the Telos account where your payment(s) will be sent if your proposal is accepted. This may be the same account submitting the proposal but does not need to be.

Under Cycles, enter the number of cycles that a proposal will run.

Click the Confirm button to bring up the Submit New Worker Proposal dialogue box.

If the summarized details for your submission are correct, click the Submit Proposal button to finalize the submission.

Image for post
Image for post

If your work proposal submission fails

To cancel a proposal submission:

On the Proposals Portal page, find the proposal you wish to cancel. It will most likely be at the top of the list of proposals.

Image for post
Image for post

Click the Delete Proposal button. This brings up the Delete Worker Proposal dialog box.

Image for post
Image for post

Click the Delete Proposal button to permanently delete the submitted proposal. Be aware: Deleting the proposal does not return your deposit fee. Your fee will be lost permanently.

To start the voting period:

Click the Start Ballot button. This brings up the Open Voting for Proposal dialog box.

Image for post
Image for post

Click the Start Ballot button to begin the 5 million block voting period for the submitted proposal.

Image for post
Image for post

When you return to the proposal, the Voting Begins and Voting Ends information will have updated to reflect the voting period.

Image for post
Image for post

To reclaim your deposit fee:

Select the Smart Contracts tab to open the Smart Contracts interface tab page.

In the box for Contract Account Name type or select ‘eosio.saving’ and click the Load Contract button.

On the Actions tab, in the Contract Actions drop-down list, select getdeposit. Under the Action Parameters section, owner text entry box, enter the name of the Telos account that has a deposit to reclaim (the same account that submitted the worker proposal). Click the Create Transaction button.

Image for post
Image for post

This will open a Review Transaction screen. Click Sign + Broadcast Transaction to complete the getdeposit action.

To claim payment for an accepted proposal:

On the Proposals Portal page, find the proposal you wish to claim. It may be down the list of active proposals.

Click the Claim button. This brings up the Claim Work Proposal dialog box.

If a proposal is accepted in another cycle, repeat this process after each cycle.

When you claim work proposal funds, please remember that you have been entrusted by the Telos users with the network’s funds on the promise that you will deliver on your promised items or actions. Failure to deliver as promised not only jeopardizes your ability to win work proposals in the future, but you may also be sent to binding arbitration by the Telos block producers for failure to deliver on your paid proposal. Please respect the trust that the Telos users have placed in you with their votes and funds.

To verify your submission deposit

Select the Smart Contracts tab to open the Smart Contracts interface tab page.

In the box for Contract Account Name type or select ‘eosio.saving’ and click the Load Contract button.

On the Tables tab, in the Contract Tables drop-down list, select Deposits. Click the Load Table button. When the table loads, look for your account name in the ‘owner’ column and find the deposit amount in the corresponding position in the ‘escrow’ column.

Image for post
Image for post

More about GoodBlock can be found at: www.goodblock.io

Join us on Twitter @GoodBlockio

Vote for GoodBlock on the Telos Blockchain Network @goodblocktls

The Telos Network Blog

Articles about the Telos Blockchain Network

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

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store