Table of Contents
- Downloading Electroneum CLI
- Synchronizing the Blockchain
- View Wallet Only Mode
- Loading Wallet
- Viewing Your Wallet Balance
- Sending Electroneum
- Closing Electroneum CLI properly
- Blockchain data location
- Opening paper wallet with Electroneum CLI guides
- Repairing corrupted blockchain guide
- Importing raw blockchain to Electroneum CLI guide
- Video Guide
- Usefull Tips
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. Once electroneumd.exe completes synchronizing, skip Method 2 and 3 and go to Loading Wallet section.
Method 2: Importing raw blockchain guide can be found here: Importing the Blockchain to Electroneum CLI
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
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:
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.)
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:
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-v188.8.131.52:
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:
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:
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.
View Wallet Only 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.
electroneum-wallet-cli.exe --daemon-host=nodes.hashvault.pro:26968 --generate-from-view-key=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.exe”.
You must have the electroneumd.exe window running in the background for wallet to function if you’ve synchronized blockchain using the slow method.
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. Continue reading Viewing Your Wallet Balance after you’ve opened electroneum-wallet-cli.exe
Viewing Your Wallet Balance
- To view the balance of your wallet, type balance within
electroneum-wallet-cli.exewindow 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.
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.
electroneum-wallet-cli.exewindow type save and press enter, then type exit and press enter to close electroneum-wallet-cli.exe first.
electroneumd.exewindow 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.
Blockchain Data Location
- 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).
Restoring Electroneum CLI from paper wallet keys or seed guides
Corrupted blockchain repair guide
Importing raw blockchain to Electroneum CLI
Video Guide by @NorthEastTexasTech
electroneumd status & commands
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
https://electroneum101.com/ - for providing most of the CLI guide
@DividedShark - for providing Remote Node Instructions
@BegaMutex - thanks for helping Boss!
@NorthEastTexasTech - for creating Video Guide