🔗 SoWasIt - Documentation Technique

Architecture et modèles de données de la plateforme blockchain

Concepts & Garanties Techniques

SoWasIt est une infrastructure d'ancrage cryptographique conçue pour garantir l'intégrité absolue de vos données via des preuves d'existence immuables et mathématiquement vérifiables.

Pourquoi SoWasIt est fiable :

Immuabilité par chaînage : Chaque bloc contient le double hash du précédent (SHA-256). Modifier un seul bit dans l'historique invalide mathématiquement toute la chaîne suivante.
Horodatage certifié : L'heure de création est enregistrée et scellée dans le double hash du bloc.
Indépendance de la preuve : La preuve (hash + contenu) est exportable. Son intégrité peut être vérifiée avec des outils standards, sans dépendre de notre plateforme.

Mécanisme d'Ancrage

L'originalité de SoWasIt réside dans son architecture à double niveau :

[ Votre App ] -> [ Chaîne Privée ] -> [ Chaîne d'Ancrage Publique ]
      |               |                       |
   Données      Ordre & Contexte        Preuve Globale

Chaque événement de votre application est d'abord enregistré dans votre chaîne privée (pour garder vos données confidentielles), puis immédiatement ancré dans la chaîne publique partagée.

Le registre partagé : Tous les clients de SoWasIt s'ancrent dans la même chaîne publique. Cela crée une interdépendance cryptographique : pour falsifier vos données, il faudrait falsifier l'historique de tous les clients de la plateforme simultanément.

Atomicité & Fiabilité

Pour garantir qu'une preuve existe dès qu'une opération est confirmée, SoWasIt utilise des mécanismes de transaction avancés.

Transactions Atomiques

L'écriture dans votre chaîne et l'ancrage public sont exécutés au sein d'une transaction unique et atomique.

Garantie : Si l'ancrage public échoue, l'enregistrement privé est annulé. Vous n'avez jamais de 'preuve partielle'.

Gestion des Verrous

L'utilisation de verrous système garantit un ordre de succession parfait des blocs, évitant toute condition de course, même en cas de fortes sollicitations simultanées.

Sécurité & Isolation

Bien que l'infrastructure soit partagée (Multi-tenant), l'isolation est hermétique.

Isolation logique : Chaque requête est filtrée par un tenant_id au niveau du moteur de base de données. Un utilisateur d'un tenant A ne peut jamais, par construction, adresser une chaîne du tenant B.
Secrets hachés : Les clés API et les tokens de session ne sont jamais stockés en clair. Seul leur hash SHA-256 est conservé.
Idempotence : Le système supporte des clés d'idempotence. Si vous renvoyez la même requête, SoWasIt détecte le doublon et renvoie la preuve originale.

Référence API

L'API est RESTful et communique exclusivement en JSON via HTTPS.

Documentation complète : Une documentation interactive Swagger (OpenAPI) est disponible sur /api-docs

Authentification

Utilisez le header X-API-Key pour vos appels serveurs.

GET /api/v1/chains
Host: api.sowasit.io
X-API-Key: your_api_key_here

Gestion des Chaînes

Une chaîne est un conteneur logique pour vos preuves.

Méthode	Endpoint	Description
`GET`	`/chains`	Liste vos chaînes
`POST`	`/chains`	Crée une nouvelle chaîne

Ancrage de Blocs

C'est l'opération principale pour créer une preuve.

POST /chains/{chainId}/blocks
{
  "data": {
    "event": "document_signed",
    "hash": "e3b0c442...",
    "user_id": "user_42"
  }
}

Réponse : Vous recevez immédiatement le hash du bloc et son prev_hash, constituant votre preuve d'existence.