slashbinslashnoname/10101

Self-custodial derivative trading at your fingertips.

10101 - One app, all things bitcoin

10101 combines the power of a self-custodial on-chain and off-chain wallet with the vast world of trading. 10101 - a numeral palindrome and the binary representation of 21 - as in 21 million possible bitcoin. The vision of 10101 embodies what Bitcoin stands for: Decentralized and censorship resistant money.

Getting Started

To begin, ensure that you have a working installation of the following items:

• Docker and docker-compose
• Flutter SDK
• Rust language
• Appropriate Rust targets for cross-compiling to your device
• For Android targets:
  • Install cargo-ndk
  • Install Android NDK 22, then put its path in one of the gradle.properties, e.g.:

echo "ANDROID_NDK=.." >> ~/.gradle/gradle.properties

• For iOS targets:
  • XCode
  • Cocoapods

You can see whether you have all the sufficient dependencies for your platform by running flutter doctor.

Contributing

We encourage community contributions whether it be a bug fix or an improvement to the documentation. Please have a look at the contributing guidelines.

Dependencies

A lot of complexity for building the app has been encapsulated in a just-file. You can install just with cargo install just.

To see the available commands with explanations, simply run just --list.

To install necessary project dependencies for all targets, run the following:

just deps

Diesel database dependencies

Some crates, e.g. the coordinator use diesel for the database connection. This may require installing dependencies, such as e.g. libpql for the postgres database for the coordinator.

MacOS

On macOS, one can install libpq with the following command:

brew install libpq

Bear in mind that libpq is keg-only (not installed globally). This means that you have to add the library path the linker manually. The are a number ways to do that (e.g. by setting rustflags), however the easiest one is to add the following lines to your .zshrc/.bashrc

export LDFLAGS="-L/usr/local/opt/libpq/lib"
export CPPFLAGS="-I/usr/local/opt/libpq/include"

This will ensure that libpq is available during building the project

Running 10101

Run the app natively (on your Linux/MacOS/other OS)

The following command will build and start all the necessary services, including the native desktop 10101 app.

just all

Run the mobile-app on the iOS simulator

Note: Ensure that the iOS simulator is running on your machine so it can be selected as target.

The following command will build and start all the necessary services, including the native desktop 10101 app.

just all-ios

Run the mobile-app on the Android simulator

Note: Ensure that the Android simulator is running on your machine so it can be selected as target. Also ensure that you have run just deps-android to install the right targets for build.

The following command will build and start all the necessary services, including the android app.

just all-android

How to faucet your lightning wallet.

The app currently works only on regtest, which means that the wallet needs to be fauceted with the provided steps before you can start trading.

Setup

1. If you have run the app before, we recommend to clear the dev environment by running just wipe

2. Start the complete project stack with just all.

Adding funds to 10101 lightning wallet

1. Create an invoice in your 10101 app by navigating to the receive screen.

2. Click on the "pay the invoice with 10101 faucet" button.

Useful information for local regtest debugging

1. Follow coordinator's logs - tail -f data/coordinator/regtest.log
2. Block explorer - http://localhost:8080/
3. Lightning & Bitcoin faucet - http://localhost:8080/faucet/
4. Manually open a lightning channel - http://localhost:8080/channel/