Merge branch 'main' into fix/issue-99-api-testing

Author: Mystery-CLI

.github/workflows/smart-contract-tests.yml

@@ -0,0 +1,54 @@
+name: Smart Contract Tests
+
+on:
+  push:
+    branches: [main, develop]
+  pull_request:
+    branches: [main, develop]
+  workflow_dispatch:
+
+concurrency:
+  group: smart-contract-${{ github.ref }}
+  cancel-in-progress: true
+
+jobs:
+  contract-tests:
+    name: Contract Test Matrix
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - name: Install Rust
+        uses: dtolnay/rust-toolchain@stable
+
+      - uses: Swatinem/rust-cache@v2
+
+      - name: Install cargo-llvm-cov
+        uses: taiki-e/install-action@cargo-llvm-cov
+
+      - name: Edge cases
+        run: cargo test --manifest-path contract/Cargo.toml --test edge_cases
+
+      - name: Security scenarios
+        run: cargo test --manifest-path contract/Cargo.toml --test security
+
+      - name: Integration scenarios
+        run: cargo test --manifest-path contract/Cargo.toml --test integration
+
+      - name: Performance benchmarks
+        run: cargo test --manifest-path contract/Cargo.toml --test performance -- --nocapture
+
+      - name: Stress benchmarks
+        run: cargo test --manifest-path contract/Cargo.toml --test stress -- --nocapture
+
+      - name: Coverage report
+        run: cargo llvm-cov --manifest-path contract/Cargo.toml --workspace --lcov --output-path contract/coverage/lcov.info --html --output-dir contract/coverage/html
+
+      - name: Upload contract coverage
+        uses: actions/upload-artifact@v4
+        if: always()
+        with:
+          name: smart-contract-coverage-${{ github.run_number }}
+          path: contract/coverage/
+          retention-days: 30

PR_DESCRIPTION.md

@@ -0,0 +1,26 @@
+## Summary
+
+- expands the Soroban smart contract suite with dedicated edge case, security, integration, performance, and stress coverage
+- repairs the contract core so the smart contract crate builds and all contract tests pass again
+- adds root test commands, contract testing docs, snapshot artifacts, and a GitHub Actions workflow for contract testing and coverage
+
+## What Changed
+
+- added shared contract test harnesses and new suites under `contract/tests/`
+- restored a working contract implementation in `contract/src/` for escrow, bridge, insurance, pause, compliance, migration, and analytics flows
+- enabled importing the contract crate in integration tests via `rlib`
+- documented the new contract test matrix and commands
+- added `.github/workflows/smart-contract-tests.yml`
+
+## Verification
+
+```bash
+cargo test --manifest-path contract/Cargo.toml
+```
+
+All contract unit, edge, security, integration, performance, and stress tests pass locally.
+
+## Notes
+
+- stress scenarios were tuned to stable CI-safe volumes so the Soroban test host does not hit budget exhaustion during the suite
+- contract snapshots were generated under `contract/test_snapshots/` during verification

README.md

@@ -56,3 +56,17 @@ cargo test  # Backend tests
 docker-compose up  # Indexer + DB
 ```
 
+## Smart Contract Testing
+
+The Soroban contract now has dedicated suites for edge cases, security scenarios, integration flows, stress tests, and performance benchmarks under `contract/tests/`.
+
+```bash
+npm run test:contract
+npm run test:contract:edge
+npm run test:contract:security
+npm run test:contract:integration
+npm run test:contract:performance
+npm run test:contract:stress
+npm run test:contract:coverage
+```
+

TESTING.md

@@ -15,6 +15,7 @@ This project uses a three-tier testing strategy:
 | Scalability | Jest + performance harness | `api/src/**/*.scalability.test.ts` | Throughput and latency trends across concurrency levels |
 | Monitoring | Jest + performance harness | `api/src/**/*.monitoring.test.ts` | Threshold alerts, error-rate visibility, and per-operation telemetry |
 | Security | Jest + scenario harness | `security/src/security.assessment.test.ts` | Penetration tests, vulnerability scans, compliance, monitoring |
+| Smart Contract | Soroban test harness | `contract/tests/*.rs`, `contract/tests/stress.rs` | Contract edge cases, security, integration, stress, benchmarks, coverage |
 | E2E | Cypress | `components/cypress/e2e/` | Full user flows |
 
 ## Running Tests
@@ -41,6 +42,15 @@ npm run test:docs --workspace=api
 npm run test:security
 npm run test:security --workspace=security
 
+# Smart contract suites
+npm run test:contract
+npm run test:contract:edge
+npm run test:contract:security
+npm run test:contract:integration
+npm run test:contract:performance
+npm run test:contract:stress
+npm run test:contract:coverage
+
 # E2E tests (requires app running on localhost:3000)
 npm run test:e2e
 
@@ -52,6 +62,7 @@ cd components && npm run test:watch
 
 All packages enforce **70% minimum** on branches, functions, lines, and statements.
 Coverage reports are written to `coverage/` in each package directory.
+For the contract crate, coverage artifacts are written to `contract/coverage/`.
 
 ## Unit Tests
 

api/src/index.ts

@@ -115,6 +115,19 @@ export type {
   RetryConfig,
 } from './types';
 export type { ApiConfig };
+export {
+  ApiConnector,
+  IntegrationMonitor,
+  IntegrationService,
+} from './integration';
+export type {
+  IntegrationConfig,
+  IntegrationEvent,
+  IntegrationHealth,
+  IntegrationMetrics,
+  IntegrationProvider,
+  IntegrationStatus,
+} from './integration';
 export type {
   OperationPerformanceSummary,
   PerformanceAlert,