Nicolas Cantu cb7ee0cfd4 Replace nos2x and NostrConnect with Alby authentication
- Remove nos2x and NostrConnect support
- Create new NostrAuthService using Alby (window.nostr NIP-07)
- Replace useNostrConnect with useNostrAuth in all components
- Update NostrRemoteSigner to use Alby for signing
- Delete NostrConnect-related files (nostrconnect.ts, handlers, etc.)
- Update documentation to reflect Alby-only authentication
- Remove NOSTRCONNECT_BRIDGE environment variable
- All TypeScript checks pass
2025-12-27 23:54:34 +01:00

320 lines
10 KiB
Markdown

# Guide d'utilisation - zapwall.fr
Bienvenue sur zapwall.fr ! Cette plateforme vous permet de lire des publications scientifiques et de science-fiction avec des aperçus gratuits et de débloquer le contenu complet en payant avec Lightning Network.
## Table des matières
1. [Introduction](#introduction)
2. [Premiers pas](#premiers-pas)
3. [Connexion avec Nostr](#connexion-avec-nostr)
4. [Lire des publications](#lire-des-publications)
5. [Payer pour débloquer une publication](#payer-pour-débloquer-une-publication)
6. [Rechercher et filtrer des publications](#rechercher-et-filtrer-des-publications)
7. [Voir votre profil et votre page auteur](#voir-votre-profil-et-votre-page-auteur)
8. [Séries](#séries)
9. [Avis](#avis)
10. [Dépannage](#dépannage)
---
## Introduction
zapwall.fr est une plateforme de publication de contenus scientifiques et de science-fiction basée sur le protocole Nostr. Les auteurs peuvent publier des publications avec :
- **Aperçu gratuit** : Visible par tous
- **Contenu complet** : Débloqué après un paiement Lightning de 800 sats (moins 100 sats de commission et frais de transaction)
### Fonctionnalités principales
- ✅ Lecture gratuite des aperçus de publications
- ✅ Déblocage du contenu complet via paiement Lightning
- ✅ Recherche et filtrage de publications
- ✅ Page auteur avec présentation et sponsoring
- ✅ Séries pour organiser vos publications
- ✅ Avis rémunérables sur les publications
- ✅ Sponsoring d'auteurs (0.046 BTC)
---
## 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](https://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 [zapwall.fr](https://zapwall.fr) dans votre navigateur
2. Vous verrez la liste des publications 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. L'application utilise l'extension Alby pour l'authentification Nostr (NIP-07) et les paiements Lightning (WebLN)
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 créer votre page auteur (obligatoire pour publier)
- ✅ Vous pouvez publier des publications
- ✅ Vous pouvez payer pour débloquer des publications
- ✅ Vous pouvez accéder à votre profil avec vos publications
### Déconnexion
Cliquez sur le bouton **"Disconnect"** pour vous déconnecter.
---
## Lire des publications
### Aperçu gratuit
Toutes les publications affichent automatiquement :
- **Titre** de la publication
- **Aperçu** (preview) - contenu gratuit
- **Auteur** (avec lien vers sa page auteur)
- **Montant** en sats (800 sats)
- **Date de publication**
- **Catégorie** (Science-fiction ou Recherche scientifique)
### Contenu complet
Pour lire le contenu complet d'une publication :
1. Cliquez sur le bouton **"Débloquer"**
2. Suivez les instructions pour effectuer un zap Lightning de 800 sats
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 une publication
### Processus de zap
1. **Cliquez sur "Débloquer"** sur la publication 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 publications. 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 "Débloquer" 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 "Débloquer"
- Consultez la [section Dépannage](#dépannage)
---
## Rechercher et filtrer des publications
### Barre de recherche
Utilisez la barre de recherche en haut de la page pour rechercher des publications par :
- **Titre**
- **Aperçu** (preview)
- **Contenu** (même le contenu débloqué est recherchable)
### Filtres
Les filtres vous permettent de :
- **Filtrer par catégorie** : Science-fiction ou Recherche scientifique
- **Filtrer par auteur** : Sélectionnez un auteur spécifique
- **Trier les publications** :
- Plus récentes d'abord (par défaut)
- Plus anciennes d'abord
### Utilisation des filtres
1. Utilisez les onglets de catégorie pour filtrer par type de contenu
2. Utilisez le menu déroulant pour sélectionner un auteur
3. Les résultats se mettent à jour automatiquement
4. Cliquez sur "Effacer tout" pour réinitialiser tous les filtres
---
## Voir votre profil et votre page auteur
### 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 avec :
- Votre description
- Votre adresse Bitcoin mainnet pour le sponsoring (optionnel)
4. Une fois créée, votre page auteur est accessible à tous via `/author/[votre-pubkey]`
### 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)
### Vos publications
La section "My Articles" affiche :
- Toutes vos publications publiées
- Recherche et filtres sur vos publications
- Statut de déblocage pour chaque publication
---
## Séries
### Qu'est-ce qu'une série ?
Une série est un regroupement de publications organisées par un auteur. Les séries permettent de :
- Organiser vos publications par thème
- Créer une continuité narrative
- Faciliter la découverte de vos contenus
### Créer une série
1. Connectez-vous avec Nostr
2. Lors de la publication, vous pouvez créer ou sélectionner une série
3. Remplissez les informations de la série :
- Titre
- Description
- Image de couverture (optionnel)
4. Les publications de la série seront regroupées sur la page de la série
### Voir une série
1. Cliquez sur une série depuis la page d'un auteur
2. Vous verrez toutes les publications de la série
3. Chaque publication peut être débloquée individuellement
---
## Avis
### Qu'est-ce qu'un avis ?
Un avis est un commentaire ou une évaluation d'une publication par un lecteur qui a acheté la publication. Les avis sont :
- **Rémunérables** : L'auteur peut remercier un avis avec 70 sats (moins 21 sats de commission)
- **Publics** : Visibles par tous sur la plateforme
- **Liés à une publication** : Chaque avis est associé à une publication spécifique
### Poster un avis
1. Débloquez une publication (800 sats)
2. Accédez à la page de la publication
3. Rédigez votre avis
4. Publiez votre avis
### Remercier un avis
En tant qu'auteur, vous pouvez remercier un lecteur pour son avis :
1. Accédez à la publication concernée
2. Trouvez l'avis que vous souhaitez remercier
3. Cliquez sur "Remercier" (70 sats)
4. Confirmez le zap dans Alby
> **Note** : Le remerciement d'un avis coûte 70 sats (49 sats au reviewer, 21 sats de commission).
---
## 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 l'extension Alby est installée et activée
- 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 la publication si le problème persiste
### Problèmes d'affichage
**Les publications 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 la publication
### Problèmes de publication
**Je ne peux pas publier de publication**
- Vérifiez que vous êtes connecté avec Nostr
- Vérifiez que vous avez créé votre page auteur (obligatoire)
- 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](./faq.md)
- Consultez le [Guide de publication](./publishing-guide.md)
- Consultez le [Guide de paiement](./payment-guide.md)
---
**Dernière mise à jour** : Décembre 2024