toss-expo-sdk 0.1.0

package/lib/module/client/TossClient.js

@@ -0,0 +1,324 @@
+"use strict";
+
+import { Connection, PublicKey } from '@solana/web3.js';
+import { createIntent } from "../intent.js";
+import { secureStoreIntent, getSecureIntent, getAllSecureIntents } from "../storage/secureStorage.js";
+import { processIntentsForSync } from "../intentManager.js";
+import { TossError, NetworkError, StorageError, ERROR_CODES } from "../errors.js";
+import { createNonceAccount, getNonce } from "../utils/nonceUtils.js";
+import { useWallet } from "../contexts/WalletContext.js";
+import { syncToChain, checkSyncStatus } from "../sync.js";
+import { detectConflicts, getReconciliationState } from "../reconciliation.js";
+const DEFAULT_RETRY_OPTIONS = {
+  maxRetries: 3,
+  retryDelay: 1000 // 1 second
+};
+export class TossClient {
+  static createClient(config) {
+    return new TossClient(config);
+  }
+  constructor(config) {
+    this.config = {
+      projectId: config.projectId,
+      mode: config.mode || 'devnet',
+      privateTransactions: config.privateTransactions || false,
+      provider: config.provider,
+      sync: config.sync || {
+        syncBackupDb: false
+      },
+      rpcUrl: config.rpcUrl || this.getDefaultRpcUrl(config.mode || 'devnet'),
+      maxRetries: config.maxRetries ?? DEFAULT_RETRY_OPTIONS.maxRetries,
+      retryDelay: config.retryDelay ?? DEFAULT_RETRY_OPTIONS.retryDelay,
+      feePayer: config.feePayer
+    };
+    this.connection = new Connection(this.config.rpcUrl, 'confirmed');
+    this.walletContext = useWallet();
+    if (!this.walletContext) {
+      throw new Error('TossClient must be used within a WalletProvider');
+    }
+  }
+  getDefaultRpcUrl(network) {
+    const urls = {
+      'devnet': 'https://api.devnet.solana.com',
+      'testnet': 'https://api.testnet.solana.com',
+      'mainnet-beta': 'https://api.mainnet-beta.solana.com'
+    };
+    return urls[network] || urls.devnet;
+  }
+  async withRetry(fn, context) {
+    let lastError = null;
+    const {
+      maxRetries,
+      retryDelay
+    } = this.config;
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+      try {
+        return await fn();
+      } catch (error) {
+        lastError = error;
+
+        // Don't retry on validation errors
+        if (error instanceof TossError) {
+          throw error;
+        }
+
+        // Exponential backoff
+        if (attempt < maxRetries) {
+          const delay = retryDelay * Math.pow(2, attempt - 1);
+          await new Promise(resolve => setTimeout(resolve, delay));
+        }
+      }
+    }
+    throw new NetworkError(`Failed after ${maxRetries} attempts: ${lastError?.message}`, {
+      context,
+      cause: lastError
+    });
+  }
+
+  /**
+   * Initialize a nonce account for durable transactions
+   * @param amount SOL amount to fund the nonce account with (default: 1 SOL)
+   * @returns Object containing nonce account and authority public keys
+   */
+  async initializeNonceAccount(amount = 1) {
+    if (!this.config.feePayer) {
+      throw new Error('Fee payer keypair is required for nonce account creation');
+    }
+    const {
+      nonceAccount,
+      nonceAuth
+    } = await createNonceAccount(this.connection, this.config.feePayer, undefined, amount * 1e9 // Convert SOL to lamports
+    );
+    this.nonceAccount = nonceAccount;
+    this.nonceAuth = nonceAuth;
+    return {
+      nonceAccount: nonceAccount.publicKey.toBase58(),
+      nonceAuth: nonceAuth.toBase58()
+    };
+  }
+
+  /**
+   * Get the current nonce value from the nonce account
+   * @returns The current nonce value as a base58 string
+   */
+  async getCurrentNonce() {
+    if (!this.nonceAccount) {
+      throw new Error('Nonce account not initialized. Call initializeNonceAccount() first.');
+    }
+    return getNonce(this.connection, this.nonceAccount.publicKey);
+  }
+  async createIntent(sender, recipient, amount, feePayer, options = {}) {
+    return this.withRetry(async () => {
+      try {
+        if (!this.connection) {
+          throw new TossError('Connection not initialized', ERROR_CODES.NETWORK_ERROR);
+        }
+
+        // Handle 'current' sender to use the wallet context
+        const senderKeypair = sender === 'current' ? this.walletContext.keypair : sender;
+        if (!senderKeypair) {
+          throw new TossError('No sender keypair provided and no wallet is connected', ERROR_CODES.SIGNATURE_VERIFICATION_FAILED);
+        }
+
+        // Convert string addresses to PublicKey if needed
+        const recipientPubkey = typeof recipient === 'string' ? new PublicKey(recipient) : recipient;
+        const feePayerPubkey = feePayer ? typeof feePayer === 'string' ? new PublicKey(feePayer) : feePayer : senderKeypair.publicKey;
+
+        // Set up nonce account and auth if using durable nonce
+        if (options.useDurableNonce && this.nonceAccount && this.nonceAuth) {
+          // nonce account and auth are passed via options to createIntent
+        }
+
+        // Get the latest blockhash (no need to store it as it's handled internally)
+        await this.connection.getLatestBlockhash();
+        const intent = await createIntent(senderKeypair, recipientPubkey, amount, this.connection, {
+          ...options,
+          feePayer: feePayerPubkey,
+          nonceAccount: options.useDurableNonce ? this.nonceAccount : undefined,
+          nonceAuth: options.useDurableNonce ? this.nonceAuth : undefined
+        });
+        await secureStoreIntent(intent);
+        return intent;
+      } catch (error) {
+        if (error instanceof TossError) throw error;
+        throw new TossError('Failed to create intent', ERROR_CODES.TRANSACTION_FAILED, {
+          cause: error
+        });
+      }
+    }, 'createIntent');
+  }
+  async getIntents() {
+    return this.withRetry(async () => {
+      try {
+        return await getAllSecureIntents();
+      } catch (error) {
+        if (error instanceof TossError) throw error;
+        throw new StorageError('Failed to retrieve intents', {
+          cause: error
+        });
+      }
+    }, 'getIntents');
+  }
+  async updateIntentStatus(intentId, status, error) {
+    return this.withRetry(async () => {
+      try {
+        const intent = await getSecureIntent(intentId);
+        if (!intent) return null;
+
+        // Ensure updatedAt is a number (timestamp)
+        const updatedAt = Date.now();
+        const updatedIntent = {
+          ...intent,
+          status,
+          updatedAt,
+          ...(error ? {
+            error
+          } : {})
+        };
+        await secureStoreIntent(updatedIntent);
+        return updatedIntent;
+      } catch (error) {
+        if (error instanceof TossError) throw error;
+        throw new StorageError('Failed to update intent status', {
+          cause: error,
+          intentId,
+          status
+        });
+      }
+    }, 'updateIntentStatus');
+  }
+  async sync() {
+    return this.withRetry(async () => {
+      try {
+        const intents = await getAllSecureIntents();
+        if (!this.config.sync?.syncBackupDb || !this.config.sync.dbUrl) {
+          return intents;
+        }
+
+        // Process intents for sync and update their statuses
+        const processedIntents = await processIntentsForSync(intents, this.connection);
+
+        // Save updated intents
+        await Promise.all(processedIntents.map(intent => secureStoreIntent(intent)));
+        return processedIntents;
+      } catch (error) {
+        if (error instanceof TossError) throw error;
+        throw new NetworkError('Failed to sync intents', {
+          cause: error
+        });
+      }
+    }, 'sync');
+  }
+
+  /**
+   * Full synchronisation with Solana blockchain (TOSS Section 9)
+   *
+   * Performs complete reconciliation:
+   * - Detects conflicts with onchain state
+   * - Settles all pending intents
+   * - Updates local state deterministically
+   *
+   * @returns Complete sync results including settlements, conflicts, and final state
+   */
+  async fullSync() {
+    return this.withRetry(async () => {
+      try {
+        return await syncToChain(this.connection, this.config.feePayer?.publicKey);
+      } catch (error) {
+        if (error instanceof TossError) throw error;
+        throw new NetworkError('Full sync failed', {
+          cause: error
+        });
+      }
+    }, 'fullSync');
+  }
+
+  /**
+   * Check synchronisation status without settling
+   *
+   * Lightweight operation to query current reconciliation state
+   * without committing any settlements to the blockchain.
+   */
+  async checkSyncStatus() {
+    return this.withRetry(async () => {
+      return await checkSyncStatus(this.connection);
+    }, 'checkSyncStatus');
+  }
+
+  /**
+   * Detect conflicts between local intents and onchain state
+   *
+   * Useful for monitoring and alerting users to potential issues
+   * before attempting settlement.
+   */
+  async detectIntentConflicts() {
+    return this.withRetry(async () => {
+      return await detectConflicts(this.connection);
+    }, 'detectIntentConflicts');
+  }
+
+  /**
+   * Get current reconciliation state
+   *
+   * Returns summary of processed, failed, and conflicting intents
+   * for UI updates or logging.
+   */
+  async getReconciliationStatus() {
+    return this.withRetry(async () => {
+      return await getReconciliationState(this.connection);
+    }, 'getReconciliationStatus');
+  }
+
+  /**
+   * Create an intent from the current user's wallet
+   */
+  async createUserIntent(recipient, amount, options = {}) {
+    if (!this.walletContext.user) {
+      throw new TossError('No user is currently signed in', ERROR_CODES.SIGNATURE_VERIFICATION_FAILED);
+    }
+
+    // Ensure wallet is unlocked
+    if (!this.walletContext.isUnlocked) {
+      const unlocked = await this.walletContext.unlockWallet();
+      if (!unlocked) {
+        throw new TossError('Wallet is locked', ERROR_CODES.SIGNATURE_VERIFICATION_FAILED);
+      }
+    }
+    const recipientPubkey = typeof recipient === 'string' ? new PublicKey(recipient) : recipient;
+    return this.createIntent('current',
+    // This will use the wallet context's keypair
+    recipientPubkey, amount, this.walletContext.user.wallet.publicKey, {
+      ...options,
+      memo: options.memo || `TOSS transfer to ${recipientPubkey.toBase58()}`
+    });
+  }
+
+  /**
+   * Get the current user's wallet address
+   */
+  getCurrentUserAddress() {
+    return this.walletContext.user?.wallet.publicKey.toString() || null;
+  }
+
+  /**
+   * Check if the wallet is currently unlocked
+   */
+  isWalletUnlocked() {
+    return this.walletContext.isUnlocked;
+  }
+
+  /**
+   * Lock the wallet
+   */
+  async lockWallet() {
+    await this.walletContext.lockWallet();
+  }
+
+  /**
+   * Sign out the current user
+   */
+  async signOut() {
+    await this.walletContext.signOut();
+  }
+}
+//# sourceMappingURL=TossClient.js.map

