Architecture V8.2 · Importateur First · Trade Finance islamique
Base · USDC · TradeFinancePool · Mudarabah Import · Musharakah Import · Takaful · CargoX · HAQQ Ethiq · ShariahGateway · ICC Arbitration
Page 2 · Architecture cible

Une architecture centrée sur l’importateur, le fournisseur et le profit réel.

ETHIGONE V8.2 remplace le MVP logistique par un modèle importateur-first. Chaque pool finance une opération d’import précise : fournisseur vérifié, marchandise documentée, paiement direct, inspection, revente contrôlée et distribution du résultat réel après encaissement.

01 · Décision d’architecture

Le client principal devient l’importateur. La logistique devient une composante du dossier, pas un produit séparé.

La V8.1 avait réduit le MVP au financement des frais logistiques vérifiables. La V8.2 tranche différemment : ETHIGONE démarre avec un seul produit plus fort, le financement d’une opération d’import réelle destinée à une revente documentée.

Décision V8.2 : ne pas lancer deux modèles au début. Le produit unique est Import Trade Finance. Le module logistique reste inclus dans le dossier import, mais il ne devient pas une offre séparée.

Ce qu’on finance

Achat marchandise, inspection, transport, assurance et frais directement rattachés à l’opération import validée.

ImportMarchandise réelle

Ce qu’on contrôle

Importateur, fournisseur, débouché commercial, documents, Incoterm, paiement fournisseur, livraison et encaissement.

RiskKYB

Ce qu’on refuse

Trésorerie libre, stock général non rattaché, fournisseurs non vérifiables, rendement garanti et profit non encaissé.

No loanNo yield promise
02 · Schéma cible V8.2

Base exécute, HAQQ Ethiq certifie, ETHIGONE orchestre l’opération import.

UTILISATEURS
Importateur · Fournisseur · Acheteur final · Investisseur · Inspecteur · Transitaire · Scholar · Admin
        │
        ▼
APPLICATION ETHIGONE
KYB · dossier import · supplier check · buyer commitment · scoring · documents · workflow scholar
        │
        ├──────────── Base — exécution financière ────────────┐
        │   TradeFinancePool.sol                              │
        │   TakafulReserve.sol                                │
        │   FraudRegistry.sol                                 │
        │   CompanyTradePassport.sol                          │
        │   ReputationEngine.sol                              │
        │   PaymentMilestoneEngine.sol                        │
        │   ImportSettlementEngine.sol                        │
        │                                                      │
        └──────────── HAQQ Ethiq — certification ─────────────┘
            ShariahGateway.sol
            ShariahPolicyRegistry.sol
            ShariahCertificateRegistry.sol
            ShariahOracleProcess

Le contrat central devient TradeFinancePool.sol. Il ne présume pas que tous les dossiers sont des Musharakah. Il route chaque opération vers une politique Shariah adaptée selon l’apport réel de l’importateur et le rôle économique des investisseurs.

03 · Acteurs du dossier

La confiance ne porte plus seulement sur l’exportateur : elle porte sur toute la chaîne import.

ActeurRôle dans V8.2Preuve attendue
ImportateurPorte le dossier, organise l’achat et la revente.KYB, historique, capacité commerciale, apport éventuel.
FournisseurVend la marchandise et reçoit le paiement direct.KYB léger, facture pro-forma, coordonnées bancaires société, preuve d’existence.
Acheteur finalSécurise le débouché commercial.Bon de commande, contrat, facture de revente, acompte ou preuve de capacité de paiement.
InvestisseursApportent le capital en USDC.Dépôt dans le pool, acceptation du risque, absence de rendement garanti.
InspecteurVérifie la marchandise avant paiement final ou expédition.Rapport SGS, Bureau Veritas, Intertek ou inspecteur agréé.
TransitaireOrganise transport, documents, douane et livraison.Devis, tracking, eBL, attestation, preuve transport.
04 · Workflow opérationnel

Une opération import ETHIGONE suit 9 étapes strictes.

