Nicolas Cantu
90ff8282f1
- 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.
257 lines
8.4 KiB
Markdown
257 lines
8.4 KiB
Markdown
# Guide de zap avec Alby
|
|
|
|
Ce guide vous explique comment effectuer un zap pour débloquer des articles avec Alby et le protocole Lightning Network.
|
|
|
|
> **Important** : Seuls les zaps sont autorisés pour débloquer les articles. Les paiements Lightning standard ne fonctionnent pas.
|
|
|
|
## Qu'est-ce qu'Alby ?
|
|
|
|
[Alby](https://getalby.com/) est une extension de navigateur qui permet de gérer des zaps Lightning Network directement depuis votre navigateur. Alby utilise le standard WebLN pour interagir avec les applications web.
|
|
|
|
## Installation d'Alby
|
|
|
|
### 1. Télécharger Alby
|
|
|
|
1. Visitez [getalby.com](https://getalby.com/)
|
|
2. Cliquez sur **"Get Alby"** ou **"Install Extension"**
|
|
3. Choisissez votre navigateur :
|
|
- Chrome / Edge
|
|
- Firefox
|
|
- Brave
|
|
- Safari (via l'App Store)
|
|
|
|
### 2. Installer l'extension
|
|
|
|
1. Suivez les instructions d'installation pour votre navigateur
|
|
2. L'extension Alby apparaîtra dans la barre d'outils de votre navigateur
|
|
3. Cliquez sur l'icône Alby pour commencer la configuration
|
|
|
|
### 3. Configurer Alby
|
|
|
|
#### Option A : Créer un nouveau compte Alby
|
|
|
|
1. Cliquez sur l'icône Alby dans votre navigateur
|
|
2. Cliquez sur **"Create Account"** ou **"Sign Up"**
|
|
3. Suivez les instructions pour créer un compte
|
|
4. Ajoutez des fonds à votre portefeuille Alby :
|
|
- Par carte bancaire
|
|
- Par virement bancaire
|
|
- Par Lightning Network (depuis un autre portefeuille)
|
|
|
|
#### Option B : Connecter un portefeuille Lightning existant
|
|
|
|
1. Cliquez sur l'icône Alby
|
|
2. Choisissez **"Connect Wallet"** ou **"Link Existing Wallet"**
|
|
3. Suivez les instructions pour connecter votre portefeuille Lightning (LND, CLN, etc.)
|
|
|
|
### 4. Vérifier l'installation
|
|
|
|
1. Revenez sur Nostr Paywall
|
|
2. Si Alby est correctement installé, vous verrez un message de confirmation
|
|
3. Si Alby n'est pas installé, un message vous invitera à l'installer
|
|
|
|
## Effectuer un zap pour un article
|
|
|
|
### Processus étape par étape
|
|
|
|
#### 1. Choisir un article
|
|
|
|
1. Parcourez la liste des articles sur la page d'accueil
|
|
2. Lisez l'aperçu gratuit
|
|
3. Si vous souhaitez lire le contenu complet, cliquez sur **"Débloquer avec X sats zap"**
|
|
|
|
#### 2. Fenêtre de zap
|
|
|
|
Une fenêtre modale s'ouvre avec :
|
|
- **Montant du zap** : 800 sats (montant fixe)
|
|
- **QR Code Lightning** : Pour scanner avec un portefeuille mobile
|
|
- **Invoice Lightning** : La facture Lightning (BOLT11)
|
|
- **Timer d'expiration** : Temps restant avant expiration (24h)
|
|
- **Bouton "Pay with Alby"** : Pour payer directement avec Alby
|
|
|
|
#### 3. Méthodes de zap
|
|
|
|
Vous avez **3 options** pour effectuer le zap :
|
|
|
|
> **Important** : Seuls les zaps sont autorisés pour débloquer les articles. Les paiements Lightning standard ne fonctionnent pas.
|
|
|
|
##### Option 1 : Zap avec Alby (recommandé)
|
|
|
|
1. Cliquez sur **"Pay with Alby"**
|
|
2. Une fenêtre Alby s'ouvre automatiquement
|
|
3. Vérifiez les détails du zap :
|
|
- Montant (800 sats)
|
|
- Description
|
|
- Destinataire
|
|
4. Cliquez sur **"Confirm"** ou **"Pay"** dans Alby
|
|
5. Le zap est effectué instantanément
|
|
6. La fenêtre se ferme automatiquement
|
|
7. Le contenu complet s'affiche après quelques secondes
|
|
|
|
##### Option 2 : Scanner le QR Code
|
|
|
|
1. Ouvrez votre portefeuille Lightning mobile (BlueWallet, Breez, etc.)
|
|
2. Utilisez la fonction "Scanner" de votre portefeuille
|
|
3. Scannez le QR code affiché dans la fenêtre
|
|
4. Confirmez le zap dans votre portefeuille mobile
|
|
5. Le contenu se débloque automatiquement après confirmation
|
|
|
|
##### Option 3 : Copier l'invoice
|
|
|
|
1. Cliquez sur **"Copy Invoice"** pour copier l'invoice Lightning
|
|
2. Collez l'invoice dans votre portefeuille Lightning (n'importe lequel)
|
|
3. Effectuez le zap
|
|
4. Le contenu se débloque automatiquement après confirmation
|
|
|
|
### 4. Confirmation du zap
|
|
|
|
Après le zap :
|
|
1. **Vérification automatique** : L'application vérifie le zap via les reçus de zap Nostr (NIP-57)
|
|
2. **Délai** : La vérification peut prendre quelques secondes (généralement 5-30 secondes)
|
|
3. **Affichage du contenu** : Une fois vérifié, le contenu complet s'affiche automatiquement
|
|
4. **Stockage local** : Le contenu est stocké localement dans votre navigateur (IndexedDB)
|
|
|
|
## Expiration des invoices
|
|
|
|
### Durée de validité
|
|
|
|
- Les invoices expirent après **24 heures**
|
|
- Un timer affiche le temps restant dans la fenêtre de zap
|
|
- Si l'invoice expire, elle devient invalide
|
|
|
|
### Que faire si l'invoice expire ?
|
|
|
|
1. **Fermez la fenêtre de zap**
|
|
2. **Cliquez à nouveau sur "Débloquer avec X sats zap"**
|
|
3. **Une nouvelle invoice sera générée** automatiquement
|
|
4. **Effectuez le zap avec la nouvelle invoice**
|
|
|
|
> **Note** : N'effectuez jamais un zap avec une invoice expirée, le zap échouera.
|
|
|
|
## Dépannage
|
|
|
|
### Alby ne s'ouvre pas
|
|
|
|
**Solutions** :
|
|
- Vérifiez que Alby est bien installé
|
|
- Rafraîchissez la page
|
|
- Vérifiez que l'extension Alby est activée dans votre navigateur
|
|
- Réessayez de cliquer sur "Pay with Alby"
|
|
|
|
### Le zap échoue
|
|
|
|
**Vérifiez** :
|
|
- ✅ Que vous avez suffisamment de fonds dans Alby
|
|
- ✅ Que l'invoice n'a pas expiré
|
|
- ✅ Votre connexion internet
|
|
- ✅ Les logs d'erreur dans la console du navigateur
|
|
- ✅ Que vous effectuez bien un zap (pas un paiement Lightning standard)
|
|
|
|
**Solutions** :
|
|
- Ajoutez des fonds à votre portefeuille Alby
|
|
- Générez une nouvelle invoice (fermez et rouvrez la fenêtre)
|
|
- Réessayez le zap
|
|
- Assurez-vous d'effectuer un zap via Nostr, pas un paiement Lightning standard
|
|
|
|
### Le contenu ne se débloque pas après le zap
|
|
|
|
**Vérifiez** :
|
|
- ✅ Que le zap a bien été effectué (vérifiez dans Alby)
|
|
- ✅ Attendez quelques secondes (la vérification peut prendre du temps)
|
|
- ✅ Rafraîchissez la page
|
|
- ✅ Que le zap a bien été vérifié via les reçus de zap Nostr
|
|
|
|
**Solutions** :
|
|
- Attendez 30-60 secondes pour la vérification
|
|
- Rafraîchissez la page
|
|
- Vérifiez vos notifications (badge en haut à droite)
|
|
- Contactez l'auteur de l'article si le problème persiste
|
|
|
|
### Je n'ai pas assez de fonds
|
|
|
|
**Solutions** :
|
|
- Ajoutez des fonds à votre portefeuille Alby :
|
|
- Par carte bancaire
|
|
- Par virement bancaire
|
|
- Par Lightning Network (depuis un autre portefeuille)
|
|
- Attendez que les fonds soient disponibles
|
|
- Réessayez le zap
|
|
|
|
### L'invoice a expiré
|
|
|
|
**Solutions** :
|
|
- Fermez la fenêtre de zap
|
|
- Cliquez à nouveau sur "Débloquer avec X sats zap"
|
|
- Une nouvelle invoice sera générée
|
|
- Effectuez le zap avec la nouvelle invoice
|
|
|
|
## Sécurité
|
|
|
|
### Les zaps sont-ils sécurisés ?
|
|
|
|
Oui, les zaps Lightning Network sont :
|
|
- ✅ **Décentralisés** : Pas de serveur central
|
|
- ✅ **Rapides** : Confirmations en quelques secondes
|
|
- ✅ **Peu coûteux** : Frais minimes
|
|
- ✅ **Vérifiables** : Vérifiés via les reçus de zap Nostr (NIP-57)
|
|
- ✅ **Seule méthode autorisée** : Seuls les zaps fonctionnent pour débloquer les articles
|
|
|
|
### Mes informations sont-elles partagées ?
|
|
|
|
- ✅ **Non** : Les zaps Lightning sont privés
|
|
- ✅ Seul le montant et le destinataire sont visibles sur la blockchain Lightning
|
|
- ✅ Votre identité Nostr est liée aux zaps via les zap receipts (NIP-57)
|
|
|
|
### Puis-je obtenir un remboursement ?
|
|
|
|
Les zaps Lightning sont généralement **irréversibles**. Si vous avez un problème :
|
|
1. Vérifiez que le zap a bien été effectué
|
|
2. Contactez l'auteur de l'article
|
|
3. Vérifiez que le contenu ne s'est pas débloqué (attendez quelques secondes)
|
|
|
|
## Alternatives à Alby
|
|
|
|
### Autres portefeuilles WebLN
|
|
|
|
Si vous préférez ne pas utiliser Alby, vous pouvez utiliser d'autres portefeuilles Lightning compatibles WebLN :
|
|
- **Breez** (si support WebLN)
|
|
- **Zeus** (si support WebLN)
|
|
- Autres portefeuilles compatibles
|
|
|
|
### Portefeuilles mobiles
|
|
|
|
Vous pouvez également utiliser un portefeuille Lightning mobile :
|
|
1. Scannez le QR code avec votre portefeuille mobile
|
|
2. Confirmez le zap
|
|
3. Le contenu se débloque automatiquement
|
|
|
|
**Portefeuilles mobiles populaires** :
|
|
- BlueWallet
|
|
- Breez
|
|
- Zeus
|
|
- Wallet of Satoshi
|
|
|
|
## Conseils
|
|
|
|
### Gérer vos fonds
|
|
|
|
- Gardez suffisamment de fonds dans Alby pour plusieurs articles
|
|
- Ajoutez des fonds régulièrement pour éviter les interruptions
|
|
- Surveillez votre solde dans l'extension Alby
|
|
|
|
### Zaps multiples
|
|
|
|
- Vous pouvez effectuer des zaps pour plusieurs articles en succession
|
|
- Chaque zap est indépendant
|
|
- Le contenu de chaque article est stocké séparément
|
|
|
|
### Contenu débloqué
|
|
|
|
- Le contenu débloqué est stocké localement dans votre navigateur
|
|
- Il reste accessible même après déconnexion
|
|
- Si vous videz le cache, le contenu peut être perdu (vous devrez peut-être payer à nouveau)
|
|
|
|
---
|
|
|
|
**Dernière mise à jour** : Décembre 2024
|