package/lib/module/client/TossClient.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["Connection","PublicKey","createIntent","secureStoreIntent","getSecureIntent","getAllSecureIntents","processIntentsForSync","TossError","NetworkError","StorageError","ERROR_CODES","createNonceAccount","getNonce","useWallet","syncToChain","checkSyncStatus","detectConflicts","getReconciliationState","DEFAULT_RETRY_OPTIONS","maxRetries","retryDelay","TossClient","createClient","config","constructor","projectId","mode","privateTransactions","provider","sync","syncBackupDb","rpcUrl","getDefaultRpcUrl","feePayer","connection","walletContext","Error","network","urls","devnet","withRetry","fn","context","lastError","attempt","error","delay","Math","pow","Promise","resolve","setTimeout","message","cause","initializeNonceAccount","amount","nonceAccount","nonceAuth","undefined","publicKey","toBase58","getCurrentNonce","sender","recipient","options","NETWORK_ERROR","senderKeypair","keypair","SIGNATURE_VERIFICATION_FAILED","recipientPubkey","feePayerPubkey","useDurableNonce","getLatestBlockhash","intent","TRANSACTION_FAILED","getIntents","updateIntentStatus","intentId","status","updatedAt","Date","now","updatedIntent","intents","dbUrl","processedIntents","all","map","fullSync","detectIntentConflicts","getReconciliationStatus","createUserIntent","user","isUnlocked","unlocked","unlockWallet","wallet","memo","getCurrentUserAddress","toString","isWalletUnlocked","lockWallet","signOut"],"sourceRoot":"../../../src","sources":["client/TossClient.ts"],"mappings":"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","ignoreList":[]}

