@meshconnect/react-native-link-sdk
v2.1.9
Published
Mesh Connect React Native SDK.
Downloads
1,747
Readme
Mesh Connect React Native SDK
React Native library for integrating with Mesh Connect.
Installation
With npm
:
npm install --save @meshconnect/react-native-link-sdk
With yarn
:
yarn add @meshconnect/react-native-link-sdk
💡 This package requires react-native-webview
to be installed in your project. Some times it is not installed automatically (This is a known npm issue). You should install it manually via following command in this case:
npm install --save react-native-webview
# or with yarn
yarn add react-native-webview
Get Link token
Link token should be obtained from the POST /api/v1/linktoken endpoint. API reference for this request is available here. The request must be performed from the server side because it requires the client's secret. You will get the response in the following format:
{
"content": {
"linkToken": "{linkToken}"
},
"status": "ok",
"message": ""
}
Launch Link
import React from 'react';
import {
LinkConnect,
LinkPayload,
LinkSettings,
LinkEventType,
IntegrationAccessToken,
TransferFinishedPayload,
TransferFinishedSuccessPayload,
TransferFinishedErrorPayload
} from '@meshconnect/react-native-link-sdk';
const accessTokens: IntegrationAccessToken = [
/* Your access tokens */
];
const transferDestinationTokens: IntegrationAccessToken = [
/* Your transfer destination tokens */
];
const linkSettings: LinkSettings = {
accessTokens,
transferDestinationTokens,
};
export const App = () => {
return (
<LinkConnect
linkToken={"YOUR_LINKTOKEN"}
settings={linkSettings}
onIntegrationConnected={(payload: LinkPayload) => {
// use broker account data
}}
onTransferFinished={(payload: TransferFinishedPayload) => {
if (payload.status === 'success') {
const successPayload = payload as TransferFinishedSuccessPayload
// use transfer finished data
} else {
const errorPayload = payload as TransferFinishedErrorPayload
// handle transfer error
}
}}
onEvent={(event: LinkEventType) => {
console.log(event);
}}
onExit={(err?: string) => {
// use error message
}}
/>
)
}
export default App;
ℹ️ See full source code examples at examples/.
LinkConnect
component arguments
| key | type | Required/Optional | description |
|---------------------------|-------------------------------------------------|-------------------|------------------------------------------------------------|
| linkToken
| string
| required | Link token |
| settings
| LinkSettings
| optional | Settings object |
| disableDomainWhiteList
| boolean
| optional | Disable origin whitelisting[1] |
| onIntegrationConnected
| (payload: LinkPayload) => void
| optional | Callback called when users connects their accounts |
| onTransferFinished
| (payload: TransferFinishedPayload) => void
| optional | Callback called when a crypto transfer is executed |
| onExit
| (err: string) => void)
| optional | Called if connection not happened. Returns an error message |
| onEvent
| (event: LinkEventType) => void
| optional | Callback called when an event is triggered |
The LinkSettings
option allows to configure the Link behaviour:
accessTokens
- an array ofIntegrationAccessToken
objects that is used as an origin for crypto transfer flow.transferDestinationTokens
- an array ofIntegrationAccessToken
objects that is used as a destination for crypto transfer flow.disableDomainWhiteList
- a boolean flag that allows to disable origin whitelisting. By default, the origin is whitelisted, with the following domains set:*.meshconnect.com
*.getfront.com
*.walletconnect.com
*.walletconnect.org
*.walletlink.org
*.coinbase.com
*.okx.com
*.gemini.com
*.coinbase.com
*.hcaptcha.com
*.robinhood.com
*.google.com
https://meshconnect.com
https://getfront.com
https://walletconnect.com
https://walletconnect.org
https://walletlink.org
https://coinbase.com
https://okx.com
https://gemini.com
https://coinbase.com
https://hcaptcha.com
https://robinhood.com
https://google.com
https://front-web-platform-dev
https://front-b2b-api-test.azurewebsites.net
https://web.getfront.com
https://web.meshconnect.com
https://applink.robinhood.com
https://m.stripe.network
https://js.stripe.com
https://app.usercentrics.eu
robinhood://
V1 -> V2 migration guide
In Mesh Connect React Native SDK v2, url
prop is removed from LinkConnect
component. You should use linkToken
prop instead of url
prop.
orError
and onClose
props are combined with onExit
callback with an optional error message argument.
Following are the renamed props:
onBrokerConnected
->onIntegrationConnected
FrontPayload
->LinkPayload
The component FrontFinance
is renamed to LinkConnect
.
Typescript support
Typescript definitions for @meshconnect/react-native-link-sdk
are built into the npm package.
Adding URL Schemes to Info.plist
To enable our SDK to interact with specific apps, please add the following URL schemes to your Info.plist file:
- Open your Info.plist file: This file is located in the ios directory of your React Native project.
- Add the following XML snippet within the
<dict>
tags (example for adding trust, robinhood, and metamask):<key>LSApplicationQueriesSchemes</key> <array> <string>trust</string> <string>robinhood</string> <string>metamask</string> </array>
This configuration allows our SDK to query and interact with the specified apps, ensuring seamless integration and functionality.