# Guide de paiement avec Alby

Ce guide vous explique comment effectuer un zap pour débloquer des publications avec Alby et le protocole Lightning Network.

> **Important** : Seuls les zaps sont autorisés pour débloquer les publications. 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 zapwall.fr
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 une publication

### Processus étape par étape

#### 1. Choisir une publication

1. Parcourez la liste des publications sur la page d'accueil
2. Lisez l'aperçu gratuit
3. Si vous souhaitez lire le contenu complet, cliquez sur **"Débloquer"**

#### 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 publications. 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"**
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.

## Commissions et montants

### Montant d'une publication

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

### Montant du sponsoring

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

### Montant d'un remerciement d'avis

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

## 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 la publication 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"
- 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 publications

### 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 la publication
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 publications
- 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 publications en succession
- Chaque zap est indépendant
- Le contenu de chaque publication 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