The first step to becoming a voter is voter registration. Successful registration will open a zero-balance account for the new voter, allowing them to obtain tokens and cast votes and interact with any future or existing ballot launched by the treasury.
Find a Treasury to Join
Finding a Treasury to join is easy - just browse the treasury table and get the treasury symbol.
Consider the Access Method
Some treasuries are not open to the public and are instead only available based on an invite from a referrer. Typically the referrer must already be a voter for that treasury, but more tightly controlled
private ballots require an invite from the treasury manager.
Open to everyone
Requires referral by manager
Requires referral by voter
Once a suitable treasury has been found, the voter (or the referrer) must call the
regvoter() action and supply the following arguments:
voter: This is the name of the new voter's Telos account.
treasury_symbol: This is the symbol of the treasury to join. Treasury symbols are expressed as the token's precision (i.e. the number of decimal places it has) followed by the ticker symbol of the treasury token.
referrer (Optional): This is the account name of the referrer, if applicable. This account will authorize the registration of the
voter account. If there is no referrer, then use
After successful registration, the voter is allowed to begin casting votes on ballots.
Once a voter is registered they must obtain tokens in order to cast a vote. The method for acquiring tokens will vary based on the treasury and project, but in general tokens can be acquired through a purchase, as a gift from another voter, or through the treasury manager directly.
Find an Open Ballot
After acquiring a balance of tokens, a voter can cast votes using the weight of those tokens. Any ballot with a status of
voting is currently accepting votes.
Cast Your Vote
Once an open ballot has been found, all that's left to do is vote! Voters can submit their votes to the ballot by calling the
castvote() action and supplying the following arguments:
This is the name of the voter's account.
This is the name of the ballot to vote on.
This is the list of options that the voter wishes to vote on. The voter can vote for as many ballot options as they like, up to the max options limit set by the ballot.
["option1", "option3", ...]
Sometimes voters want to retract previously submitted votes. Note that unvoting will rollback all votes cast on a ballot by a single user, but the vote receipt will remain on-chain until the ballot has reached its completion. This design allows the vote to track work performed on it and ensures that voters can't unvote and erase vote history.
Certain treasuries will allow or disallow staking of tokens. If staking is allowed, vote weights will be pulled from the voter's staked amount instead of liquid when casting votes.
Balance of liquid tokens.
Balance of staked tokens.
Time point the last stake or unstake occurred.
Tokens delegated to a registered delegate.
The delegate account to which the voter's tokens are delegated.
Time point the last delegation or undelegation occurred.
Account name of the voter.
True if the voter account is a delegate.
Amount of raw tokens cast for this vote.
Map of ballot option -> total votes.
Time point of vote.