Electroneum CLI wallet guide with Remote Node method

Table of Contents

- Downloading Electroneum CLI Wallet
- Synchronizing Electroneum CLI Wallet

- Loading Wallet - Watch Mode
- Loading Wallet - Full Mode

- Viewing Your Wallet Balance
- Sending Electroneum
- Closing Electroneum CLI properly

- Opening Paper Wallet / Private Keys with Electroneum CLI
- Opening Paper Wallet / Private Keys with Mobile App or Online Wallet
- Opening Mnemonic Seed Wallet (25 words passphrase) with Electroneum CLI

- Importing Raw Blockchain to Electroneum CLI Wallet
- Repairing Electroneum CLI Corrupted Blockchain Data
- Blockchain Data Locations

- Video Guide

- Usefull Tips
- Contributors

Downloading Electroneum CLI (command line interface) Wallet

To start, visit Electroneum’s official github download page https://github.com/electroneum/electroneum/releases (Windows, Linux, and Mac versions available, this tutorial will focus on Windows users).

For Windows, download the electroneum-win-x64-v2.x.x.x.zip file.

NOTE:

  • electroneum-win-x64-v2.x.x.x.zip is a zip file and will need to be extracted, you may create a new folder on your desktop and name it electroneum-win-x64-v2.x.x.x and extract all contents in here, replace x’s with actual version of the downloaded zip.

:arrow_up: Back to Table of Contents

Synchronizing the Blockchain

--- METHOD 1: Old-Fashioned

The simplest method to start synchronizing is just to double-click on electroneumd.exe, this method is slow and can take a couple of days with the current size of the blockchain. Once electroneumd.exe completes synchronizing, go to Loading Wallet section.

--- METHOD 2: Importing raw blockchain

Guide to import Electroneum raw blockchain can be found here: Importing the Blockchain to Electroneum CLI

This is a much faster method. Raw blockchain data provided by the official Electroneum team. Note that if your PC quality is poor, it can take some hours to fully import blockchain and refresh wallet data.

--- METHOD 3: Remote Node

By connecting to a remote node you don’t have to download the Blockchain to your computer nor you have to wait for it to sync. This will connect your wallet to the network right away.

1. Press the Windows Key and the letter R simultaneously
2. In the “Run” window that comes up, delete any text in the field, type in “cmd,” and press “Ok”
3. The command line window will come up (Don’t freak out! I’ll walk you through it! Steps 3 through 10 explain how to enter Electroneum CLI wallet directory inside command prompt, also known as cmd.exe or cmd) and it will likely look something like this

C:\Users\userName>
image

where userName is the name you assigned to your computer “i.e. Alice-Laptop, Bob-PC, etc.” In steps 4-6, I will show you how to find your electroneum-wallet-cli.exe file. If you already know where your electroneum-wallet-cli.exe file is, skip to step 7.

4. In the command line, type “explorer” so that your command line looks like this:

C:\Users\userName>explorer
image

then press Enter to bring up the Windows file explorer.

5. You are now going to use the file explorer to find your electroneum-wallet-cli.exe file. On the left pane of the file explorer you will see either a picture of a computer named “This PC” or “Computer” or some other custom name above your Desktop, Downloads, Documents, and other miscellaneous folders. Click on the picture of the computer. You should see the hard drive(s) on your computer (C:, D:, Z: etc.)

image

6. Click inside the search bar at the top right corner of the file explorer window and type in: electroneum-wallet-cli.exe and press the Enter key on your keyboard. Note this may take a while to find.

image

7. Once you see the electroneum-wallet-cli.exe file in the file explorer, right click on it and select the option near the bottom of the list that says “Properties”

image

8. A new window will pop. The second section of the “General” tab should begin with the word “Location” followed by an address (ex: Location: C:\User\Bob\Desktop\Electroneum).

8a. Take note of the letter that comes first. The address may begin with C:\ or D:\ or Y:\ or X:\ etc. Write this down or remember it, you will need to type it in step 9.
8b. You are going to want to highlight the entire address that is to the right of the word location, right click on the highlighted area, and select “Copy”

