BLOCKTRUST TrustScan MCP server

BlockTrust MVP

Plateforme de certification et vérification d'authenticité pour les entreprises

Stack: Next.js 16, Prisma, PostgreSQL, JWT (ES256), QR Codes

Déploiement & Neon (bold-frost / vercel-dev) : voir DEPLOYMENT.md.

🎯 Vue d'ensemble

BlockTrust est une plateforme permettant aux entreprises de :

• Créer et gérer des certificats de confiance
• Générer des signatures JWT pour authentifier leurs emails
• Vérifier l'authenticité des communications via des badges et QR codes
• Suivre les vérifications et détecter les tentatives de falsification

🚀 Technologies

• Framework: Next.js 16.1.1 (App Router)
• Base de données: PostgreSQL avec Prisma ORM
• Authentification: JWT avec ES256 (clés ECDSA)
• UI: React 19, Tailwind CSS 4
• QR Codes: Bibliothèque qrcode

📁 Structure du projet

blocktrust-mvp/
├── app/
│   ├── api/
│   │   ├── entities/
│   │   │   └── route.ts          # CRUD des entités
│   │   └── v2/
│   │       ├── issue/
│   │       │   └── route.ts      # Génération de signatures JWT
│   │       └── verify/
│   │           └── route.ts      # Vérification de signatures
│   ├── badge/
│   │   └── [id]/
│   │       └── page.tsx          # Page badge avec QR code
│   ├── components/
│   │   └── QRCode.tsx            # Composant QR code
│   ├── dashboard/
│   │   ├── create/
│   │   │   └── page.tsx          # Formulaire création entité
│   │   └── page.tsx              # Dashboard principal
│   ├── verify/
│   │   ├── [id]/
│   │   │   └── page.tsx          # Vérification par ID/SIRET
│   │   └── page.tsx              # Vérification par token JWT
│   ├── lib/
│   │   └── db.ts                 # Client Prisma
│   └── page.tsx                  # Page d'accueil
├── lib/
│   └── v2/
│       ├── context.ts            # Canonicalisation et hash des contextes
│       └── jwt.ts                # Signatures et vérification JWT
├── prisma/
│   ├── schema.prisma             # Schéma de base de données
│   ├── migrations/               # Migrations Prisma
│   └──

🗄️ Modèle de données

User

• Informations utilisateur (email, nom, plan)

Entity

• Entité certifiée (nom légal, SIRET, email, site web)
• Statuts: kycStatus (PENDING/APPROVED/REJECTED)
• Niveaux: validationLevel (BRONZE/SILVER/GOLD)

Certificate

• Certificat lié à une entité
• Statuts: PENDING/APPROVED/REJECTED
• Niveaux: BRONZE/SILVER/GOLD

Signature (V2)

• Métadonnées de signature JWT
• jti: Identifiant unique du token
• ctxHash: Hash du contexte signé
• expiresAt: Date d'expiration
• revoked: Statut de révocation

VerificationEvent

• Historique des vérifications
• IP, User-Agent, verdict (VALID/TAMPERED/REVOKED/etc.)

🔐 API V2 - Signatures JWT

POST /api/v2/issue

Génère une signature JWT pour un contexte email.

Request:

{
  "entityId": "string",
  "certificateId": "string",
  "context": {
    "from": "contact@example.com",
    "to": "client@example.com",
    "subject": "Sujet de l'email",
    "date": "2024-01-15T10:00:00Z",
    "body": "Corps de l'email (optionnel)"
  },
  "expiresInSeconds": 3600
}

Response:

{
  "token": "eyJ...",
  "verifyUrl": "http://localhost:3000/verify?token=...",
  "signatureId": "uuid"
}

POST /api/v2/verify

Vérifie une signature JWT.

Request:

{
  "token": "eyJ...",
  "context": {
    "from": "contact@example.com",
    "to": "client@example.com",
    "subject": "Sujet de l'email",
    "date": "2024-01-15T10:00:00Z",
    "body": "Corps de l'email (optionnel)"
  }
}

Response:

{
  "verdict": "VALID" | "VALID_WITH_WARNING" | "TAMPERED" | "REVOKED" | "EXPIRED" | "INVALID",
  "reason": "string (optionnel)",
  "entityId": "string",
  "certificateId": "string",
  "jti": "string"
}

🛠️ Installation et configuration

Prérequis

Shortened. The full README is on GitHub.