Tech V8.2 · Importateur First · Stack & contrats
Base · USDC · TradeFinancePool.sol · ShariahEngine · SupplierRegistry · BuyerCommitmentRegistry · PaymentMilestoneEngine · ImportSettlementEngine · HAQQ Ethiq · Circuit breaker
Page 4 · Architecture technique

Le moteur technique d’un Trade Finance importateur.

ETHIGONE V8.2 remplace le pool unique Musharakah ou logistique par un moteur technique plus exact : un TradeFinancePool.sol par opération import, un ShariahEngine pour qualifier Mudarabah ou Musharakah, des registres pour vérifier fournisseur et débouché, puis un settlement réel après encaissement.

01 · Décision technique

Le cœur technique devient TradeFinancePool.sol, pas MusharakahPool.sol.

La V8.2 ne peut plus utiliser un contrat nommé MusharakahPool.sol par défaut, car toutes les opérations import ne sont pas des Musharakah. Si l’importateur apporte uniquement son travail, son réseau et sa capacité de revente, la structure ressemble davantage à une Mudarabah Import. Si l’importateur apporte aussi du capital, elle peut devenir une Musharakah Import.

Décision V8.2 : le smart contract central s’appelle TradeFinancePool.sol. Il porte une opération import précise et sélectionne le mode Shariah validé par ShariahEngine.
TradeFinancePool.sol
├─ MUDARABAH_IMPORT              // investisseurs = capital, importateur = travail / revente
├─ MUSHARAKAH_IMPORT             // investisseurs + importateur apportent du capital
├─ LOGISTICS_COSTS_INCLUDED       // logistique incluse dans l'opération import
└─ SCHOLAR_REVIEW_REQUIRED        // cas atypique ou marge / risque non standard
02 · Stack cible

Base exécute les flux, HAQQ Ethiq certifie, ETHIGONE orchestre les preuves.

La stack V8.2 conserve la séparation fondamentale : Base porte les dépôts USDC, les verrous, les états de pool et les distributions ; HAQQ Ethiq porte la certification Shariah vérifiable ; ETHIGONE orchestre KYB, scoring, documents, inspection, paiement et settlement.

UTILISATEURS
Importateur · Investisseur · Fournisseur · Acheteur final · Inspecteur · Transitaire · Scholar · Admin
        │
        ▼
APPLICATION ETHIGONE
KYB/KYC · scoring · documents · débouché commercial · inspection · paiement · settlement
        │
        ├─────────────── Base — exécution financière ───────────────┐
        │   TradeFinancePool.sol                                    │
        │   TakafulReserve.sol                                      │
        │   FraudRegistry.sol                                       │
        │   CompanyTradePassport.sol                                │
        │   ReputationEngine.sol                                    │
        │   SupplierRegistry.sol                                    │
        │   BuyerCommitmentRegistry.sol                             │
        │   PaymentMilestoneEngine.sol                              │
        │   ImportSettlementEngine.sol                              │
        │   DefaultWorkflow.sol                                     │
        │                                                           │
        └─────────────── HAQQ Ethiq — certification ────────────────┘
            ShariahGateway.sol
            ShariahPolicyRegistry.sol
            ShariahCertificateRegistry.sol
            ShariahOracleProcess
03 · Contrats & modules

Chaque module a une responsabilité simple, auditable et non mélangée.

