Web Wallet (Testnet) User Guide

Note

Known limitations:

  • Web Wallet is used only for Testnet.
  • Web Wallet doesn’t support old SBBS addresses for transactions, only new type of addresses.
  • The restore from seed phrase is yet to be implemented
  • Only single-use addresses are supported: once issued, the address will remain active for 12 hours.

How to install Beam Web Wallet

User can download Web wallet from Chrome Webstore

Download Web wallet

or load unpacked extension here chrome://extensions/ (to download packed extension, please, check our Github )

Chrome Extension
Download Web wallet

Creating new wallet

There are two ways of how user can create new wallet: Easy onboarding and Create a new wallet with the seed phrase verification

Easy onboarding

The easiest way. After installation and clicking on the button “Create new wallet”, a user can skip the step about verifying seed by clicking on “I will do it later”. Take a look at the following screenshots.

Creating page

For the extension view:

Creating page
Before generating seed phrase

For the extension view:

Before generating seed phrase

Attention

Seed phrase in the Beam wallet is not linked to email, phone number or any other identifier. You will need this phrase to restore your wallet when you lose or reformat your device, or want to access your funds from another device.

Generating seed phrase

For the extension view:

Generating seed phrase

On the next step user needs to enter a password for his wallet and confirm it. This password is not the same as the seed phrase. Seed phrase identifies a wallet and enables access to all the funds stored in Beam blockchain from any device. Your wallet password provides with a second security layer in case someone gains access to your computer or has stolen your wallet database file.

Creating a password

For the extension view:

Creating a password

It is important to choose a strong password. The wallet will provide some indication of password strength for your convenience. Do not count on it, however. Choose a password that is at least 8 characters long with a combination of letters, numbers, and symbols.

Creating with a strong password

The screen with the loading bar is opened. It takes a few seconds/minutes (depends on your connection) to finish the creation of the wallet.

Creating screen with loading bar

For the extension view:

Creating screen with loading bar

Once your wallet is created, the main screen will show up.

Main screen

For the extension view:

Main screen

Create a new wallet with the seed phrase verification

Once you launch the wallet for the first time, click the ‘Create new wallet’ button.

Creating page

For the extension view:

Creating page

As a part of creating a new wallet, a new seed phrase will be generated for you.

Attention

Seed phrase is the most important secret you have to keep. Knowing the seed phrase enables you (or anyone else) to access all your funds.

Before generating seed phrase

For the extension view:

Before generating seed phrase

Attention

Did you wrote down your seed phrase correctly? Triple-check your handwriting again. The difference between _F_unnel and _T_unnel can be crucial when trying to restore a wallet with valuable funds in the far or near future.

Did you verified your handwriting? Now go find a safe space for the paper!

Generating seed phrase

For the extension view:

Generating seed phrase

Important

Storing the seed phrase on your computer makes your funds prone to cyber attacks (read: much less secure). ‘Creative’ approaches like saving a screenshot of the wallet or your handwriting on your computer or in the cloud may sound like a good idea, but it is absolutely not recommended. If hackers get the access to your computer, network drive etc., they can can potentially steal your seed phrase by using OCR programs (which can scan pictures and transform them into plain text) and, therefore, get access to your funds.

Generating seed phrase

For the extension view:

Generating seed phrase

Always store your seed phrase in a safe and secure location (and better more than one in different geo locations). Write it on a piece of paper. Do not store electronically neither as plain text nor in any other form!

In order to ensure that you have really written down your seed phrase, you will be asked to fill in the specific words from your seed phrase in random order. Only when you typed all the selected words correctly, you will be allowed to proceed to the next step.

Generating seed phrase

For the extension view:

Generating seed phrase

Creating a password is the next step, which was described in Easy onboarding part. When the password was filled in, press the ‘Start using your wallet’ button

Once your wallet is created, the main screen will show up without popup with the seed phrase verification.

Generating seed phrase

For the extension view:

Generating seed phrase

Seed verification

Attention

You can close the popup until your balance will not exceed 100 beams. When your balance exceeds 100 beams the popup becomes to be unclosing. It will be closed only after the seed verification

If you decide to use an easy onboarding feature you need to verify your seed phrase later to be able to restore your wallet on other devices later. You can several options to do it:

1. Through popup Secure your seed

Attention

The seed phrase is for your eyes only! Make sure no one is looking over your shoulder. For the best security always generate it on a clean air-gapped machine.

