story-research-zapwall/docs/publishing-guide.md

Guide de publication

Ce guide vous explique comment publier une publication sur zapwall.fr avec un aperçu gratuit et un contenu payant.

Prérequis

Avant de publier une publication, vous devez avoir :

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

Étapes de publication

1. Créer votre page auteur (obligatoire)

Avant de pouvoir publier, vous devez créer votre page auteur :

1. Connectez-vous avec Nostr
2. Cliquez sur "Créer page auteur" dans le menu
3. Remplissez votre présentation :
   • Votre description
   • Votre adresse Bitcoin mainnet pour le sponsoring (optionnel)
4. Publiez votre page auteur

Important

: La page auteur est obligatoire. Vous ne pouvez pas publier de publication sans avoir créé votre page auteur.

2. Accéder à la page de publication

1. Cliquez sur "Publier une publication" dans le menu principal
2. Vous serez redirigé vers la page /publish

3. Remplir le formulaire

Le formulaire contient plusieurs champs :

Titre (obligatoire)

• Le titre de votre publication
• Visible par tous dans la liste des publications
• 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..."

Catégorie (obligatoire)

• Science-fiction : Pour les contenus de fiction scientifique
• Recherche scientifique : Pour les contenus scientifiques et de recherche

Série (optionnel)

• Vous pouvez créer une nouvelle série ou sélectionner une série existante
• Les séries permettent d'organiser vos publications par thème
• Remplissez les informations de la série :
  • Titre
  • Description
  • Image de couverture (optionnel)

4. Publier la publication

1. Cliquez sur le bouton "Publier la publication"
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 (800 sats)
5. Votre publication sera publiée sur le relay Nostr

5. Confirmation

Une fois publiée, vous verrez :

• ✅ Un message de confirmation
• Vous serez automatiquement redirigé vers la page d'accueil
• Votre publication apparaîtra dans la liste des publications

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 :

• #publication : Type de contenu
• #sciencefiction ou #research : Catégorie
• #id_<id> : Identifiant unique
• #paywall : Indique que le contenu est payant
• title : Le titre de la publication
• preview : L'aperçu gratuit
• zapAmount : Le montant en sats (800 sats)
• invoice : L'invoice Lightning (BOLT11)
• paymentHash : 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 toutes les publications)
• Description : "Payment for publication: {titre}"
• Expiration : 24 heures

3. Stockage du contenu complet

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

• Associé à l'ID de la publication
• Chiffré avec AES-GCM
• 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 à la publication
   • Un tag p avec la clé publique du destinataire

Commissions

Sur les ventes de publications

• Montant total : 800 sats
• À l'auteur : 700 sats
• Commission plateforme : 100 sats
• Frais de transaction : Payés par l'auteur

Sur le sponsoring

• Montant total : 0.046 BTC
• À l'auteur : 0.042 BTC
• Commission plateforme : 0.004 BTC
• Frais de transaction : Payés par l'auteur

Sur les remerciements d'avis

• Montant total : 70 sats
• Au reviewer : 49 sats
• Commission plateforme : 21 sats
• Frais de transaction : Payés par l'auteur

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 paiement

Le montant est fixe à 800 sats pour toutes les publications. 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 paiement de 800 sats
• ✅ Être bien formaté et lisible
• ✅ Inclure des exemples ou des illustrations si pertinent

Utiliser les séries

Les séries permettent d'organiser vos publications :

• ✅ Créez des séries thématiques
• ✅ Regroupez vos publications par sujet
• ✅ Facilitez la découverte de vos contenus

Gestion des publications publiées

Voir vos publications

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

Statistiques

Actuellement, vous pouvez voir :

• Le nombre de publications publiées
• Les notifications de paiements reçus

Note

: Des statistiques plus détaillées seront ajoutées dans une future version.

Édition et suppression

Note

: L'édition et la suppression de publications ne sont pas encore disponibles. Les événements Nostr sont immutables, donc une fois publiée, une publication ne peut pas être modifiée. 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 vous avez créé votre page auteur (obligatoire)
• ✅ 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

La publication 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 publications sur d'autres plateformes Nostr
• Mentionnez vos publications dans vos notes Nostr
• Créez une communauté autour de votre contenu

Engagement avec les lecteurs

• Répondez aux avis (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