ModuleRôlePourquoi il est nécessaire
TradeFinancePool.solCrée et gère un pool par opération import.Remplace le pool Musharakah unique et supporte Mudarabah/Musharakah selon le dossier.
ShariahEngineQualifie la structure économique du dossier.Évite d’appeler Musharakah une opération qui est en réalité Mudarabah.
CompanyTradePassport.solRegistre d’identité et d’historique des acteurs.Importateur, fournisseur, acheteur final, transitaire et inspecteur ne doivent pas être mélangés.
SupplierRegistry.solVérifie le fournisseur et ses coordonnées bancaires.Empêche le paiement d’un fournisseur fantôme ou d’un compte tiers suspect.
BuyerCommitmentRegistry.solEnregistre le débouché commercial.Le financement dépend d’une revente crédible, pas d’une promesse vague.
PaymentMilestoneEngine.solGère les jalons de paiement.Le fournisseur peut être payé par étapes : commande, inspection, documents, expédition.
ImportSettlementEngine.solCalcule profit, perte et distribution.La distribution doit dépendre de l’encaissement réel.
DefaultWorkflow.solGère retards, défauts, Takaful et litiges.Évite l’improvisation à J+7, J+14, J+30.
FraudRegistry.solMarque les fraudes et double financements.Protège les investisseurs et l’historique des acteurs.
TakafulReserve.solGère la réserve Tabarru’.2% en Phase 1, montée possible à 5% en Phase 2, sans garantie de capital.
ShariahGateway.solVérifie statut HAQQ Ethiq avant action sensible.Bloque les pools si certificat absent, suspendu, révoqué ou oracle indisponible.
04 · Modèle de données

Un dossier import doit relier acteur, marchandise, paiement, revente et preuve.

Le dossier technique ne doit pas seulement stocker une facture. Il doit relier toutes les preuves qui permettent de comprendre l’opération : qui achète, qui vend, qui revend, quelle marchandise, quel Incoterm, quels coûts, quelles preuves de paiement et quel revenu final.

ImportDeal
├─ dealId
├─ importerId
├─ supplierId
├─ buyerCommitmentId
├─ goodsCategory
├─ incoterm
├─ originCountry
├─ destinationCountry
├─ supplierInvoiceHash
├─ resaleCommitmentHash
├─ inspectionReportHash
├─ cargoXReference / eBLReference
├─ financedAmount
├─ importerCapitalContribution
├─ tabarruAmount
├─ shariahMode
├─ poolStatus
├─ milestoneStatus[]
├─ payoutProofs[]
├─ resaleCollectionProof
├─ settlementResult
└─ defaultStatus
Règle V8.2 : aucun pool ne peut être ouvert si le fournisseur, la marchandise, le débouché commercial, le mode Shariah et les conditions de paiement ne sont pas reliés dans un même dossier.
05 · États du pool

Le pool doit avancer par états contrôlés, pas par décaissement libre.

Pour éviter les abus, chaque pool suit un cycle d’états. Les investisseurs déposent, mais les fonds ne sont utilisés qu’après validation des preuves et des jalons. L’importateur ne reçoit pas librement le capital.

DRAFT
  → KYB_PENDING
  → DOCUMENTS_UNDER_REVIEW
  → SHARIAH_REVIEW
  → APPROVED_FOR_FUNDING
  → FUNDING_OPEN
  → FUNDED_LOCKED
  → SUPPLIER_PAYMENT_PENDING
  → SUPPLIER_PAID
  → INSPECTION_PENDING
  → IN_TRANSIT
  → DELIVERED
  → RESALE_COLLECTION_PENDING
  → SETTLEMENT_READY
  → DISTRIBUTED

Cas négatifs :
  → REJECTED
  → SUSPENDED
  → DEFAULT_WORKFLOW
  → ICC_ARBITRATION
  → CLOSED_LOSS
06 · Workflow technique

Le parcours technique suit l’opération réelle, du dossier jusqu’à la distribution.

01

Création du dossier import

L’importateur crée un dossier avec facture fournisseur, marchandise, Incoterm, montant demandé, débouché commercial et documents de base.

02

Vérification des acteurs

KYB importateur, vérification fournisseur, compte bancaire fournisseur, acheteur final ou débouché, scoring initial.

03

Qualification Shariah

ShariahEngine décide Mudarabah Import, Musharakah Import ou revue Scholar Board selon l’apport capital, la marge et le risque.

04

Ouverture du pool

TradeFinancePool.sol ouvre uniquement si les critères bloquants sont passés et si ShariahGateway retourne un statut ACTIVE.

05

Verrouillage des USDC

Les investisseurs déposent. Les fonds restent verrouillés jusqu’à validation des jalons de paiement.

06

Paiement fournisseur et prestataires

Décaissement via VASP/PSP régulé : fournisseur, inspecteur, transporteur, assureur. Jamais versement libre à l’importateur.

07

