Primal Docs
  • Summary
  • DOCUMENTATION
    • Learn about the Primal Platform
      • Primal Overview: vision, strategy and platform components
      • The Primal Blockchain
        • Discovering the Network
        • Primal Consensus
        • Delegation through Staking with Validators
        • Ethereum (EVM) Compatibility and Smart Contracts
        • Boosting Primal's Scalability
      • Primal Coin (PRM)
        • PRM Coinomics
        • Exchanges, Wallets, On-Ramps and DeFi Tools Supporting PRM
        • PRM on Other Chains
      • Interoperability
      • Primal Governance and Development
        • Primal Assembly
        • Primal Improvement Proposals (PIPs)
      • Wallets supporting Primal
    • Primal for Business
    • Things you can do on Primal
      • Interacting with the Primal Blockchain
      • Primal Ecosystem
      • Community
      • Grants and Bounties
    • Primal Mobile Infrastructure Use Cases
  • Developers
    • Network Details
      • Primal Mainnet
      • Primal Testnet
      • Coin Faucets
      • Network Upgrades
        • Upgrade Guide
        • Upgrade Guide (explorer nodes)
        • Block 13,800,000 Fork
        • PIP
    • Primal Consensus
      • Contracts Overview
      • Stake, Delegate and Withdraw
      • Vote
      • End-of-Cycle Flow
      • Contract Addresses
    • How to run network nodes
    • Resources & Tools
      • TheGraph
      • WalletConnect on Primal
    • Important smart contracts
      • Primal Coin
      • Primal Dollar
      • Major Deployed Contracts
      • Bridges
        • Ethereum ↔ Primal Dollar Token
        • Ethereum ↔ Primal TL20 Tokens
        • BSC ↔ Primal BNB
        • BSC ↔ Primal Native
        • BSC ↔ Primal TL20
        • Ethereum ↔ Primal Native
    • How to become a validator
      • Getting started as a validator
      • Getting started as on the Primal testnet
  • Links
    • Discord
    • Facebook
    • GitHub
    • LinkedIn
    • Medium
    • Telegram
    • Twitter
    • Instagram
    • YouTube
Powered by GitBook
On this page
  • Open a new ballot
  • Check ballot info
  • Vote
  • getQuorumState
  • getAccepted/getRejected
  • activeBallots
  1. Developers
  2. Primal Consensus

Vote

PreviousStake, Delegate and WithdrawNextEnd-of-Cycle Flow

Last updated 2 years ago

Primal chain functionality can be change by voting on the contracts implementations. New implementations can be deployed, and opened to vote by validators for others to decide on whether to accept/reject the changes.

Open a new ballot

In order to open a new vote, a validator needs to call the `newBallot` function on the with the following params:

  • startAfterNumberOfCycles - number of cycles (minimum 1) after which the ballot is open for voting

  • cyclesDuration - number of cycles (minimum 2) for the ballot to remain open for voting

  • contractType

    • 1 - Consensus

    • 2 - BlockReward

    • 3 - ProxyStorage

    • 4 - Voting

  • proposedValue - address of the new implementation deployed for the relevant contract type

  • description - text description which should contain the reason/change introduced in the ballot

Check ballot info

Everyone can check all the ballots that were created using the `getBallotInfo` function. This function receives two params:

  • id - the ballot id

  • key - account address

Vote

Everyone can vote on open ballots, after the start block has passed and until the end block hasn't yet.

It's important to note that at the end of a vote, only validators count towards the final result.

Voting is done by calling the `vote` function, which receives two params:

  • id - the ballot id

  • choice - 1 is accept, 2 is reject

getQuorumState

Returns the state of a specific ballot id: 1 - in progress, 2 - accepted, 3 - rejected

getAccepted/getRejected

Returns the number of accepts/reject of a specific ballot id.

activeBallots

Returns an array of active ballot ids.

Some other useful functions on the are:

voting contract
voting contract
new ballot
getBallotInfo
vote