Epic Cash · Restore map

1 · Restoring on the phone

Epic Cash Mobile keeps one wallet for each network. Restoring means typing the recovery phrase, choosing a PIN, and letting the app search the blockchain for your coins.

Screen you see The app works Saved on the device / a file Network or blockchain Warning, stop or problem A way in 3 Known issue, see the list below the diagram

Thick green arrows are the usual path. Dashed arrows are side paths. Arrows into the red band are what happens when something goes wrong. In the diagram, tap a box to highlight its links.

How a restore starts and runsOpen full screen ↗

Swipe sideways to see the whole diagram, or open it full screen to zoom.

Ways to reach Restore

First open. The first screen asks Create a new wallet or Restore from a phrase, before any PIN, so the keyboard never hides the choice.
After Delete wallet. Deleting ends on the same first screen.
Forgot PIN? on the unlock screen. It deletes the wallet from this phone (after you tick that you have the phrase) and returns to the first screen.
Settings › Wallet › Restore from a phrase. This replaces the wallet on this phone. It shows Delete's warning, asks you to tick that you wrote the phrase down, type the confirm word and enter your PIN. Then it deletes the current wallet and opens the restore.

Step by step

Type the phrase. 12 to 24 words, separated by spaces. Upper case and extra spaces are fine. If a word or the order is wrong, the app says the phrase is not valid but not which word.
Optional: where to start. Under the phrase, Start from lets you pick a date (main network only) or a block height. Leave it closed to search the whole chain. For now, always leave it closed: a restore with a start date or height currently leaves the wallet unable to receive or send (known issue 1). A start date after your first payment would also miss coins.
Choose a PIN (6 digits), confirm it, then turn on the fingerprint or face unlock if the phone has it. The phone has no password. The app makes one itself and locks it with your PIN.
Search the chain. "Looking for your funds on the blockchain. Keep the app open until this finishes." A progress bar shows the percentage. There is no Cancel button.
History file. When the search is done, the app offers to import a .wfeh history file (payment history, contacts, invoices and settings). Not now goes to the wallet. You can import one later from Settings.

Network

The phrase belongs to no network. The phone restores onto the network it is set to, which is the main network in the normal app. One wallet per network: each has its own folder, PIN and settings, and deleting one never touches the other.

When the search is interrupted

The blockchain search on the phoneOpen full screen ↗

Swipe sideways to see the whole diagram, or open it full screen to zoom.

App closed, phone locked for long, network lost, or Offline mode: the search stops. Coins found so far stay found. The phone does not pick the search up again by itself. Settings › Wallet › Recheck balance finds the coins, but today it does not finish the restore, so the wallet still cannot receive or send. Until that is fixed, delete the wallet and restore again, and keep the app open and online until the search ends (known issue 2).
Offline mode blocks the search unless the node is on your local network.
Delete waits: "Wait for the scan to finish before deleting the wallet."
There is no Cancel during the search, and nothing keeps the screen on. Keep the phone awake and the app in front.
Auto-lock waits for a running search to end before it locks.

What a restored phone gets back

Thing	Comes back?	From where
Balance, coins you can spend	Yes	Blockchain search
Payments received (unspent coins)	Partly	The search lists each coin found as a received payment, without sender, note or fee
Payments you sent, fees, cancelled payments	Only with a history file	`.wfeh` import
Notes, labels, who paid	Only with a history file	`.wfeh` import
Contacts, stars	If still on the phone, or from a file	The shared address book stays on the phone after Delete. Otherwise a contacts file or `.wfeh`
Paired contacts	See Your data	`.wfeh`, or the contact pairs again
Invoices, payment requests	Only with a history file	`.wfeh` import; a request still open when the file was saved comes back as history only
Epicbox address	Yes, the same	Made from the phrase
PIN, fingerprint	No, set new ones	Not in the phrase
Theme, language, node, Epicbox server, Advanced switches	Stay on the same phone, or from a file	Phone settings survive Delete. A new phone starts at defaults until you import a `.wfeh`

PIN or phrase: what you can do with which

PIN only: open the wallet and show the phrase (Settings asks for the PIN). Write it down.
Phrase only: restore on this phone after Forgot PIN?, or on any other phone.
Neither: the coins cannot be recovered by anyone.

Known issues

1Restoring with a start date or block height leaves the wallet unable to receive or send High Fixed

Where: Phone › Restore › 'Start from a date or height'; Desktop › Restore › 'Start from a block height'; then any Receive, Send or invoice
What: If you restored your wallet with a start date or block height, the wallet cannot receive or send until a full scan from the first block runs; the app does not offer that scan yet.
Status: Fixed in the next update

2On the phone, a restore scan that stops early can never be finished High Fixed

Where: Phone › Restore › scan step ('Looking for your funds…'), then Home and Settings › Wallet › Recheck balance
What: If the first scan after a restore is interrupted on the phone, the wallet may show a balance but refuse to send or receive until it is deleted and restored again without interruption.
Status: Fixed in the next update

3On the phone, a damaged wallet database is rebuilt empty and never rescanned High Fixed

Where: Phone › Unlock (PIN) after the core reports a damaged database
What: If the phone's wallet database is damaged, the app may open an empty wallet that cannot receive until a full scan runs.
Status: Fixed in the next update

7Phone: Settings › Restore from a phrase deletes the wallet before the phrase is typed Medium Fixed

Where: Phone › Settings › Wallet › Restore from a phrase
What: On the phone, 'Restore from a phrase' in Settings deletes the current wallet first and asks for the new phrase afterwards; have the phrase ready before starting.
Status: Fixed in the next update

8Phone: 'Back to the phrase' after an error empties the phrase field Medium Fixed

Where: Phone › Restore › PIN step error › 'Back to the phrase'
What: On the phone, if restoring fails at the PIN step, going back to the phrase requires typing all the words again.
Status: Fixed in the next update

9Phone: the restore scan step has no Cancel or Back and nothing keeps the phone awake Medium Fixed

Where: Phone › Restore › 'Looking for your funds on the blockchain'
What: Keep the phone awake and on the restore screen until the scan finishes; a failed scan currently offers only 'Open wallet'.
Status: Fixed in the next update

10Phone: a delete that fails after the lock leaves the app on Settings without a wallet Medium Fixed

Where: Phone › Settings › Wallet › Delete wallet (error notice)
What: On the phone, if deleting the wallet fails, the app may need a restart before it works again.
Status: Fixed in the next update

17Deleting a wallet does not unregister push notifications Low Fixed

Where: Phone › Settings › Delete wallet / Forgot PIN
What: After deleting a wallet, notifications for its old address may still arrive until the app registers a new wallet.
Status: Fixed in the next update

18Phone: 'Forgot PIN' delete skips the clean-up Settings › Delete does Low Fixed

Where: Phone › Unlock › Forgot PIN?
What: Deleting a wallet through 'Forgot PIN' may leave an old backup reminder behind.
Status: Fixed in the next update

22Phone: the phrase error never says which word is wrong Low Fixed

Where: Phone › Restore › phrase step
What: On the phone, an invalid phrase is reported without saying which word is wrong.
Status: Fixed in the next update

36Phone: an auto-lock right after the restore scan skips the history-backup offer Low Fixed

Where: Phone › Restore › scan step › (phone away long enough) › PIN › Home
What: If the phone locked during the restore scan, import the history backup from Settings afterwards.
Status: Fixed in the next update