Introduction

Quilvion Docs

Quilvion is an AI-powered Web3 commerce platform built on the Sui blockchain. It combines on-chain escrow, AI fraud detection, LLM-powered marketplace intelligence, and decentralized reputation systems into a single protocol.

On-chain Escrow
AI Fraud Detection
LLM Intelligence
Reputation System
USDC Settlement
4 Blockchains

Core Philosophy — Wallet as Identity

Quilvion eliminates account creation friction through one principle: Wallet = Identity.

Your wallet becomes:

  • The identity layer
  • The payment layer
  • The reputation layer
  • The trust layer

System Architecture

Buyer / Merchant / Admin
        ↓
   Next.js 15 Frontend
        ↓
   FastAPI Backend (Python)
   ├── XGBoost ML Fraud Engine
   ├── Groq LLaMA 3.3 70B
   └── PostgreSQL (Neon)
        ↓
   Sui Blockchain (Move Smart Contracts)
        ↓
   Escrow + Settlement + Reputation

Supported Chains

💧

Sui

Slush Wallet

Live

Primary chain — full feature support

🦊

Ethereum / EVM

MetaMask

In Progress

EVM-compatible chains

👻

Solana

Phantom

In Progress

High-speed transactions

🌀

Aptos

Petra

In Progress

Move-based L1

Escrow & Transactions

Every transaction is protected through Move smart contracts on the Sui blockchain. USDC is used as the settlement token (6 decimals).

Purchase Flow

1. Buyer initiates purchase using USDC

2. Funds are locked into escrow smart contract

3. AI fraud analysis runs before settlement

4. Merchant delivers product

5. Funds release automatically or through admin approval

6. Buyers can raise disputes during refund window

Risk ScoreLevelAction
0–49LOWAuto-complete
50–74MEDIUMEscrow hold
75–100HIGH / CRITICALTransaction blocked

AI Infrastructure

Quilvion integrates two independent AI systems optimized for different purposes:

Fraud Detection

XGBoost

Real-time transaction risk scoring (~50ms). Runs before wallet confirmation.

Language Intelligence

Groq LLaMA 3.3 70B

Marketplace AI features: assistant, descriptions, dispute summaries, merchant profiles.

Fraud Explanation Agent

Transforms ML risk scores into human-readable explanations.

AI Buyer Assistant

Conversational shopping assistant with live marketplace context and product recommendations.

AI Product Description Generator

Merchants can generate professional descriptions from natural-language prompts.

AI Dispute Summarizer

Aggregates transaction data and generates admin recommendations: Refund, Release, or Investigate.

Merchant Risk Profiler

Creates readable merchant trust summaries from raw platform data.

XP Tier Notifications

Generates personalized buyer progression messages using real transaction data.

Reputation System

Buyer XP Tiers

0–99 XPBronze
100–499 XPSilver
500+ XPGold

Merchant Score Events

Successful order+5 score
Dispute loss−20 score

Smart Contracts

Network

Sui Testnet

Language

Move 2024

Token

USDC (6 decimals)

commerce_core

Primary protocol layer — order creation, escrow release, disputes, settlement, risk storage.

escrow_logic

Fund locking, treasury balances, refund execution, fee deduction, daily spending limits.

access_control

Role-based permissions: DEFAULT_ADMIN, ADMIN, BOT, MERCHANT.

reputation_manager

Buyer XP, tiers, merchant trust scores, order history, badge minting.

config_manager

Dynamic runtime configuration — fees, refund windows, escrow thresholds. No redeployment needed.

Tech Stack

Frontend

  • Next.js 15
  • TypeScript
  • Tailwind CSS
  • Framer Motion
  • @mysten/dapp-kit
  • Cloudinary CDN

Backend

  • FastAPI (Python)
  • PostgreSQL (Neon)
  • SQLAlchemy
  • XGBoost
  • Groq LLaMA 3.3 70B
  • Cloudinary SDK

Blockchain

  • Sui Move 2024
  • USDC Escrow
  • On-chain disputes
  • Role-based access
  • Reputation on-chain

Questions or contributions?

GitHub Repository·Mustak Aalam