What to Do and How it Works
On-chain governance is important for any decentralized DLT. With Shimmer Firefly’s newest update, Shimmer token holders can now participate in the governance of the network. With the support of the IOTA Foundation, the Shimmer community has developed a highly flexible and secure system for casting votes directly on the Shimmer Tangle through the Firefly wallet and counting the votes in the network’s Hornet nodes.
To understand how immutable on-chain governance works on Shimmer, read on! The Shimmer community has developed an extensive framework for governance decisions with three phases: Discussion, Temperature Check, and Voting. This blog describes how the Voting phase is carried out amongst network participants.
The Voting phase of a governance vote is further divided into four stages:
- Proposal announcement: Upon publishing the voting ballot to the GitHub repository, Hornet node operators can activate the voting ballot in their nodes’ Participation Plugin to be prepared to count any votes that are cast.
- Voting Open: The Voting Open stage lasts seven days and starts when a predefined milestone in the Shimmer network is reached. After the network has passed this milestone, users can cast, change, revoke, or redo the vote using the governance functionality of the Shimmer Firefly wallet. It's important to note that changes of opinion during this timeframe will not affect the final vote count. Ideally, voters should cast their votes before the next stage begins to ensure the highest possible vote count.
- Counting Start: This directly follows the Voting Open stage. The node software counts the user's vote, which gains weight with increasing holding time at every milestone passed (a milestone is issued every five seconds). If the voter holds their vote for the predefined number of milestones, the voter will reach 100% of the possible votes related to their voting power (i.e. the number of tokens they have used in the vote). If users change their vote in this stage, the participation plugin updates these changes from the time when they were made. However, the previously counted votes are still valid and do not change, even if the voter’s opinion or voting power changes (examples are provided below for clarification).
- Counting Stops: The accumulation of votes ends. All nodes will now be able to produce and verify the final result of the vote.
The voting mechanism utilizes Shimmer’s ability to issue value transactions with attached metadata. To participate in voting, the user must define the amount of SMR tokens that should be used for governance votes, which represents their voting power, for each wallet associated with their Shimmer Firefly profile. The tokens that represent the voting power will be sent to a new output (UTXO) at the same address (i.e., the user sends the tokens to themselves) using the Manage Voting Power function in the new Governance section of Shimmer Firefly.
This Governance Output to which the tokens are allocated will now be used for all governance votes of this wallet. The voter can decide to vote on all kinds of governance questions with the allocated voting weight.
Whenever a vote is cast, it uses the tokens that are stored in the Governance Output for a transaction (again, the user sends the tokens to themselves, to the same output, using the same address). During this transaction, metadata that includes the ballot event ID, question ID, and answer will be attached to the UTXO where the tokens reside. This immutably writes the metadata onto the UTXOs of this address in the Tangle. So, after the voting transaction is complete, the tokens will still reside at the same address as before but now they will have attached metadata representing the voter's opinion for the referendum.
Because every node in the SMR network knows the status of every UTXO in the Tangle, they can observe and register changes to these UTXOs. As soon as a vote transaction is issued and confirmed, the UTXO will hold a piece of attached metadata information.
Hornet nodes with activated INX participation plugin monitor the ledger for UTXOs that contain this specific metadata. They count all UTXOs that have this metadata for every new milestone in the Tangle and create a database for the counted votes of this event. This database includes the following information for every milestone:
- Every UTXO ID containing the vote's event ID.
- The voter’s opinion (question ID and answer) that is written to this UTXO.
- The number of tokens that are stored on the UTXO at a milestone.
The result will be produced and verified in a decentralized manner through every node that participates in the counting. Each node can make the current and final result of its counting publicly available through an API endpoint.
After the commencement of the Counting Start phase (which is the milestone in the Tangle that has been designated as the starting point), the number of votes will be tallied for every milestone where tokens are recognized on a UTXO that has the attached voting metadata. The community has determined that 1000 Glow (0.001 SMR) represents one vote per milestone.
Therefore, a vote using an amount of 1 SMR for an option will be counted as follows:
- Since 1000 Glow represents one vote, a vote with one million Glow (equal to 1 SMR) will result in 1000 votes per milestone.
- The counting occurs at every milestone of the “counting period, meaning that:
- 1000 votes are counted at the first milestone.
- 1000 votes are counted at the second milestone.
- 1000 votes are counted at the third milestone, and so on.
Let's assume that the counting period lasts for 1,500 milestones:
The method described above updates the nodes' database with newly counted every time a new milestone is reached. For instance, if a voter uses 1 SMR token in a vote, after 10 milestones, they would have gained 10,000 votes. After 100 milestones, the accumulated votes would be 100,000, and after 1,500 milestones, the total counted votes would reach 1.5 million.
This counting mechanism also means that the result is greatly influenced by the tokens' Vote Holding Time. Votes gain “weight” based on the length of time they are kept on an address during the counting phase.
This is a crucial security feature of the voting mechanism that rewards long-term token holders and punishes voting speculators or vote buyers. This is achieved by requiring voters to lock their capital over a longer period and making any attempt to buy votes a speculative risk due to the potential volatility of the SMR price during the seven-day counting phase.
Voting weight examples
Let's look at some examples of voting weight based on different variables.
If the counting phase is seven days and a user has a balance of 100 SMR in their Shimmer Firefly wallet that they allocate as voting power:
- Using the tokens to vote for the full seven days of the counting phase leads to 100% of the possible votes being attributed.
- Holding the tokens for only six consecutive days out of a total of seven days accumulates only around 85.7% (6/7) of the maximum possible votes.
- By starting to vote after the counting phase has already begun (for example, on day two out of seven days total) and then keep voting for that opinion, the voter gains around 71.4% (5/7) of the possible votes added through their allocated tokens.
- Starting the vote at the beginning of the counting phase with a vote for option A, holding this option for three days but then changing to option B and holding it for the remaining four days results in the following outcome:
- 100 SMR are allocated for three days to option A, which means that around 42.8% (3/7) of the users' maximum achievable votes are counted for option A.
- Changing the vote for the remaining four days to option B results in the remaining 57.2% (5/7) of the users' available votes being counted towards option B.
This solution ensures that voters always have control over their tokens. The tokens never leave the user’s wallet and are never locked or unusable, and owners can remove, send, revoke, or change their opinion on them at any time, even during the counting phase, following familiar Firefly staking rules.
Creating and adding new governance events
Shimmer's voting system builds upon IOTA's first governance vote in 2022, with key improvements for a fully decentralized implementation.
In contrast to the earlier voting system developed for the IOTA network, this Shimmer version does not rely on the IOTA Foundation to add governance events to the Firefly wallet. Every community member can:
- Create a governance event following the specifications for participation events
- Add this governance event to a Hornet node with the INX Participation Plugin
- Add this governance event to the Shimmer Firefly wallet by connecting Shimmer Firefly to a node that carries this event and use the “add event” function in the Governance section
- Vote on this event with SMR tokens
Community members, projects, or other ecosystem participants are free to create their own governance events and invite the Shimmer token holders to participate in such votes.
Decentralized and community-driven
To summarize: Voting in SMR is
- Free and feeless: A vote is a transaction in the Tangle without fees.
- Decentralized: No one gatekeeps the creation and implementation of governance votes.
- Secure: Just like the Shimmer ledger and every Shimmer transaction.
- Flexible: Users have complete control over their funds.
- Voluntary: No one is forced to vote.
Please update your Shimmer Firefly wallet by following the link on the Firefly website.
Four important Shimmer governance proposals need your vote!. The counting phase begins at 2pm CET tomorrow, Thursday the 23rd of March, and lasts seven days. We recommend that you hold your SMR tokens in these votes for the full seven days to gain your maximum voting power.
Links in this article
- Wiki: The Shimmer Governance Framework
- Blog post: IOTA Community Treasury Vote
- GitHub: Specifications for Participation Events
- GitHub: Shimmer Governance Participation Events
- Wiki: INX Participation Plugin
- Wiki: Governance Guide to Shimmer Firefly
- Firefly Wallet website
- Blog post: Shimmer Governance: Time to Vote