story-research-zapwall/docs/author-funds-specification.md

Author Funds Collection Specification

Author: Équipe 4NK Date: 2026-01-14

Objectifs

1. Pour chaque auteur, collecter :

   • Fonds perçus sur le mempool (Bitcoin mainnet pour sponsoring)
   • Fonds perçus par la plateforme (commission)

2. Créer un lien entre :

   • Paiement (zap receipt) ↔ Note de paiement ↔ Objet (publication/avis/auteur)

3. Clarification de la structure :

   • Publications (plusieurs pages d'une série) sont les objets achetés
   • Séries sont les objets commentés (reviews)
   • Avis/Commentaires sont les objets récompensés (review tips)
   • Auteurs sont les objets sponsorisés
   • Les publications sont des notes (kind 1)
   • Les pages sont dans le JSON des notes de publications (pas de notes séparées)

Tags à ajouter

Payment Notes (kind 1, type='payment')

• publication_id ou article: ID de la publication (pour achat)
• series_id ou series: ID de la série (si applicable)
• review_id: ID de l'avis (pour review tip)
• author: Pubkey de l'auteur (receveur)
• zap_receipt: ID du zap receipt (si Lightning)
• transaction_id: ID de la transaction Bitcoin (si mainnet sponsoring)
• platform_commission: Montant de la commission
• author_funds: Fonds reçus par l'auteur

Zap Receipts (kind 9735)

Déjà présents :

• #e: Event ID (article ID pour purchases)
• #p: Pubkey (author pubkey)
• kind_type: Type de paiement
• review_id: Review ID (pour review tips)
• series: Series ID (optionnel)

Prochaines étapes

1. ✅ Document de spécification créé
2. ⏳ Modifier les payment notes pour inclure les tags de liaison
3. ⏳ Créer un service pour collecter les fonds par auteur
4. ⏳ Intégrer la collecte des fonds du mempool pour sponsoring Bitcoin
5. ⏳ Créer une interface pour afficher les fonds par auteur