react-native-blockstack

Decentralized identity and storage with Blockstack in React Native

Welcome to the React Native bridge of the Blockstack SDK. This bridge exists to help you get started quickly developing react native apps, but not all functionality available in the official native Blockstack SDK has been bridged over. As this is a community maintained repo, feel free to fill in the gaps and submit a pull request. For questions, concerns, ideas, or requests, open an issue, join the Blockstack Community Slack (https://community.blockstack.org/slack), or reach out in the forums (https://forum.blockstack.org). Happy hacking!

Getting started

$ npm install react-native-blockstack --save

Mostly automatic installation (not for iOS, see steps below)

$ react-native link react-native-blockstack

Manual installation

iOS

Create project

If you do not already have a react native project set up, create one via the React Native CLI. Follow Facebook's official getting started guide here: https://facebook.github.io/react-native/docs/getting-started.html.

Once this is set up, move on to the next section to integrate the Blockstack SDK.

Setup Cocoapods

1. Install cocoapods, sudo gem install cocoapods
2. In the terminal, navigate to your project root and use command pod init
3. In the created Podfile, add the following lines:

   use_frameworks!
   
   pod 'Blockstack'
   pod 'React', :path => '../node_modules/react-native', :subspecs => [
       'Core',
       'CxxBridge', # Include this for RN >= 0.47
       'DevSupport', # Include this to enable In-App Devmenu if RN >= 0.43
       'RCTText',
       'RCTNetwork',
       'RCTWebSocket', # Needed for debugging
       # Add any other subspecs you want to use in your project
   ]
   # Explicitly include Yoga if you are using RN >= 0.42.0
   pod 'yoga', :path => '../node_modules/react-native/ReactCommon/yoga'
   # Third party deps podspec link
   pod 'DoubleConversion', :podspec => '../node_modules/react-native/third-party-podspecs/DoubleConversion.podspec'
   pod 'glog', :podspec => '../node_modules/react-native/third-party-podspecs/glog.podspec'
   pod 'Folly', :podspec => '../node_modules/react-native/third-party-podspecs/Folly.podspec'
   

4. From the terminal, enter pod install
5. Open the newly created [your project's name].xcworkspace project. Note: Always use this file and not the .xcodeproj file when opening your project.

Add module

1. In XCode, in the project navigator, right click your project and select Add Files to [your project's name]

   • NOTE: Make sure "Create Groups" is selected in the file picker, or the native module will not be properly exported!

2. Go to node_modules ➜ react-native-blockstack ➜ ios and add the RNBlockstackSdk folder

3. Run your project (Cmd+R)

4. In your React Native project's App.js file, add the following line:

   import RNBlockstackSdk from "react-native-blockstack";
   

5. Utilize relevant methods as defined in RNBlockstackSdk.swift (i.e. RNBlockstackSdk.isUserSignedIn())

   • This is a community maintained repo. Feel free to add any missing functionality and submit a pull request :).

Android

1. Open up android/app/src/main/java/[...]/MainActivity.java

• Add import com.reactlibrary.RNBlockstackSdkPackage; to the imports at the top of the file
• Add new RNBlockstackSdkPackage() to the list returned by the getPackages() method

2. Append the following lines to android/settings.gradle:

   include ':react-native-blockstack'
   project(':react-native-blockstack').projectDir = new File(rootProject.projectDir, 	'../node_modules/react-native-blockstack/android')
   

3. Insert the following lines inside the dependencies block in android/app/build.gradle:

     compile project(':react-native-blockstack')
   

Windows

Read it! :D

1. In Visual Studio add the RNBlockstackSdk.sln in node_modules/react-native-blockstack/windows/RNBlockstackSdk.sln folder to their solution, reference from their app.
2. Open up your MainPage.cs app

• Add using Blockstack.Sdk.RNBlockstackSdk; to the usings at the top of the file
• Add new RNBlockstackSdkPackage() to the List<IReactPackage> returned by the Packages method

Add Deep Linking for Android

<intent-filter>
    <action android:name="android.intent.action.VIEW" />
    <category android:name="android.intent.category.DEFAULT" />
    <category android:name="android.intent.category.BROWSABLE" />
    <data android:scheme="yourappname" />
</intent-filter>

Usage

import RNBlockstackSdk from 'react-native-blockstack';

// check whether a blockstack session is running
result = await RNBlockstackSdk.hasSession()
hasSession = result["hasSession"]

// create a new session (replace with your app domain)
config = {
      appDomain:"https://example.com",
      scopes:["store_write"]
}
session = await RNBlockstackSdk.createSession(config)

// sign user in (starts redirect to blockstack browser)
await RNBlockstackSdk.signIn()

// handle auth response, e.g. from a prop
result = await RNBlockstackSdk.handleAuthResponse(this.props.authResponse)
did = result["decentralizedID"]

// sign user out
result = await RNBlockstackSdk.signUserOut()
success = result["signedOut"]

// check whether a user is signed in
result = await RNBlockstackSdk.isUserSignedIn()
signedIn["signedIn"]

// read profile data of signed in user
result = await RNBlockstackSdk.loadUserData()
did = result["decentralizedID"]
                
// put file, e.g. store unencrypted text in "text.txt"
content = "Hello React Native"
options = {encrypt: false}
result = await RNBlockstackSdk.putFile("text.txt", content, options)
fileUrl = result["fileUrl"]

// get file, e.g. read unencrypted text from "text.txt"
options = {decrypt:false}
result = await RNBlockstackSdk.getFile("text.txt", options)
fileContents = result["fileContents"]