Note

This code relates to version 1.x of QRL, the world's first open-source PQ blockchain, which has been securing digital assets since December 2016. The next generation of QRL, version 2.0, is in development and has its own repositories. See this discussion page.

QRL Mobile wallet

This mobile application is based on the react-native framework to provide an Android and iOS implementation of the QRL wallet.

General information

The mobile-wallet apps are still under heavy development. Please be aware that frequent changes will occur to this repository.

Requirements

Common to iOS and Android

• React-Native (https://facebook.github.io/react-native/)
• CMake (https://cmake.org/)

iOS specific

• XCode
• Cocoapods (https://cocoapods.org/)

Android specific

• Android Studio (https://developer.android.com/studio/install)
• Gradle (https://gradle.org/): can be handled within Android Studio

How to generate the iOS libraries

To generate the iOS libraries you need to clone the theQRL/qrllib and build the *.a iOS libraries (for the simulator and real device) using Xcode.

git clone https://github.com/theQRL/qrllib
git submodule update --init --recursive
cd qrllib
mkdir build
cd build
cmake -G Xcode ..

These commands will generate a new Xcode project called qrllib.xcodeproj. Open the Xcode project and build the 4 different libraries (dilithium, kyber, qrllib and shasha) for the iOS simulator and "iOS generic device". You will see all the generated libraries under build/Debug-iphoneos and build/Debug-iphonesimulator directories.

How to generate the Android libraries

To generate the Android libraries you need to load the /android project folder in Android Studio and open the build-gradle file. Open the "Gradle menu" and double click on "android:app [externalNativeBuildDebug]" under the "Run Configurations" category to start building the libraries. The generated *.so libraries are located under android/app/build/intermediates/cmake/debug/obj/.

How to update proto files

In case of any change on the proto file, one needs to regenerate the gRPC pods

rm -rf Pods
rm Podfile.lock
pod install

Load the generated libraries to the mobile-wallet app

• Open the mobile-wallet Xcode project (ios/theQRL.xcworkspace)
• Click on the project name (theQRL) and select theQRL under the TARGETS list
• Add all the generated .a libraries to the Linked Frameworks and Libraries section

RN <-> native code communication

For more information about the communication between React-Native and native code (Objective-C and c++) check the original Communication between native and React Native documentation.