Introduction

VoteBox is a decentralized opinion market platform built on the TON blockchain. It allows users to stake TON tokens on their preferred choices in voting boxes, creating a dynamic market where winners share rewards from losing choices.

Key features include:

  • Time-weighted voting - Vote early for maximum impact
  • Dynamic equilibrium - Automatic balancing promotes fair competition
  • Proportional rewards - Winners share the prize pool based on their stake
  • Proof-of-vote tokens - Jettons representing your vote
  • Blockchain security - Funds secured by smart contracts on TON

Security Note: All funds are controlled by immutable smart contracts on the TON blockchain. No person or entity can access, freeze, or confiscate your tokens.

Getting Started

To start using VoteBox, you'll need:

  1. A TON wallet - Any compatible TON wallet (Tonkeeper, MyTonWallet, etc.)
  2. TON tokens - Some TON for voting and gas fees
  3. Access to VoteBox - Via the web interface or Telegram Mini App

Wallet Setup

If you don't have a TON wallet yet:

  • Download Tonkeeper or another TON wallet from official sources
  • Create a new wallet and securely store your seed phrase
  • Purchase TON tokens through the wallet's built-in exchange or transfer from an exchange

Accessing the Platform

Once you have a wallet with TON tokens, you can access VoteBox through:

The platform will prompt you to connect your wallet when you first access it.

How to Vote

Participating in a voting box is straightforward:

  1. Browse voting boxes - Find a topic that interests you
  2. Review the options - Read all available choices carefully
  3. Choose your option - Select the choice you believe will win
  4. Decide your stake - Enter how much TON you want to invest (between the minimum and maximum limits)
  5. Submit your vote - Confirm the transaction in your wallet
  6. Receive vote tokens - You'll get jetton tokens as proof of your vote
  7. Wait for results - The voting period will end at the specified time
  8. Claim rewards - If you voted for winning option you get rewards based on your stake

Important: Once you vote, your stake is locked until the voting period ends. You cannot withdraw or change your vote after submitting.

You can vote on multiple options in the same box if you want to hedge your position, but only the option with the most total votes will be declared the winner.

Dynamic Voting Mechanics

What is Vote Power?

Vote Power determines how many votes you receive for each 1 TON you stake. It's a multiplier that can range from as low as 0.1× to as high as 3× or more, depending on when you vote and which option you choose.

For example:

  • High vote power (2.5×): Staking 10 TON gives you 25 votes
  • Medium vote power (1.0×): Staking 10 TON gives you 10 votes
  • Low vote power (0.5×): Staking 10 TON gives you 5 votes

More votes mean a larger share of the winning pool if your option wins. The winning option is determined by total vote count, not by total TON staked.

Vote Power Formula

VoteBox uses a sophisticated voting power system that combines two factors: time decay and equilibrium adjustments. Your final voting power is calculated as:

Vote Power = Time Decay × Equilibrium

Both factors multiply together, meaning you can maximize your voting power by optimizing either timing or option selection.

Time Decay Component

The time decay system encourages early participation while still allowing later votes:

  • Graceful Period - Initial period with 100% time-based power (default: 20% of voting duration)
  • Decay Period - After the graceful period, time-based power gradually decreases using a square root function
  • Floor Percentage - Minimum time-based power retained at the end (default: 10%)

The square root decay ensures a gradual decline rather than linear drop, giving meaningful power to votes throughout most of the voting period.

Equilibrium Component

The equilibrium system automatically balances competition between choices:

  • Leading options receive 1.0× equilibrium multiplier (no boost)
  • Underdog options receive a boost multiplier greater than 1.0×
  • Boost increases based on how far behind an option is in both stakes and vote counts
  • Natural limits prevent excessive compensation through dampening factors

This creates a self-balancing market where backing an underdog can significantly increase your voting power, even if you vote late in the period.

Strategic Voting

To maximize your vote power, consider both factors:

  • Equilibrium exploit strategy: Vote for underdog options during the graceful period (first 20% of duration)
  • Early voting: Vote during graceful period for maximum time-based power (1.0× time decay)
  • Strategic late voting: Even after graceful period, voting for an underdog can give you higher total power than voting early for the leader
  • Minimum guarantee: Even the latest vote on a leading option retains at least 10% time-based power