01
Onboarding importateur
KYB, historique, secteur, pays, capacité de revente, réputation et sanctions screening.
02
Dossier fournisseur
Facture pro-forma, bon de commande, marchandise, HS code, Incoterm, banque fournisseur et vérification minimale.
03
Débouché commercial sécurisé
Facture de revente, bon de commande ferme, contrat client, acompte ou preuve sérieuse de capacité de paiement.
04
Qualification Shariah
Blacklist, absence de riba, structure Mudarabah ou Musharakah, revue Scholar si cas limite.
05
Ouverture du pool
Les investisseurs déposent en USDC. Les fonds sont verrouillés jusqu’aux conditions de décaissement.
06
Paiement direct
Le fournisseur et les prestataires validés sont payés directement via VASP/PSP régulé. Aucun versement libre à l’importateur.
07
Inspection & transport
Inspection, CargoX/eBL, suivi transport, assurance, douane et preuves ajoutées au Trade Passport.
08
Revente & encaissement
Le revenu de revente est encaissé, contrôlé ou documenté avant tout calcul de marge.
09
Settlement
Calcul du profit ou de la perte réelle, distribution, défaut, Takaful et ICC si nécessaire.
05 · TradeFinancePool.sol

Le pool devient neutre : il finance une opération, puis applique la bonne structure Shariah.

TradeFinancePool.sol remplace les noms trop étroits comme MusharakahPool.sol ou LogisticsFinancePool.sol. Le contrat doit pouvoir gérer un dossier import sans forcer une qualification incorrecte.

TradeFinancePool.sol
├─ MUDARABAH_IMPORT
│  └─ investisseurs = capital · importateur = travail / réseau commercial
│
├─ MUSHARAKAH_IMPORT
│  └─ investisseurs + importateur apportent du capital ou supportent une exposition réelle
│
├─ LOGISTICS_COSTS_INCLUDED
│  └─ frais logistiques intégrés au coût complet de l’opération import
│
└─ SCHOLAR_REVIEW_REQUIRED
   └─ cas limite, marge atypique, apport ambigu ou document contradictoire
Le pool n’est jamais un prêt. Il ne promet ni rendement fixe, ni capital garanti. Il finance une opération commerciale vérifiée et distribue uniquement le résultat réel.
06 · Qualification Shariah

Mudarabah par défaut si l’importateur ne met pas de capital ; Musharakah seulement s’il apporte une exposition réelle.

CasApport investisseursApport importateurQualification
Importateur opérateurCapital USDC pour acheter la marchandise et payer les coûts validés.Travail, sourcing, négociation, gestion commerciale, revente.Mudarabah Import
Importateur cofinanceurCapital USDC partiel.Capital propre, acompte fournisseur, avance logistique ou exposition documentée.Musharakah Import
Cas ambiguCapital ou frais difficiles à qualifier.Apport non valorisable ou clauses atypiques.Revue Scholar obligatoire
if importerCapitalContribution == 0
    policyType = MUDARABAH_IMPORT
else if importerCapitalContribution > 0 and lossExposure == true
    policyType = MUSHARAKAH_IMPORT
else
    scholarReviewRequired = true

if guaranteedReturn == true
    poolRejected = true
if capitalGuaranteedByDefault == true
    poolRejected = true
07 · Company Trade Passport

Le Trade Passport devient un passeport de dossier import, pas seulement un profil exportateur.

CompanyTradePassport
├─ Importateur KYB
├─ Fournisseur vérifié
├─ Acheteur final / débouché commercial
├─ Marchandise, HS code, quantité, valeur
├─ Incoterm et route commerciale
├─ Facture pro-forma fournisseur
├─ Bon de commande ou facture de revente
├─ Documents CargoX / eBL / IPFS hashes
├─ Inspection et certificats
├─ Paiements fournisseur / prestataires
├─ Encaissement revente
├─ Statut Shariah
└─ Historique réputationnel

Le Trade Passport doit permettre de répondre à trois questions : la marchandise existe-t-elle, le fournisseur est-il réel, et le débouché commercial est-il suffisamment sécurisé pour ouvrir le pool ?

08 · Paiement et conversion fiat

ETHIGONE ne remet pas l’argent à l’importateur : le fournisseur et les prestataires sont payés directement.

La gestion financière doit séparer l’orchestration ETHIGONE de l’exécution réglementée. ETHIGONE fixe les conditions, le smart contract verrouille les fonds, et un partenaire VASP/PSP exécute la conversion et les paiements.

