Quick Start

1

Install

Add the SDK to your project

2

Initialize

Configure at app startup

3

Verify

Call verify() on sensitive actions

1. Install

React Native

npm install @surtai/guardian-rn
cd ios && pod install && cd ..

iOS

In Xcode: File → Add Package Dependencies → enter https://github.com/surtTech/surt-guardian-sdk, version 0.1.0.

Android

build.gradle.kts

dependencies {
    implementation("com.surt.guardian:securitysdk:0.1.0")
}

2. Initialize

React Native

App.tsx

import { GuardianProvider } from '@surtai/guardian-rn';

export default function App() {
  return (
    <GuardianProvider apiKey="YOUR_API_KEY" environment="production">
      <Navigation />
    </GuardianProvider>
  );
}

iOS

AppDelegate.swift

import SurtGuardianSDK

GuardianSDK.initialize(
    apiKey: "YOUR_API_KEY",
    options: GuardianOptions(environment: .production)
)

Android

MyApplication.kt

import com.surt.guardian.GuardianSDK
import com.surt.guardian.core.Environment
import com.surt.guardian.core.GuardianOptions

GuardianSDK.initialize(
    context = this,
    apiKey = "YOUR_API_KEY",
    options = GuardianOptions(environment = Environment.Production)
)

3. Set Customer & Verify

React Native

LoginScreen.tsx

import { useGuardian } from '@surtai/guardian-rn';

function LoginScreen() {
  const { verify, setCustomer } = useGuardian();

  const handleLogin = async () => {
    setCustomer('user_123', 'John Doe', 'john@example.com');

    const result = await verify('login', 'User Login');

    if (result.allowed) {
      // Proceed
    } else {
      // Blocked - check result.riskLevel
    }
  };
}

iOS

GuardianSDK.shared.setCustomer(customerId: "user_123", name: "John Doe", email: "john@example.com")

let result = try await GuardianSDK.shared.verify(transactionType: .login, transactionName: "User Login")

if result.allowed {
    // Proceed
}

Android

GuardianSDK.getInstance().setCustomer(customerId = "user_123", name = "John Doe", email = "john@example.com")

val result = GuardianSDK.getInstance().verifySuspend(
    transactionType = TransactionType.LOGIN,
    transactionName = "User Login"
)

if (result.allowed) {
    // Proceed
}

Next Steps

Choose your platform for the full integration guide:

• React Native
• iOS (Swift)
• Android (Kotlin)