Pro Tip: The equilibrium boost for underdogs can be larger than the time decay penalty for voting late. This means strategic late voting on underdogs can outperform early voting on leaders!

Voting Constraints

To ensure fair play and prevent spam, VoteBox implements minimum and maximum vote amounts:

Default Limits

  • Minimum vote: 0.5 TON per vote
  • Maximum vote: 10 TON per vote

Why These Limits Exist

Minimum threshold:

  • Prevents users from flooding the system with tiny votes
  • Ensures votes cover gas and storage costs
  • Keeps the voting data manageable

Maximum threshold:

  • Prevents single large holders from dominating votes
  • Encourages broader participation
  • Maintains competitive balance

Note: You can vote multiple times on the same option to stake more than the maximum, but each individual vote transaction is subject to these limits.

Vote Tokens (Jettons)

When you vote, you receive jetton tokens as proof of your position. These are standard TON jettons with special properties.

Key Properties

  • Proof of vote: Jettons represent your stake in a specific voting option
  • Burned on claim: When you claim rewards, the jettons are permanently destroyed

Fees

Understanding the fee structure helps you calculate potential returns and transaction costs.

Platform Fee

10% of all stakes - This fee supports platform development, maintenance, and operations. A portion of this fee (20%) is shared with users who refer new participants to the platform.

Creator Fee

5% of all stakes - This fee is paid to the voting box creator regardless of which option wins. It incentivizes users to create interesting and engaging voting boxes for the community.

Gas Fees

Approximate transaction costs on the TON blockchain:

  • Voting: ~0.08 TON per successful vote transaction
  • Claiming rewards: ~0.02 TON per claim transaction
  • Creating a box: 1.5 TON (includes deployment and initialization costs)
  • Failed transactions: ~0.02 TON (e.g., voting on a closed box)

Note: Gas fees are estimates and may vary based on network congestion and transaction complexity. The TON blockchain typically has low and predictable fees.

How Rewards Work

VoteBox uses a winner-takes-all system where the option with the most votes wins, and all participants who voted for that option share the stake pool.

Winner Stake Pool Composition

The stake pool consists of:

  • Your stake on the winning option (returned to you minus platform fee)
  • All stakes from losing options (redistributed to winners proportionally)
  • Minus platform and creator fees (deducted from total)

Winner Determination

The winning option is determined by:

  1. Accumulated vote counts (not TON amounts)
  2. In case of a tie, the winning option is the one that received the first vote
  3. Winners share the losing pool proportionally based on their vote counts

Guaranteed Minimum Return

Winners are guaranteed to receive at least their net investment back (original stake minus platform and creator fees). This prevents reward dilution scenarios where too many winners would reduce individual payouts below the invested amount.

How to Claim Rewards

After the voting period ends, winners can claim their rewards through a simple process.

Claiming Process

  1. Wait for voting to end - Voting must be completely finished
  2. Grace period - A 5-minute grace period follows the end time for final processing
  3. Burn vote jettons - Claim rewards in app -s ubmit a transaction to burn your vote tokens
  4. Receive rewards - Your TON rewards are automatically sent to your wallet

Important Details

  • Winners only: Only participants who voted for the winning option receive rewards
  • Losers get nothing: If you voted on a losing option, you cannot claim any rewards
  • Jettons are burned: When you claim, your vote jettons are permanently burned
  • Gas costs: Claiming requires a small amount of TON for gas (~0.02 TON)

Tip: You can check the voting results immediately after the end time to see if your option won before claiming.

Reward Calculation

Understanding how rewards are calculated helps you make informed voting decisions.

The Reward Formula

If you voted for the winning option, your reward consists of two parts:

Your Reward = (Your Stake × 0.85) + (Total Loser Stakes × Your Vote Share × 0.85)

Where:

  • Your Stake × 0.85 - You get back 85% of what you invested (after 15% fees)
  • Your Vote Share = Your votes ÷ Total winner votes
  • Total Loser Stakes × Your Vote Share × 0.85 - Your proportional share of losing stakes (after 15% fees)
  • 15% fees = 10% platform fee + 5% creator fee

Key Points

  • Winners share loser stakes: All losing stakes are redistributed to winners based on their vote share
  • Vote share matters: Your share depends on your votes, not your TON stake (remember: higher vote power means more votes per TON)
  • Fees apply to everything: Both your stake return and your loser share are reduced by 15% fees
  • Losers get nothing: If you voted on a losing option, you receive 0 TON back

