story-research-zapwall/docs/remaining-tasks.md

Tâches restantes - Système de commissions

Date : Décembre 2024 Auteur : Équipe 4NK

État actuel

✅ Implémenté :

• Configuration centralisée des commissions
• Validation des montants à chaque étape
• Tracking des commissions sur Nostr
• Services de split (articles, avis, sponsoring)
• Services de transfert automatique (structure)

⏳ À compléter :

1. Intégration mempool.space pour vérification transactions Bitcoin
2. Récupération adresses Lightning depuis profils Nostr
3. Mise à jour événements Nostr pour avis rémunérés
4. Tracking sponsoring sur Nostr
5. Transferts Lightning réels (nécessite nœud Lightning)

Tâches détaillées

1. Intégration mempool.space ✅ IMPLÉMENTÉ

Objectif : Vérifier que les transactions Bitcoin de sponsoring contiennent les deux sorties correctes.

API mempool.space :

• Endpoint : https://mempool.space/api/tx/{txid}
• Documentation : https://mempool.space/api

Implémenté :

• ✅ Service MempoolSpaceService pour récupérer une transaction depuis mempool.space
• ✅ Vérification que la transaction a deux sorties :
  • Sortie 1 : split.authorSats vers authorMainnetAddress
  • Sortie 2 : split.platformSats vers PLATFORM_BITCOIN_ADDRESS
• ✅ Vérification du nombre de confirmations
• ✅ Gestion des erreurs et retry
• ✅ Intégré dans sponsoringPayment.ts

Fichier : lib/mempoolSpace.ts ✅

2. Récupération adresses Lightning ✅ IMPLÉMENTÉ

Objectif : Récupérer les adresses Lightning des auteurs/reviewers depuis leurs profils Nostr.

Standards Nostr :

• NIP-19 : Lightning addresses dans les métadonnées de profil
• Format : lud16 ou lud06 dans le profil JSON
• Exemple : {"lud16": "user@domain.com"}

Implémenté :

• ✅ Service LightningAddressService pour parser les métadonnées de profil
• ✅ Extraction de lud16 ou lud06 depuis les profils
• ✅ Cache des adresses récupérées
• ✅ Fallback si pas d'adresse disponible
• ✅ Intégré dans paymentPolling.ts et reviewReward.ts

Fichiers :

• lib/lightningAddress.ts ✅
• types/nostr.ts ✅ (ajout de lud16 et lud06)

3. Mise à jour événements Nostr pour avis ✅ IMPLÉMENTÉ

Objectif : Mettre à jour l'événement Nostr d'un avis avec les tags rewarded: true et reward_amount: 70.

Implémenté :

• ✅ Récupération de l'événement original de l'avis
• ✅ Ajout des tags rewarded et reward_amount
• ✅ Publication de l'événement mis à jour
• ✅ Gestion des erreurs si l'événement n'existe plus
• ✅ Vérification que l'avis n'est pas déjà rémunéré
• ✅ Parsing des tags dans parseReviewFromEvent

Fichiers :

• lib/reviewReward.ts ✅ (méthode updateReviewWithReward implémentée)
• lib/nostrEventParsing.ts ✅ (parsing des tags rewarded et reward_amount)

4. Tracking sponsoring sur Nostr ✅ IMPLÉMENTÉ

Objectif : Publier des événements de tracking pour les paiements de sponsoring.

Implémenté :

• ✅ Service SponsoringTrackingService pour publier les événements
• ✅ Tags similaires aux articles : author_amount, platform_commission
• ✅ Vérification de transaction via mempool.space avant tracking
• ✅ Informations de confirmation et nombre de confirmations
• ✅ Intégré dans sponsoringPayment.ts

Fichiers :

• lib/sponsoringTracking.ts ✅ (nouveau service)
• lib/sponsoringPayment.ts ✅ (méthode trackSponsoringPayment implémentée)

5. Transferts Lightning réels (PRIORITÉ BASSE - nécessite infrastructure)

Objectif : Effectuer réellement les transferts Lightning vers les auteurs/reviewers.

Prérequis :

• Nœud Lightning de la plateforme
• API pour créer et payer des invoices
• Gestion des erreurs et retry

À implémenter :

• Intégration avec l'API du nœud Lightning
• Création d'invoices pour les transferts
• Paiement automatique des invoices
• Queue de transferts en attente
• Retry en cas d'échec

Fichier : lib/automaticTransfer.ts (modifier les méthodes de transfert)

Plan d'implémentation

Phase 1 : Vérification transactions ✅ TERMINÉ

1. ✅ Créer lib/mempoolSpace.ts
2. ✅ Implémenter récupération transaction
3. ✅ Implémenter vérification sorties
4. ✅ Intégrer dans sponsoringPayment.ts

Phase 2 : Adresses Lightning ✅ TERMINÉ

1. ✅ Créer lib/lightningAddress.ts
2. ✅ Parser profils Nostr pour lud16/lud06
3. ✅ Intégrer dans paymentPolling.ts et reviewReward.ts

Phase 3 : Mise à jour avis ✅ TERMINÉ

1. ✅ Implémenter updateReviewWithReward dans reviewReward.ts
2. ✅ Parser tags rewarded et reward_amount dans parseReviewFromEvent

Phase 4 : Tracking sponsoring ✅ TERMINÉ

1. ✅ Créer lib/sponsoringTracking.ts
2. ✅ Implémenter tracking dans sponsoringPayment.ts
3. ⏳ Mise à jour total_sponsoring sur présentation (structure préparée)

Phase 5 : Transferts réels (long terme - nécessite infrastructure)

1. ⏳ Configurer nœud Lightning
2. ⏳ Implémenter API d'intégration
3. ⏳ Créer queue de transferts
4. ⏳ Monitoring et alertes

Notes techniques

mempool.space API

Récupérer une transaction :

GET https://mempool.space/api/tx/{txid}

Réponse :

{
  "txid": "...",
  "vout": [
    {
      "value": 4200000,
      "scriptpubkey_address": "bc1q..."
    },
    {
      "value": 400000,
      "scriptpubkey_address": "bc1q..."
    }
  ],
  "status": {
    "confirmed": true,
    "block_height": 123456,
    "block_hash": "..."
  }
}

Lightning addresses dans Nostr

Format profil :

{
  "name": "Author",
  "lud16": "author@getalby.com",
  "lud06": "lnurl..."
}

NIP-19 : Les adresses Lightning peuvent être dans les métadonnées de profil (kind 0).