Inspection, transport et livraison

Preuves CargoX/IPFS, inspection SGS/BV/Intertek, tracking, documents douane, preuve de livraison.

08

Encaissement et settlement

ImportSettlementEngine calcule le résultat réel uniquement après preuve d’encaissement de la revente.

09

Distribution ou défaut

Si profit réel : distribution selon ratio. Si retard/défaut : DefaultWorkflow, Takaful, ReputationEngine, puis ICC si nécessaire.

07 · ShariahEngine

Le moteur Shariah choisit la structure selon les apports réels.

La qualification ne doit pas être décidée au hasard ou par marketing. Elle dépend de qui apporte le capital, qui supporte le risque, qui travaille, et comment les pertes sont traitées.

if importerCapitalContribution == 0:
    structure = MUDARABAH_IMPORT
    lossRule = investors bear capital loss except fraud / negligence / breach
    importerLoss = effort + reputation + contractual liability if fault

elif importerCapitalContribution > 0:
    structure = MUSHARAKAH_IMPORT
    lossRule = losses according to capital exposure
    profitRule = ratio agreed upfront

elif ethigoneBuysAndResells == true:
    structure = MURABAHA_REVIEW_ONLY
    action = Scholar Board + legal review required

else:
    structure = SCHOLAR_REVIEW_REQUIRED

Mudarabah Import

Investisseurs apportent le capital ; importateur apporte travail, réseau commercial et gestion de la revente.

Musharakah Import

Importateur apporte aussi du capital, donc il partage l’exposition financière réelle.

Revue Scholar

Obligatoire si marge atypique, marchandise sensible, clause ambiguë ou structure proche d’une Murabahah.

08 · Critères bloquants

Certains défauts ne réduisent pas le score : ils refusent directement le dossier.

CritèreDécision techniqueRaison
KYB importateur incompletREFUSOn ne finance pas un acteur non identifié.
Fournisseur non vérifiableREFUSRisque fournisseur fantôme ou compte frauduleux.
Compte bancaire fournisseur incohérentREFUSLe paiement direct doit arriver au bon bénéficiaire.
Marchandise blacklistéeREFUSConformité Shariah non négociable.
Débouché commercial absentREFUSPas de revente crédible, donc pas de profit vérifiable.
Marge irréalisteREVUEPeut cacher fraude, erreur ou promesse de rendement.
Double financement détectéREFUSRisque de fraude documentaire.
Certificat Shariah non ACTIVEREFUSShariahGateway doit bloquer l’ouverture.
09 · Scoring technique

Le score aide à décider, mais ne remplace jamais les critères bloquants.

Après les blocages, ETHIGONE calcule un score global 0-100. Ce score sert à orienter la décision : refus, revue manuelle ou éligibilité au financement.

CritèreScoreSeuilSource
Historique importateur0-100< 40 = refusKYB, factures passées, activité, réputation.
Capacité de revente0-100< 40 = refusBon de commande, client final, canal de vente, historique.
Marge réaliste0-100< 60 = revuePrix fournisseur, marché, frais, délai, secteur.
Risque corridor0-100< 60 = revuePays, douane, logistique, historique d’incidents.
Qualité fournisseur0-100< 40 = refusKYB léger, registre, coordonnées, documents, compte bancaire.
if anyBlockingCriterion == true:
    decision = REJECTED
elif globalScore < 40:
    decision = REJECTED
elif globalScore >= 40 and globalScore <= 60:
    decision = MANUAL_REVIEW
else:
    decision = ELIGIBLE
10 · Paiement & conversion fiat

ETHIGONE orchestre le paiement ; un partenaire régulé exécute la conversion et les virements.

Le smart contract verrouille les USDC, mais ETHIGONE ne doit pas devenir lui-même une banque ou un établissement de paiement. En Phase 1, la conversion USDC → fiat et les virements aux bénéficiaires doivent passer par un partenaire VASP/PSP validé.

Option recommandée Phase 1

