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

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

  1. Introduction
  2. Premiers pas
  3. Connexion avec Nostr
  4. Lire des articles
  5. Payer pour débloquer un article
  6. Rechercher et filtrer des articles
  7. Voir votre profil
  8. Notifications
  9. 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 :

  1. Visitez getalby.com
  2. Installez l'extension Alby pour votre navigateur
  3. Créez un compte ou connectez votre portefeuille Lightning existant
  4. Ajoutez des fonds à votre portefeuille Alby

Note

: D'autres portefeuilles Lightning compatibles WebLN fonctionnent également.

2. Accéder à la plateforme

  1. Ouvrez [votre instance de Nostr Paywall] dans votre navigateur
  2. Vous verrez la liste des articles disponibles
  3. Cliquez sur "Connect with Nostr" pour vous connecter

Connexion avec Nostr

Comment se connecter

  1. Cliquez sur le bouton "Connect with Nostr" en haut à droite
  2. Une fenêtre s'ouvrira pour vous connecter avec votre portefeuille Nostr
  3. Par défaut, l'application utilise use.nsec.app comme pont NostrConnect
  4. 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 :

  1. Cliquez sur le bouton "Débloquer avec X sats zap"
  2. Suivez les instructions pour effectuer un zap Lightning
  3. 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

  1. Cliquez sur "Débloquer avec X sats zap" sur l'article que vous souhaitez débloquer
  2. Une fenêtre s'ouvre avec :
    • Le montant du zap (800 sats)
    • Un QR code Lightning
    • L'invoice Lightning
    • Un bouton "Pay with Alby"
  3. 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
  4. 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

  1. Utilisez les menus déroulants pour sélectionner vos filtres
  2. Les résultats se mettent à jour automatiquement
  3. Cliquez sur "Clear Filters" pour réinitialiser tous les filtres

Voir votre profil

Accéder à votre profil

  1. Connectez-vous avec Nostr
  2. Cliquez sur votre nom ou avatar en haut à droite
  3. 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 :


Dernière mise à jour : Décembre 2024