How outlier1217/quilvion-multichain-testnet works
Quilvion is a wallet-based commerce protocol: buyers and merchants use chain-specific Next.js apps to discover products, transact through escrow, manage orders and disputes, and build reputation. The FastAPI backends provide risk scoring, marketplace assistance, and admin/merchant workflows, backed by PostgreSQL and Groq; chain programs/contracts enforce on-chain commerce and settlement. The tree documents EVM and Sui frontends and a Solana program/client, while the README describes additional chain deployments. Route, transaction, and most contract excerpts were not sampled, so uncertain runtime wiring is omitted.
Main entry points: main.py FastAPI service · claude_client.py Groq LLM client · app/page.tsx EVM storefront · app/page.tsx Sui storefront
Components 26
Commerce clients
- EVM storefront
quilvion-evm-frontend/src/app/page.tsx - Sui storefront
quilvion-sui-frontend/src/app/page.tsx - EVM transactions
quilvion-evm-frontend/src/lib/evm/transactions.ts - Sui transactions
quilvion-sui-frontend/src/lib/sui/transactions.ts - API client
quilvion-evm-frontend/src/lib/api.ts
AI backend
- FastAPI service
quilvion-backend/main.py - Fraud scoring
quilvion-backend/app/routes/risk.py - AI assistance
quilvion-backend/app/routes/llm.py - Merchant workflows
quilvion-backend/app/routes/merchant.py - Dispute handling
quilvion-backend/app/routes/dispute.py - Buyer assistance
quilvion-backend/app/routes/buyer.py - Admin operations
quilvion-backend/app/routes/admin.py - Order API
quilvion-backend/app/routes/orders.py - ML model
quilvion-backend/app/ml/model.py - Groq LLM client
quilvion-backend/app/llm/claude_client.py
Chain execution
- EVM contracts
quilvion_evm - Sui contracts
quilvion-sui-frontend/src/lib/sui - Solana commerce
quilvion_solana/programs/commerce-core/src/lib.rs - Solana client
quilvion_solana/client/client.ts
Protocol state
- Commerce database
quilvion-backend/app/database.py
Other components
- Buyers
- Merchants
- Groq service
- EVM network
- Sui network
- Solana network
Connections 27
- Buyers → EVM storefront: use storefront
- Buyers → Sui storefront: use storefront
- Merchants → EVM storefront: manage commerce
- Merchants → Sui storefront: manage commerce
- EVM storefront → API client: request API
- Sui storefront → API client: request API
- EVM storefront → EVM transactions: initiate transactions
- Sui storefront → Sui transactions: initiate transactions
- API client → FastAPI service: HTTP requests
- FastAPI service → Fraud scoring: dispatches
- FastAPI service → AI assistance: dispatches
- FastAPI service → Merchant workflows: dispatches
- FastAPI service → Dispute handling: dispatches
- FastAPI service → Buyer assistance: dispatches
- FastAPI service → Admin operations: dispatches
- FastAPI service → Order API: dispatches
- Fraud scoring → ML model: scores risk
- AI assistance → Groq LLM client: requests generation
- Merchant workflows → Groq LLM client: requests generation
- Dispute handling → Groq LLM client: requests generation
- Buyer assistance → Groq LLM client: requests generation
- Groq LLM client → Groq service: calls API
- FastAPI service → Commerce database: initializes tables
- EVM transactions → EVM network: submits transactions
- Sui transactions → Sui network: submits transactions
- Solana client → Solana commerce: uses program
- Solana commerce → Solana network: executes on