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.

1. Download the latest files as separate zip files or packaged zip file here: https://epic.tech/downloads/
2. (for Windows) Extract the files to a convenient location such as C:\Program Files\Epic.

Setup Wallet and Server (for Windows)

Write down your 24-word recovery seed phrase and confirm it was written down properly. It is used to recover your wallet and should not be shared with others.

1. Open epic-wallet folder and run epic-wallet-create (bat file).
2. 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.
3. 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.
4. 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.
5. 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).

Full blockchain synchronization takes several hours from scratch. When the Header Chain Height and Chain Height match, your wallet is synchronized.

Download and Install Files (for Linux)

To send and receive on Linux, you need Epic wallet and server.

1. Download the latest Linux files here: https://epic.tech/downloads/
2. Press Ctrl+Alt+T to open a new terminal.
3. Enter this command to install dependencies:
   sudo apt install libncurses5 libncursesw5 zlib1g openssl
4. Navigate to the directory where you downloaded the files with command:
   cd <directory>
Example if the files are located in /Downloads:
   cd Downloads
5. To display files in the directory, use the list command:
   ls
6. 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)

1. Open epic-wallet folder and run epic-wallet-create (bat file).
2. 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.
3. Open epic folder (server) and run epic.exe.
4. 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.
5. 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

1. Open epic folder (server) and run epic.exe.
2. Open Command Prompt as Administrator.
   - Option 1: Click the Search icon on the taskbar, type cmd, and click “Run as Administrator”.
   - Option 2: Press Windows key+R to open Run, type cmd, and press Ctrl+Shift+Enter.
3. 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:

1. 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
2. An Epic Cash transaction file will be generated in the same folder as epic-wallet.exe. Send this transaction file to the receiver.
3. Wait for the receiver to create a TransactionName.tx.response file and send it back to you.
4. 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:

1. Place the transaction file in the same folder as your epic-wallet.exe.
2. 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
3. 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.
4. 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

The HTTP Listener requires 3415 to be open. You can use Canyouseeme.org to verify you have successfully opened the port.

1. Open port 3415 on both router and firewall. See How to Open Ports wikiHow guide.
2. You can check if port 3415 is open and view your IP address at CanYouSeeMe.org.
3. Open epic folder (server) and run epic.exe.
4. Open epic-wallet folder and run epic-wallet-listen (bat file).

To receive Epic Cash with HTTP Listener:

1. Provide the sender with your IP address.
2. 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 account
cancel       Cancels a previously created transaction, freeing previously locked outputs for use again
check        Checks a wallet's outputs against a live node, repairing and restoring missing outputs if required
finalize     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 summary
init         Initialize a new wallet seed file and database
invoice      Initialize an invoice transaction.
listen       Runs the wallet in listening mode waiting for transactions
outputs      Raw wallet output info (list of outputs)
owner_api    Runs the wallet's local web API
pay          Spend coins to pay the provided invoice transaction
receive      Processes a transaction file to accept a transfer from a sender
recover      Recover a wallet.seed file from a recovery phrase (default) or displays a recovery phrase for an existing seed file
repost       Reposts a stored, completed but unconfirmed transaction to the chain, or dumps it to a file
restore      Restores a wallet contents from a seed file
send         Builds a transaction to send coins and sends to the specified listener directly
txs          Display transaction information

Instructions for canceling a stuck transaction (.bat file method)

1. 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).
2. Edit Epic-transaction cancel (bat file) to include the transaction number and run it.
3. Run epic-wallet-info (bat file) to verify the transaction was canceled.

Instructions for canceling a stuck transaction (Command Prompt/text file method)

1. Generate a transaction file in plaintext:
   epic-wallet -p YourPassword TransactionFileName.txt
2. Search the TransactionFileName.txt file for the stuck transaction and record the transaction number (located on the left).
3. Run this command to cancel the transaction:
   epic-wallet cancel -i TransactionNumber
4. 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/