sh-mobile-sdk v1.0.0

SimpleHold React-Native SDK

sh-mobile-sdk is SimpleHold react native SDK, it allows you to request wallets.

• Table of Contents
  • Installation
  • Configuring Android
  • Configuring iOS
  • Example
  • Usage
  • Contributing
  • License

Installation

yarn add sh-mobile-sdk

Configuring Android

Make sure you have set up intent-filter for your app (documentation here)

The example app settings:

<activity
  android:name=".MainActivity"
  android:launchMode="singleTask"
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />
        <category android:name="android.intent.category.DEFAULT" />
        <data android:scheme="example-app"/>
    </intent-filter>
</activity>

Configuring iOS

Make sure you have set up url scheme for your app (Open Xcode an click on your project. Go to the 'Info' tab and expand the 'URL Types' group).

The example app settings:

<key>CFBundleURLTypes</key>
<array>
  <dict>
    <key>CFBundleTypeRole</key>
    <string>Editor</string>
    <key>CFBundleURLSchemes</key>
    <array>
      <string>example-app</string>
    </array>
  </dict>
</array>

// iOS 9.x or newer
#import <React/RCTLinkingManager.h>

- (BOOL)application:(UIApplication *)application
   openURL:(NSURL *)url
   options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
  return [RCTLinkingManager application:application openURL:url options:options];
}

// If your app is using Universal Links
- (BOOL)application:(UIApplication *)application continueUserActivity:(NSUserActivity *)userActivity
 restorationHandler:(void (^)(NSArray * _Nullable))restorationHandler
{
 return [RCTLinkingManager application:application
                  continueUserActivity:userActivity
                    restorationHandler:restorationHandler];
}

Example

Run iOS

react-native run-ios

Run Android

react-native run-android

Usage

import the package:

import SimpleHoldSDK from "sh-mobile-sdk";

initialize an instance, e.g. in componentDidMount:

const sh = new SimpleHoldSDK("<your_app_scheme>://");

request wallets:

sh.requestWallets()
  .then((wallets) => {
    Alert.alert("Wallets", wallets.join("\n"));
  })
  .catch((error) => {
    Alert.alert("Error", JSON.stringify(error));
  });

clean up all resolve handlers, e.g. incomponentWillUnmount:

sh.cleanup();

Contributing

You are welcome! Create pull requests and help to improve the package.

License

MIT