Pipeline recommandé Phase 1
├─ Investisseurs déposent USDC dans TradeFinancePool.sol
├─ Smart contract verrouille les fonds
├─ Conditions de décaissement vérifiées manuellement
├─ Partenaire VASP/PSP convertit USDC → EUR / USD / devise locale
├─ Paiement direct fournisseur contre facture et compte bancaire vérifié
├─ Paiement inspecteur / transporteur / assureur si inclus dans le dossier
├─ Preuve de paiement uploadée dans le Trade Passport
└─ Étape suivante validée manuellement

Phase 1

Semi-manuel : validation humaine des documents, paiement contrôlé, preuve uploadée et distribution on-chain après settlement.

Phase 2+

Automatisation progressive via API VASP/PSP, mais uniquement après validation compliance et tests de paiement réels.

09 · Settlement & calcul des gains

Le profit n’existe que lorsque la revente est réellement encaissée ou sécurisée.

ETHIGONE doit éviter les profits théoriques. Le résultat du pool se calcule sur les flux réellement documentés.

Profit réel distribuable =
revenu de revente réellement encaissé
- coût fournisseur payé
- coûts logistiques / assurance / inspection validés
- taxes et frais non distribuables

Si revenu encaissé inférieur aux coûts :
→ perte réelle, pas de profit à distribuer

Si revenu non encaissé :
→ pas de profit reconnu, dossier en défaut / recouvrement / ICC
ExempleMontantTraitement
Prix fournisseur50 000 USDCCoût réel payé au fournisseur.
Transport + inspection + assurance5 000 USDCCoûts rattachés au dossier import.
Coût total55 000 USDCBase de calcul du résultat.
Revente encaissée65 000 USDCRevenu reconnu seulement s’il est encaissé ou sécurisé.
Profit distribuable10 000 USDCPartagé selon la clé validée, sans garantie préalable.
Ne pas écrire “rendement investisseur garanti”. Écrire : “dans cet exemple, si la revente est encaissée comme prévu, la marge distribuable est de 10 000 USDC”.
10 · Poches financières du pool

Un pool import doit suivre le capital, les décaissements, le Tabarru’, les frais et le résultat.

TradeFinancePool #001
├─ investorCapitalUSDC        → dépôts investisseurs
├─ importerCapitalUSDC        → apport éventuel importateur
├─ tabarruReserve             → 2% Phase 1, séparé du capital
├─ approvedSupplierPayments   → fournisseur payé directement
├─ approvedServicePayments    → inspecteur, transporteur, assureur, douane
├─ ethigoneFees               → frais dossier / monitoring / succès validé
├─ resaleRevenue              → encaissement revente documenté
├─ distributableProfit        → profit réel après coûts
└─ lossAmount                 → perte réelle si revenu insuffisant
11 · Critères bloquants & scoring

Le scoring aide à arbitrer, mais certains critères bloquent automatiquement le dossier.

CritèreTraitementDécision
KYB importateur incompletBloquantRefus
Fournisseur non vérifiableBloquantRefus
Marchandise blacklistéeBloquant ShariahRefus
Débouché commercial absentBloquant Phase 1Refus ou attente
Marge irréalisteRisque fortRevue manuelle
Double financement probableFraude potentielleFraudRegistry + blocage
Statut Shariah non ACTIVEBloquantRefus d’ouverture
<40Refus score global
40–60Revue manuelle
>60Éligible si aucun bloquant
ACTIVEStatut Shariah obligatoire
12 · Incoterms importateur

L’Incoterm détermine quels coûts, risques et documents entrent dans le pool.

IncotermUtilité V8.2Avis Phase 1
FOBL’importateur contrôle le fret depuis le port d’embarquement.Très adapté si transitaire fiable.
CIFLe fournisseur inclut fret maritime + assurance jusqu’au port destination.Adapté car coûts plus lisibles.
CFRFret inclus, assurance à gérer séparément.Adapté avec assurance contrôlée.
FCABon pour multimodal avec transporteur désigné.Adapté si documentation claire.
CPT/CIPTransport multimodal, avec assurance pour CIP.Adapté pour dossiers modernes.
EXWL’importateur porte trop d’obligations depuis l’usine.À éviter en Phase 1.
DDPPratique mais opaque : taxes et responsabilités cachées dans le prix.À éviter au MVP.
13 · HAQQ Ethiq & Shariah Oracle

La certification doit prouver la politique appliquée, pas seulement afficher un badge.

