Flag Doc
  • Summary
  • DOCUMENTATION
    • Learn about the Flag Platform
      • Flag Overview: vision, strategy and platform components
      • The Flag Blockchain
        • Discovering the Network
        • Flag Consensus
        • Delegation through Staking with Validators
        • Ethereum (EVM) Compatibility and Smart Contracts
        • Boosting Flag's Scalability
      • Flag Coin (FLAG)
        • FLAG Tokenomics
        • Exchanges, Wallets, On-Ramps and DeFi Tools Supporting FLAG
        • FLAG on Other Chains
      • Interoperability
      • Flag Governance and Development
        • Flag Assembly
        • Flag Improvement Proposals (FIPs)
      • Wallets supporting Flag
    • Flag for Business
    • Things you can do on Flag
      • Interacting with the Flag Blockchain
      • Flag Ecosystem
      • Community
      • Grants and Bounties
  • Developers
    • Network Details
      • Flag Mainnet
      • Flag Testnet
      • Token Faucets
      • Network Upgrades
        • Upgrade Guide
        • Upgrade Guide (explorer nodes)
        • Block 13,800,000 Fork
        • FIP's
    • Flag Consensus
      • Contracts Overview
      • Stake, Delegate and Withdraw
      • Vote
      • End-of-Cycle Flow
      • Contract Addresses
    • How to run network nodes
    • Resources & Tools
      • TheGraph
      • WalletConnect on Flag
    • Important smart contracts
      • Flag Token
      • Major Deployed Contracts
      • Bridges
        • Ethereum ↔ Flag FLG20 Tokens
        • BSC ↔ Flag BNB
        • BSC ↔ Flag Native
        • BSC ↔ Flag FLG20
        • Ethereum ↔ Flag Native
    • How to become a validator
      • Getting started as a validator
      • Getting started as on the Flag testnet
  • Links
    • Discord
    • Facebook
    • GitHub
    • LinkedIn
    • Medium
    • Telegram
    • Twitter
    • YouTube
Powered by GitBook
On this page
  • Consensus - 0xF631D903d6C31b606Ec527558e441108B6211af3
  • Block Reward - 0x25E1d50A7967b9e50B31B05c61f1706130FCd44c
  • Voting - 0x27E184c98E376963dFf564E455e96983298B1169
  • Proxy Storage
  1. Developers

Flag Consensus

PreviousFIP'sNextContracts Overview

Last updated 1 year ago

Consensus is a fault-tolerant mechanism that is used in blockchain systems to achieve the necessary agreement on the single state of the network. Flag network is using a (DPoS) consensus model. DPoS is a variation of consensus. In PoS there are a set of validators that are responsible for keeping the network updated and validating the network's state. They do this in turns, every validator has their turn in line. On their turn the validator updates the network's state, and the rest of the validators check that the update is valid.

Consensus contract is used to manage the list of the network validators and delegators

BlockReward contract is calculates the reward amount that validators and delegators will receive on each block validation. The reward size is proportional to validator's stake.

With Voting contract validators are vote on various changes on these 3 base level contracts. All those contracts are proxied with implementation that handles the logic. The implementations can be changed only by the Voting process.

The bridge is used to transfer the Flag native token between Flag and Ethereum networks.

This contract is responsible for handling the network DPos consensus. The contract stores the current validator set and chooses a new validator set at the end of each cycle. The logic for updating the validator set is to select a random snapshot from the snapshots taken during the cycle.

The snapshots are taken of pending validators, who are those which staked more than the minimum stake needed to become a network validator. Therefore the contract is also responsible for staking, delegating and withdrawing those funds.

Stake amount for a validator is the sum of staked and delegated amount to it's address.

minimum stake amount = 100,000 Flag token

cycle duration blocks = 57600 (approximately 2 days)

This contract is responsible for generating and distributing block rewards to the network validators according to the network specs (5% yearly inflation).

Another role of this contract is to call the snapshot/cycle logic on the Consensus contract

This contract is responsible for opening new ballots and voting to accept/reject them. Ballots are basically offers to change other network contracts implementation.

Only network validators can open new ballots, everyone can vote on them, but only validators votes count when the ballot is closed.

Ballots are opened/closed on cycle end.

max number of open ballots = 100

max number of open ballots per validator = 100 / number of validators

minimum ballot duration (cycles) = 2

maximum ballot duration (cycles) = 14

This contract is responsible for holding network contracts implementation addresses and upgrading them if necessary (via voting).

This contract is based on non-reporting ValidatorSet .

This contract is based on BlockReward .

Consensus - 0xF631D903d6C31b606Ec527558e441108B6211af3
described in Parity Wiki
Block Reward - 0x25E1d50A7967b9e50B31B05c61f1706130FCd44c
described in Parity Wiki
Voting - 0x27E184c98E376963dFf564E455e96983298B1169
Proxy Storage
Delegated Proof of Stake
Proof of Stake