Cellframe Wiki

Search

SearchSearch

Cellframe Poll

Apr 22, 20254 min read

The Cellframe Poll service allows any user to create their own poll.

Creation

To do this, you need to create a poll transaction. This can be done using the Node Command - POLL CREATE.

The command has the following syntax and parameters:

SYNTAX:

poll create 
-net <net_name> 
-question <"Question_string"> 
-options <"Option1","Option2",..."OptionN"> 
[-expire <poll_expire_time_in_RCF822>] 
[-max_votes_count <Votes_count>] 
[-delegated_key_required] 
[-vote_changing_allowed] 
[-token <ticker>]
-fee <value_datoshi> 
-w <fee_wallet_name>

OPTIONS:

net - name of the Cellframe Network question - subject of the poll (string in quotes, limit - 200 characters) options - answer options (strings in quotes listed through commas, limit of a one answer - 100 characters, number of options - not more than 10) expire - poll end time (optional, time format is RCF822, use time of your system) max_votes_count - maximum number of votes being accepted (optional) delegated_key_required - allows to vote only for users who has delegated key (optional) vote_changing_allowed - allows to change previously sent answer in poll (optional) token - a name of the token which will be used to participate in poll (optional) fee - validator’s commission, because poll is a transaction too w - name of the wallet from which commission will be paid

After this, other users can participate in the poll by using the balance of their wallet.

Voting

To participate in the poll, you need to create a corresponding transaction using the Node Command - POLL VOTE.

The user must choose which poll they are participating in and the answer option. In the case that this is a poll only for delegates, the user must also attach a delegated certificate.

Voting is done using the full balance of the wallet in the specified token. If no token is specified when creating the poll, the native token of the network will be used by default, for example, CELL is for Backbone. Thus, the weight of each vote is determined by the token balance, and the number of tokens used to vote for a particular answer option is taken into account when counting the votes.

Important

The funds which already used for voting are recorded in the system, so it will not be possible to vote with them from another wallet.

To understand how this works, let’s find an active poll and look at its detailed information.

Description

Use the Node Command - POLL LIST to see the active votings in the Backbone network.

We will get a list of polls:

            poll_tx:
  0xD14C2A64BE7C5887FC57C9D605F99983869D78F2AE39EF8664B529AD207A00C1
            question: When 2-way bridge?
            token: CELL
 
 
            poll_tx: 0x3F8D12CA187ED9A61BEB6B410C8F3AC553B9BE5154936F623372086D425FEBC4
            question: qa_test_Q_21.10.24
             token: CELL
 
 
            poll_tx: 0x2FF637550D9C13C72C11EF8ECD1D7D03297D4BC34B64043B0582CBFC1C38EE95
            question: "question?"
             token: CELL
 
 
            poll_tx: 0xFF83795F5C732A017628F5B20C830BE4AE55CFFFC11F06C2AB19B657CFB625A7
            question: What volume of CELL designated for block-signing rewards for validators and staking rewards would you like to see emitted in the next year?
             token: CELL
...
"this response was cut to make it more comfortable for article"

Take the first poll transaction.

            poll_tx:
  0xD14C2A64BE7C5887FC57C9D605F99983869D78F2AE39EF8664B529AD207A00C1
            question: When 2-way bridge?
            token: CELL

Let’s get more detailed information about this poll using Node Command - POLL DUMP.

poll_tx: 0xD14C2A64BE7C5887FC57C9D605F99983869D78F2AE39EF8664B529AD207A00C1
        question: When 2-way bridge?
        token: CELL
        can_change_status: false
        delegated_key_required: false
        results:
 
                option_id: 0
                option_text: 0...June
                votes_count: 1
                votes_percent: 20
                votes_sum: 233576.883418888350810852
                votes_sum_datoshi: 233576883418888350810852
                votes_sum_weight: 53.10
 
 
                option_id: 1
                option_text: 1...later this summer
                votes_count: 2
                votes_percent: 40
                votes_sum: 92835.463744868269475289
                votes_sum_datoshi: 92835463744868269475289
                votes_sum_weight: 21.10
 
 
                option_id: 2
                option_text: 2...Maybe Q3-4
                votes_count: 2
                votes_percent: 40
                votes_sum: 113483.190847209755246254
                votes_sum_datoshi: 113483190847209755246254
                votes_sum_weight: 25.80
 
 
        votes_count: 5
        total_sum: 439895.538010966375532395
        total_sum_datoshi: 439895538010966375532395

question - When 2-way bridge? token - CELL

The parameter can_change_status: false indicates that you can’t change your choice if you have already voted in this poll. The parameter delegated_key_required: false indicates that this is not a poll for delegates, as a delegated key is not required.

Below are 3 answer options with the following parameters:

option_id - the ID of the answer option (starting from 0) option_text - answer option voting_count - number of votes vote_percent - number of votes for this option relative to the total number of votes, normalized to 100 vote_sum - sum of the balances of those who voted for this option in coins vote_sum_datoshi - sum of the balances of those who voted for this option in datoshi vote_sum_weight - specific weight of votes for this option relative to the total weight of votes in tokens

At the very bottom, you can also find information about the total number of voters votes_count: 5, as well as the total sum total_sum: 439895.538010966375532395 of the voted balances.

What will be decisive—the relative weight or the number of votes for each answer option—is determined by the creator of the poll.

Graph View

Backlinks