Merge pull request #350 from Grace-CODE-D/feature/react-app-stress-mobile-privacy

Feature/react app stress mobile privacy

Author: Mystery-CLI

app/package.json

@@ -11,6 +11,10 @@
   "dependencies": {
     "@stellar-escrow/components": "*",
     "@stellar-escrow/state": "*",
+    "@emotion/react": "^11.11.3",
+    "@emotion/styled": "^11.11.0",
+    "@mui/icons-material": "^5.15.3",
+    "@mui/material": "^5.15.3",
     "@reduxjs/toolkit": "^1.9.7",
     "react": "^18.2.0",
     "react-dom": "^18.2.0",

app/src/App.tsx

@@ -1,29 +1,38 @@
-import { Routes, Route, NavLink } from 'react-router-dom';
+import { Routes, Route } from 'react-router-dom';
+import { AppBar, Toolbar, Typography, Button, Box, Container } from '@mui/material';
+import { NavLink } from 'react-router-dom';
 import Dashboard from './pages/Dashboard';
 import TradeDetail from './pages/TradeDetail';
 import CreateTrade from './pages/CreateTrade';
 import { ErrorBoundary } from './ErrorBoundary';
-import './App.css';
 
 export default function App() {
   return (
     <ErrorBoundary>
-      <div className="app">
-        <nav className="nav">
-          <span className="nav-brand">StellarEscrow</span>
-          <NavLink to="/" end>Dashboard</NavLink>
-          <NavLink to="/trades/new">New Trade</NavLink>
-        </nav>
-        <main className="main">
+      <Box sx={{ display: 'flex', flexDirection: 'column', minHeight: '100vh' }}>
+        <AppBar position="static" color="primary">
+          <Toolbar sx={{ gap: 2 }}>
+            <Typography variant="h6" sx={{ fontWeight: 700, flexGrow: 1 }}>
+              StellarEscrow
+            </Typography>
+            <Button color="inherit" component={NavLink} to="/" end>
+              Dashboard
+            </Button>
+            <Button color="inherit" component={NavLink} to="/trades/new">
+              New Trade
+            </Button>
+          </Toolbar>
+        </AppBar>
+        <Container component="main" sx={{ flex: 1, py: 4 }}>
           <ErrorBoundary>
             <Routes>
               <Route path="/" element={<Dashboard />} />
               <Route path="/trades/new" element={<CreateTrade />} />
               <Route path="/trades/:id" element={<TradeDetail />} />
             </Routes>
           </ErrorBoundary>
-        </main>
-      </div>
+        </Container>
+      </Box>
     </ErrorBoundary>
   );
 }

app/src/main.tsx

@@ -3,7 +3,9 @@ import ReactDOM from 'react-dom/client';
 import { Provider } from 'react-redux';
 import { PersistGate } from 'redux-persist/integration/react';
 import { BrowserRouter } from 'react-router-dom';
+import { ThemeProvider, CssBaseline } from '@mui/material';
 import { store, persistor } from '@stellar-escrow/state';
+import theme from './theme';
 import App from './App';
 import './index.css';
 
@@ -12,7 +14,10 @@ ReactDOM.createRoot(document.getElementById('root')!).render(
     <Provider store={store}>
       <PersistGate loading={null} persistor={persistor}>
         <BrowserRouter>
-          <App />
+          <ThemeProvider theme={theme}>
+            <CssBaseline />
+            <App />
+          </ThemeProvider>
         </BrowserRouter>
       </PersistGate>
     </Provider>

app/src/theme.ts

@@ -0,0 +1,20 @@
+import { createTheme } from '@mui/material/styles';
+
+const theme = createTheme({
+  palette: {
+    primary: { main: '#1a1a2e' },
+    secondary: { main: '#e94560' },
+    background: { default: '#f5f5f5' },
+  },
+  typography: {
+    fontFamily: "-apple-system, BlinkMacSystemFont, 'Segoe UI', sans-serif",
+  },
+  components: {
+    MuiButton: {
+      defaultProps: { disableElevation: true },
+      styleOverrides: { root: { textTransform: 'none', borderRadius: 6 } },
+    },
+  },
+});
+
+export default theme;

contract/STRESS_TESTING.md

@@ -5,9 +5,14 @@ Validates StellarEscrow contract performance under load using Soroban's built-in
 ## Running
 
 ```bash
-cd contract
+# Automated runner (from repo root) — runs all tests and prints a summary
+./scripts/stress-test.sh
+
+# Release build (faster execution, closer to production)
+./scripts/stress-test.sh --release
 
-# All stress tests with output
+# Directly via cargo
+cd contract
 cargo test --test stress -- --nocapture
 
 # Single scenario

contract/src/privacy.rs

@@ -86,3 +86,46 @@ pub fn get_grant(
     get_disclosure_grant(env, trade_id, grantee)
         .ok_or(ContractError::DisclosureGrantNotFound)
 }
+
+/// Check whether a trade has privacy settings configured.
+pub fn has_privacy(env: &Env, trade_id: u64) -> bool {
+    get_trade_privacy(env, trade_id).is_some()
+}
+
+/// Check whether a specific grantee has an active disclosure grant for a trade.
+pub fn has_disclosure_grant(env: &Env, trade_id: u64, grantee: &Address) -> bool {
+    get_disclosure_grant(env, trade_id, grantee).is_some()
+}
+
+/// Verify that a data hash matches the stored privacy commitment.
+/// Returns `Ok(true)` if the hash matches, `Ok(false)` if it doesn't,
+/// or `Err(DisclosureGrantNotFound)` if no privacy record exists.
+pub fn verify_data_hash(
+    env: &Env,
+    trade_id: u64,
+    claimed_hash: &String,
+) -> Result<bool, ContractError> {
+    let privacy = get_trade_privacy(env, trade_id)
+        .ok_or(ContractError::DisclosureGrantNotFound)?;
+    Ok(privacy.data_hash == *claimed_hash)
+}
+
+/// Privacy compliance check: ensure a trade has a privacy record before
+/// allowing sensitive operations (e.g. private arbitration).
+/// Returns `Err(DisclosureUnauthorized)` if private_arbitration is requested
+/// but no privacy record has been set.
+pub fn require_privacy_compliance(
+    env: &Env,
+    trade_id: u64,
+    requires_private_arbitration: bool,
+) -> Result<(), ContractError> {
+    if !requires_private_arbitration {
+        return Ok(());
+    }
+    let privacy = get_trade_privacy(env, trade_id)
+        .ok_or(ContractError::DisclosureUnauthorized)?;
+    if !privacy.private_arbitration {
+        return Err(ContractError::DisclosureUnauthorized);
+    }
+    Ok(())
+}

mobile-sdk/src/flows.rs

@@ -0,0 +1,121 @@
+/// Mobile-optimized transaction flows for common escrow operations.
+///
+/// Each flow bundles the steps a mobile user takes into a single function:
+/// build → (optionally queue offline) → sign → submit.
+use crate::error::MobileSdkError;
+use crate::offline_queue::OfflineQueue;
+use crate::signing::sign_transaction;
+use crate::transaction_builder::{
+    build_cancel_trade, build_confirm_receipt, build_fund_trade, build_raise_dispute,
+};
+use crate::types::{QueuedTransaction, SignedTransaction};
+
+/// Result of a mobile flow step.
+pub enum FlowResult {
+    /// Transaction was signed and is ready for submission.
+    Ready(SignedTransaction),
+    /// Device is offline; transaction was queued for later.
+    Queued(String),
+}
+
+/// Fund a trade: build + sign in one call.
+/// If `secret_key_hex` is provided, signs immediately (offline-capable).
+/// If the device is offline (`is_online = false`), queues instead.
+pub fn flow_fund_trade(
+    contract_id: &str,
+    trade_id: u64,
+    sequence: i64,
+    network_passphrase: &str,
+    secret_key_hex: &str,
+    is_online: bool,
+    queue: &mut OfflineQueue,
+) -> Result<FlowResult, MobileSdkError> {
+    let unsigned = build_fund_trade(contract_id, trade_id, sequence, network_passphrase)?;
+
+    if !is_online {
+        let queued_id = format!("fund_trade_{trade_id}_{sequence}");
+        queue.enqueue(QueuedTransaction {
+            id: queued_id.clone(),
+            unsigned_xdr: unsigned.xdr,
+            operation: format!("fund_trade:{trade_id}"),
+            created_at: 0, // caller should set epoch seconds
+        });
+        return Ok(FlowResult::Queued(queued_id));
+    }
+
+    let signed = sign_transaction(&unsigned, secret_key_hex)?;
+    Ok(FlowResult::Ready(signed))
+}
+
+/// Confirm receipt: build + sign in one call.
+pub fn flow_confirm_receipt(
+    contract_id: &str,
+    trade_id: u64,
+    sequence: i64,
+    network_passphrase: &str,
+    secret_key_hex: &str,
+    is_online: bool,
+    queue: &mut OfflineQueue,
+) -> Result<FlowResult, MobileSdkError> {
+    let unsigned = build_confirm_receipt(contract_id, trade_id, sequence, network_passphrase)?;
+
+    if !is_online {
+        let queued_id = format!("confirm_receipt_{trade_id}_{sequence}");
+        queue.enqueue(QueuedTransaction {
+            id: queued_id.clone(),
+            unsigned_xdr: unsigned.xdr,
+            operation: format!("confirm_receipt:{trade_id}"),
+            created_at: 0,
+        });
+        return Ok(FlowResult::Queued(queued_id));
+    }
+
+    let signed = sign_transaction(&unsigned, secret_key_hex)?;
+    Ok(FlowResult::Ready(signed))
+}
+
+/// Raise dispute: build + sign in one call.
+pub fn flow_raise_dispute(
+    contract_id: &str,
+    trade_id: u64,
+    sequence: i64,
+    network_passphrase: &str,
+    secret_key_hex: &str,
+) -> Result<SignedTransaction, MobileSdkError> {
+    let unsigned = build_raise_dispute(contract_id, trade_id, sequence, network_passphrase)?;
+    sign_transaction(&unsigned, secret_key_hex)
+}
+
+/// Cancel trade: build + sign in one call.
+pub fn flow_cancel_trade(
+    contract_id: &str,
+    trade_id: u64,
+    sequence: i64,
+    network_passphrase: &str,
+    secret_key_hex: &str,
+) -> Result<SignedTransaction, MobileSdkError> {
+    let unsigned = build_cancel_trade(contract_id, trade_id, sequence, network_passphrase)?;
+    sign_transaction(&unsigned, secret_key_hex)
+}
+
+/// Drain the offline queue and return signed transactions ready for submission.
+/// Call this when connectivity is restored.
+pub fn flush_offline_queue(
+    queue: &mut OfflineQueue,
+    secret_key_hex: &str,
+    network_passphrase: &str,
+) -> Vec<Result<SignedTransaction, MobileSdkError>> {
+    queue
+        .drain()
+        .into_iter()
+        .map(|queued| {
+            let unsigned = crate::types::UnsignedTransaction {
+                xdr: queued.unsigned_xdr,
+                network_passphrase: network_passphrase.to_string(),
+                fee: 100,
+                sequence: 0,
+            };
+            sign_transaction(&unsigned, secret_key_hex)
+        })
+        .collect()
+}

mobile-sdk/src/lib.rs

@@ -1,7 +1,9 @@
 pub mod error;
+pub mod flows;
 pub mod mobile_error;
 pub mod offline_queue;
 pub mod push_notifications;
 pub mod signing;
 pub mod transaction_builder;
 pub mod types;
+pub mod wallet;