This page shows runtime components and their main data paths.

Runtime components

Arcane architecture map The diagram shows the primary runtime path only. Internal backend module responsibilities and table groups are listed below instead of adding every dependency as another arrow.

Runtime responsibilities

ComponentImplementationResponsibility
Reference or partner applicationIntegrator applicationEnd-user UI, wallet connection, SDK calls, Soroban transaction submission
PrivacyPoolSDKstellar-privacy-layer-contracts/client-sdkCoin construction, stealth address helpers, witness construction, proof generation, Soroban serialization
Stellar walletWallet integrationMessage signing and Soroban transaction signing
Soroban contractstellar-privacy-layer-contracts/contract/src/lib.rstransact, proof verification, nullifier checks, commitment state, token transfers, audit event emission
Stellar RPCConfigured chain.rpc_urlLedger and event source for registered contract scanning
Backend APINestJS controllers and guardsAuthenticated API routes for applications, audit rows, cases, reports, logs, team/admin actions
ScannerScannerModule, StellarLedgerScannerServiceLedger range scanning, Soroban event parsing, raw audit upsert, stellar_scans checkpoint update
Interpretation workerAuditInterpretationRunnerServiceDecrypt raw audit rows and write normalized audit_interpretation records
PostgreSQLTypeORM entities and migrationsRegistry, audit, interpretation, access, workflow, report, and activity-log data
Audit UIReact/Vite applicationOrganization and application workspaces backed by GET /auth/me and scoped API routes

Primary paths

PathSequence
Private transaction executionApplication -> SDK -> wallet -> PrivacyPoolsContract.transact -> contract state + AuditEncodedDigest
Indexing and interpretationAuditEncodedDigest -> Stellar RPC -> scanner -> audit -> interpretation worker -> audit_interpretation
Portal accessAudit UI -> identity flow -> GET /auth/me -> permission buckets -> guarded API routes
Disclosure workflowCase request -> administrator decision -> approved case -> assigned auditor review -> report/activity log