4nk/story-research-zapwall
5
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
story-research-zapwall/docs/publishing-guide.md
Nicolas Cantu 90ff8282f1 feat: Implémentation système de commissions systématique et incontournable 
- Création lib/platformCommissions.ts : configuration centralisée des commissions
  - Articles : 800 sats (700 auteur, 100 plateforme)
  - Avis : 70 sats (49 lecteur, 21 plateforme)
  - Sponsoring : 0.046 BTC (0.042 auteur, 0.004 plateforme)

- Validation des montants à chaque étape :
  - Publication : vérification du montant avant publication
  - Paiement : vérification du montant avant acceptation
  - Erreurs explicites si montant incorrect

- Tracking des commissions sur Nostr :
  - Tags author_amount et platform_commission dans événements
  - Interface ContentDeliveryTracking étendue
  - Traçabilité complète pour audit

- Logs structurés avec informations de commission
- Documentation complète du système

Les commissions sont maintenant systématiques, validées et traçables.
2025-12-27 21:11:09 +01:00

6.9 KiB
Raw Blame History

Guide de publication d'articles

Ce guide vous explique comment publier un article sur Nostr Paywall avec un aperçu gratuit et un contenu payant.

Prérequis

Avant de publier un article, vous devez avoir :

  1. ✅ Un portefeuille Nostr (pour vous connecter et signer les événements)
  2. ✅ Alby installé (pour créer l'invoice Lightning)
  3. ✅ Des fonds dans votre portefeuille Lightning (optionnel, mais recommandé pour tester)

Étapes de publication

1. Se connecter avec Nostr

  1. Cliquez sur "Connect with Nostr" en haut à droite
  2. Autorisez la connexion avec votre portefeuille Nostr
  3. Vérifiez que votre profil s'affiche correctement

2. Accéder à la page de publication

  1. Cliquez sur "Publish Article" dans le menu principal
  2. Vous serez redirigé vers la page /publish

3. Remplir le formulaire

Le formulaire contient 4 champs :

Titre (obligatoire)

  • Le titre de votre article
  • Visible par tous dans la liste des articles
  • Exemple : "Introduction à Nostr"

Preview / Aperçu (obligatoire)

  • Le contenu gratuit visible par tous
  • C'est ce que les lecteurs verront avant de payer
  • Doit être suffisamment intéressant pour inciter à payer
  • Exemple : "Découvrez les bases du protocole Nostr et comment il révolutionne les réseaux sociaux décentralisés..."

Content / Contenu complet (obligatoire)

  • Le contenu complet qui sera débloqué après paiement
  • Envoyé via message privé chiffré (NIP-04) après paiement
  • Peut contenir du texte, des images (liens), etc.
  • Exemple : "Nostr est un protocole de réseau social décentralisé basé sur des clés cryptographiques..."

Sponsoring / Montant de sponsoring

  • Le montant de sponsoring est fixe : 800 sats (satoshi)
  • 1 BTC = 100 000 000 sats
  • 800 sats = environ 0,000008 BTC
  • Tous les articles ont le même montant de sponsoring

4. Publier l'article

  1. Cliquez sur le bouton "Publish"
  2. Si Alby n'est pas installé, vous serez invité à l'installer
  3. Autorisez la création de l'invoice Lightning dans Alby
  4. L'invoice sera créée automatiquement
  5. Votre article sera publié sur le relay Nostr

5. Confirmation

Une fois publié, vous verrez :

  • ✅ Un message de confirmation "Article Published!"
  • Vous serez automatiquement redirigé vers la page d'accueil après 2 secondes
  • Votre article apparaîtra dans la liste des articles

Comment ça fonctionne techniquement

1. Publication de l'aperçu

L'aperçu est publié comme un événement Nostr de type 1 (note textuelle) avec les tags suivants :

  • title : Le titre de l'article
  • preview : L'aperçu gratuit
  • zap : Le montant de sponsoring en sats (800 sats)
  • content-type : "article"
  • invoice : L'invoice Lightning (BOLT11)
  • payment_hash : Le hash de l'invoice

2. Création de l'invoice

L'invoice Lightning est créée via Alby/WebLN lors de la publication :

  • Montant : 800 sats (montant fixe pour tous les articles)
  • Description : "Payment for article: {titre}"
  • Expiration : 24 heures

3. Stockage du contenu complet

Le contenu complet est stocké localement dans votre navigateur (IndexedDB) :

  • Associé à l'ID de l'article
  • Expire après 30 jours
  • Utilisé pour envoyer le contenu après paiement

4. Envoi du contenu après paiement

Quand un lecteur paie :

  1. Le paiement est vérifié via les reçus de zap Nostr (NIP-57)
  2. Le contenu complet est envoyé via message privé chiffré (NIP-04)
  3. Le message privé contient :
    • Le contenu chiffré
    • Un tag e liant à l'article
    • Un tag p avec la clé publique du destinataire

Conseils pour bien publier

Écrire un bon aperçu

L'aperçu est crucial pour inciter les lecteurs à payer :

  • ✅ Donnez un avant-goût du contenu complet
  • ✅ Posez une question ou créez de la curiosité
  • ✅ Mentionnez les points clés qui seront développés
  • ❌ Ne révélez pas tout le contenu
  • ❌ Ne soyez pas trop vague

Exemple d'aperçu efficace :

"Découvrez comment Nostr révolutionne les réseaux sociaux en éliminant les serveurs centralisés. Dans cet article, nous explorerons l'architecture du protocole, les avantages de la décentralisation, et comment créer votre première application Nostr. Vous apprendrez également à implémenter des paiements Lightning directement dans vos applications."

Montant de sponsoring

Le montant de sponsoring est fixe à 800 sats pour tous les articles. Cela simplifie l'expérience utilisateur et garantit une tarification équitable.

Contenu de qualité

Le contenu complet doit :

  • ✅ Être substantiel et apporter de la valeur
  • ✅ Justifier le montant de sponsoring de 800 sats
  • ✅ Être bien formaté et lisible
  • ✅ Inclure des exemples ou des illustrations si pertinent

Gestion des articles publiés

Voir vos articles

  1. Cliquez sur votre profil (nom/avatar en haut à droite)
  2. La section "My Articles" affiche tous vos articles
  3. Vous pouvez rechercher et filtrer vos articles

Statistiques

Actuellement, vous pouvez voir :

  • Le nombre d'articles publiés
  • Les notifications de paiements reçus

Note

: Des statistiques plus détaillées (vues, revenus, etc.) seront ajoutées dans une future version.

Édition et suppression

Note

: L'édition et la suppression d'articles ne sont pas encore disponibles. Les événements Nostr sont immutables, donc une fois publié, un article ne peut pas être modifié. Cette fonctionnalité sera ajoutée dans une future version.

Dépannage

Je ne peux pas publier

Vérifiez :

  • ✅ Que vous êtes connecté avec Nostr
  • ✅ Que votre portefeuille Nostr peut signer des événements
  • ✅ Que Alby est installé et activé
  • ✅ Que tous les champs sont remplis

L'invoice ne se crée pas

Vérifiez :

  • ✅ Que Alby est installé
  • ✅ Que vous avez autorisé l'application dans Alby
  • ✅ Que votre portefeuille Lightning a des fonds (optionnel)
  • ✅ Votre connexion internet

L'article ne s'affiche pas après publication

Vérifiez :

  • ✅ Que le relay Nostr est accessible
  • ✅ Rafraîchissez la page
  • ✅ Vérifiez la console du navigateur pour les erreurs

Je ne reçois pas les paiements

Vérifiez :

  • ✅ Que les lecteurs paient effectivement
  • ✅ Vos notifications (badge en haut à droite)
  • ✅ Votre portefeuille Lightning
  • ✅ Que l'invoice n'a pas expiré

Bonnes pratiques

Fréquence de publication

  • Publiez régulièrement pour maintenir l'engagement
  • Ne publiez pas trop souvent (risque de spam)
  • Qualité > Quantité

Promotion

  • Partagez vos articles sur d'autres plateformes Nostr
  • Mentionnez vos articles dans vos notes Nostr
  • Créez une communauté autour de votre contenu

Engagement avec les lecteurs

  • Répondez aux commentaires (si cette fonctionnalité est ajoutée)
  • Créez du contenu de qualité qui mérite d'être payé
  • Écoutez les retours de vos lecteurs

Dernière mise à jour : Décembre 2024