{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"PERS SDK React Native Introduction"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"pers-sdk-react-native-introduction","__idx":0},"children":["PERS SDK React Native Introduction"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The PERS React Native SDK provides authentication, token, campaign, and redemption operations for React Native apps, with native passkey (WebAuthn) support and on-device blockchain transaction signing. It wraps the same Manager-Service architecture as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["@explorins/pers-sdk"]},", exposed through React hooks and a context provider."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"what-is-pers","__idx":1},"children":["What is PERS?"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["PERS is a SaaS tokenization and loyalty infrastructure. The React Native SDK provides access to:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Authentication"]}," - Passkey (WebAuthn) login with device biometrics, secure token storage"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Token Operations"]}," - Balance queries, transfers, on-chain reads"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Campaign Management"]}," - Campaign discovery, claims, triggers"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Redemptions"]}," - Reward redemption with automatic blockchain signing when required"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Business Operations"]}," - Merchant and partner integrations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Transaction Signing"]}," - Native ECDSA signing via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["react-native-quick-crypto"]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"installation","__idx":2},"children":["Installation"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"npm install @explorins/pers-sdk-react-native\nnpm install @react-native-async-storage/async-storage\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Native dependencies (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["react-native-quick-crypto"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["react-native-keychain"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["react-native-passkey"]},") install automatically but require a native rebuild (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["npx expo run:android"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["pod install"]},"). Metro must have ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unstable_enablePackageExports = true"]}," — see the package README for full setup and Android New Architecture requirements."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"quick-start","__idx":3},"children":["Quick Start"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"1-set-up-the-provider","__idx":4},"children":["1. Set up the Provider"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"import React from 'react';\nimport { PersSDKProvider } from '@explorins/pers-sdk-react-native';\n\nexport default function App() {\n  return (\n    <PersSDKProvider config={{\n      apiUrl: 'https://api.pers.ninja',\n      tenantId: 'your-tenant-id' // Optional\n    }}>\n      <NavigationContainer>\n        <YourAppContent />\n      </NavigationContainer>\n    </PersSDKProvider>\n  );\n}\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"2-authentication--token-operations","__idx":5},"children":["2. Authentication & Token Operations"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"typescript","header":{"controls":{"copy":{}}},"source":"import { useAuth, useTokens, useRedemptions, useTransactionSigner } from '@explorins/pers-sdk-react-native';\n\nfunction RewardScreen() {\n  const { user, isAuthenticated, login } = useAuth();\n  const { getTokens } = useTokens();\n  const { redeem } = useRedemptions();\n\n  if (!isAuthenticated) return <LoginScreen onLogin={login} />;\n\n  return <YourRewardUI user={user} onRedeem={redeem} />;\n}\n","lang":"typescript"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"architecture-overview","__idx":6},"children":["Architecture Overview"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Same Manager-Service pattern as the core SDK, exposed via hooks:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["useAuth"]}," - Authentication and user sessions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["useUsers"]}," - User profile management"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["useTokens"]}," / ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["useTokenBalances"]}," - Token operations and on-chain balances"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["useCampaigns"]}," - Marketing campaigns"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["useRedemptions"]}," - Reward redemptions"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["useTransactions"]}," - Transaction history"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["usePurchases"]}," - Purchase and payment processing"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["useTriggerSources"]}," - Campaign trigger sources"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["useWeb3"]}," - Blockchain operations"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["useTransactionSigner"]}," - Native transaction signing (passkey-backed)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"critical-setup-passkeys","__idx":7},"children":["Critical Setup: Passkeys"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["To enable Passkey authentication (WebAuthn) on iOS and Android, register your app with the PERS backend (contact ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["support@explorins.com"]}," with your Bundle ID/Apple Team ID or Package Name/SHA-256 fingerprint) and configure native files per the Passkey Setup Guide. Use development builds with Expo, not Expo Go."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related-packages","__idx":8},"children":["Related Packages"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.npmjs.com/package/@explorins/pers-sdk"},"children":["@explorins/pers-sdk"]}]}," - Platform-agnostic core SDK. Use this for web/Node.js instead of this package."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.npmjs.com/package/@explorins/pers-shared"},"children":["@explorins/pers-shared"]}]}," - Shared types, interfaces, and DTOs used across the PERS ecosystem (required peer dependency)"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"support-and-resources","__idx":9},"children":["Support and Resources"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Package"]},": ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://www.npmjs.com/package/@explorins/pers-sdk-react-native"},"children":["npm package"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Platform Documentation"]},": ",{"$$mdtype":"Tag","name":"MarkdownLink","attributes":{"href":"https://docs.pers.ninja/1.intro"},"children":["PERS Platform Docs"]}]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Support"]},": Contact support@explorins.com for issues and feature requests"]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"license","__idx":10},"children":["License"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["MIT License - See package for full license details."]}]},"headings":[{"value":"PERS SDK React Native Introduction","id":"pers-sdk-react-native-introduction","depth":1},{"value":"What is PERS?","id":"what-is-pers","depth":2},{"value":"Installation","id":"installation","depth":2},{"value":"Quick Start","id":"quick-start","depth":2},{"value":"1. Set up the Provider","id":"1-set-up-the-provider","depth":3},{"value":"2. Authentication & Token Operations","id":"2-authentication--token-operations","depth":3},{"value":"Architecture Overview","id":"architecture-overview","depth":2},{"value":"Critical Setup: Passkeys","id":"critical-setup-passkeys","depth":2},{"value":"Related Packages","id":"related-packages","depth":2},{"value":"Support and Resources","id":"support-and-resources","depth":2},{"value":"License","id":"license","depth":2}],"frontmatter":{"seo":{"title":"PERS SDK React Native Introduction"}},"lastModified":"2026-08-21T18:26:30.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/sdk-intro-react-native","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}