Press on the “Secure your phrase” button to start verification.

Seed verification through the popup

For the extension view:

Seed verification through the popup

The wallet will ask your password to be sure that you are the owner.

The seed verification popup require the password

For the extension view:

The seed verification popup require the password

After that you will be able to verify your seed phrase in a regular way.

Seed verification

For the extension view:

Seed verification

Attention

The seed phrase is for your eyes only! Make sure no one is looking over your shoulder. For the best security always generate it on a clean air-gapped machine.

Read carefully information on the popup and confirm it.

Seed verification confirmation

For the extension view:

Seed verification confirmation

On the next screen enter six required words to finish seed verification

Confirm seed verification with six words

For the extension view:

Confirm seed verification with six words

After successful verification popup is closed and never shown again

Main screen without seed verification popup

For the extension view:

Main screen without seed verification popup

2. Through Settings

To initiate verification in another way, open the Settings by action menu

Choose settings in action menu

For the extension view:

Choose settings in action menu

In the Settings menu choose Privacy submenu and then choose Complete seed verification.

Choose seed verification in settings

For the extension view:

Choose seed verification in settings

The Wallet will ask your password to be sure that you are the owner.

Seed verification confirmation

For the extension view:

Seed verification confirmation

After that you will be able to verify your seed phrase in a regular way.

On the next screen enter six required words to finish seed verification

Confirm seed verification with six words

For the extension view:

Confirm seed verification with six words

After successful verification popup is closed and never shown again

Main screen without seed verification popup

For the extension view:

Main screen without seed verification popup

Restoring the Web Wallet

Restore is not supported in the Beta version.

Main screen

The main screen of the wallet shows the current balance in the Amount status field as well as the transaction history and statuses. There are several transactions tabs All, In progress, Sent, Receive. On the left, under wallet status, there is a toolbar that provides navigation between two wallet screens - Main Screen and UTXO Screen. In the right top corner there is an action menu which includes some functions: Security Mode, Payment proof, Where to buy beam, Settings and Logout. All of these functions will be explored below. Under the action menu there are two buttons Send and Receive which lead to according screens.

Main screen elements

For the extension view:

Main screen elements

In the right top corner there is an action menu which includes some functions: Security Mode, Payment proof, Where to buy beam, Settings and Logout. All of these functions will be explained below.

Receiving funds

Here is how the process of receiving BEAM looks like from a Receiver’s perspective:

  • Generate an address
  • Send your address to the Sender person over a secure communication channel
  • Both Sender and Receiver’s Wallet must be online at the same time to complete a transaction.

It’s possible to reuse an address that already exists, more on that later.

Generate an address

Proceed to the main screen and click the blue ‘Receive’ button at the top right corner. This will open the receive screen.

Go to receiver screen

For the extension view:

Go to receiver screen

Copy and paste the newly generated Beam address to send to Sender over a secure communication channel. There are three ways to do it:

  • By selecting the address and clicking Command-C or Ctrl-C (depending on your platform)
  • By right-click on the address and choosing ‘Copy’ from the drop-down menu
  • By clicking the ‘Copy transaction address’ button
A receiver screen

For the extension view:

A receiver screen

Each time the Receive Beam dialog is open, a new Beam address is generated. By default, the address is valid for 24 hours. If you want make the address active, you should close Receive screen. You can do it by clicking on ‘Close’ button or ‘Copy transaction address’.

Sending funds

Here is how the process of sending BEAM looks like from a Sender’s perspective:

  • Receive the address the funds should be sent to
  • Send BEAM to Receiver
  • Stay online until Receiver confirms the transaction

Attention

Make sure that the address is received untampered by using a secure communication channel.

Attention

When copying the address to the Beam Wallet app please verify visually that the address in the wallet looks exactly like the address in the secure messaging app, because viruses and malware on your computer may change your address while it’s in the clipboard.

In order to send BEAM, you will need to click the magenta ‘Send’ button at the top right corner. This will open the Send screen. Make sure you have the correct address and paste the Receiver’s Beam address in the ‘Send To’ field.

To help to identify the transaction, you may also choose to fill in the optional Comment field. The comment will remind you what or who the transaction is for. The comment is stored locally, thus it will only be visible in your wallet for bookkeeping purposes.

Go to Sender screen

For the extension view:

