Last updated for Bitum v1.4.0.
This guide assumes you have already set up a Bitum wallet using the Bitum Setup guide.
The main menu of Bitum is displayed on the left side of the window, and it is used to switch between the different features Bitum offers. It can be minimised by clicking the arrow icon at the top. At the bottom of the menu is a button to rescan the blockchain. This button will force a rescan of all of your owned addresses to check for new transactions, which can sometimes fix issues where Bitum is displaying an incorrect balance. This process will take some time, however it will not cause Bitum to redownload the whole blockchain.
The overview tab gives a quick summary of your total BITUM (available and locked in tickets) and a list of recent transactions.
Graphs of your balance, ticket and transaction over the last two weeks can be viewed here.
The transactions tab is split into four sections:
This where you can send Bitum from your wallet to another address. First you need to select which account in your wallet to send the funds from, and then enter the recipient address into the text box. Finally enter the amount of Bitum you wish to send.
There are additional buttons here which can be used to create more advanced transactions if required. The + button will allow you to send Bitum to multiple addresses in a single transaction. The Send All button will construct a transaction that will completely drain the selected account. There is also a button which will allow you to send funds from one account in your wallet to another account in your wallet.
Once you have entered the details of your transaction, the estimated fee and transaction size are detailed below the input panels. After reviewing these numbers, you can press the Send button and your transaction will be broadcast.
This is where you can generate wallet addresses to give to other people so they can send you BITUM. The address is displayed in the blue text box - it’s the line that starts with B1, or Ts on testnet. Simply choose the account you want funds to go to and select the Generate New Address button. You can select the clipboard icon to copy the address and share it with the person sending you BITUM. Bitum addresses can be used as many times as you want, but for privacy reasons it’s best to generate a new one for each transaction. There’s around 1.4E48 (that’s 14 followed by 47 zeroes) addresses available so you don’t need to worry about running out.
This tab shows a list of all transactions that have occurred involving this wallet. A dropdown menu allows filtering the list by transaction type: regular, ticket and vote transactions. The transaction hash can be used with the block explorer to see more information about the transaction.
This tab shows allows you to export your transaction history in a .csv format. You can choose the data you wish to export, select a location to output the generated file, and then press the Export button.
The governance tab enables users holding tickets to have their say on Bitum’s governance. Here you can browse and vote upon Politeia proposals, and you can set your voting preferences for on chain consensus rule votes. Your privacy settings must allow Bitum to contact Politeia to download proposal information.
Politeia proposals can be filtered by “Under Discussion”, “Under Vote”, “Finished Voting” and “Abandoned”. The “Create Proposal” button will open on https://proposals.bitum.io in your browser.
You are able to vote on proposals if the following two criteria are met:
There are currently proposals available open for voting
You owned live proof-of-stake tickets when the proposal was opened for voting
The Consensus Changes page shows all of the agendas which are currently up for vote on the Bitum blockchain. You can read the details of each agenda and choose which way you would like to vote on each issue. This setting is only used at the moment each individual ticket votes, which means that you can change your voting preferences if you change your mind about an agenda.
The tickets tab is split into four sections:
Before you can purchase tickets you must first import the API key from your stakepool account.
Once you have done this, the “Purchase Tickets” tab becomes active.
The total number of tickets you currently own is at the top of the page:
- Mempool Tickets - Tickets waiting to be mined by PoW miners (only 20 new tickets are mined into each block)
- Immature Tickets - Mined tickets which cannot vote until a 256 block maturing period has passed (around 20 hours)
- Live Tickets - Mature tickets eligible to be called to vote
Backup redeem script¶
Now is a good time to back up your VSPs multi-sig voting script (or “redeem script”).
If your VSP goes down, you’ll need this script to vote or revoke tickets.
Click on the gear icon next to your VSP. Then click on the donut icon that appears.
This will bring up your VSP’s configuration details. Copy the string of characters in the
Script field and store them in a safe location.
In order to purchase tickets you just need to select which account to purchase tickets from, how many tickets you want to buy, and then press the Purchase button.
The “Automatic Ticket Buyer” panel allows you to enable the automated ticket buyer - Bitum will continually buy tickets for you for as long as you keep it running. You can configure how the ticket buyer works using the options:
- From - Funds to purchase tickets will come from this account
- Stake Pool - Which pool to purchase tickets with
- Balance to maintain - If your balance is lower than this number, you will not buy tickets. The default of 0 will use all the funds in your account to buy tickets
This tab shows a summary of all of the tickets your wallet has ever purchased. Filters and sorting options are available to make browsing the list easier.
This page displays various statistics about all of the available stakepools. The dropdown can be used to change the currently displayed pool.
The accounts tab shows you the accounts in your wallet and allows you to add new ones. Accounts in Bitum work just like bank accounts. They allow you to keep separate records of your BITUM. This feature is most useful for those who run businesses and wish to keep separate accounts for tax records for example. Transferring BITUM across accounts will create a transaction on the blockchain.
The Security tab offers two key features - the ability to sign and verify messages using your private key, and the ability to validate addresses.
Sign and Verify messages¶
Signing a message with an address’ private key allows you to prove that you are the owner of a given address to a possible counterparty.
For instance, let’s say you sent 100 BITUM to a merchant and you have yet to receive your merchandise. You contact the merchant and explain the situation, but need a way to prove you are, in fact, the owner of the address that the funds were sent from. To do this you can generate a signature based on a message only known to you and your counterparty and the private key associated with the address. Upon receipt, the counterparty may use the Verify Message form to ensure the signature is valid.
A Bitum address can be entered into the Validate Address text box, and Bitum will put that address into one of three categories:
- Invalid address
- Valid address owned by the current wallet
- Valid address not owned by the current wallet
The help tab contains links to get help using Bitum and to learn more about Bitum. There are also links to our various communication platforms. The Tutorials section contains introductions to the ticket lifecycle and how Bitum’s proof-of-stake system works. It is also possible to view logs of the
bitum processes in the Logs section.
The settings tab allows you to customise the units BITUM amounts are displayed in and also allows you to switch Bitum onto the testnet blockchain.
The settings tab is also where you come to change your private passphrase.