Skip to content

Ticket Splitting


Ticket splitting is the process of splitting the cost of a full ticket with other BITUM holders. This allows you to stake and participate in Bitum’s governance even if you don’t have enough BITUM to purchase a full ticket. The minimum amount of BITUM that can be put into a split ticket is 5 BITUM.

This page will provide you a high-level description of how ticket splitting works, instructions on setting up the necessary Split Ticket Buyer software and splitting your first ticket.

If you prefer video, try this tutorial.

Warning

Ticket Splitting is still in Beta. The code for splitting tickets has not been extensively vetted by automated tests and more experienced community members. See risks in joining the beta for further explanation of the risks.


Requirements

  • Bitum wallet: You will need Bitum to run the Split Ticket Buyer.
  • 5 BITUM: A minimum of 5 BITUM (plus transaction fees) is required to participate in ticket splitting. This must be in your Bitum wallet, not on an exchange.
  • Split Ticket Buyer: This is the software that coordinates ticket splitting with other participants

How it works

BITUM holders wishing to split a ticket join a “session” with other participants. Sessions can be public or private. There is typically at least one public session going at all times. Participants in a session pledge an amount of BITUM they are willing to spend, and when the total amount pledged by all participants reaches the ticket price, a ticket is automatically purchased.

Coordination of sessions is currently done on Bitum’s Slack group in the #ticket_splitting channel, or in the Telegram group located here.

Voting

Consensus Rule Voting

Voting rights for consensus rule voting are assigned pseudorandomly to a single participant, based on the percentage of their contribution. I.e., if someone purchases 60% of a split ticket, they have a 60% chance of being selected as the voter for that ticket.

Politeia Voting

Rights for voting on Politeia proposals are granted to the biggest contributor of a split-ticket. The biggest contributor can vote on proposals in Bitum or via the CLI using politeiavoter, exactly as if they had purchased a whole ticket.


Setting up Ticket Splitting

These instructions will walk you through buying a ticket using the GUI version of Split Ticket Buyer. For instructions on installing the Command-line Interface (CLI) version.

  1. Create an account with a Voting Service Provider (VSP) that supports ticket splitting. Below is a list of VSPs that support ticket splitting.

  2. Login to your VSP and navigate to the Settings tab. Copy the API token.

    VSP Settings page

  3. Open your Bitum wallet. Navigate to the Tickets tab, select your VSP from the Stakepool dropdown menu, and paste in your VSP API key. If you already have another VSP configured, add the new VSP as you would any other VSP.

    Ticket tab Bitum

  4. Enter your wallet passphrase. You should now see your configured stakepool.

    Configured Bitum Stakepool

  5. Run the splitticketbuyergui executable. This will open the Split Ticket Buyer GUI (shown below).

    Split Ticket Buyer config menu

  6. Click Config -> Load from bitum and select your wallet name and VSP from the drop-down menus.

    Split Ticket Buyer config menu

  7. Enter the amount of BITUM you wish to put into your split ticket. Currently, only integer numbers are supported in the GUI version of Split Ticket Buyer. In the CLI version you can purchase arbitrary amounts. The minimum amount of BITUM you can contribute is 5 BITUM. Transaction fees will be automatically calculated by the Split Ticket Buyer and added to your pledged amount when the ticket is purchased. Transaction fees will vary based on the number of participants in the split ticket. A typical transaction fee might be 0.003 BITUM. If you have more than 0.1 BITUM in your wallet for fees, that should be more than enough.

    Split Ticket Buyer config menu

  8. Enter the name of the ticket buying session you want to join and your wallet passphrase. Then click Participate to join the session. In the screenshot below, we’re joining a public session, bitumvoting1. You can also create private sessions with other participants. All that is required to create a private session is for all participants to use the same session name.

    Split Ticket Buyer config menu

    After successfully joining a session, you will see the number of other participants and the total amount of BITUM currently in the pool.

    Split Ticket Buyer config menu

    You are now in the ticket splitting pool! Until the ticket price is reached, no BITUM is spent. Participants are free to change the amount pledged, change wallets, or leave the pool altogether.

  9. Wait for the amount of pledged BITUM to reach the ticket price. While the time this takes can vary, public sessions are fairly active and often reach the ticket price in about a day.

    Once the amount in the pool reaches the current ticket price, all participating wallets will automatically buy their portion of the ticket.

    Split Ticket Buyer config menu

  10. You can now close Split Ticket Buyer and Bitum. Your VSP should email you a confirmation once your split ticket has been purchased, as well a notification email when your ticket was called to vote. Voting rewards are split according to the percentage of the split ticket each participant bought, and sent to the wallet used to purchase the split ticket.


Troubleshooting

When loading your wallet and VSP configuration details into Split Ticket Buyer (Step #7), some users may see the following error:

Split Ticket Buyer config error

In this case, you may need to manually update a parameter value in the splitticketbuyer.conf file. See the video tutorial for a step-by-step walkthrough of fixing this error.


General help

General technical support is often available in the #ticket_splitting channel on Bitum’s group.