Go to Sender screen

The comment is also displayed in the extended transaction view on Main Screen:

Select the transaction amount in BEAM you want to send. Transaction amount is in BEAM and may contain fractional values such as 1.25 BEAM or 11.3 BEAM and the like. Keep in mind you also have to pay a transaction fee, hence the amount to send plus the fee must be equal to or less than the available balance. Transaction fees are specified in GROTH (100 millionths of BEAM).The minimum fee is 100 GROTH, it’s set by default but the higher transaction fee will help miners to prioritize your transaction.

You can see the remaining amount of BEAM in your wallet and the change that will be received after the transaction.

After you click ‘Send’ you will see a confirmation transaction details popup with the most important transaction details:

Sender screen

For the extension view:

Sender screen

It also can require the password if this function was turned on in the settings.

Completing the transaction

Once you confirm, the transaction is sent to the Receiver’s wallet. If Receiver’s wallet is currently offline or if the network is loaded, you might see the transaction appear ‘Waiting for receiver’ accordingly on your transaction list. Once the transaction is starting, it will be sent to the nodes and shown as ‘sending’.

Go to Sender screen
Go to Sender screen

While a transaction is in ‘Waiting for receiver’ you can cancel it by clicking on the dropdown to the right of the transaction row and then select ‘Cancel’. The other party will receive notification that the transaction was either ‘Cancelled’ or ‘Expired,’ and funds plus fee that were allocated for this transaction will become available again. It is not possible to cancel a transaction in ‘In progress’ or ‘Sent’ states. If your transaction appears as ‘Waiting for receiver’ for a long time, it means the Receiver is not online.

Attention

If the transaction was not sent to the nodes, for any reason, it will expire after 720 blocks, or roughly 12 hours. This is done to avoid a situation in which UTXO is locked forever.

Beams from Faucet

For best understanding how the wallet is worked you can receive some amount from Beam Community Faucet.

  1. First of all, copy an address from the Receiver screen (read Receiving funds for more information)
Go to receiver screen

For the extension view:

Go to receiver screen
A receiver screen

For the extension view:

A receiver screen
  1. Then on the main screen press on get coins button from the popup. It should link you to the Beam Community Faucet
Go to Faucet

For the extension view:

Go to Faucet
  1. On this website enter your address below to get some free beams for testing to appropriate field, do a captcha and press on ‘Get beams’ button
Beam Community Faucet
  1. When the transaction is approved on Beam Community Faucet you need to return to the Wallet. The transaction with a small amount should have receiving status (or received).
Receiving from Faucet

For the extension view:

Receiving from Faucet
Received from Faucet

UTXO screen

UTXO (Unspent Transaction (TX) Output) is like a banknote of a specific amount. Simply said, if BEAM is the currency, any UTXO can be considered a ‘bill’. You can have multiple ‘bills’ in your wallet at the same time. On the technical level, in Beam, like in most other cryptocurrencies, your balance emerges as a result of multiple incoming and outgoing transactions. Each transaction uses some existing inputs and creates new outputs. All the outputs controlled by the wallet are shown in the UTXO screen. There are several transaction tabs Available, In progress, Spent, Unavailable which include UTXO with appropriate statuses. The type of UTXO can be:

  • Regular - UTXO received as a result of a transaction. It is immediately available for spending
  • Change - UTXO received as a result of change from a transaction. It is immediately available for spending

In the following screenshots you can see how this screen is displayed.If you push to a certain UTXO you see details. This function is available only for full screen view. Also, in this screenshot, transactions are finished and have status available.

UTXO Screen

For extension view this screen look like that:

UTXO Screen

For the next screenshot there is an example for the ‘in progress’ transaction

UTXO Screen with the 'in progress' transaction

For extension view this screen look like that:

UTXO Screen with the 'in progress' transaction

Security mode

If you want you may hide from over eyes all values that you have in the wallet. Just activate ‘Security mode’ from the action menu. Look to the following screenshots:

Security mode in action menu

On the main screen amounts and balance aren’t shown.

Security mode for Main screen

For incoming/outgoing UTXO information also has been hided.

Security mode for the 'in progress' transaction

The main screen for extension view in security mode:

Security mode for main screen in extension view

In Security mode for the UTXO screen you can’t see your UTXO list.

Security mode for UTXO screen

The same in the extension view:

Security mode for UTXO screen in extension view

