Skip to content

Epic wallet

João Victor da Silva edited this page Jan 20, 2023 · 12 revisions

Table of contents

Epic wallet user guide

This should guide you through the basic operation of the epic wallet.

Epic miner installation and basic guide can be found here.

CLI Command-List

CLI main commands:

-a, --account <account>

Wallet account to use for this operation [default: default]

-r, --api_server_address <api_server_address>

API address of the 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

Here are the wallet 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

Transactions

This will guide you on transaction operations.

Using Emojis (from 3.2.2 forward)

This will guide you through the use of transaction emojis to receive or send Epic Cash

Send Epic Cash with Emoji

Epic Cash can be sent using Emojis, to do so, follow these steps:

  1. Run this command:
epic-wallet send -m emoji EpicCashAmount

Example of sending 10 Epic Cash:

epic-wallet send -m emoji 10
  1. Then you will get an emoji string that you will send to the receiver, then this string is the input for the receive command.
  2. Wait for the receiver to create a response string of emojis and send it back to you.
  3. After receiving the string of emojis, finalize the transaction with this command:
epic-wallet finalize -m emoji -i ResponseStringOfEmojis

Example of finalizing a transaction in a string of emojis:

epic-wallet finalize -m emoji -i 🥉🎨📏🤛🪞🥼💸🤎🚟🧞📷😶🪒🈶🍚🌖🦥🦹💳...

Note: Here we cut the string of emojis and add the ... to the end to make it readable on the wiki. The number of emojis that can be generated can exceed a few hundred in rare cases.

Receive Epic Cash with Emojis

This will guide you to receive Epic Cash using Emojis:

  1. Get the string of emojis from the sender, here we will call SentStringOfEmojis.
  2. Run this command:
epic-wallet receive -m emoji -i SentStringOfEmojis

Example of receiving Epic Cash with emojis:

epic-wallet receive -m emoji -i 🏆🥇😫🤵🚪🈯🍻🥾📩📟💃🧛...

Note: Here we cut the string of emojis and add the ... to the end to make it readable on the wiki. The number of emojis that can be generated can exceed a few hundred in rare cases. 3. Then you will get an emoji string ReceiveStringOfEmojis. Send this string back to the sender to finalize this transaction.

Using Transaction Files

This will guide you through the use of transaction files to receive or send Epic Cash

Send Epic Cash with Transaction File

Epic Cash can be sent using transaction files, to do so, follow these steps:

  1. Run this command:
epic-wallet send -d TransactionName.tx -m file EpicCashAmount

Example of sending 123.456 Epic Cash in a file named Transaction.tx:

epic-wallet send -d Transaction.tx -m file 123.456
  1. An Epic Cash transaction file will be generated in the same folder as epic-wallet. Send this transaction file to the receiver.
  2. Wait for the receiver to create a TransactionName.tx.response file and send it back to you.
  3. After receiving the TransactionName.tx.response file, place it in the same folder as your epic-wallet, 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

Receive Epic Cash with Transaction File

This will guide you to receive Epic Cash using transaction files:

  1. Place the transaction file in the same folder as your epic-wallet
  2. Run this command:
epic-wallet receive -i TransactionName.tx

Example of receiving Epic Cash in a file named Transaction.tx:

epic-wallet receive -i Transaction.tx
  1. An Epic Cash TransactionName.tx.response file will be generated in the same folder as epic-wallet. Send this file back to the Epic Cash sender to process.
  2. The Epic Cash sender must place the TransactionName.tx.response file in the same folder as their epic-wallet, and finalize the transaction with this command:
epic-wallet finalize -i TransactionName.tx.response

Receive and Send with HTTP Listener

Epic Cash can also be sent or received using HTTP, to prepare our wallet for HTTP operations follow these steps:

  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. Start the epic server (this guide can be followed).
  4. Run the following:
epic-wallet -e listen

Receive Epic Cash with HTTP Listener

To receive Epic Cash using HTTP Listener, follow these steps:

  1. Provide the sender with your IP address.
  2. Your Epic wallet must be HTTP listening when the sender sends you Epic Cash.

Send Epic Cash with HTTP Listener:

To send Epic Cash using HTTP Listener, follow these steps:

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