Epic Cash CLI Wallet Tutorial
If you find this guide useful, please consider donating to the authors through their Epicfundme.com links: Killing Joke and Adonis Cnut.
This tutorial covers CLI (non-GUI) wallet setup and sending and receiving Epic Cash with Transaction Files and HTTP Listener. The CLI command list can be found at the article end. If you’re looking to mine Epic Cash, please check out the Windows or Linux mining tutorials.
Download Files (for Windows)
To send and receive on Windows, you need Epic wallet and server.
- Download the latest files as separate zip files or packaged zip file here: https://epic.tech/downloads/
- (for Windows) Extract the files to a convenient location such as C:\Program Files\Epic.
Setup Wallet and Server (for Windows)
- Open epic-wallet folder and run epic-wallet-create (bat file).
- Set a strong password and backup your 24-word seed phrase. Please note: The seed phrase is required to recover your wallet. Do not share or lose your seed phrase, or you may lose your funds. Your wallet.seed file will be located in C:\Users\USERNAME\.epic\main\wallet_data.
- Open epic folder (server) and run the epic-server_config_fix.bat file, this will configure you server and begin the syncing process. You do not need to run this .bat file again after initial set up, and can run epic.exe instead.
- Allow your Epic node to synchronize to the latest block, which may take several hours. “Header Chain Height” and “Chain Height” will match when fully synchronized.
- Open epic-wallet folder and run epic-wallet-listen (bat file).
To view balance on Windows, open epic-wallet folder and run epic-wallet-info (bat file).
To restore an existing wallet.seed file, move the file to C:\Users\USERNAME\.epic\main\wallet_data, wait until full synchronization, and run epic-wallet-check (bat file).
Download and Install Files (for Linux)
To send and receive on Linux, you need Epic wallet and server.
- Download the latest Linux files here: https://epic.tech/downloads/
- Press Ctrl+Alt+T to open a new terminal.
- Enter this command to install dependencies:
sudo apt install libncurses5 libncursesw5 zlib1g openssl
- Navigate to the directory where you downloaded the files with command:
cd <directory>
Example if the files are located in /Downloads:cd Downloads
- To display files in the directory, use the list command:
ls
- Right-click and install, or enter the following commands, replacing
x
with the correct version number:sudo dpkg -i epic_x.deb
sudo dpkg -i epic-wallet_x.deb
Setup Wallet and Server (for Linux)
- Open epic-wallet folder and run epic-wallet-create (bat file).
- Set a strong password and backup your 24-word seed phrase. Please note: The seed phrase is required to recover your wallet. Do not share or lose your seed phrase, or you may lose your funds.
- Open epic folder (server) and run epic.exe.
- Allow your Epic node to synchronize to the latest block, which may take some time. “Header Chain Height” and “Chain Height” will match when fully synchronized.
- Open epic-wallet folder and run epic-wallet-listen (bat file).
To view balance on Linux, run command:epic-wallet info
Send and Receive with Transaction Files
- Open epic folder (server) and run epic.exe.
- Open Command Prompt as Administrator.
- Option 1: Click the Search icon on the taskbar, typecmd
, and click “Run as Administrator”.
- Option 2: Press Windows key+R to open Run, typecmd
, and press Ctrl+Shift+Enter. - Change directory to the folder containing epic-wallet.exe (either epic-wallet folder or Epic package folder) with the
cd
command.
Example:
cd C:\Program Files\epic-wallet_2.6.0
To send Epic Cash with Transaction File:
- Run this command:
epic-wallet.exe send -d TransactionName.tx -m file EpicCashAmount
Example of sending 123.456 Epic Cash in a file named Transaction.tx:epic-wallet.exe send -d Transaction.tx -m file 123.456
- An Epic Cash transaction file will be generated in the same folder as epic-wallet.exe. Send this transaction file to the receiver.
- Wait for the receiver to create a TransactionName.tx.response file and send it back to you.
- After receiving the TransactionName.tx.response file, place it in the same folder as your epic-wallet.exe, and finalize the transaction with this command:
epic-wallet finalize -i TransactionName.tx.response
Example of finalizing transaction in a file named Transaction.tx.response:epic-wallet finalize -i TransactionName.tx.response
To receive Epic Cash with Transaction File:
- Place the transaction file in the same folder as your epic-wallet.exe.
- Run this command:
epic-wallet.exe receive -i TransactionName.tx
Example of receiving Epic Cash in a file named Transaction.tx:epic-wallet.exe receive -i Transaction.tx
- An Epic Cash TransactionName.tx.response file will be generated in the same folder as epic-wallet.exe. Send this file back to the Epic Cash sender to process.
- The Epic Cash sender must place the TransactionName.tx.response file in the same folder as their epic-wallet.exe, and finalize the transaction with this command:
epic-wallet finalize -i TransactionName.tx.response
Receive and Send with HTTP Listener
- Open port 3415 on both router and firewall. See How to Open Ports wikiHow guide.
- You can check if port 3415 is open and view your IP address at CanYouSeeMe.org.
- Open epic folder (server) and run epic.exe.
- Open epic-wallet folder and run epic-wallet-listen (bat file).
To receive Epic Cash with HTTP Listener:
- Provide the sender with your IP address.
- Your Epic wallet must be HTTP listening when the sender sends you Epic Cash.
To send Epic Cash with HTTP Listener:
Run this command:epic-wallet send -d “http://RecipientIP:3415” EpicCashAmount
Example of sending 555.555 Epic Cash to IP 123.45.67.89 at port 3415:epic-wallet send -d “http://123.45.67.89:3415” 555.555
If the recipient’s Epic Cash wallet is actively HTTP listening, the transaction should complete in under 10 seconds. If the recipient’s Epic Cash wallet is not listening, your wallet will attempt to send the transaction for up to ~one minute before timing out.
CLI Command List
Wallet Options and Functions in Command Prompt
-a
, --account <account>
Wallet account to use for this operation [default: default]
-r
, --api_server_address <api_server_address>
Api address of running node on which to check inputs and post transactions
-d
, --data_dir <data_dir>
Directory in which to store wallet files
-p
, --pass <pass>
Wallet passphrase used to encrypt wallet seed
Subcommands
account List wallet accounts or create a new accountcancel Cancels a previously created transaction, freeing previously locked outputs for use againcheck Checks a wallet's outputs against a live node, repairing and restoring missing outputs if requiredfinalize Processes a receiver's transaction file to finalize a transfer.help Prints this message or the help of the given subcommand(s)info Basic wallet contents summaryinit Initialize a new wallet seed file and databaseinvoice Initialize an invoice transaction.listen Runs the wallet in listening mode waiting for transactionsoutputs Raw wallet output info (list of outputs)owner_api Runs the wallet's local web APIpay Spend coins to pay the provided invoice transactionreceive Processes a transaction file to accept a transfer from a senderrecover Recover a wallet.seed file from a recovery phrase (default) or displays a recovery phrase for an existing seed filerepost Reposts a stored, completed but unconfirmed transaction to the chain, or dumps it to a filerestore Restores a wallet contents from a seed filesend Builds a transaction to send coins and sends to the specified listener directlytxs Display transaction information
Instructions for canceling a stuck transaction (.bat file method)
- Open epic-wallet folder and run Epic-transaction txs (bat file). Search for the stuck transaction and record the transaction number (located on the left).
- Edit Epic-transaction cancel (bat file) to include the transaction number and run it.
- Run epic-wallet-info (bat file) to verify the transaction was canceled.
Instructions for canceling a stuck transaction (Command Prompt/text file method)
- Generate a transaction file in plaintext:
epic-wallet -p YourPassword TransactionFileName.txt
- Search the TransactionFileName.txt file for the stuck transaction and record the transaction number (located on the left).
- Run this command to cancel the transaction:
epic-wallet cancel -i TransactionNumber
- Run this command to verify that the transaction was canceled:
epic-wallet info
Website: www.epic.tech
Telegram: https://t.me/EpicCash
Discord: https://discord.gg/ZjnC6bh
Reddit: https://www.reddit.com/r/epiccash/
Twitter: www.twitter.com/EpicCashTech
Facebook: https://www.facebook.com/EpicCashTech/