Cashual Wallet: The Quest for Good, User-Friendly Crypto Design

Cashual Wallet: The Quest for Good, User-Friendly Crypto Design

TL;DR: Crypto’s extended Winter has placed renewed emphasis on the culture of building, #buidl, and along those lines developer Jonathan Silverblood is among the most prolific. Here, he outlines principles of good wallet design with an eye toward onboarding grandmother. Meet Cashual Wallet.  

More Spice: Bitcoin White Paper Webcomic by Comics Legend Scott McCloud

Cashual Wallet: A Serious Attempt at Implementing a User-Friendly Wallet for Non-Technical Users

Six months ago I wrote an article outlining some design principles and guidelines for how to make a user-friendly wallet. I wanted to offer feedback and inspire developers to build more user-friendly wallets.

Cashual Wallet: The Quest for Good, User-Friendly Crypto Design
An early design from about six months ago.

While the design I made back then (above) was fully functional, my mindset while making it had been to create a design mockup rather than to build a wallet. It received a lot of positive response, but there were still some issues that needed to be worked out.

After I released the wallet design, I wanted to build a wallet based on it, but I didn’t want to write the cryptographic or security sensitive parts of the code myself, knowing that a mistake on my end could cost somebody their family savings or otherwise damage their lives.

Starting From Scratch

The peer-reviewed widely-used wallet library I needed did not exist back then, but the features are now being integrated in the the libraries used by Bitpay.

Revisiting my old design mockups and thinking about how #CashAccounts could be integrated, I started from scratch with the same goals as the previous wallet design. Re-reading the feedback on the initial design led to the conclusion I had chosen a target user base that was too big.

Going from targeting the general public to targeting specifically the non-technical first-time user, I significantly reduced requirements of the wallet.

Onboarding User Experience

It is important to me new users can get up and running with minimal effort. I’ve always disliked the all common onboarding flow where the user is forced to go through some complicated seed word backup process.

Backups are important, but they are not important to the first-time user (at least not before they receive their first significant payment).

Cashual Wallet: The Quest for Good, User-Friendly Crypto Design

So what is important to the first-time non-technical user?


While there are a lot of English speaking users in the world, the people we’re looking to target are non-technical everyday moms and pops, people who might not be young, might not have grown up with the internet readily available, and who might live outside major English-speaking countries.

To them, it simply isn’t acceptable to use a foreign language. They will feel alienated and insufficient if they have to cope with translating themselves, and if they have to do so while learning something entirely new.

Therefor, the Cashual Wallet will use the language of the device’s operating system when possible, but default to English if there is no available translation. On the very first setup screen, they will have the choice to change languages if they want to, but the aim is that in 99% of the cases their preferred choice should already be chosen and used without them making any decision.

By showing the option to control the language, you empower the user. By using their own language as the default, you make the wallet seem familiar and comfortable.


For the time being, virtually every user in a target demographic base uses their national currency as the unit of account. The wallet will ask the device operating system for the user’s locale, and pre select the appropriate currency in the same manner it does for language.


The theme allows the user to change to and from night mode. The default is a bright and colorful theme in order to align the experience with a positive and optimistic viewpoint, but the dark theme has some distinct advantages and can be turned on or off as needed.

Cash Account

Traditionally, cryptocurrency wallets use technical identifiers as payment information. While that works, it is neither humane nor does it give the users a good experience.

Instead, the Cashual Wallet is focused on strong integration with Cash Accounts, an open-source aliasing scheme that allows users to bind their technical payment information to user-friendly account names directly on the Bitcoin Cash blockchain.

In order to allow the user the best possible experience, they will be asked for a name to receive payment on the setup screen, and that name registration is then automated.

Behind the Scenes

Before we move on to the rest of the user interface design, I would like to explain a bit in more detail what happens in the background for new users.

When the user enters a name for their Cash Account, and the wallet utilizes reusable addresses, it then contacts a registration service and asks it to register the name with the user’s payment information. When the registration is complete, the wallet verifies the information before using it.

This is done with a third party because a new user has no funds, and cannot complete the on-chain transaction necessary to register the name on their own.

Wallet Home and History

