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
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.
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>
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 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:
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>
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.
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
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
- If you are using Remote Node method, skip opening electroneumd.exe and repeat step 11a or 11b in Synchronizing the Blockchain section and then continue to Viewing Your Wallet Balance.
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.
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.
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.
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.
- On
electroneum-wallet-cli.exe
window type save and press enter, then type exit and press enter to close electroneum-wallet-cli.exe first.
- 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.
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).
Opening Paper Wallet with Electroneum CLI
Opening Paper Wallet with Mobile App or Online Wallet
Opening Mnemonic Seed Wallet - 25 words
Corrupted blockchain repair guide
Importing raw blockchain to Electroneum CLI
Video Guide by @NorthEastTexasTech
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
Thank you!
-
https://electroneum101.com/ - Electroneum CLI Written Guide
-
@NorthEastTexasTech - Electroneum CLI - Video Guide
-
@DividedShark - Remote Node Instructions
-
@M44FFW - Remote Node Host Owner and Maintainer
-
@BegaMutex - Prime Helper
-
@RSKNOR - Prime Helper