BeamX: How to set up your Beam Wallet.

Niran
Beam Africa
Published in
5 min readMay 22, 2021

The Beam CLI Wallet is a command-line interface wallet that allows you to receive beam, send beam, swap beam for other BTC, Dash, Qtum, Eth, Confidential Asset and more extensive functionalities. You can also create your own Confidential Asset on the beam CLI wallet.

This article will guide you on how to set up your own Beam CLI wallet using a step by step approach.

  1. The first step is to download the Beam CLI node here.
Download page for BeamX CLI Node (Linux user)

2. Extract the content into a location you can easily access.

Extracted Beam wallet

3. Launch your Terminal and navigate to the folder where you extracted the Beam Wallet.

Beam Wallet Directory

4. Initialize the wallet by typing beam-wallet-beamx.exe init (for Windows) ./beam-wallet-beamx init (for Linux or Mac) into the terminal.

Running this command will:

  1. Create a new wallet database in the same folder
  2. Print out your seed phrase (which you should copy and keep somewhere, just in case)
  3. Prompt you to set up a wallet password.

Once you are done, move to the next step.

Please note that I renamed the beam-node-BeamX and beam-wallet-beamx to beam-node and beam-wallet, respectively, to reduce my typing time. You can choose to leave it as it were.

5. After copying out your seed phrase in a safe and secure location (I strongly recommend offline storage), the next step is to get the owner’s key. To get the owner’s key, we enter the command

Below are some of the command you can run on the Beam CLI Wallet

  1. To generate a new wallet address, type the command below into the beam wallet terminal.
./beam-wallet get_address
A screenshot of the new wallet address generated

To get your address list

./beam-wallet address_list
A screenshot of all of the address

2. To get information about your wallet and transactions, type the command below into the beam-wallet terminal.

./beam-wallet info
A screenshot of wallet balance

./beam-wallet info — tx_history

A screenshot of the wallet balance and transaction history

3. To generate new a new wallet address, type the command below into the beam-wallet terminal.

./beam-wallet new_addr
A screenshot of a new wallet address generated

4. To change your wallet address expiration, you’ll need to get the wallet address first. To get the wallet address, use the address_list command in step one, next is to state the desired expiration time, either for the address to “never expire”, expire after “24h” or “now”. After getting the wallet address and expiration time, type in the command below into your terminal.

./beam-wallet change_address_expiration — address=<sbbs address> — expiration_time=(never|24h|now)
A screenshot of address expiration set to never, 24h, and now

5. To view transaction history, type in the command below into your wallet terminal.

./beam-wallet info — tx_history
A screenshot of the transaction history

6. To view details of a particular transaction, you need to get the transaction id using the command in no 5. then you type in the command in your beam wallet.

./beam-wallet tx_details — tx_id=<txid>
A screenshot of a transaction.

7. To receive an incoming transaction, your wallet needs to listen to your node and your node needs to be in sync with the blockchain.

To listen for an incoming transaction, type in the command below in the beam wallet terminal.

./beam-wallet listen -n 127.0.0.1:8501
The beam wallet is now connected to the node
100 Beam received

The transaction will then be received in your wallet.

8. To send beam to a wallet address, your wallet needs to connect to the node running on your system and then you state the recipient address, amount and transaction fee will be specified.

Below is a template of the command.

./beam-wallet send -n <node address and port, ex: 127.0.0.1:10000> -r <sbbs address> -a <amount (in Beams), ex: 11.3> -f <fee (in Groth) , ex: 0.2>

Where:

  • -n: states the node address
  • -r: wallet address
  • -a: amount
  • -f: transaction fee
./beam-wallet send -n 127.0.0.1:8501 -r 8NmCQLhTTk2P7XeFZrHe1SNv6q8t4o52ixxeruX7xTQMxxVzg8z84HtRySZGWJK7ASCTp9DzQJFfqY9LpfmRxEM8ds1TEzySKaipv3kToHMfpQoZvtbia5oFFi1Qgrgd1rba4SUsYAVsN -a 200 -f 0.1

The receiver will get the sent beam once it has been confirmed on the blockchain.

I hope you find this article helpful. Please drop your comment, suggestions and feedback in the comment section.

Be A Part Of Our Community.

We are a growing community of investors, students, founders, and professionals learning about Privacy, Blockchain technology, and cryptocurrencies every day.

And we want you to be a part of our community if you aren’t already. We are inviting you to join us on our social media platforms, and on Telegram too. Check out some of our official links below.

Follow us on Twitter | Join us on Telegram | See our official website:

You can also download our mobile apps to start sending and receiving cryptocurrency more securely and privately.

Downloads: Beam Android Wallet | Beam iOS Wallet | Beam Desktop Wallet

--

--