Bitcoindevkit Android Demo Wallet

The Android Devkit Demo Bitcoin Wallet (we're calling it Devkit Wallet for short) is a simple testnet Bitcoin wallet built as a reference app for the bitcoindevkit on Android. It is purposely lean on Android-specific bells and whistles in order to keep the focus on bitcoin fundamentals and the bitcoindevkit API.

The repository is built to help newcomers to the bitcoindevkit by layering complexity slowly while not adding too much UI polish to the app.

The repository works in the following way: multiple branches are maintained in parallel, each of them focusing on a specific version of the app.

1. the default branch is the simple-wallet branch. It builds a simple bitcoin wallet which implements the core functionality one would expect from a wallet: create addresses, send, receive, display transaction history, and BIP84-compatible wallet recovery.
2. the ui branch builds the basic design and UI without any functionality
3. the docs branch is mostly empty and is used for docs

Design Choices

The Devkit Wallet makes rather opinionated choices regarding its design and architecture, all with the goal of being as helpful to potential bitcoindevkit developers exploring the library and looking for a working example. The end users of this application are developers, not real users. Here are some of these choices:

1. Be lean on Android-specific bells and whistles
2. Return types are explicitly stated for all code that touches bitcoin, even when the IDE doesn't like it
3. Some bugs are left in and considered acceptable if squashing them requires a lot of polish/boilerplate code that does not add to the understanding of the bitcoindevkit
4. Errors are not always communicated back to the user on-screen (for example through polished snackbars) for similar reasons as (3); if something is not working, take a look a the logcat output
5. I don't make use of string resources. This makes the codebase easier to search and simpler to parse on GitHub and platforms where the IDE doesn't show inline replacements of the string resources. In short, string resources, while a best practice, do not improve readability, the prime focus of this sample application.

Companion Documentation Website

You can find the companion tutorial website for this repository here. To learn more about the bitcoindevkit, check out the shiny new docs here.

First Time Building on Android?

If it's your first time working with Android apps or the bitcoindevkit android library, you can start by building this initial test app, which will ensure your local setup is up and running, ready to get started for development and exploration on the various apps here.