Shariah Oracle Process
1. ETHIGONE prépare le dossier technique et économique
2. Scholar Board interne qualifie la structure : Mudarabah / Musharakah / revue
3. Soumission au Shariah Oracle HAQQ Ethiq
4. Community Approval / revue de conformité HAQQ
5. Scholar Board HAQQ examine la politique et la version du contrat
6. Certificat / SBT non transférable si validation
7. ShariahGateway.sol publie : ACTIVE, SUSPENDED, REVOKED
8. TradeFinancePool.sol exécute uniquement si statut ACTIVE
14 · Circuit breaker ShariahGateway.sol

Si la preuve Shariah devient indisponible, ETHIGONE n’ouvre aucun nouveau pool.

if gatewayMode == PAUSED              → action sensible bloquée
if oracleStatus == UNAVAILABLE        → nouveaux pools bloqués
if bridgeDataIsStale == true          → nouveaux pools bloqués
if certificate.status == REVOKED      → pool refusé
if certificate.status == SUSPENDED    → revue scholar obligatoire
if policyType is undefined            → pool refusé
if bytecodeHash != certifiedHash      → pool refusé
else                                  → ouverture possible

En mode dégradé, un ancien statut connu peut servir au suivi des dossiers déjà ouverts, mais jamais à créer une nouvelle exposition financière.

15 · Takaful & Tabarru’

La réserve Takaful protège certains risques documentés, sans garantir le capital.

PhaseTaux Tabarru’Règle
Phase 12%Pilote prudent, montant limité, activation manuelle et revue documentée.
Phase 2Jusqu’à 5%Ajustement selon sinistralité, corridor, marchandise et décision Shariah/risk.
La réserve n’est ni une garantie de rendement, ni une assurance automatique du capital. Elle intervient seulement selon procédure documentée.
16 · Défaut, litiges & ICC

Un défaut est traité comme un événement commercial documenté, pas comme un simple retard de paiement.

ÉvénementRéponse ETHIGONE
Fournisseur ne livre pasPaiement par jalons, inspection, blocage paiement final, recours contractuel.
Marchandise non conformeRapport inspecteur, gel du settlement, litige fournisseur / assureur.
Importateur ne revend pasReputationEngine, revue, revente alternative si prévue, défaut commercial.
Acheteur final ne paie pasRecouvrement, preuve d’impayé, absence de profit reconnu.
Fraude documentaireFraudRegistry, gel, enquête, exclusion, procédure judiciaire si nécessaire.
Litige internationalICC Arbitration standard par défaut, sauf contrainte légale locale validée.
J+7  → relance documentée
J+14 → mise en demeure / revue risque
J+30 → défaut qualifié, Takaful si applicable, ICC ou recouvrement
17 · Contrats & modules à prévoir

La refonte est moyenne techniquement, mais forte métier : le moteur économique change.

ModuleRôle V8.2Modification
TradeFinancePool.solPool principal import, dépôts, policyType, décaissements, résultat.Remplace MusharakahPool / LogisticsFinancePool.
CompanyTradePassport.solHistorique importateur, fournisseur, acheteur final, transitaire.Élargit le Trade Passport exportateur.
SupplierRegistry.solVérification fournisseur et bénéficiaire bancaire.Nouveau.
BuyerCommitmentRegistry.solDébouché commercial et acheteur final.Nouveau.
PaymentMilestoneEngine.solDécaissements par jalons : acompte, inspection, documents, livraison.Nouveau.
ImportSettlementEngine.solCalcul profit/perte, distribution, défaut.Nouveau.
ShariahGateway.solStatut ACTIVE/SUSPENDED/REVOKED + circuit breaker.Conservé et renforcé.
18 · Roadmap V8.2

Démarrer manuel, prouver le modèle, puis automatiser.

Phase 1 · Pilote manuel

3 à 5 dossiers import, validation KYB, paiements manuels via partenaire, Tabarru’ 2%, settlement assisté.

Phase 2 · Testnet

TradeFinancePool testnet, Shariah Oracle testnet, certificats test, circuit breaker, API paiement simulée.

Phase 3 · Mainnet contrôlé

Activation Base mainnet + HAQQ mainnet, dossiers limités, montants plafonnés, monitoring renforcé.

Phase 4 · Scale

Multi-corridors, scoring avancé, partenaires PSP/VASP, automatisation paiement et reporting investisseurs.