Where to buy Beam?

If you want to buy some beams use only exchanges from our website beam.mw.

Exchanges

In the Web Wallet there is a link to that page, it will redirect you from Wallet to website beam.mw. Just press on the action menu and choose Where to buy Beam.

Link where to buy link in the web wallet

Same steps in the extension view:

Link where to buy link in the web wallet for extension view

Proof of transaction

Receiver wallet automatically signs proof of received transaction and sends it to the sender. Proof of transaction will be added to the outcoming transaction that was successfully completed (transaction’s status is ‘sent’). Proof of transaction is not available for transaction with different status (‘expired’, ‘failed’, ‘completed’, ‘received’). Upon request, sender can observe proof of transaction following the procedure below:

  1. Click outcoming transaction from the list of transactions:
Transactioms details
  1. Click ‘Details’ button under Payment proof:
Payment proof popup
  1. Send payment proof code to the receiver. Copy it by clicking ‘Copy code’ button at ‘Payment proof’ form, or ‘Copy’ button in transactions details:
Copy payment proof code

Payment proof code:

80d07841d031b14ccdb9c56d182b4d1babee264e338bfdabb0b1e9df303bbfe9988057c7d160ddb896c566e67975e93e31b25e114fcc0ebbd2218e9738bae22970770400c2eb0b39d353baa1db2c6ef5b005dea976df47c3ba626f33243eb7ed83246d032b447026c81c9874edb83382c94bf7eb68f870eb863657a6548ecdc2fff172b8de1108017fa94e6e6e574200c2e268ebe7016fa40838ec274e08982e47df7a0be27f6c90
  1. Receiver can verify that proof is correct by clicking to active menu and choosing ‘Payment proof’ from the list:
Payment proof in action menu
Payment proof verification
  1. And pasting payment proof code into the form:
Payment proof verification with code

Logout

When you’ve finished work with your wallet, you should logout from it to secure your beams. There are two options:

  1. Close the tab with wallet in your browser (extension view will close if you tap to the place beyond the wallet).
  2. Open action menu and choose Logout.
Logout in action menu

For the extension view:

Logout in action menu

After logout you will see the starting screen with the login field.

The login screen

For the extension view:

The login screen

Settings screen

To get to the Settings screen you should use the Settings button from the action menu.

Settings in action menu

For the extension view:

Settings in action menu

The settings screen includes 5 submenu: General, Privacy, Utilities, Report a problem and Remove current wallet.

Settings submenus

For the extension view:

Settings submenus

General

This submenu includes only one point: Clear local wallet data. It allows users to clear information about transactions and session logs.

General submenu

For the extension view:

General submenu

Privacy

The privacy submenu allows users to manipulate with some password features. First, you can use a switcher to set up a confirmation of password for every sending transaction. If the switcher is active (has a green color) the password will be required. When the switcher is grey out the confirmation window won’t be required.

Privacy submenu

For the extension view:

Privacy submenu

Second, you can change the password. You can change your password using this button, which leads to change password popup. Remember, that password cannot be the same as old. Enter all fields with correct data and press the ‘change password’ button to finish this action.

Change wallet password

Utilities

From Utilities submenu users can get into payment proof or get some test coins from Beam Community Faucet. The “Get beams from the community Faucet” button opens Beam Community Faucet. Do the same steps which was described in Beams from Faucet replacing the second step to this manipulation. The “Payment proof” button opens payment proof popup, which allows users to verify transactions. All steps how to do verification are described into Proof of transaction section

Utilities submenu

For the extension view:

Utilities submenu

Report a problem

If you’ve got any troubles with the Web Wallet you need to contact support and provide them session logs through Report a problem submenu. Press on Report a problem submenu, it will open Report a problem popup. Just accurately read all information and press on the “save wallet logs” button. When the file with logs will be downloaded, send it to Beam Support.

Report a problem submenu

For the extension view:

Report a problem submenu

Remove current wallet

This submenu allows you to erase the current wallet from the database. Press on the submenu to start this procedure.

Warning

Read carefully all information on this popup: All data will be erased. Make sure you’ve saved your seed phrase if you want to restore this wallet later on!

Choose Remove if you are sure to erase the wallet. It will require the password. Enter the password to confirm this action.

Report a problem submenu

For the extension view:

Report a problem submenu

After removing this wallet the creating screen is shown

Creating page