320 lines
9.0 KiB
Markdown
320 lines
9.0 KiB
Markdown
# User Guide - zapwall.fr
|
|
|
|
Welcome to zapwall.fr! This platform allows you to read scientific and science-fiction publications with free previews and unlock full content by paying with Lightning Network.
|
|
|
|
## Table of Contents
|
|
|
|
1. [Introduction](#introduction)
|
|
2. [Getting Started](#getting-started)
|
|
3. [Connecting with Nostr](#connecting-with-nostr)
|
|
4. [Reading Publications](#reading-publications)
|
|
5. [Paying to Unlock a Publication](#paying-to-unlock-a-publication)
|
|
6. [Searching and Filtering Publications](#searching-and-filtering-publications)
|
|
7. [Viewing Your Profile and Author Page](#viewing-your-profile-and-author-page)
|
|
8. [Series](#series)
|
|
9. [Reviews](#reviews)
|
|
10. [Troubleshooting](#troubleshooting)
|
|
|
|
---
|
|
|
|
## Introduction
|
|
|
|
zapwall.fr is a publishing platform for scientific and science-fiction content based on the Nostr protocol. Authors can publish publications with:
|
|
- **Free Preview**: Visible to everyone
|
|
- **Full Content**: Unlocked after a Lightning payment of 800 sats (minus 100 sats commission and transaction fees)
|
|
|
|
### Main Features
|
|
|
|
- ✅ Free reading of publication previews
|
|
- ✅ Full content unlock via Lightning payment
|
|
- ✅ Search and filter publications
|
|
- ✅ Author page with presentation and sponsoring
|
|
- ✅ Series to organize your publications
|
|
- ✅ Rewarded reviews on publications
|
|
- ✅ Author sponsoring (0.046 BTC)
|
|
|
|
---
|
|
|
|
## Getting Started
|
|
|
|
### 1. Install Alby (Recommended)
|
|
|
|
To make Lightning payments, you need to install a Lightning wallet extension compatible with WebLN:
|
|
|
|
1. Visit [getalby.com](https://getalby.com/)
|
|
2. Install the Alby extension for your browser
|
|
3. Create an account or connect your existing Lightning wallet
|
|
4. Add funds to your Alby wallet
|
|
|
|
> **Note**: Other WebLN-compatible Lightning wallets also work.
|
|
|
|
### 2. Access the Platform
|
|
|
|
1. Open [zapwall.fr](https://zapwall.fr) in your browser
|
|
2. You will see the list of available publications
|
|
3. Click "Connect with Nostr" to connect
|
|
|
|
---
|
|
|
|
## Connecting with Nostr
|
|
|
|
### How to Connect
|
|
|
|
1. Click the **"Connect with Nostr"** button in the top right
|
|
2. A window will open to connect with your Nostr wallet
|
|
3. The application uses the Alby extension for Nostr authentication (NIP-07) and Lightning payments (WebLN)
|
|
4. Authorize the connection in your Nostr wallet
|
|
|
|
### What Happens After Connection?
|
|
|
|
- ✅ Your Nostr profile is displayed (name, avatar, etc.)
|
|
- ✅ You can create your author page (required to publish)
|
|
- ✅ You can publish publications
|
|
- ✅ You can pay to unlock publications
|
|
- ✅ You can access your profile with your publications
|
|
|
|
### Disconnecting
|
|
|
|
Click the **"Disconnect"** button to disconnect.
|
|
|
|
---
|
|
|
|
## Reading Publications
|
|
|
|
### Free Preview
|
|
|
|
All publications automatically display:
|
|
- **Title** of the publication
|
|
- **Preview** - free content
|
|
- **Author** (with link to their author page)
|
|
- **Amount** in sats (800 sats)
|
|
- **Publication date**
|
|
- **Category** (Science Fiction or Scientific Research)
|
|
|
|
### Full Content
|
|
|
|
To read the full content of a publication:
|
|
1. Click the **"Unlock"** button
|
|
2. Follow the instructions to make a Lightning zap of 800 sats
|
|
3. Once the zap is confirmed, the full content will automatically display
|
|
|
|
> **Note**: Unlocked content is stored locally in your browser and remains accessible even after disconnection.
|
|
|
|
---
|
|
|
|
## Paying to Unlock a Publication
|
|
|
|
### Zap Process
|
|
|
|
1. **Click "Unlock"** on the publication you want to unlock
|
|
2. **A window opens** with:
|
|
- The zap amount (800 sats)
|
|
- A Lightning QR code
|
|
- The Lightning invoice
|
|
- A "Pay with Alby" button
|
|
3. **Choose your zap method**:
|
|
- **Option 1**: Click "Pay with Alby" (recommended)
|
|
- Your Alby extension will automatically open
|
|
- Confirm the zap in Alby
|
|
- **Option 2**: Scan the QR code with your mobile Lightning wallet
|
|
- **Option 3**: Copy the invoice and make the zap from your wallet
|
|
4. **Wait for confirmation**:
|
|
- The zap is automatically verified via Nostr zap receipts (NIP-57)
|
|
- Full content will automatically display once confirmed
|
|
- This may take a few seconds
|
|
|
|
> **Note**: Only zaps are allowed to unlock publications. Standard Lightning payments do not work.
|
|
|
|
### Invoice Expiration
|
|
|
|
Lightning invoices expire after 24 hours. If an invoice expires:
|
|
- Close the payment window
|
|
- Click "Unlock" again to generate a new invoice
|
|
|
|
### Payment Issues
|
|
|
|
If payment fails:
|
|
- Check that you have sufficient funds in your wallet
|
|
- Check that the invoice has not expired
|
|
- Try again by clicking "Unlock" again
|
|
- Consult the [Troubleshooting](#troubleshooting) section
|
|
|
|
---
|
|
|
|
## Searching and Filtering Publications
|
|
|
|
### Search Bar
|
|
|
|
Use the search bar at the top of the page to search publications by:
|
|
- **Title**
|
|
- **Preview**
|
|
- **Content** (even unlocked content is searchable)
|
|
|
|
### Filters
|
|
|
|
Filters allow you to:
|
|
- **Filter by category**: Science Fiction or Scientific Research
|
|
- **Filter by author**: Select a specific author
|
|
- **Sort publications**:
|
|
- Newest first (default)
|
|
- Oldest first
|
|
|
|
### Using Filters
|
|
|
|
1. Use category tabs to filter by content type
|
|
2. Use the dropdown menu to select an author
|
|
3. Results update automatically
|
|
4. Click "Clear all" to reset all filters
|
|
|
|
---
|
|
|
|
## Viewing Your Profile and Author Page
|
|
|
|
### Author Page (Required)
|
|
|
|
Before you can publish, you must create your **author page**:
|
|
1. Connect with Nostr
|
|
2. Click **"Create author page"** in the menu
|
|
3. Fill in your presentation with:
|
|
- Your description
|
|
- Your Bitcoin mainnet address for sponsoring (optional)
|
|
4. Once created, your author page is accessible to everyone via `/author/[your-pubkey]`
|
|
|
|
### Accessing Your Profile
|
|
|
|
1. Connect with Nostr
|
|
2. Click your **name or avatar** in the top right
|
|
3. You will be redirected to the `/profile` page
|
|
|
|
### Information Displayed
|
|
|
|
Your profile displays:
|
|
- **Profile picture** (if available)
|
|
- **Name** (if defined in your Nostr profile)
|
|
- **Public key** (pubkey)
|
|
- **NIP-05** (if verified)
|
|
- **Description** (about)
|
|
|
|
### Your Publications
|
|
|
|
The "My Articles" section displays:
|
|
- All your published publications
|
|
- Search and filters on your publications
|
|
- Unlock status for each publication
|
|
|
|
---
|
|
|
|
## Series
|
|
|
|
### What is a Series?
|
|
|
|
A series is a grouping of publications organized by an author. Series allow you to:
|
|
- Organize your publications by theme
|
|
- Create narrative continuity
|
|
- Facilitate discovery of your content
|
|
|
|
### Creating a Series
|
|
|
|
1. Connect with Nostr
|
|
2. When publishing, you can create or select a series
|
|
3. Fill in the series information:
|
|
- Title
|
|
- Description
|
|
- Cover image (optional)
|
|
4. Series publications will be grouped on the series page
|
|
|
|
### Viewing a Series
|
|
|
|
1. Click on a series from an author's page
|
|
2. You will see all publications in the series
|
|
3. Each publication can be unlocked individually
|
|
|
|
---
|
|
|
|
## Reviews
|
|
|
|
### What is a Review?
|
|
|
|
A review is a comment or evaluation of a publication by a reader who has purchased the publication. Reviews are:
|
|
- **Rewarded**: The author can thank a review with 70 sats (minus 21 sats commission)
|
|
- **Public**: Visible to everyone on the platform
|
|
- **Linked to a publication**: Each review is associated with a specific publication
|
|
|
|
### Posting a Review
|
|
|
|
1. Unlock a publication (800 sats)
|
|
2. Access the publication page
|
|
3. Write your review
|
|
4. Publish your review
|
|
|
|
### Thanking a Review
|
|
|
|
As an author, you can thank a reader for their review:
|
|
1. Access the relevant publication
|
|
2. Find the review you want to thank
|
|
3. Click "Thank" (70 sats)
|
|
4. Confirm the zap in Alby
|
|
|
|
> **Note**: Thanking a review costs 70 sats (49 sats to the reviewer, 21 sats commission).
|
|
|
|
---
|
|
|
|
## Troubleshooting
|
|
|
|
### Connection Issues
|
|
|
|
**I cannot connect with Nostr**
|
|
- Check that your Nostr wallet is accessible
|
|
- Check that the Alby extension is installed and enabled
|
|
- Try refreshing the page
|
|
- Check your internet connection
|
|
|
|
### Payment Issues
|
|
|
|
**Payment is not working**
|
|
- Check that Alby (or your Lightning wallet) is installed and enabled
|
|
- Check that you have sufficient funds
|
|
- Check that the invoice has not expired
|
|
- Try refreshing the page and try again
|
|
|
|
**Content does not unlock after payment**
|
|
- Wait a few seconds (verification may take time)
|
|
- Check that payment was actually made in your wallet
|
|
- Refresh the page
|
|
- Contact the publication author if the problem persists
|
|
|
|
### Display Issues
|
|
|
|
**Publications are not displaying**
|
|
- Check your internet connection
|
|
- Check that the Nostr relay is accessible
|
|
- Try refreshing the page
|
|
- Check the browser console for errors
|
|
|
|
**Unlocked content has disappeared**
|
|
- Content is stored locally in your browser
|
|
- If you cleared the cache or browser data, content may be lost
|
|
- You may need to pay again to unlock the publication
|
|
|
|
### Publication Issues
|
|
|
|
**I cannot publish a publication**
|
|
- Check that you are connected with Nostr
|
|
- Check that you have created your author page (required)
|
|
- Check that your Nostr wallet can sign events
|
|
- Check that Alby is installed (required to create the invoice)
|
|
- Check that all fields are filled (title, preview, content)
|
|
|
|
---
|
|
|
|
## Support
|
|
|
|
For more help:
|
|
- Consult the [FAQ](./faq.md)
|
|
- Consult the [Publishing Guide](./publishing-guide.md)
|
|
- Consult the [Payment Guide](./payment-guide.md)
|
|
|
|
---
|
|
|
|
**Last updated**: December 2024
|