Ballots

Ballot Creation

To create a new ballot, call the newballot() action. Note that the account publishing the ballot must also be a member of the group they wish to publish the ballot under.

Ballot Statuses

Ballot statuses describe the current stage of a ballot's lifecycle. All new ballots begin with the setup status.

Status	Description
setup	Ballot is being drafted.
voting	Ballot is currently open for voting.
closed	Ballot is closed and final results have been rendered.
cancelled	Ballot was cancelled, awaiting deletion.
archived	Ballot is currently archived and can't be deleted.

Voting Methods

Voting Methods describe how a ballot will react to voters with different token balances. One method splits a voter's balance among all of their selections, and another casts their full balance on each selection, for example.

Voting Method	Description	Raw Token Weight	Transformed Weight Per Selection
1acct1vote	Every voter gets 1 whole token vote, regardless of account balance. Zero balances don't count.	0.01 TEST	1.00 TEST Each
1tokennvote	Raw token weight is applied to each option selected.	3.00 TEST	3.00 TEST Each
1token1vote	Raw token weight is split among all selections.	3.00 TEST	1.00 TEST Each
1tsquare1v	Raw weight is split among selections and each weight squared. At ballot closure each option's total will be square-rooted	3.00 TEST	9.00 TEST Each
quadratic	Raw weight is square-rooted and split among selections.	3.00 TEST	9.00 Each

Ballot Settings

Ballots have a range of settings that further alter their behavior.

Setting	Description	Default
lightballot	Marks as a light ballot.	false
revotable	Allows revoting on the ballot.	true
voteliquid	Considers voter's liquid balance into vote weight.	false
votestake	Considers voter's staked balance into vote weight.	true

Table Breakdown

Table: ballots

Scope: self

Field Name	Field Type	Description
ballot_name	name	Name of ballot.
category	name	Ballot category name.
publisher	name	Account that published the ballot.
status	name	Ballot status.
title	string	Ballot title.
description	string	Tweet-length ballot description.
content	string	Link or hash of external content.
treasury_symbol	symbol	Treasury that ballot belongs to.
voting_method	name	Name of selected voting method.
min_options	uint8_t	Minimum ballot selections allowed on a vote.
max_options	uint8_t	Maximum ballot selections allowed on a vote.
options	map<name, asset>	Map of Ballot Options and their current vote tallies.
total_voters	uint32_t	Number of voters who participated on ballot.
total_delegates	uint32_t	Number of delegates who participated on ballot.
total_raw_weight	asset	Total number of raw tokens cast on ballot.
cleaned_count	uint32_t	Number of expired vote receipts that have been cleaned.
settings	map<name, bool>	Map of setting names and on/off states.
begin_time	time_point_sec	Time ballot voting is opened.
end_time	time_point_sec	Time ballot voting closes.