RWallet

Introduction

This is a multi-cryptocurrency wallet application. Supports both english and spanish.

Prerequisite

To run on Android

1. In order to run this App in Android Simulator, Android Studio needs to be installed with Android SKD 10 (Api level 29). Please refer to https://developer.android.com/studio
2. Open Android Studio, create a device via Tools > AVD Manager > Create Virtual Device. After downloading required dependencies, start the device by clicking on Play icon.
3. Now we are testing if you can invoke adb in terminial. This is for running rWallet Android App on Android virtual device.
   1. Since we already have Android Studio installed we can add platform-tools to path

      echo 'export ANDROID_HOME=/Users/$USER/Library/Android/sdk' >> ~/.bash_profile
      echo 'export PATH=${PATH}:$ANDROID_HOME/tools:$ANDROID_HOME/platform-tools' >> ~/.bash_profile
      

   2. Then, refresh bash profile by source ~/.bash_profile
   3. Start using adb with adb devices
   4. If you have a virtual device running, it should show

      List of devices attached
      emulator-5554	device
      

Note: When syncing project with gradle files using Android SKD 11, it throws the following error:

No variants found for ':@imstar15_react-native-firebase'. Check build files to ensure at least one variant exists. at:

To run on iOS Devices

1. XCode needs to be installed (v11.x). iOS simulator will be installed along with XCode.

Note: When running npm install with xCode 12.x it throws the following error:

ReferenceError: globalThis is not defined #2795

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes. See deployment for notes on how to deploy the project on a live system.

The first three steps are needed for both Android and iOS devices.

1. npm install to install dependencies. If you are using Windows, use npm run install:windows to install and fix the broken metro-config blacklist.js file.

2. Create an environment variable file named .env in the root directory

   # Parse server configuration
   # Server URL https://rwallet.app/v1
   # Devbox Server URL for Android Simulator http://10.0.2.2:1338/parse
   # Devbox Server URL for iOS Simulator http://<YOUR_IP_ADDRESS>:1338/parse
   # RWALLET_ENV: Production, Dogfood or others. If RWALLET_ENV value is "Production", or not set, the final server URL value is the same as Server URL such as "https://rwallet.app/v1"; otherwise, the RWALLET_ENV value will be prepended to Server URL in lower case as a sub-domain. For example, if RWALLET_ENV is "Dogfood" and Server URL is "https://rwallet.app/v1", the final URL is https://dogfood.rwallet.app/v1.
   
   PARSE_SERVER_URL=https://rwallet.app/v1
   RWALLET_API_KEY=6a740128-2ba2-4b82-9301-8cbe07208ee9
   RWALLET_ENV=Dogfood
   

   • If .env file is changed, manually edit the file importing react-native-dotenv (rwallet/config.js) by either adding an empty line or whitespace will work.
   • For security, we force the use of https to transfer data. If you use http during development, you need to set NSAllowsArbitraryLoads to true in the iOS environment and useCleartextTraffic to true in the Android environment.
   • Note: There are 2 examples for Dogfood (.env_dogfood) and Local (.env_local) environments for easy configuration. Copy the files to .env for a quick change of environments.

3. In order to use firebase messaging on Android, put google-services.json in the android/app.

4. npm run android or npm run ios. The script will first start server daemon in a separate terminal window, the same effect as npm run start. You should see console output like below.

   > rwallet@0.0.1 start /Users/mikasa/Documents/repos/rwallet
   > node node_modules/react-native/local-cli/cli.js start
   
   ┌──────────────────────────────────────────────────────────────────────────────┐
   │                                                                              │
   │  Running Metro Bundler on port 8081.                                         │
   │                                                                              │
   │  Keep Metro running while developing on any JS projects. Feel free to        │
   │  close this tab and run your own Metro instance if you prefer.               │
   │                                                                              │
   │  https://github.com/facebook/react-native                                    │
   │                                                                              │
   └──────────────────────────────────────────────────────────────────────────────┘
   
   Looking for JS files in
     /Users/mikasa/Documents/repos/rwallet 
   
   Loading dependency graph, done.
   

   • For Android, npm run android will start the app in your physical device or Android virtual device. You need to check what device are available by running adb devices in terminal. To test the app in a physical Android device, you need to make sure Developer Options -> Enable Debugging via USB is turned on for that device. Note: If you encounter an error like below then you need to create a local.properties file under ./android and add one line sdk.dir = /Users/<username>/Library/Android/sdk in it.

     SDK location not found. Define location with an ANDROID_SDK_ROOT environment variable or by setting the sdk.dir path in your project's local properties file at '/Users/<usernmae>/Documents/repos/rwallet/android/local.properties'.
     

   • For iOS device, npm run ios will start the App in iOS physical or virtual device.

5. Hot reload code change - Press Command + m on virtual device and select Enable Hot Reloading to hot reload file changes.

Fastlane

Set up Fastlane

Homebrew	Installer Script	Rubygems
macOS	macOS	macOS or Linux with Ruby 2.0.0 or above
brew install fastlane	Download the zip file. Then double click on the install script (or run it in a terminal window).	sudo gem install fastlane -NV

Setup fastlane environment variable

APP_IDENTIFIER="com.rsk.rwallet.reactnative"


# Apple id
USERNAME=""

# Apple password
FASTLANE_PASSWORD=""

# Apple specific password
FASTLANE_APPLE_APPLICATION_SPECIFIC_PASSWORD=""

# Apple developer team id
TEAM_ID=""

# itunes connect team name
FASTLANE_ITC_TEAM_NAME=""

# Apple certs storage
GIT_URL="git@xxx.com:xxxx/xxxxx.git"
MATCH_PASSWORD=""