1. Investisseurs déposent USDC dans TradeFinancePool.sol
2. Fonds verrouillés jusqu'à validation documentaire
3. Admin + contrôles déclenchent le décaissement
4. USDC transférés vers partenaire VASP / stablecoin payment provider
5. Conversion USDC → fiat si nécessaire
6. Paiement direct : fournisseur / inspecteur / transporteur / assureur
7. Preuve de virement récupérée
8. Hash de la preuve uploadé dans le Trade Passport
9. Validation manuelle avant étape suivante

Règle de sécurité

Le paiement libre à l’importateur est interdit en Phase 1. Les fonds vont uniquement vers des bénéficiaires vérifiés.

Règle d’intégration

Wise peut rester une option fiat si accepté par sa compliance, mais le rail principal doit être un partenaire crypto/stablecoin-native ou VASP compatible.

11 · PaymentMilestoneEngine

Le fournisseur peut être payé par jalons, pas forcément en une seule fois.

Le paiement par jalons réduit le risque fournisseur. Selon le secteur, ETHIGONE peut payer une partie à la commande, une partie après inspection, puis le solde contre documents de transport ou preuve d’expédition.

JalonDéclencheurPaiement possiblePreuve requise
CommandeDossier validé + pool financéAcompte fournisseurFacture pro-forma, compte fournisseur, contrat.
Pré-expéditionMarchandise prêtePaiement partielInspection avant expédition, photos, rapport tiers.
DocumentsDocuments transport disponiblesSolde fournisseur ou freteBL, CargoX, packing list, certificat.
ArrivéeLivraison ou douane validéePrestataires restantsPreuve livraison, déclaration, facture prestataire.
12 · ImportSettlementEngine

Le profit est calculé seulement après encaissement réel.

Le settlement est le point sensible du modèle importateur. ETHIGONE ne distribue pas un profit théorique basé sur une facture ou une promesse. Le moteur de settlement attend une preuve d’encaissement réelle ou sécurisée.

Inputs settlement
├─ totalFinancedCosts
├─ importerCapitalContribution
├─ actualSupplierPaid
├─ actualLogisticsPaid
├─ actualInspectionPaid
├─ resaleAmountCollected
├─ nonDistributableFees
└─ profitShareRatios

profitDistribuable = resaleAmountCollected
                     - actualSupplierPaid
                     - actualLogisticsPaid
                     - actualInspectionPaid
                     - nonDistributableFees

if profitDistribuable > 0:
    distribute capital + profit according to pool rules
elif profitDistribuable == 0:
    return available capital only, no profit
else:
    trigger loss / default workflow
Règle V8.2 : une facture de revente non payée ne crée aucun profit distribuable. Le résultat n’existe qu’après encaissement réel ou mécanisme de paiement sécurisé accepté.
13 · Défaut, Takaful & ICC

Le défaut doit être codé comme un workflow, pas traité au cas par cas.

Le défaut peut venir du fournisseur, de l’importateur, de l’acheteur final, de la douane ou d’un problème qualité. Le workflow doit distinguer retard simple, litige, fraude et perte économique normale.

DefaultWorkflow.sol

J+7
├─ relance importateur / fournisseur / acheteur final
├─ demande de preuve complémentaire
└─ statut WATCHLIST

J+14
├─ mise en demeure contractuelle
├─ suspension réputation
├─ gel nouvelle exposition
└─ revue comité risque + Scholar Board si nécessaire

J+30
├─ activation analyse Takaful si perte éligible
├─ ouverture procédure ICC si litige commercial
├─ inscription FraudRegistry si fraude documentée
└─ clôture perte si perte économique normale

Takaful

Tabarru’ 2% en Phase 1. Aide solidaire selon règles validées, jamais garantie de capital.

ICC

Arbitrage ICC standard par défaut pour les dossiers internationaux, sauf contrainte locale documentée.

Fraude

FraudRegistry, gel réputation, suspension accès et action juridique selon gravité.

14 · ShariahGateway & circuit breaker

Si la preuve Shariah devient indisponible, les nouveaux pools sont bloqués.

ShariahGateway.sol est le point de contrôle technique entre HAQQ Ethiq et Base. Il vérifie que le certificat est actif, que le contrat correspond au hash certifié et que le pont/oracle ne renvoie pas de données périmées.