package/lib/module/client/index.js

@@ -0,0 +1,4 @@
+"use strict";
+
+export * from "./TossClient.js";
+//# sourceMappingURL=index.js.map

package/lib/module/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"names":[],"sourceRoot":"../../../src","sources":["client/index.ts"],"mappings":";;AAAA,cAAc,iBAAc","ignoreList":[]}

package/lib/module/contexts/WalletContext.js

@@ -0,0 +1,99 @@
+"use strict";
+
+import { createContext, useContext, useState, useEffect } from 'react';
+import { AuthService } from "../services/authService.js";
+import { jsx as _jsx } from "react/jsx-runtime";
+const WalletContext = /*#__PURE__*/createContext(undefined);
+export const WalletProvider = ({
+  children
+}) => {
+  const [isInitialized, setIsInitialized] = useState(false);
+  const [isUnlocked, setIsUnlocked] = useState(false);
+  const [user, setUser] = useState(null);
+  const [keypair, setKeypair] = useState(null);
+  useEffect(() => {
+    const checkAuth = async () => {
+      try {
+        const session = await AuthService.getSession();
+        if (session) {
+          // In a real app, you'd fetch the user from your backend
+          const {
+            user
+          } = await AuthService.signInWithWallet(session.walletAddress);
+          setUser(user);
+          setIsUnlocked(await AuthService.isWalletUnlocked());
+        }
+      } catch (error) {
+        console.error('Auth check failed:', error);
+      } finally {
+        setIsInitialized(true);
+      }
+    };
+    checkAuth();
+  }, []);
+  const unlockWallet = async () => {
+    try {
+      // Biometric authentication REQUIRED - throws if not authorized
+      const unlockedKeypair = await AuthService.unlockWalletWithBiometrics();
+      if (unlockedKeypair) {
+        // Keypair held ONLY in React state memory (NOT persisted to disk)
+        setKeypair(unlockedKeypair);
+        setIsUnlocked(true);
+        return true;
+      }
+      return false;
+    } catch (error) {
+      console.error('Biometric authentication failed:', error);
+      setIsUnlocked(false);
+      setKeypair(null);
+      return false;
+    }
+  };
+  const lockWallet = async () => {
+    // Clear keypair from memory (from React state)
+    // Encrypted keypair remains stored securely (requires biometric to re-unlock)
+    setKeypair(null);
+    setIsUnlocked(false);
+  };
+  const signIn = async (walletAddress, isTemporary = false) => {
+    const {
+      user
+    } = await AuthService.signInWithWallet(walletAddress, isTemporary);
+    setUser(user);
+    setIsUnlocked(true);
+  };
+  const signOut = async () => {
+    // Clear session from storage
+    await AuthService.signOut();
+
+    // Clear all memory (state)
+    setUser(null);
+    setKeypair(null); // Remove from RAM
+    setIsUnlocked(false);
+
+    // NOTE: Encrypted keypair remains in SecureStore
+    // It can only be accessed again with biometric authentication
+  };
+  return /*#__PURE__*/_jsx(WalletContext.Provider, {
+    value: {
+      isInitialized,
+      isUnlocked,
+      user,
+      keypair,
+      unlockWallet,
+      lockWallet,
+      signIn,
+      signOut
+    },
+    children: children
+  });
+};
+export const useWallet = () => {
+  const context = useContext(WalletContext);
+  if (context === undefined) {
+    throw new Error('useWallet must be used within a WalletProvider');
+  }
+  return context;
+};
+export default WalletContext;
+//# sourceMappingURL=WalletContext.js.map

package/lib/module/contexts/WalletContext.js.map

@@ -0,0 +1 @@
+{"version":3,"names":["createContext","useContext","useState","useEffect","AuthService","jsx","_jsx","WalletContext","undefined","WalletProvider","children","isInitialized","setIsInitialized","isUnlocked","setIsUnlocked","user","setUser","keypair","setKeypair","checkAuth","session","getSession","signInWithWallet","walletAddress","isWalletUnlocked","error","console","unlockWallet","unlockedKeypair","unlockWalletWithBiometrics","lockWallet","signIn","isTemporary","signOut","Provider","value","useWallet","context","Error"],"sourceRoot":"../../../src","sources":["contexts/WalletContext.tsx"],"mappings":"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","ignoreList":[]}