npm install @sunnyside-io/privacy-boost-react-native
# or
yarn add @sunnyside-io/privacy-boost-react-native

cd ios && pod install

import { PrivacyBoost, type WalletDelegate } from '@sunnyside-io/privacy-boost-react-native';

const walletDelegate: WalletDelegate = {
  getAddress: async () => wallet.address,
  getChainId: async () => BigInt(wallet.chainId),
  signMessage: async (message: string) => wallet.signMessage(message),
  signTypedData: async (typedDataJson: string) => wallet.signTypedData(typedDataJson),
  sendTransaction: async (toAddress: string, value: string, data: string) =>
    wallet.sendTransaction({ to: toAddress, value, data }),
  waitForTransactionReceipt: async (txHash: string) => {
    const receipt = await wallet.waitForReceipt(txHash);
    return { txHash, status: receipt.status === 1, logs: receipt.logs };
  },
};

import {
  PrivacyBoost,
  PrivacyBoostConfig,
  KeySource,
} from '@sunnyside-io/privacy-boost-react-native';

// 1. Create configuration
const config = PrivacyBoostConfig.create({
  serverUrl: 'https://test-api.privacyboost.io',
  chainId: 10n,
  shieldContractAddress: '0x...',
  wethContractAddress: '0x4200000000000000000000000000000000000006',
  teePublicKey: undefined,
  appId: 'app_abc123xyz',
  persistenceStorage: undefined,
  persistenceUnlock: undefined,
});

// 2. Initialize SDK
const sdk = new PrivacyBoost(config);

// 3. Authenticate
const authResult = await sdk.authenticate(
  walletDelegate,
  new KeySource.WalletDerived(),
  undefined,
);
switch (authResult.tag) {
  case 'Authenticated':
    console.log('Privacy address:', authResult.loginResult.privacyAddress);
    break;
  case 'MnemonicGenerated':
    // First-time user — display the mnemonic, confirm the user saved it,
    // then proceed.
    await confirmMnemonicSaved(authResult.mnemonic);
    const newLogin = await sdk.proceedAfterMnemonic(undefined, undefined);
    console.log('Privacy address:', newLogin.privacyAddress);
    break;
  case 'CredentialRequired': {
    // Prompt the user for their PIN / password, then submit it.
    const pin = await promptUserForPin(authResult.challenge);
    const loginResult = await sdk.submitCredential(pin, undefined);
    console.log('Privacy address:', loginResult.privacyAddress);
    break;
  }
  case 'RecoveryRequired':
    // Local keys are missing but an account exists — prompt for the
    // recovery mnemonic and re-authenticate with new KeySource.Mnemonic(...).
    console.log('Recovery needed:', authResult.challenge);
    break;
}

// 4. Check balance
const balance = await sdk.getBalance('0x...');
console.log('Shielded:', balance.shieldedBalance);

// 5. Deposit
const shieldResult = await sdk.shield('0x...', '1000000000000000000'); // 1 token
console.log('Deposit tx:', shieldResult.txHash, 'requestId:', shieldResult.requestId);

// 6. Transfer
const transferResult = await sdk.send(
  '0x...',
  '500000000000000000',
  '0x04...recipient-privacy-address',
);
console.log('Transfer tx:', transferResult.txHash);

// 7. Withdraw
const unshieldResult = await sdk.unshield(
  '0x...',
  '250000000000000000',
  '0x...',
);
console.log('Withdraw tx:', unshieldResult.txHash);

import React, { useState, useCallback } from 'react';
import { View, Text, Button } from 'react-native';
import { PrivacyBoost, PrivacyBoostConfig } from '@sunnyside-io/privacy-boost-react-native';

function WalletScreen() {
  const [isAuthenticated, setIsAuthenticated] = useState(false);
  const [privacyAddress, setPrivacyAddress] = useState<string | null>(null);
  const [sdk] = useState(() => new PrivacyBoost(
    PrivacyBoostConfig.create({
      serverUrl: 'https://test-api.privacyboost.io',
      chainId: undefined,
      shieldContractAddress: undefined,
      wethContractAddress: '0x4200000000000000000000000000000000000006',
      teePublicKey: undefined,
      appId: 'app_abc123xyz',
      persistenceStorage: undefined,
      persistenceUnlock: undefined,
    })
  ));

  const authenticate = useCallback(async () => {
    try {
      const result = await sdk.authenticate(walletDelegate, undefined, undefined);
      if (result.tag === 'Authenticated') {
        setPrivacyAddress(result.loginResult.privacyAddress);
        setIsAuthenticated(true);
      }
      // Other variants (MnemonicGenerated, CredentialRequired, RecoveryRequired)
      // need their own handling — see the Quick Example above.
    } catch (error) {
      console.error('Authentication failed:', error);
    }
  }, [sdk]);

  const deposit = useCallback(async () => {
    try {
      await sdk.shield('0x...', '1000000000000000000');
    } catch (error) {
      console.error('Deposit failed:', error);
    }
  }, [sdk]);

  const clearSession = useCallback(() => {
    sdk.clearSession();
    setIsAuthenticated(false);
    setPrivacyAddress(null);
  }, [sdk]);

  if (isAuthenticated) {
    return (
      <View>
        <Text>Privacy Address:</Text>
        <Text style={{ fontSize: 10 }}>{privacyAddress}</Text>
        <Button title="Deposit 1 Token" onPress={deposit} />
        <Button title="Clear Session" onPress={clearSession} />
      </View>
    );
  }

  return (
    <View>
      <Button title="Connect Wallet" onPress={authenticate} />
    </View>
  );
}