Detailed Example

Let's walk through a concrete example:

Scenario:
• You staked 100 TON on the winning option
• You received 100 votes (vote power was 1.0×)
• Total winner votes: 1,000 votes
• Total winning stake: 1,000 TON
• Total losing stakes: 2,000 TON

Calculation:
1. Your stake return: 100 TON × 0.85 = 85 TON
2. Your vote share: 100 votes ÷ 1,000 votes = 0.1 (10%)
3. Your loser share: 2,000 TON × 0.1 × 0.85 = 170 TON

Your Total Reward: 85 + 170 = 255 TON
Net Profit: 255 - 100 = 155 TON (155% return)

Remember: If you vote on a losing option, you receive nothing back. All losing stakes are redistributed to winners.

How to Create a Voting Box

Anyone can create a voting box and earn fees from the activity. Here's what you need to know:

Box Parameters

  • Question - The topic or question (up to 200 characters)
  • Choices - Between 2 and 5 voting options
  • Duration - Voting period from 3 days to 5 days
  • Visibility - Display in public app feed or not

Creation Cost

Creating a voting box costs a flat fee:

Box Creation Fee: 1.5 TON

Creator Benefits

As a box creator, you earn a creator fee of 5% of the total stake pool. This fee is paid automatically when the box ends, regardless of which option wins.

Important: Once created, a voting box cannot be edited or cancelled. Make sure all parameters are correct before submitting.

Referral Program

Earn passive income by inviting others to VoteBox. Share your unique referral link and receive rewards from all voting activity by your referrals.

How It Works

  • Get your unique referral link from the platform
  • Earn 20% of all platform fees from your referrals' votes
  • Request withdrawal once you accumulate at least 3 TON
  • No limits on referral earnings

Earnings Breakdown

Since platform fees are 10% of all stakes, you effectively earn 2% of all TON staked by your referrals (20% of 10%). This creates a passive income stream that grows with your network.

Withdrawal Process

Referral rewards accumulate in your rewards account automatically, along with any bonus rewards you've earned. Once your combined balance (referrals + bonuses) reaches the 3 TON minimum threshold, you can request a manual withdrawal through the platform interface.

Tip: Share your referral link on social media, forums, or with friends interested in prediction markets to maximize your earnings.

Bonus System

VoteBox rewards new users with TON bonuses for completing key milestones. These one-time bonuses help you get started on the platform.

Available Bonuses

  • First Vote Bonus: 1 TON - Rewarded when you cast your first vote on any voting box
  • First Box Creation Bonus: 0.5 TON - Rewarded when you create your first voting box
  • Friend Invitation Bonus: 0.5 TON - Rewarded when you successfully invite 5 friends to the platform

Rewards Account

Bonuses are automatically credited to your rewards account once you complete the required action. This is the same account that accumulates your referral earnings.

Withdrawal Requirements

Your bonus rewards and referral rewards are combined in a single balance. You can request a withdrawal once your total rewards balance (bonuses + referrals) reaches at least 3 TON.

Important Notes

  • One-time only: Each bonus can only be claimed once per account
  • Automatic crediting: Bonuses are automatically added to your rewards balance
  • Combined with referrals: Your bonus rewards and referral earnings share the same account and withdrawal threshold (3 TON minimum)

Tip: Complete all three bonuses to earn a total of 2 TON in free rewards! Combined with referral earnings, this helps you reach the 3 TON withdrawal threshold faster.

Smart Contracts & Blockchain

VoteBox runs entirely on smart contracts deployed to the TON blockchain, ensuring transparency and security.

Contract Architecture

The system uses a three-layer contract hierarchy:

  1. Box Collection - Handles voting box creation and management
  2. Individual Box - Contains voting logic and state for each voting box
  3. Vote Jetton Contracts - Manage proof-of-vote tokens for each option

Viewing on Blockchain

You can view master contract, boxes and transactions on TON blockchain explorers:

You can use these explorers to:

  • View your votes and vote jetton balances
  • Track voting box statistics in real-time
  • Verify transaction history
  • Audit reward distributions

Note: VoteBox smart contracts are proprietary and not open source. However, all transactions and contract states are publicly visible on the blockchain.