story-research-zapwall/docs/en/user-guide.md

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
2. Getting Started
3. Connecting with Nostr
4. Reading Publications
5. Paying to Unlock a Publication
6. Searching and Filtering Publications
7. Viewing Your Profile and Author Page
8. Series
9. Reviews
10. 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
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 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 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
• Consult the Publishing Guide
• Consult the Payment Guide

---

Last updated: December 2024