Customer Voting Module
Structured Governance for Real Decisions
The Customer Voting Module is Vora's foundational capability and the core expression of its customer governance philosophy. It provides organizations with a complete governance infrastructure for involving customers in real business decisions --- not casual polls or non-binding surveys, but structured, blockchain-verified voting processes with defined lifecycles, configurable strategies, and auditable outcomes.
Design Principles
The Customer Voting Module is designed around three principles that distinguish it from every existing feedback and polling tool:
1. Decisions, not opinions. Vora proposals are designed for decisions that the organization intends to act on. The proposal lifecycle includes an "Executed" stage, signaling that the outcome of the vote was implemented. This creates a governance contract between the brand and its community: votes have consequences.
2. Verification, not trust. Every vote cast through Vora is recorded on the blockchain. The organization cannot alter vote counts, selectively disclose results, or claim outcomes that differ from what was actually voted. The community can independently verify every governance action through public block explorers.
3. Strategy, not simplicity. Different decisions require different voting mechanisms. A binary product decision (Option A or Option B) requires a different governance approach than a multi-stakeholder resource allocation or a community priority ranking. Vora provides seven distinct voting strategies, each designed for specific governance contexts, enabling organizations to match their governance mechanism to their governance need.
Proposal Lifecycle
Every governance proposal in Vora follows a structured lifecycle with defined stages:
Draft
The proposal is created and configured but not yet visible to voters. During the Draft stage, the governance designer --- typically a brand administrator --- defines:
The proposal question and description
Available voting options
The voting strategy to be applied
Ending conditions (time-based, vote-count-based, or voting-power-based)
Voter eligibility (whitelist, public, or badge-earner mode)
Notification settings
The Draft stage enables careful governance design before any votes are cast, ensuring that proposals are well-structured and clearly communicated.
Active
The proposal is published and open for voting. During the Active stage:
Eligible voters can cast votes according to the selected voting strategy
Real-time analytics update continuously as votes are received
Votes are immutably recorded --- once cast, a vote cannot be changed or withdrawn
The governance designer can monitor participation rates, consensus metrics, and engagement patterns
Voter notifications (SMS, email) are sent according to configuration
The immutability of cast votes is a deliberate design decision. In governance systems, the ability to change or withdraw a vote after casting introduces manipulation vectors and undermines the integrity of the process. Vora's position is that a vote, once cast, is a governance commitment.
Closed
The proposal has reached its ending condition and is no longer accepting votes. The ending condition can be triggered in three ways:
Voting Duration: The proposal closes after a predetermined time period elapses (e.g., 7 days, 14 days, 30 days). This is the most common mode for community governance decisions where broad participation is desired.
Number of Votes: The proposal closes after a specified number of votes have been cast (e.g., after 500 votes). This mode is useful when the governance designer needs a specific sample size before acting on results.
Total Voting Power: The proposal closes after the cumulative voting power of all votes reaches a threshold. This mode is relevant when using weighted voting strategies (e.g., Tenure-Based, Engagement Score-Based) where the governance significance of each vote varies.
When a proposal closes, its results are certified on-chain, creating an immutable record of the governance outcome that can be independently verified.
Executed
The organization has implemented the decision indicated by the vote outcome. Moving a proposal to "Executed" is a governance commitment signal --- it demonstrates to the community that the governance process produced a real-world action. Over time, an organization's ratio of closed-to-executed proposals becomes a visible metric of governance integrity.
Cancelled
The proposal was withdrawn before or during voting. Cancellation creates a transparent record: it is visible that the proposal existed and was cancelled, preserving governance history rather than allowing silent deletion.
Voting Strategies
Vora offers seven configurable voting strategies, each designed for specific governance contexts. The selection of voting strategy is one of the most consequential governance design decisions, and Vora provides the breadth necessary for organizations to match strategy to context.
One Person One Vote
The simplest and most intuitive strategy. Each eligible voter casts exactly one vote for one option. This strategy embodies radical democratic equality: regardless of tenure, spending history, or engagement level, every participant has exactly one vote.
Best suited for: Binary decisions, community-wide policies, decisions where equal representation is paramount.
Governance properties: Maximum equality, simple to understand, resistant to concentration of influence. Does not account for intensity of preference or depth of knowledge.
Multiple Vote (Passion)
Each voter receives a fixed allocation of votes that they can distribute across options. A voter who feels strongly about one option can concentrate their votes; a voter with distributed preferences can spread them. This strategy captures not just preference direction but preference intensity.
Best suited for: Prioritization exercises, feature ranking, decisions where understanding the intensity of community sentiment is as important as understanding its direction.
Governance properties: Reveals preference intensity, produces richer signal than one-person-one-vote, enables the Passion Index analytics capability.
Group-Based Power
Voting power is determined by the voter's membership in defined groups. Different groups receive different voting weights, allowing the governance designer to structure decision influence according to stakeholder categories.
Best suited for: Multi-stakeholder decisions where different constituencies have different levels of relevant expertise or stake. For example, a product design decision where frequent purchasers receive higher voting weight than occasional browsers.
Governance properties: Reflects differentiated stakeholder interests, enables structured representation, requires careful group definition to avoid perceived unfairness.
Tenure / Seniority Based
Voting power scales with the duration of the voter's relationship with the governance space. Long-standing community members receive higher voting weight than recent joiners. The specific weighting function is configurable by the governance designer.
Best suited for: Communities where institutional knowledge and long-term commitment should carry additional weight. Prevents new-member flooding attacks and ensures that governance reflects the perspectives of the community's most invested participants.
Governance properties: Rewards sustained participation, resistant to short-term manipulation through mass onboarding, may create barriers for new but valuable community members (mitigated by combining with other strategies).
Engagement Score Based
Voting power is derived from the voter's engagement score within the governance space. Engagement scores reflect the breadth and depth of a participant's governance activity --- voting frequency, challenge participation, badge achievements. The more actively a community member participates in governance, the more governance weight they earn.
Best suited for: Meritocratic governance models where influence should reflect demonstrated commitment. Creates a virtuous cycle where governance participation is rewarded with increased governance power.
Governance properties: Strongly incentivizes participation, creates meritocratic governance hierarchies, requires careful calibration to prevent runaway concentration of influence among early adopters.
Role-Based Tiers
Voting power is assigned based on defined roles within the governance space. Governance designers create custom roles (e.g., "Founding Member," "Verified Purchaser," "Ambassador") and assign voting weights to each role. Participants are assigned roles based on criteria defined by the governance designer.
Best suited for: Complex organizational governance where different roles carry different levels of responsibility and expertise. Enables formal governance structures similar to representative democracy models.
Governance properties: Highly structured, enables complex governance architectures, requires active role management by governance administrators.
Quadratic Voting (Anti-Whale)
Quadratic voting is an advanced voting mechanism, first formally described by Weyl (2017), in which the cost of additional votes on a single option increases quadratically. A voter's first vote on an option costs 1 unit, the second costs 4, the third costs 9, and so on. This mechanism mathematically prevents any single voter from dominating outcomes, regardless of their voting power allocation.
Best suited for: Governance contexts where preventing concentration of influence is critical. Particularly valuable for communities with significant power asymmetries (e.g., a mix of casual participants and high-engagement power users) where standard voting strategies might produce plutocratic outcomes.
Governance properties: Mathematically optimal for reflecting aggregate community preference with protection against influence concentration (Lalley & Weyl, 2018). More complex to explain to participants but produces governance outcomes that more accurately reflect the breadth of community sentiment.
Proposal-Level Override
In addition to setting a default voting strategy at the governance space level, Vora allows governance designers to override the strategy on a per-proposal basis. This provides maximum flexibility: an organization might use One Person One Vote as its default but switch to Quadratic Voting for a high-stakes community decision, or employ Passion Voting for a feature prioritization exercise.
Voter Access Modes
Vora provides three modes for controlling who is eligible to vote on a given proposal:
Whitelist Only
Only pre-approved addresses (imported via CSV, API, or manual entry) can vote. This mode is used for closed governance processes where the voting population is predetermined --- for example, verified purchasers of a specific product, members of a specific community tier, or participants in a specific program.
Public Voting
Any authenticated user can vote. This mode is used for open governance processes where the organization wants to maximize participation breadth. Public voting is suitable for brand-level decisions where all community members should have a voice.
Badge Earner
Only users who hold a specific NFT-backed badge (or badges) can vote. This mode creates a meritocratic governance gate: only participants who have demonstrated sufficient governance engagement to earn a badge can participate in specific decisions. This is a powerful mechanism for creating tiered governance, where the most consequential decisions are reserved for the most engaged community members.
Voter Notifications
Vora supports customizable voter notification through two channels:
Email notifications: Configured per proposal with custom messaging to inform eligible voters about new proposals, remind them of approaching deadlines, and notify them of outcomes.
SMS notifications: For organizations that require higher-urgency communication, SMS notifications ensure that governance invitations reach participants even when email is insufficient.
Notifications are fully customizable by the governance designer, enabling brand-consistent communication throughout the governance process.
Analytics Capabilities
The Customer Voting Module provides real-time analytics that transform raw governance data into decision intelligence:
Core Governance Metrics
Total Proposals: Cumulative count of all governance proposals across the space
Active Proposals: Currently open proposals accepting votes
Total Votes: Cumulative vote count, providing a measure of overall governance activity
Unique Voters: Distinct participants, indicating the breadth of governance engagement
Participation Rate: The ratio of actual voters to eligible voters, measuring governance reach
Governance Level Segmentation
Participants are automatically segmented into four governance levels based on their activity:
Platinum
Top 10%
The most active governance participants
Gold
10-25%
Highly engaged participants
Silver
25-50%
Moderately engaged participants
Bronze
Bottom 50%
Occasional participants
This segmentation enables governance designers to understand the distribution of engagement within their communities and to design strategies (notifications, badge incentives, targeted proposals) that move participants up the governance hierarchy.
Shannon Entropy Analysis
Vora applies Shannon Entropy --- a measure from information theory (Shannon, 1948) --- to voting outcomes to assess the degree of consensus or polarization within the community. Shannon Entropy quantifies the amount of uncertainty or disorder in a probability distribution. Applied to governance:
Low entropy indicates strong consensus: votes are concentrated on one or few options, suggesting the community has a clear collective preference.
High entropy indicates dispersed opinion: votes are spread relatively evenly across options, suggesting the community is divided or uncertain.
This metric provides governance designers with a scientifically rigorous alternative to simple majority percentages. A proposal that passes with 51% of the vote in a two-option decision has a very different governance quality than one that passes with 85%. Shannon Entropy captures this distinction quantitatively.
Passion Index
For proposals using the Multiple Vote (Passion) strategy, the Passion Index measures how voters distribute their vote allocations. A high Passion Index indicates that voters concentrated their votes on specific options, suggesting strong, differentiated preferences. A low Passion Index indicates distributed voting, suggesting diffuse or undifferentiated preferences.
The Passion Index provides a measure of conviction depth that is unavailable in single-vote governance systems.
Blockchain Verification
Every vote cast through the Customer Voting Module is recorded on the blockchain according to the organization's plan tier:
Starter: Individual vote transactions on Base Mainnet
Growth/Pro: Merkle tree aggregated batches (up to 50 votes per transaction) on Base Mainnet
Enterprise: Merkle tree aggregated batches on Ethereum Mainnet
When a proposal closes, its results are certified on-chain through the VoteAuditLog smart contract, creating an immutable, publicly verifiable record of the governance outcome. This on-chain certification is the mechanism through which Vora delivers on its core promise: if you can verify a vote happened, it happened. If you cannot, it did not.
Detailed blockchain architecture is described in the Blockchain Transparency Layer section.
Last updated