Cashual Wallet: The Quest for Good, User-Friendly Crypto Design

Immediately after the user creates her wallet she is shown an empty home screen. There is an history entry for the wallet creation, and a pending entry for account registration.

Until the account registration is completed, she can use her wallet like as she normally would, with the exception that she cannot share her account identifier to receive funds, and would have to share their technical identifier instead.

After a period of usage, the history on the home screen would start to fill up with transactions and system messages. In the history, users can find how they have received and sent money as well as when they make, verify, sweep backups, and change security settings.

When the user has a currency other than the native cryptocurrency as their display currency, the history will also show dynamically calculated entries for appreciation and depreciation of their funds based on the currency displayed (though that is not displayed in the screenshot above, and is still a work-in-progress).

Being able to get a clear view of what happens in your wallet is important to build trust. Having valuation changes listed allows the user to easily do a manual audit of the wallet balance.

Sending Money

Cashual Wallet: The Quest for Good, User-Friendly Crypto Design

When the user takes the initiative to send money they need to tell the wallet:

  • Who they want to send money to
  • How much money they want to send

The send screen has been designed to show the user the full process in a single screen, optimized for the intended use case: sending money to a Cash Account.

For a new user, this means selecting the recipient field and typing in a Cash Account identifier, after which the wallet will look up the account and display the account identicon as confirmation of proper entry.

The user then enters how much money to send, and once a valid recipient and amount has been entered, the send payment button becomes available.

In order to be backwards compatible, the wallet also allows the user to fall back on technical identifiers, either by pasting an address into the recipient field or by tapping the scan icon in the header to interact with a QR code or NFC device.

When the user has sent money to a Cash Account, it is available in the contact history for convenient entry.

Sometimes the user might want to send a value measured in a currency other than their display currency. They can easily change the currency used in the send screen by tapping on the current unit in the value entry field.

It is also possible to send all funds in the wallet by tapping the wallet icon in the value entry field, which ensures there will be no dust left in the wallet after sending.


The send screen is easy to use and should work really well for the intended use case, but there is still some things that could be improved upon.

When the user is trying to send more money than their configured spend lock limit, the send payment should turn into a verify payment screen, which contains a summary of the transaction and the unlock mechanism. This is also the screen that will be shown when the user has scanned a payment request.

The contact list is currently automatic based on the users sending history. This is not ideal, as the user might not want all of their recipients stored in the list, so favourites and the ability to remove or hide entries has to be added.

Receiving Money

Cashual Wallet: The Quest for Good, User-Friendly Crypto Design

The receive screen is somewhat of an odd case. On one hand, it is a must-have feature to easily find out how to receive money, but the intended way to receive money is by users entering a Cash Account identifier.

As such, this screen might not be feature complete and it might change significantly in future iterations, but let’s go over what we have right now.

The screen is divided into two sections: the first allows the user to learn how to receive money at any time, and the second allows the user to request money now.

To receive money at any time, simply share the account identifier. The intended way is verbally, but there is a share button in the header that lets you share the information in any way your device supports.

To request money right now you enter an optional amount to request, then share the address or payment request encoded in the QR code.


The user interface design for backup management is not yet done. Backups are important and deserve a well thought-out process, top-class usability, and peer-reviewed security.

A separate full-length article will be written on this subject later on.

Current Status

Like all my work in the field, the source code is available and anyone is free to use it according to the MIT license. I appreciate all the help I can get, but I don’t expect anyone else to do the heavy lifting. For as long as I can afford, I will keep working on crypto related projects.

For updates on the projects I work with you can follow me on twitter or bitbacker.

Reprinted from “Meet cashual wallet, a serious attempt at implementing a userfriendly wallet for non-technical users,” By Jonathan Silverblood 

Cashual Wallet: The Quest for Good, User-Friendly Crypto DesignCONTINUE THE SPICE and check out our piping hot VIDEOS. Our podcast, The CoinSpice Podcast, has amazing guests. Follow CoinSpice on Twitter. Join our Telegram feed to make sure you never miss a post. Drop some BCH at the merch shop — we’ve got some spicy shirts for men and women. Don’t forget to help spread the word about CoinSpice on social media.