# Android sign file
ANDROID_SIGN_FILE="android/app/keystores/release.rwallet.jks"
ANDROID_SIGN_PASSWORD=""
ANDROID_SIGN_KEY_ALIAS="key0"
ANDROID_SIGN_KEY_PASSWORD=""


SLACK_URL=""

Build on iOS

1. The App Store will no longer accept new apps using UIWebView as of April 2020 and app updates using UIWebView as of December 2020. Remove Libraries/React.xcodeproj/React/Views/RCTWebView.h、RCTWebView.m、RCTWebViewManager.h、RCTWebViewManager.m in Xcode to remove UIWebView.
2. Make sure you have the latest version of the Xcode command line tools installed:

   xcode-select --install
   

3. Set up fastlane match by running fastlane match init. match is the alias for the sync_code_signing action. It creates all required certificates & provisioning profiles and stores them in a separate git repository.
4. Gernerate certificates by fastlane match appstore
5. Once match is set, run fastlane ios beta version:<version_number> build:<build_number> to push to TestFlight. For example, fastlane ios beta version:0.8.1 build:3 (build parameter can be omitted for auto-increment)

build on Android

1. Make sure you have Android Studio installed, so that it is easy to sync the gradle build config.
2. To build the APK, run fastlane android build_apk version:<version_number> code:<version_code>

Development

Remote Debugging

Remote Debugging on iOS Simulator

1. Run npm run ios to start the app in Simulator.
2. Wait for the build

Remote Debugging on Android Devices

Step 1: Discover your Android device

1. Open the Developer Options screen on your Android. See Configure On-Device Developer Options.
2. Select Enable USB Debugging
3. On your development machine, open Chrome.
4. Open DevTools.
5. In DevTools, click the Main Menu Main Menu then select More tools > Remote devices.
6. In DevTools, open the Settings tab.
7. Make sure that the Discover USB devices checkbox is enabled.
8. Connect your Android device directly to your development machine using a USB cable. The first time you do this, you usually see that DevTools has detected an unknown device. If you see a green dot and the text Connected below the model name of your Android device, then DevTools has successfully established the connection to your device.
9. If your device is showing up as Unknown, accept the Allow USB Debugging permission prompt on your Android device.

Step 2: Debug content on your Android device from your development machine TODO: How to debug android app with Mac OS is to be added

Debugging

1. Mac OS Dev environment

   • In Android Simulator, press Command + M to start remote debugging
   • In iOS Simulation, press Command + D to start remote debugging

2. Linux Dev environment

   • In Android Simulator

3. Windows Dev environment

Deployment

1. Android
   1. Modify keystore setting in ./android/gradle.properties
   2. Run npm run android to build android apk. the apk file will be generated at the path: ./android/app/build/outputs/apk/release
2. iOS
   1. Remove Libraries/React.xcodeproj/React/Views/RCTWebView.h、RCTWebView.m、RCTWebViewManager.h、RCTWebViewManager.m in Xcode to remove UIWebView.
   2. Change signing team in the project settings
   3. Build ios app via Product -> Archive in Xcode
   4. Window -> Organizer, Distribute app to App Store Connect
   5. Login App Store Connect, add new build to TestFlight

Testing Procedure

Unit Testing

Unit Testing module is to be added.

1. Run all test suites
   • npm test
2. Run a specific test suite file
   • npm test -t "test/transaction.test.js"
3. Run a specific describe test or it test
   • node node_modules/jest/bin/jest.js -i <test_file_name> -t "<describe_string> (or <it_string>)"
   • Example: 'node node_modules/jest/bin/jest.js -i test/common.test.js -t "ConvertCoinAmountToUnitHex"'

Manual Testing

Manual Testing has to be done on a real iOS/android device. This is to make sure we mimic real user's experience.

Steps

1. Create a wallet
   • Check Go Back Button
   • Enable all three testnet tokens
2. Import a wallet
   • Check Go Back Button
   • Enable all three testnet tokens
3. Delete a wallet
   • Goes to Me bottom tab and delete a Key
   • Go back to dashboard and make sure wallet is deleted
4. Receive Test BTC
   • Send Test BTC from an external wallet, and make sure transaction and balance correct in Address Detail page
   • Send Test BTC from rWallet, and make sure transaction and balance correctin Address Detail page
5. Receive Test RBTC
   • Send Test RBTC from an external wallet, and make sure transaction and balance correct in Address Detail page
   • Send Test RBTC from rWallet, and make sure transaction and balance correctin Address Detail page
6. Receive Test RIF
   • Send Test RIF from an external wallet, and make sure transaction and balance correct in Address Detail page
   • Send Test RIF from rWallet, and make sure transaction and balance correctin Address Detail page
7. Send Test BTC
   • Send Test BTC to an external wallet, and make sure transaction and balance correct in Address Detail page
   • Send Test BTC to another address in rWallet, and make sure transaction and balance correctin Address Detail page
8. Send Test RBTC
   • Send Test RBTC to an external wallet, and make sure transaction and balance correct in Address Detail page
   • Send Test RBTC to another address in rWallet, and make sure transaction and balance correctin Address Detail page
9. Send Test RIF
   • Send Test RIF to an external wallet, and make sure transaction and balance correct in Address Detail page
   • Send Test RIF to another address in rWallet, and make sure transaction and balance correctin Address Detail page
10. Change Language Settings
    • Change Language in Me tab, and make sure the App doesn't crash (We don't support any other launage yet)
11. Change Currency Settings
    • Change Currency in Me tab, and make sure the App doesn't crash (We don't support any other launage yet)
12. Click on Social Media Link
    • Click on all Social Media link, and make sure mobile phone could navigate to the correct webpage/app