Documentation Index
Fetch the complete documentation index at: https://docs.walletconnect.network/llms.txt
Use this file to discover all available pages before exploring further.
Wallet SDK Link Mode is a low latency mechanism for transporting One-Click Auth requests and session requests over Universal Links, reducing the need for a WebSocket connection with the Relay. This significantly enhances the user experience when connecting native dApps to native wallets by reducing the latency associated with network connections, especially when the user has an unstable internet connection.
Make sure that One-Click Auth is implemented before enabling Link Mode. How to enable it:
To support Link Mode add a universal link for your wallet in Cloud project configuration dashboard, configure your Metadata with a valid universal link and set the linkMode property to true:
const walletKit = await WalletKit.init({
core,
metadata: {
name: "Demo React Native Wallet",
description: "Demo RN Wallet to interface with Dapps",
url: "www.reown.com/walletkit",
icons: ["https://your_wallet_icon.png"],
redirect: {
native: "yourwalletscheme://",
universal: "https://example.com/example_wallet",
linkMode: true,
},
},
});
To enable universal links for your app, refer to React Native Documentation.
After following the steps provided in the official guide:
- Ensure that you handle incoming Universal Links in the your
AppDelegate.mm file.
#import <React/RCTLinkingManager.h>
// Enable deeplinks
- (BOOL)application:(UIApplication *)application
openURL:(NSURL *)url
options:(NSDictionary<UIApplicationOpenURLOptionsKey,id> *)options
{
return [RCTLinkingManager application:application openURL:url options:options];
}
// Enable Universal Links
- (BOOL)application:(UIApplication *)application continueUserActivity:(nonnull NSUserActivity *)userActivity
restorationHandler:(nonnull void (^)(NSArray<id<UIUserActivityRestoring>> * _Nullable))restorationHandler
{
return [RCTLinkingManager application:application
continueUserActivity:userActivity
restorationHandler:restorationHandler];
}
- Open your project in XCode and go to
Settings/Signing & Capabilities/Associated Domains to add the new domain. After this, your_project.entitlement should look like this:
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>com.apple.developer.associated-domains</key>
<array>
<string>applinks:example.com</string>
</array>
</dict>
</plist>
- Update/Create your domain’s
.well-known/apple-app-site-association file accordingly.
For more information about supporting universal links, visit the Supporting associated domains pageFor a debugging guide, visit the Debugging Universal Links page.
Android Studio provides a tool to configure Universal Links easily, you can read the guide in Android DocumentationAfter following the steps provided in the guide:
- Ensure that your Universal Link is properly configured in your app’s
AndroidManifest.xml file with the autoVerify set to true. It should look similar to this:
<intent-filter android:autoVerify="true">
<action android:name="android.intent.action.VIEW" />
<category android:name="android.intent.category.DEFAULT" />
<category android:name="android.intent.category.BROWSABLE" />
<data android:scheme="https" />
<data android:host="example.com" />
<data android:pathPattern="/example_wallet" />
</intent-filter>
- Update/Create your domains’s
.well-known/assetlinks.json file accordingly
For more information on how to configure universal links for your app, refer to Android Documentation.
For testing the configured universal link to app content check this documentation page.
