How jye-a-dev/trustpassz works
TrustPassz is a Web3 digital-escrow platform with user web and mobile clients, an admin portal, a NestJS API, an AI arbitration service, and on-chain escrow contracts. Its documented lifecycle runs from deal creation and deposit through inspection, settlement, or dispute and refund; disputes may be analyzed by AI and resolved by an on-chain relayer. Sampled source confirms selected API, authentication, and AI-engine calls; several subsystem links below rely on the README’s explicit architecture and lifecycle descriptions.
Main entry points: main.ts REST API · payments.service.ts Deposits and payments · disputes Dispute handling · arbitrator_engine.py Verdict engine
Components 21
Client applications
- User web portal
apps/cl_user/src/app - Mobile client
apps/mb_user/src/App.tsx - Admin portal
apps/cl_admin/src/app/(dashboard)
Platform API
- REST API
apps/server/src/main.ts - Authentication
apps/server/src/modules/auth/auth.service.ts - Deal lifecycle
apps/server/src/modules/deals/deals.service.ts - Deposits and payments
apps/server/src/modules/payments/payments.service.ts - Dispute handling
apps/server/src/modules/disputes - Deal bargaining
apps/server/src/modules/bargains - Orders
apps/server/src/modules/orders - Analytics
apps/server/src/modules/analytics - PayOS and VietQR
apps/server/src/modules/payments/services/vietqr.service.ts
AI arbitration
- Arbitration API
apps/ai_pipeline/routers/arbitration.py - Verdict engine
apps/ai_pipeline/engines/arbitrator_engine.py - Deal suggestions
apps/ai_pipeline/services/suggestion_service.py - Constrained inference
apps/ai_pipeline/core/outlines_engine.py
Escrow settlement
- Chain relayer
apps/server/src/oracle-relayer/oracle-relayer.service.ts - Digital escrow contract
packages/contracts-solana/programs/trustpassz-escrow/src/lib.rs
Platform state and evidence
- PostgreSQL data
apps/server/src/database/prisma.service.ts - Evidence storage
apps/server/src/integrations/supabase/supabase.service.ts
Other components
- Buyer or seller
Connections 25
- Buyer or seller → User web portal: uses
- Buyer or seller → Mobile client: uses
- User web portal → REST API: calls API
- Mobile client → REST API: calls API
- Admin portal → REST API: calls API
- REST API → Authentication: routes authentication
- Authentication → PostgreSQL data: upserts users
apps/server/src/modules/auth/auth.service.ts - REST API → Deal lifecycle: routes deal requests
- Deal lifecycle → PostgreSQL data: persists deals
- REST API → Deposits and payments: routes payment requests
- Deposits and payments → PayOS and VietQR: creates VietQR checkout
apps/server/src/modules/payments/payments.controller.ts - Deposits and payments → PostgreSQL data: records deposits
- REST API → Dispute handling: routes disputes
- Dispute handling → Evidence storage: stores evidence
- REST API → Deal bargaining: routes bargaining
apps/server/src/modules/bargains/bargains.controller.ts - REST API → Orders: routes orders
- REST API → Analytics: serves analytics
- Dispute handling → Arbitration API: submits dispute
- Arbitration API → Verdict engine: dispatches verdict
apps/ai_pipeline/routers/arbitration.py - Verdict engine → Constrained inference: runs inference
apps/ai_pipeline/engines/arbitrator_engine.py - Constrained inference → Deal suggestions: supports suggestions
- Verdict engine → Evidence storage: fetches image URLs
apps/ai_pipeline/engines/arbitrator_engine.py - REST API → Chain relayer: dispatches resolution
- Chain relayer → Digital escrow contract: calls resolveDispute
- Digital escrow contract → Buyer or seller: settles or refunds