Edge Wallet

A multicurrency mobile wallet for Bitcoin, Bitcoin Cash, Ethereum, Dash, Litecoin, Ripple/XRP and Monero.

Edge Wallet is:

  • simple
  • secure
  • private
  • decentralized
  • multi-currency
  • cross-platform
  • mobile first
  • open source


Edge is known to build with this exact tool set. Updated versions of these toolsets may break the build or app. If you have issues, try mirroring these exact versions.

  • MacOS High Sierra 10.13.3
  • Xcode 9.4.1
  • Android Studio 3.1.3
  • CocoaPods 1.5.3
  • Android NDK r15c This is a must have. Version r17 is known to break native code builds
  • NodeJS 8.9.3
  • NPM 5.5.1
  • Yarn 1.5.1
  • Java 1.8.0_152

Getting Started

Install nodejs (v 8.9.3 and npm (v 5.5.1)


Install yarn


Install React Native CLI

npm install -g react-native-cli

Install CocoaPods (MacOS)

sudo gem install cocoapods

Checkout develop branch & install node_modules

cd edge-react-gui

Android NDK Setup

*IMPORTANT* You must use version r15c to build. r17 and above break NDK build that this app requires. Download
the r15c NDK version here: https://developer.android.com/ndk/downloads/older_releases

(MacOS) If the NDK is already installed from Android Studio, it should be in `/Users/[user]/Library/Android/sdk/ndk-bundle`.
If you are using a version other than r15c, replace your version with version r15c downloaded from above

Set the following environment vars

export ANDROID_NDK_HOME=/Users/[username]/Library/Android/sdk/ndk-bundle
export NDK_HOME=/Users/[username]/Library/Android/sdk/ndk-bundle
export SDK_HOME=/Users/[username]/Library/Android/sdk
export JAVA_HOME="/Applications/Android Studio.app/Contents/jre/jdk/Contents/Home"

Android Recommended Versioning & Configuration

For best results, please consider using the following versions (up-to-date as of 2018-05-11)

  • Java & Jave JDK version 8u171

Add API key in env.json

Get an API key from https://developer.airbitz.co by scanning the QR code with your Airbitz wallet (https://airbitz.co/app)
Copy the env.example.json to env.json and change the AIRBITZ_API_KEY to the API key you received from developer.airbitz.co.

Run the app in debug mode

react-native run-ios or react-native run-android

Deploying (MacOS Only)

The included deploy.js is a script to automate building, signing, and deploying release builds of Edge. It provides
the following:

  • Auto set app version number based on package.json version
  • Auto increment and set the buildnum to the value of YYMMDDNN where NN is an auto-incrementing build number within a day
  • Auto sign Android APK with Android keystore files
  • Auto sign iOS IPA with provisioning profiles

To Use

  • Set the env var KEYCHAIN_PASSWORD to the keychain password of the current user
  • Copy the deploy-config.sample.json to deploy-config.json and edit the parameters accordingly. You'll need a HockeyApp account to get ids and keys
  • Put any Android keystore files into edge-react-gui/keystores/
  • If using Firebase, put your account's google-services.json and GoogleService-Info.plist into edge-react-gui/
  • Install xcpretty sudo gem install xcpretty

Run deploy

./deploy.js edge ios master
./deploy.js edge android master


For debugging, we recommend using React Native Debugger


brew update && brew cask install react-native-debugger

iOS Simulator
⌘ + d (command + d)
Select "Debug JS Remotely"

Windows / Linux


GenyMotion Android Emulator
⌘ + m (command + m)
Select "Debug JS Remotely"