Electroneum CLI wallet guide with Remote Node method


#1

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. Be sure to check out all three synchronizing methods and chose one.

Synchronizing the Blockchain

Method 1: Old-fashioned way

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.

Method 2: Importing raw blockchain: Importing raw blockchain to Electroneum CLI wallet

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!) 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 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.)
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-host=nodes.hashvault.pro:26968 --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-host=nodes.hashvault.pro:26968

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.

Loading Wallet

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”.

You must have the electroneumd.exe window running in the background for wallet to function. If you are using Remote Node method, skip opening electroneumd.exe and repeat step 11a or 11b in “Synchronizing the Blockchain” section.

If you synchronized blockchain using the slow 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.

Viewing Your Wallet Balance

  • To view the balance of your wallet, type balance 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.

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 payment_id since these two are optional parameters:

  • transfer etnkGx62jvB73KDgu9et9WBHqYgwxxXHkPrVVE6t4hPr83tVNGy 10

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.

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. Window should close all the way after executing exit command.
  2. On electroneumd.exe window type save and press enter, then finally type exit to close electroneumd.exe last. Window should close all the way after executing exit command.
  3. Tip: On electroneumd.exe you can type the status command to view network details, or help command will show other commands.

Guides restoring Electroneum CLI from paper wallet keys or seed


KYC ! Electroneum please be careful
KYC Electroneum Update!
KYC ! Electroneum please be careful
Yoti does not work on an android tablet or a pc?
Can someone tell me how to check balance after moving etn from webwallet to offline paper wallet?
Wallet sync problem
Want more ETN? Want to help stabilise ETN Price?
Complete signup in wallets!
Can someone tell me how to check balance after moving etn from webwallet to offline paper wallet?
Just an an Idea to aid user number on community forum
Slow wallet sync
Offline Wallet?
Restoring Electroneum CLI wallet from paper offline wallet keys
Downloading the blockchain again
Solve Your ETN Problems Club!
CLI wallet integrity
CLI wallet integrity
Help with cli wallet
KYC / AML Explained
Can I download the blockchain?
Wallet question
Paper wallet question
Importing the Blockchain to Electroneum CLI
Electroneum Paper (offline) Wallet generator Guide
Restoring Electroneum CLI wallet from your 25 word seed
#2

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.


#3

@DividedShark Absolutely! Thank you for Remote Node instructions!


#4

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


#5

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.


#6

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


#7

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


#8

im stuck at “Starting Refresh”


#9

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


#10

@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


#11

@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 ?


#12

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.


#13

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!


#14

Hello there!

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


#15

Thank you so much for your quick response!


#16

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.


#17

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?


#18

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.


#19

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.


#20

Yep I just needed to leave more behind, thanks