How to build a non-custodial wallet

Build a backend for a non-custodial wallet in 30 minutes

A wallet is a simple application where users can sign in, generate accounts in different blockchains, and send and receive payments. They are owners of the private keys for every blockchain address, and the wallet provider has no access to them.

A wallet can store any assets. These could be customer ERC-20 tokens, standard blockchain assets, or government-issued currencies.

In this tutorial, you will learn how to build a non-custodial wallet backend on Tatum. All you will have to do after this tutorial is to create a nice frontend for your application.

A non-custodial wallet is the type of wallet where users have full control over their funds and the associated private key.

There are two logical groups of actions that must be done to create a wallet:

  • Registration of new users in the application - what must be done during the registration phase

  • User application journey - what kind of actions users take while in the application

New user registration

When a new user signs up for the application, blockchain wallets and ledger accounts must be created. Every user should have their own blockchain wallet. Every account should be created with the external ID of the customer. This makes it possible to list all accounts for the specific customer.

pageHow to create a blockchain wallet

When you create accounts, blockchain addresses should be created and connected to the ledger accounts. This starts the process of automatic synchronization of incoming blockchain transactions. It is possible to enable webhook notifications for every incoming transaction to the account.

pageHow to automatically scan blockchain addresses and set up webhook notifications

User journey

When the user signs into the application, a list of their accounts should be visible. Usually, the last transactions that occurred in any of the accounts are presented as well.

The account's balance is available in the accounts list by default and does not have to be queried separately.

The user can see the details of the account and transactions connected only to this account. Usually, it is good to display the blockchain addresses connected to this account to send a blockchain transaction.

Finally, there should be the option to send the transaction from the account to a blockchain address.

pageHow to send a Bitcoin blockchain transaction from a virtual account

When developing a non-custodial wallet, the Bitcoin transaction should have the attr field present in the request body. This will be used as a change address for the rest of the unspent funds, and it must be the first address connected to the ledger account.

So there you have it. There are many more things that you can enhance in your app and many more features to implement, but this should be a reasonable start for you and your wallet.

Last updated