9. Return to your command window, click inside the black box, and type in the same letter I told you to write down in step 8a followed by a colon. For example, your command window may look something like this:

C:\Users\userName>C:
or
C:\Users\userName>D:
or
C:\Users\userName>Y:

etc. Press the enter key and you may or may not notice a change. Either is fine, just as long as you typed in the same letter where your electroneum-wallet-cli.exe file is located.

10: Type in "cd " (with a space to the right of “cd”) and right click on the very top of the command window (not inside the black box, right click on the actual window pane), move your mouse over the word “Edit”, and select the “Paste” option. Your command window should look something like this (for this example, the ETN file is located in C:\electroneum-win-x64-v2.1.1.0:

C:>cd C:\electroneum-win-x64-v2.1.1.0

notice how there is a C:\ on both the left and right side of the “>” sign. Those two letters should be the same, otherwise you will get an error. If everything looks good, press the enter key and you will be switched to a new directory, which is the same one you typed in. Therefore, your command line will look something like this:

C:\electroneum-win-x64-v2.1.1.0>

image

11. There are two paths forward from this point. One path is for those who already have an offline paper wallet ( 11a ), the other is for those who want to create a new offline wallet ( 11b ).

11a.

Copy and paste the following into your cmd window using the same process in step 8b:
electroneum-wallet-cli.exe --daemon-address=52.138.176.219:80818 --generate-from-keys=wallet

then press enter. You will then be instructed to enter your standard address (public view key), private view key, and private spend key. All of these can be found on the paper wallet file.

11b.

Copy and paste the following into your cmd window using the same process in step 8b:
electroneum-wallet-cli.exe --daemon-address=52.138.176.219:80818

then press enter. You will then be instructed to create a new wallet or enter a name of an existing wallet that you have previously created.

NOTE:

  • 11b command can create or access wallet. If accessing previously created wallet, you will be asked for password after entering wallet name and pressing enter.

:arrow_up: Back to Table of Contents

Loading Wallet - Watch Mode

A view wallet only means that Electroneum can NOT sent out, balance and transactions are visible. Upon generating a view wallet, only Private View key is needed. In order to send out Electroneum, Private Spend and Private View key would have to be submitted and new wallet would have to be retrieved by supplying both keys.

Remote Node Method

electroneum-wallet-cli.exe --daemon-address=52.138.176.219:80818 --generate-from-view-key=wallet

Old-fashioned Method

electroneum-wallet-cli.exe --generate-from-view-key=wallet

:arrow_up: Back to Table of Contents

Loading Wallet - Full Mode

When the syncing is done, you’ll see a message that reads “You are now synchronized with the network. You may now start electroneum-wallet-cli.exe”.

IMPORTANT: Remote Node

IMPORTANT: Old-Fashinoed

  • You must have the electroneumd.exe window running in the background for wallet (electroneum-wallet-cli.exe) to function if you’ve synchronized blockchain using the Old-Fashioned method.

If you synchronized blockchain using the Old-Fashioned method, double-click on electroneum-wallet-cli.exe and follow simple instructions to create a new wallet or enter name of an already created wallet and you will be prompt to enter wallet password. If you are creating a new wallet for the first time, be sure to write down any secret keys or words given in the same order upon creating new wallet and store them somewhere safe and secure. These secret keys and words can be used to recover access to your wallet. Continue reading Viewing Your Wallet Balance after you’ve accessed your wallet.

Command below will open a wallet with private keys with Old-Fashioned method:

With Private Keys

electroneum-wallet-cli.exe  --generate-from-keys=wallet

NOTE:

  • To open your new created wallet once you have closed electroneum-wallet-cli.exe, simply open electroneum-wallet-cli.exe again and specify the name of the newly created wallet, you will then asked to enter wallet’s password.

:arrow_up: Back to Table of Contents

Viewing Your Wallet Balance

  • To view the balance of your wallet, type balance within electroneum-wallet-cli.exe window and hit enter (you might need to run the refresh command to update your wallet’s transactions since it was restored). Your balance and unlocked balance will be displayed on the screen.
  • The incoming_transfers command will show all the transactions coming into your wallet.
  • The show_transfers command will show both incoming and outgoing transfers.

:arrow_up: Back to Table of Contents

Sending Electroneum

To send Electroneum to someone else, you’ll need to use the transfer command together with a few parameters, like this:

  • transfer PRIORITY ADDRESS AMOUNT PAYMENTID

The placeholders are as follows:

  • priority indicates how urgent this transaction is. The possible options (in order of increasing urgency) are unimportant , normal , elevated , and priority . A more urgent transaction will demand a higher transaction fee, meaning that miners will move it to the front of the queue and process it before processing transactions with lower fees. As of this writing, the fees are 0.1 ETN for an unimportant transaction and 0.8 ETN for a priority transaction.

  • address is the ETN address you wish to send your funds to (typically a 98-character text string starting with etn…).

  • amount is the amount of ETN you wish to send. The fee is not included in this amount, so make sure you leave enough ETN for the fee when sending your entire balance.

  • payment_id is an optional key that works like a payment reference in a regular bank transfer. It is sometimes required when sending ETN to an exchange.

To send Electroneum, enter the command into the CLI wallet using the priority, address, amount, and payment ID you prefer. In this example, I will send 10 ETN to my address (etnkGx…) with no payment ID and with an elevated priority level:

transfer elevated etnkGx62jvB73KDgu9et9WBHqYgwxxXHkPrVVE6t4hPr83tVNGy 10

To simply send Electroneum without priority or without payment_id since these two are optional parameters in most cases:

transfer etnkGx62jvB73KDgu9et9WBHqYgwxxXHkPrVVE6t4hPr83tVNGy 10

To send Electroneum with payment_id:

transfer etnkGx62jvB73KDgu9et9WBHqYgwxxXHkPrVVE6t4hPr83tVNGy 10 d2b6047da55f2451

NOTE:

  • When sending Electroneum to an exchange, you should always use payment_id generated by your exchange!

Next, enter your wallet password. If you’re not using a payment ID, confirm the prompt about the payment ID with Y or Yes.

It then tells you the backlog of transactions at your chosen priority level. Respond with Y or Yes . Finally, it tells you the fee at your chosen priority level (in this case, mine is 0.4 ETN). Respond with Y or Yes if you agree.

Your transaction has now been sent to the blockchain, and should take a couple of minutes to process! View the transaction status by using the show_transfers command.

:arrow_up: Back to Table of Contents

Closing Electroneum CLI wallet

Unexpected closing can cause corruption on the LMDB files (blockchain synchronization data). Use steps below to properly close Electroneum CLI wallet.

  1. On electroneum-wallet-cli.exe window type save and press enter, then type exit and press enter to close electroneum-wallet-cli.exe first.
  2. On electroneumd.exe window type save and press enter, then finally type exit to close electroneumd.exe last. Electroneumd can take longer to close, if it does not close right away give it a minute or two or perhaps longer if your PC quality is poor.

:arrow_up: Back to Table of Contents

Blockchain Data Location

  • Mac: /Users/YourName/.electroneum/lmdb/data.mdb
  • Windows: C:\ProgramData\electroneum\lmdb\data.mdb
  • Linux: /home/user/.electroneum/lmdb/data.mdb

IMPORTANT:

  • Blockchain data directories may be hidden.
  • On Windows: You have to manually use the explorer to navigate to it or search Google for a guide navigating through hidden directories for Windows 7, 8 or 10.
  • On Mac OS X you can typically use cmd+shift+. to unhide directories or cd into directory via terminal (cd ~/.electroneum).
  • On Linux you can typically use ctrl+H to unhide directories or cd into directory via terminal (cd ~/.electroneum).

:arrow_up: Back to Table of Contents

Opening Paper Wallet with Electroneum CLI

:arrow_up: Back to Table of Contents

Opening Paper Wallet with Mobile App or Online Wallet

:arrow_up: Back to Table of Contents

Opening Mnemonic Seed Wallet - 25 words

:arrow_up: Back to Table of Contents

Corrupted blockchain repair guide

:arrow_up: Back to Table of Contents

Importing raw blockchain to Electroneum CLI

:arrow_up: Back to Table of Contents

Video Guide by @NorthEastTexasTech

:arrow_up: Back to Table of Contents

Usefull Tips

electroneumd status & commands

On electroneumd.exe you can type the status command to view network details, or help command will show other commands

electroneumd blockchain data directory

Default electroneumd blockchain data directory is C:\ProgramData\electroneum on Windows. It can be by passed with a new path when electroneumd.exe is launched.

Command: electroneumd.exe --data-dir “path”

Full example: electroneumd.exe --data-dir X:\ProgramData\electroneum

Linux & Mac: ./electroneumd --data-dir ~/ETNBlockchainData

:arrow_up: Back to Table of Contents

Thank you!

:arrow_up: Back to Table of Contents

21 Likes

Can you please add this to the “Syncronizing the Blockchain” section?

Remote Node

1. Press the Windows Key and the letter R simultaneously
2. In the “Run” window that comes up, delete any text in the field, type in “cmd,” and press “Ok”
3. The command line window will come up (Don’t freak out! I’ll walk you through it!) and it will likely look something like this

C:\Users\userName>

where userName is the name you assigned to your computer “i.e. Alice-Laptop, Bob-PC, etc.” In steps 4-6, I will show you how to find your electroneum-wallet-cli.exe file. If you already know where your electroneum-wallet-cli.exe file is, skip to step 7.

4. In the command line, type “explorer” so that your command line looks like this:

C:\Users\userName>explorer

then hit Enter to bring up the Windows file explorer.

5. You are now going to use the file explorer to find your electroneum-wallet-cli.exe file. On the left pane of the file explorer you will see either a picture of a computer named “This PC” or “Computer” or some other custom name above your Desktop, Downloads, Documents, and other miscellaneous folders. Click on the picture of the computer. You should see the hard drive(s) on your computer (C:, D:, Z: etc.)

6. Click inside the search bar at the top right corner of the file explorer window and type in:
electroneum-wallet-cli.exe
and press the Enter key on your keyboard. Note this may take a while to find.

7. Once you see the electroneum-wallet-cli.exe file in the file explorer, right click on it and select the option near the bottom of the list that says “Properties”

8. A new window will pop. The second section of the “General” tab should begin with the word “Location” followed by an address (ex: Location: C:\User\Bob\Desktop\Electroneum).

8a. Take note of the letter that comes first. The address may begin with C:\ or D:\ or Y:\ or X:\ etc. Write this down or remember it, you will need to type it in step 9.
8b. You are going to want to highlight the entire address that is to the right of the word location, right click on the highlighted area, and select “Copy”

9. Return to your command window, click inside the black box, and type in the same letter I told you to write down in step 8a followed by a colon. For example, your command window may look something like this:

C:\Users\userName>C:
or
C:\Users\userName>D:
or
C:\Users\userName>Y:

etc. Press the enter key and you may or may not notice a change. Either is fine, just as long as you typed in the same letter where your electroneum-wallet-cli.exe file is located.

10: Type in "cd " (with a space to the right of “cd”) and right click on the very top of the command window (not inside the black box, right click on the actual window pane), move your mouse over the word “Edit”, and select the “Paste” option. Your command window should look something like this (for this example, the ETN file is located in D:\ProgramFiles\Electroneum:

D:>cd D:\ProgramFiles\Electroneum

notice how there is a D:\ on both the left and right side of the “>” sign. Those two letters should be the same, otherwise you will get an error. If everything looks good, press the enter key and you will be switched to a new directory, which is the same one you typed in. Therefore, your command line will look something like this:

D:\ProgramFiles\Electroneum>

11. There are two paths forward from this point. One path is for those who already have an offline paper wallet (11a), the other is for those who want to create a new offline wallet (11b).

11a. Copy and paste the following into your cmd window using the same process in step 8b:

electroneum-wallet-cli.exe --generate-from-keys --daemon-host=nodes.hashvault.pro:26968

then press enter. You will then be instructed to enter your standard address (public view key), private view key, and private spend key. All of these can be found on the paper wallet file.

11b. Copy and paste the following into your cmd window using the same process in step 8b:

electroneum-wallet-cli.exe --daemon-host=nodes.hashvault.pro:26968

then press enter. You will then be instructed to create a new wallet.

10 Likes

@DividedShark Absolutely! Thank you for Remote Node instructions!

1 Like

This is great. Thank you for the instruction. They are helpful and to the point.

1 Like

Great set of instructions,

a tiny little small non important step reduction would be to use /d at the end of cd

cd D:\ProgramFiles\Electroneum /d

this will change the drive as well as the folder in 1 simple command.

1 Like

Hello! Thank you, I will review guide soon and look into adding your shortcut :heart:

1 Like

I downloader paper wallet online , how can I view the balance?

im stuck at “Starting Refresh”

Error: failed to generate new wallet: failed to save file “–daemon-host=nodes.hashvault.pro:26968”: Unknown error

1 Like

@fin , please use this command to retrieve wallet from keys. I have also updated guide up above to reflect these new changes. Thank you for letting us know!

electroneum-wallet-cli.exe --daemon-host=nodes.hashvault.pro:26968 --generate-from-keys=wallet

2 Likes

@cuddlesquid
Firstly, thanks for the the instructions :slightly_smiling_face: … This is my first time to use CLI-Wallet using Remote Node
But I noticed that when syncing using Remote Node method, it syncing fast only if you are creating a new wallet using this command

electroneum-wallet-cli.exe --daemon-host=nodes.hashvault.pro:26968 --generate-from-keys=wallet

And when importing from existing paper wallet using this command below, it’s syncing very slow and seems to take days …

electroneum-wallet-cli.exe --daemon-host=nodes.hashvault.pro:26968

Is there a fix for that ?

1 Like

Hello there!

Im very sorry for any troubles, however I went ahead and duplicated steps above you mentioned and I am not running into very slow sync.

Upon executing “electroneum-wallet-cli.exe --daemon-host=nodes.hashvault.pro:26968” you should be asked to enter an existing wallet name or simply create a new one. Here is a an example below.

Since my wallet is already on refresh status, that means wallet already pulled an up to date blockchain.

Note: If you have a very poor quality computer “refresh” process will take some time. Any refreshed blocks are saved, so on next wallet load you will only refresh new blocks.

2 Likes

Hello cuddlesquid,

I have a question. Let’s say that I am Synchronizing the Blockchain the Old-fashioned way it is slow and you have to download the whole Blockchain to your computer. Because you run everything from *C:* is there any way to download the Blockchain to an external drive, for example *D:* where it is a much larger space.

Thank you!

Hello there!

Here is a guide on downloading and importing raw blockchain. :slight_smile:

2 Likes

Thank you so much for your quick response!

1 Like

Trying to do a transfer from a wallet I had used when mining (back before ASICs), I have kept up to date on releases. Refresh works fine and my amount is still correct. When I try doing the transfer from this wallet to another (consolidation) I receive an error

error

There is enough unlocked balance, and I’m sending less than that amount to account for fee. But I still get this error, even if I set the priority.

1 Like

Ensure you have the latest client, top of guide for link, which is electroneum-win-x64-v2.1.1.1 as of 10/02/2018

Error clearly states its related to insufficient funds for fee. In order for me to try and help you before I send you to raise a ticket, Ill at least need to know how much Electroneum you are trying to send out?

I have the latest client, as mentioned I kept up to date on releases.

I am attempting to transfer roughly 2400, leaving a few ETN behind for fee.

Try leaving at least 5 ETN in your wallet, if that does not work you may have to try leaving up to 10 ETN. Sometimes the wallet wants you to leave more than what the fee is, I’m not sure of the reasoning behind this.

3 Likes

Yep I just needed to leave more behind, thanks

4 Likes