if gatewayMode == PAUSED:
    block sensitive actions
if oracleStatus == UNAVAILABLE:
    block new pools
if bridgeDataIsStale == true:
    block new pools
if certificate.status == REVOKED:
    reject pool
if certificate.status == SUSPENDED:
    scholar review required
if bytecodeHash != certifiedHash:
    reject pool
else:
    allow next action
En mode dégradé, le dernier statut connu peut servir au suivi des dossiers déjà ouverts, mais jamais à ouvrir automatiquement un nouveau pool.
15 · Shariah Oracle HAQQ Ethiq

La certification HAQQ doit être un processus, pas un badge marketing.

ETHIGONE conserve un Scholar Board interne pour la première revue, puis HAQQ Ethiq sert de couche de certification indépendante, vérifiable et auditable.

Processus Shariah Oracle

1. ETHIGONE prépare le dossier technique et économique
2. Scholar Board interne valide ou refuse la structure
3. Le dossier validé est soumis au Shariah Oracle HAQQ Ethiq
4. Community Approval / revue de conformité HAQQ
5. Scholar Board HAQQ examine politique, contrat et version
6. Certificat / label SBT non transférable émis si validation
7. ShariahGateway.sol publie le statut : ACTIVE, SUSPENDED, REVOKED
8. TradeFinancePool.sol exécute uniquement si statut ACTIVE
16 · Sécurité & contrôles anti-fraude

La sécurité V8.2 doit couvrir les risques importateur, pas seulement blockchain.

RisqueContrôle techniqueAction si incident
Fournisseur fantômeSupplierRegistry + KYB léger + compte bancaire vérifié.Refus dossier.
Faux débouché commercialBuyerCommitmentRegistry + preuve acheteur final.Revue ou refus.
Double financementHash facture, documents CargoX/IPFS, FraudRegistry.Blocage et inscription fraude.
Marchandise non conformeInspection tiers + statut milestone.Gel paiement final, litige fournisseur.
Défaut importateurCompte de règlement, preuve encaissement, ReputationEngine.DefaultWorkflow puis ICC.
Oracle indisponibleShariahGateway circuit breaker.Blocage nouveaux pools.
17 · API & intégrations

Les intégrations doivent rester manuelles au début, puis devenir API en Phase 2-3.

La Phase 1 ne doit pas chercher le full automation. L’objectif est de prouver que le flux fonctionne avec de vrais dossiers, de vrais paiements et de vraies preuves. L’automatisation vient ensuite.

IntégrationPhase 1Phase 2-3
VASP / PSPDécaissement manuel validéAPI conversion + payout
CargoX / eBLRéférence et preuve uploadéesLecture API / webhook
InspectionRapport PDF vérifiéAPI partenaire ou signature vérifiable
TrackingUpload manuel / lien transporteurOracle Chainlink / webhooks
ERP importateurNon prioritaireConnecteur API
18 · Roadmap technique

La V8.2 démarre semi-manuelle, puis automatise seulement ce qui est validé terrain.

Phase 1 · Manuel contrôlé

Dashboard, KYB, upload documents, scoring assisté, pool test, paiement manuel, settlement assisté.

Phase 2 · Testnet

TradeFinancePool testnet, Shariah Oracle testnet, circuit breaker, simulation paiements et défauts.

Phase 3 · Mainnet contrôlé

Certificats HAQQ mainnet, pools réels limités, paiements partenaire régulé, distribution on-chain.

Phase 4 · API scale

Automatisation API, multi-corridors, intégrations partenaires, reporting investisseurs et scoring dynamique.

19 · MVP build scope

Le MVP ne doit coder que le nécessaire pour prouver le modèle.

FonctionMVP Phase 1Plus tard
Création dossier importOuiAPI ERP
KYB importateurOuiAutomatisation complète
Vérification fournisseurOuiScoring externe enrichi
Débouché commercialOuiConnexion marketplaces / ERP
Pool USDCOuiMulti-devises / EURC
Paiement prestatairesSemi-manuelAPI payout complète
SettlementAssistéAutomatisé avec preuves bancaires
Oracle logistiqueNon prioritairePhase 3-4