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.
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.
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
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
| Module | Rôle | Pourquoi il est nécessaire |
|---|---|---|
| TradeFinancePool.sol | Crée et gère un pool par opération import. | Remplace le pool Musharakah unique et supporte Mudarabah/Musharakah selon le dossier. |
| ShariahEngine | Qualifie la structure économique du dossier. | Évite d’appeler Musharakah une opération qui est en réalité Mudarabah. |
| CompanyTradePassport.sol | Registre d’identité et d’historique des acteurs. | Importateur, fournisseur, acheteur final, transitaire et inspecteur ne doivent pas être mélangés. |
| SupplierRegistry.sol | Vérifie le fournisseur et ses coordonnées bancaires. | Empêche le paiement d’un fournisseur fantôme ou d’un compte tiers suspect. |
| BuyerCommitmentRegistry.sol | Enregistre le débouché commercial. | Le financement dépend d’une revente crédible, pas d’une promesse vague. |
| PaymentMilestoneEngine.sol | Gère les jalons de paiement. | Le fournisseur peut être payé par étapes : commande, inspection, documents, expédition. |
| ImportSettlementEngine.sol | Calcule profit, perte et distribution. | La distribution doit dépendre de l’encaissement réel. |
| DefaultWorkflow.sol | Gère retards, défauts, Takaful et litiges. | Évite l’improvisation à J+7, J+14, J+30. |
| FraudRegistry.sol | Marque les fraudes et double financements. | Protège les investisseurs et l’historique des acteurs. |
| TakafulReserve.sol | Gère la réserve Tabarru’. | 2% en Phase 1, montée possible à 5% en Phase 2, sans garantie de capital. |
| ShariahGateway.sol | Vérifie statut HAQQ Ethiq avant action sensible. | Bloque les pools si certificat absent, suspendu, révoqué ou oracle indisponible. |
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
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
L’importateur crée un dossier avec facture fournisseur, marchandise, Incoterm, montant demandé, débouché commercial et documents de base.
KYB importateur, vérification fournisseur, compte bancaire fournisseur, acheteur final ou débouché, scoring initial.
ShariahEngine décide Mudarabah Import, Musharakah Import ou revue Scholar Board selon l’apport capital, la marge et le risque.
TradeFinancePool.sol ouvre uniquement si les critères bloquants sont passés et si ShariahGateway retourne un statut ACTIVE.
Les investisseurs déposent. Les fonds restent verrouillés jusqu’à validation des jalons de paiement.
Décaissement via VASP/PSP régulé : fournisseur, inspecteur, transporteur, assureur. Jamais versement libre à l’importateur.
Preuves CargoX/IPFS, inspection SGS/BV/Intertek, tracking, documents douane, preuve de livraison.
ImportSettlementEngine calcule le résultat réel uniquement après preuve d’encaissement de la revente.
Si profit réel : distribution selon ratio. Si retard/défaut : DefaultWorkflow, Takaful, ReputationEngine, puis ICC si nécessaire.
| Critère | Décision technique | Raison |
|---|---|---|
| KYB importateur incomplet | REFUS | On ne finance pas un acteur non identifié. |
| Fournisseur non vérifiable | REFUS | Risque fournisseur fantôme ou compte frauduleux. |
| Compte bancaire fournisseur incohérent | REFUS | Le paiement direct doit arriver au bon bénéficiaire. |
| Marchandise blacklistée | REFUS | Conformité Shariah non négociable. |
| Débouché commercial absent | REFUS | Pas de revente crédible, donc pas de profit vérifiable. |
| Marge irréaliste | REVUE | Peut cacher fraude, erreur ou promesse de rendement. |
| Double financement détecté | REFUS | Risque de fraude documentaire. |
| Certificat Shariah non ACTIVE | REFUS | ShariahGateway doit bloquer l’ouverture. |
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ère | Score | Seuil | Source |
|---|---|---|---|
| Historique importateur | 0-100 | < 40 = refus | KYB, factures passées, activité, réputation. |
| Capacité de revente | 0-100 | < 40 = refus | Bon de commande, client final, canal de vente, historique. |
| Marge réaliste | 0-100 | < 60 = revue | Prix fournisseur, marché, frais, délai, secteur. |
| Risque corridor | 0-100 | < 60 = revue | Pays, douane, logistique, historique d’incidents. |
| Qualité fournisseur | 0-100 | < 40 = refus | KYB 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
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
Le paiement libre à l’importateur est interdit en Phase 1. Les fonds vont uniquement vers des bénéficiaires vérifiés.
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.
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.
| Jalon | Déclencheur | Paiement possible | Preuve requise |
|---|---|---|---|
| Commande | Dossier validé + pool financé | Acompte fournisseur | Facture pro-forma, compte fournisseur, contrat. |
| Pré-expédition | Marchandise prête | Paiement partiel | Inspection avant expédition, photos, rapport tiers. |
| Documents | Documents transport disponibles | Solde fournisseur ou fret | eBL, CargoX, packing list, certificat. |
| Arrivée | Livraison ou douane validée | Prestataires restants | Preuve livraison, déclaration, facture prestataire. |
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
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
Tabarru’ 2% en Phase 1. Aide solidaire selon règles validées, jamais garantie de capital.
Arbitrage ICC standard par défaut pour les dossiers internationaux, sauf contrainte locale documentée.
FraudRegistry, gel réputation, suspension accès et action juridique selon gravité.
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
| Risque | Contrôle technique | Action si incident |
|---|---|---|
| Fournisseur fantôme | SupplierRegistry + KYB léger + compte bancaire vérifié. | Refus dossier. |
| Faux débouché commercial | BuyerCommitmentRegistry + preuve acheteur final. | Revue ou refus. |
| Double financement | Hash facture, documents CargoX/IPFS, FraudRegistry. | Blocage et inscription fraude. |
| Marchandise non conforme | Inspection tiers + statut milestone. | Gel paiement final, litige fournisseur. |
| Défaut importateur | Compte de règlement, preuve encaissement, ReputationEngine. | DefaultWorkflow puis ICC. |
| Oracle indisponible | ShariahGateway circuit breaker. | Blocage nouveaux pools. |
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égration | Phase 1 | Phase 2-3 |
|---|---|---|
| VASP / PSP | Décaissement manuel validé | API conversion + payout |
| CargoX / eBL | Référence et preuve uploadées | Lecture API / webhook |
| Inspection | Rapport PDF vérifié | API partenaire ou signature vérifiable |
| Tracking | Upload manuel / lien transporteur | Oracle Chainlink / webhooks |
| ERP importateur | Non prioritaire | Connecteur API |
Dashboard, KYB, upload documents, scoring assisté, pool test, paiement manuel, settlement assisté.
TradeFinancePool testnet, Shariah Oracle testnet, circuit breaker, simulation paiements et défauts.
Certificats HAQQ mainnet, pools réels limités, paiements partenaire régulé, distribution on-chain.
Automatisation API, multi-corridors, intégrations partenaires, reporting investisseurs et scoring dynamique.
| Fonction | MVP Phase 1 | Plus tard |
|---|---|---|
| Création dossier import | Oui | API ERP |
| KYB importateur | Oui | Automatisation complète |
| Vérification fournisseur | Oui | Scoring externe enrichi |
| Débouché commercial | Oui | Connexion marketplaces / ERP |
| Pool USDC | Oui | Multi-devises / EURC |
| Paiement prestataires | Semi-manuel | API payout complète |
| Settlement | Assisté | Automatisé avec preuves bancaires |
| Oracle logistique | Non prioritaire | Phase 3-4 |