- 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.
8.8 KiB
Guide d'utilisation - Nostr Paywall
Bienvenue sur Nostr Paywall ! Cette plateforme vous permet de lire des articles avec des aperçus gratuits et de débloquer le contenu complet en payant avec Lightning Network.
Table des matières
- Introduction
- Premiers pas
- Connexion avec Nostr
- Lire des articles
- Payer pour débloquer un article
- Rechercher et filtrer des articles
- Voir votre profil
- Notifications
- Dépannage
Introduction
Nostr Paywall est une plateforme de publication d'articles basée sur le protocole Nostr. Les auteurs peuvent publier des articles avec :
- Aperçu gratuit : Visible par tous
- Contenu complet : Débloqué après un paiement Lightning de 800 sats (par défaut)
Fonctionnalités principales
- ✅ Lecture gratuite des aperçus d'articles
- ✅ Déblocage du contenu complet via paiement Lightning
- ✅ Recherche et filtrage d'articles
- ✅ Profil utilisateur avec vos articles
- ✅ Notifications en temps réel pour les paiements
- ✅ Publication d'articles avec paiement Lightning
Premiers pas
1. Installer Alby (recommandé)
Pour effectuer des paiements Lightning, vous devez installer une extension de portefeuille Lightning compatible avec WebLN :
- Visitez getalby.com
- Installez l'extension Alby pour votre navigateur
- Créez un compte ou connectez votre portefeuille Lightning existant
- Ajoutez des fonds à votre portefeuille Alby
Note
: D'autres portefeuilles Lightning compatibles WebLN fonctionnent également.
2. Accéder à la plateforme
- Ouvrez [votre instance de Nostr Paywall] dans votre navigateur
- Vous verrez la liste des articles disponibles
- Cliquez sur "Connect with Nostr" pour vous connecter
Connexion avec Nostr
Comment se connecter
- Cliquez sur le bouton "Connect with Nostr" en haut à droite
- Une fenêtre s'ouvrira pour vous connecter avec votre portefeuille Nostr
- Par défaut, l'application utilise
use.nsec.appcomme pont NostrConnect - Autorisez la connexion dans votre portefeuille Nostr
Que se passe-t-il après la connexion ?
- ✅ Votre profil Nostr s'affiche (nom, avatar, etc.)
- ✅ Vous pouvez publier des articles
- ✅ Vous pouvez payer pour débloquer des articles
- ✅ Vous recevez des notifications pour les paiements reçus
- ✅ Vous pouvez accéder à votre profil avec vos articles
Déconnexion
Cliquez sur le bouton "Disconnect" pour vous déconnecter.
Lire des articles
Aperçu gratuit
Tous les articles affichent automatiquement :
- Titre de l'article
- Aperçu (preview) - contenu gratuit
- Auteur (clé publique Nostr)
- Montant de sponsoring en sats (800 sats)
- Date de publication
Contenu complet
Pour lire le contenu complet d'un article :
- Cliquez sur le bouton "Débloquer avec X sats zap"
- Suivez les instructions pour effectuer un zap Lightning
- Une fois le zap confirmé, le contenu complet s'affichera automatiquement
Note
: Le contenu débloqué est stocké localement dans votre navigateur et reste accessible même après déconnexion.
Payer pour débloquer un article
Processus de zap
- Cliquez sur "Débloquer avec X sats zap" sur l'article que vous souhaitez débloquer
- Une fenêtre s'ouvre avec :
- Le montant du zap (800 sats)
- Un QR code Lightning
- L'invoice Lightning
- Un bouton "Pay with Alby"
- Choisissez votre méthode de zap :
- Option 1 : Cliquez sur "Pay with Alby" (recommandé)
- Votre extension Alby s'ouvrira automatiquement
- Confirmez le zap dans Alby
- Option 2 : Scannez le QR code avec votre portefeuille Lightning mobile
- Option 3 : Copiez l'invoice et effectuez le zap depuis votre portefeuille
- Option 1 : Cliquez sur "Pay with Alby" (recommandé)
- Attendez la confirmation :
- Le zap est vérifié automatiquement via les reçus de zap Nostr (NIP-57)
- Le contenu complet s'affichera automatiquement une fois confirmé
- Cela peut prendre quelques secondes
Note
: Seuls les zaps sont autorisés pour débloquer les articles. Les paiements Lightning standard ne fonctionnent pas.
Expiration des invoices
Les invoices Lightning expirent après 24 heures. Si une invoice expire :
- Fermez la fenêtre de paiement
- Cliquez à nouveau sur "Unlock Article" pour générer une nouvelle invoice
Problèmes de paiement
Si le paiement échoue :
- Vérifiez que vous avez suffisamment de fonds dans votre portefeuille
- Vérifiez que l'invoice n'a pas expiré
- Réessayez en cliquant à nouveau sur "Unlock Article"
- Consultez la section Dépannage
Rechercher et filtrer des articles
Barre de recherche
Utilisez la barre de recherche en haut de la page pour rechercher des articles par :
- Titre
- Aperçu (preview)
- Contenu (même le contenu débloqué est recherchable)
Filtres
Les filtres vous permettent de :
- Filtrer par auteur : Sélectionnez un auteur spécifique
- Trier les articles :
- Sponsoring puis date (par défaut) : Les auteurs avec le plus de sponsoring apparaissent en premier
- Plus anciens d'abord
Utilisation des filtres
- Utilisez les menus déroulants pour sélectionner vos filtres
- Les résultats se mettent à jour automatiquement
- Cliquez sur "Clear Filters" pour réinitialiser tous les filtres
Voir votre profil
Accéder à votre profil
- Connectez-vous avec Nostr
- Cliquez sur votre nom ou avatar en haut à droite
- Vous serez redirigé vers la page
/profile
Informations affichées
Votre profil affiche :
- Photo de profil (si disponible)
- Nom (si défini dans votre profil Nostr)
- Clé publique (pubkey)
- NIP-05 (si vérifié)
- Description (about)
- Nombre d'articles publiés
Vos articles
La section "My Articles" affiche :
- Tous vos articles publiés
- Recherche et filtres sur vos articles
- Statut de déblocage pour chaque article
Notifications
Types de notifications
Actuellement, vous recevez des notifications pour :
- Paiements reçus : Quand quelqu'un paie pour un de vos articles
Badge de notification
- Un badge rouge avec le nombre de notifications non lues apparaît à côté de votre profil
- Cliquez sur le badge pour ouvrir le centre de notifications
Centre de notifications
Le centre de notifications affiche :
- Liste de toutes vos notifications
- Indicateur visuel pour les notifications non lues
- Actions disponibles :
- Marquer comme lu : Cliquez sur une notification
- Marquer tout comme lu : Bouton en haut
- Supprimer : Icône de poubelle sur chaque notification
- Tout supprimer : Bouton "Clear all"
Notifications persistantes
Les notifications sont stockées localement dans votre navigateur et persistent même après déconnexion.
Dépannage
Problèmes de connexion
Je ne peux pas me connecter avec Nostr
- Vérifiez que votre portefeuille Nostr est accessible
- Vérifiez que le pont NostrConnect (
use.nsec.app) est accessible - Essayez de rafraîchir la page
- Vérifiez votre connexion internet
Problèmes de paiement
Le paiement ne fonctionne pas
- Vérifiez que Alby (ou votre portefeuille Lightning) est installé et activé
- Vérifiez que vous avez suffisamment de fonds
- Vérifiez que l'invoice n'a pas expiré
- Essayez de rafraîchir la page et réessayez
Le contenu ne se débloque pas après le paiement
- Attendez quelques secondes (la vérification peut prendre du temps)
- Vérifiez que le paiement a bien été effectué dans votre portefeuille
- Rafraîchissez la page
- Contactez l'auteur de l'article si le problème persiste
Problèmes d'affichage
Les articles ne s'affichent pas
- Vérifiez votre connexion internet
- Vérifiez que le relay Nostr est accessible
- Essayez de rafraîchir la page
- Vérifiez la console du navigateur pour les erreurs
Le contenu débloqué a disparu
- Le contenu est stocké localement dans votre navigateur
- Si vous avez vidé le cache ou les données du navigateur, le contenu peut être perdu
- Vous devrez peut-être payer à nouveau pour débloquer l'article
Problèmes de publication
Je ne peux pas publier d'article
- Vérifiez que vous êtes connecté avec Nostr
- Vérifiez que votre portefeuille Nostr peut signer des événements
- Vérifiez que Alby est installé (nécessaire pour créer l'invoice)
- Vérifiez que tous les champs sont remplis (titre, aperçu, contenu)
Support
Pour plus d'aide :
- Consultez la FAQ
- Consultez le Guide de publication
- Consultez le Guide de paiement
Dernière mise à jour : Décembre 2024