295 lines
9.4 KiB
Markdown
295 lines
9.4 KiB
Markdown
# FAQ - Frequently Asked Questions
|
|
|
|
## General Questions
|
|
|
|
### What is zapwall.fr?
|
|
|
|
zapwall.fr is a publishing platform for scientific and science-fiction content based on the Nostr protocol. Authors can publish publications with a free preview and paid full content, unlocked via Lightning Network payments.
|
|
|
|
### How does the payment system work?
|
|
|
|
1. The author publishes a publication with a free preview
|
|
2. The author creates a Lightning invoice when publishing to receive zaps
|
|
3. Readers can read the preview for free
|
|
4. To read the full content, readers make a Lightning zap of 800 sats
|
|
5. Once the zap is confirmed, the full content is sent via encrypted private message (NIP-04)
|
|
|
|
### How much does a publication cost?
|
|
|
|
All publications have the same amount: **800 sats** (approximately 0.000008 BTC). From this amount:
|
|
- **700 sats** go to the author
|
|
- **100 sats** are the platform commission
|
|
- Lightning transaction fees are added
|
|
|
|
### What is a "sat"?
|
|
|
|
A "sat" (satoshi) is the smallest unit of Bitcoin. 1 BTC = 100,000,000 sats.
|
|
|
|
### How does sponsoring work?
|
|
|
|
Sponsoring allows you to directly support an author with **0.046 BTC**:
|
|
- **0.042 BTC** go to the author
|
|
- **0.004 BTC** is the platform commission
|
|
- Sponsoring is done via a Bitcoin mainnet transaction
|
|
|
|
---
|
|
|
|
## Connection and Authentication
|
|
|
|
### How do I connect?
|
|
|
|
Click "Connect with Nostr" and authorize the connection with Alby. The application uses the Alby extension for Nostr authentication (NIP-07) and Lightning payments (WebLN).
|
|
|
|
### Do I need an account?
|
|
|
|
No, you do not need to create an account. You use your existing Nostr identity via your Nostr wallet.
|
|
|
|
### Can I use multiple accounts?
|
|
|
|
Yes, you can disconnect and reconnect with another Nostr account at any time.
|
|
|
|
### What happens if I disconnect?
|
|
|
|
- You remain connected to read publication previews
|
|
- You must be connected to create your author page
|
|
- You must be connected to publish publications
|
|
- You must be connected to pay and unlock publications
|
|
- Already unlocked content remains accessible (stored locally)
|
|
|
|
---
|
|
|
|
## Payments
|
|
|
|
### How do I make a zap for a publication?
|
|
|
|
1. Click "Unlock" on the desired publication
|
|
2. A window opens with a QR code and Lightning invoice
|
|
3. Click "Pay with Alby" or scan the QR code with your Lightning wallet
|
|
4. Confirm the zap in your wallet
|
|
5. Content automatically unlocks after confirmation
|
|
|
|
> **Important**: Only zaps are allowed. Standard Lightning payments do not work to unlock publications.
|
|
|
|
### Which Lightning wallet can I use?
|
|
|
|
Any Lightning wallet compatible with WebLN works. **Alby** is recommended and tested. Other wallets like Breez, Zeus, etc. may work if they support WebLN and can make zaps.
|
|
|
|
### Do I need to install Alby?
|
|
|
|
Yes, to make payments easily, you need to install the Alby extension (or another WebLN-compatible Lightning wallet).
|
|
|
|
### Are zaps secure?
|
|
|
|
Yes, zaps use the Lightning Network protocol and are verified via Nostr zap receipts (NIP-57), which is secure and decentralized. Zaps are the only authorized method to unlock publications.
|
|
|
|
### What happens if I pay but content doesn't unlock?
|
|
|
|
This should not happen, but if it does:
|
|
1. Wait a few seconds (verification may take time)
|
|
2. Refresh the page
|
|
3. Check that payment was actually made in your wallet
|
|
4. Contact the publication author
|
|
|
|
### Can I get a refund?
|
|
|
|
Lightning payments are generally irreversible. Contact the publication author if you have a problem.
|
|
|
|
### Do invoices expire?
|
|
|
|
Yes, invoices expire after **24 hours**. If an invoice expires, close the window and click "Unlock" again to generate a new invoice.
|
|
|
|
---
|
|
|
|
## Publishing Publications
|
|
|
|
### How do I publish a publication?
|
|
|
|
1. Connect with Nostr
|
|
2. Create your author page (required, once)
|
|
3. Click "Publish a publication" in the menu
|
|
4. Fill in the form:
|
|
- **Title**: The title of your publication
|
|
- **Preview**: The free preview (visible to everyone)
|
|
- **Content**: The full content (unlocked after payment)
|
|
- **Category**: Science Fiction or Scientific Research
|
|
- **Series**: Optional, to organize your publications
|
|
5. Click "Publish"
|
|
6. Authorize Lightning invoice creation in Alby
|
|
7. Your publication will be published on the Nostr relay
|
|
|
|
### Do I have to pay to publish a publication?
|
|
|
|
No, publishing is free. You only need to have Alby installed to create the Lightning invoice.
|
|
|
|
### Can I edit or delete a publication after publishing?
|
|
|
|
Currently, this feature is not available. Publications published on Nostr are immutable. An edit/delete feature will be added in a future version.
|
|
|
|
### How do readers pay for my publication?
|
|
|
|
Readers click "Unlock" and pay the Lightning invoice you created when publishing. Once payment is confirmed, the full content is automatically sent via encrypted private message.
|
|
|
|
### How do I receive payments?
|
|
|
|
Payments are sent directly to your Lightning wallet (the one used to create the invoice when publishing). You will receive 700 sats on each sale (800 sats - 100 sats commission).
|
|
|
|
### Can I set a custom amount?
|
|
|
|
No, the amount is fixed at 800 sats for all publications. This simplifies the user experience and ensures fair pricing.
|
|
|
|
---
|
|
|
|
## Author Page
|
|
|
|
### What is an author page?
|
|
|
|
An author page is a required publication that each author must create before they can publish. It contains:
|
|
- Your presentation
|
|
- Your description
|
|
- Your Bitcoin mainnet address for sponsoring (optional)
|
|
|
|
### Do I need to create an author page?
|
|
|
|
Yes, the author page is **required** to publish publications. You can only publish after creating your author page.
|
|
|
|
### How do I create my author page?
|
|
|
|
1. Connect with Nostr
|
|
2. Click "Create author page" in the menu
|
|
3. Fill in your presentation
|
|
4. Publish your author page
|
|
|
|
### Is my author page public?
|
|
|
|
Yes, your author page is publicly accessible at `/author/[your-pubkey]`. It allows readers to discover you and sponsor you.
|
|
|
|
---
|
|
|
|
## 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.
|
|
|
|
### How do I create a series?
|
|
|
|
When publishing a publication, you can create a new series or select an existing series. Fill in the series information (title, description, cover image).
|
|
|
|
### Can I add a publication to an existing series?
|
|
|
|
Yes, when publishing, you can select an existing series to add your publication to.
|
|
|
|
---
|
|
|
|
## Reviews
|
|
|
|
### What is a review?
|
|
|
|
A review is a comment or evaluation of a publication by a reader who has purchased the publication.
|
|
|
|
### Who can post a review?
|
|
|
|
Only readers who have unlocked a publication can post a review on that publication.
|
|
|
|
### Are reviews rewarded?
|
|
|
|
Yes, as an author, you can thank a reader for their review with **70 sats**:
|
|
- **49 sats** go to the reviewer
|
|
- **21 sats** is the platform commission
|
|
|
|
### How do I thank a 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
|
|
|
|
---
|
|
|
|
## Content and Publications
|
|
|
|
### Can I read publications without paying?
|
|
|
|
Yes, you can read the **preview** of all publications for free. Only the **full content** requires payment.
|
|
|
|
### Is unlocked content stored?
|
|
|
|
Yes, unlocked content is stored locally in your browser (IndexedDB) to remain accessible even after disconnection.
|
|
|
|
### Can I share an unlocked publication?
|
|
|
|
Unlocked content is stored locally in your browser. You can share the publication link, but other users will need to pay to unlock the content.
|
|
|
|
### Are publications public?
|
|
|
|
**Previews** are public and visible to everyone on the Nostr relay. **Full content** is sent only via encrypted private message after payment.
|
|
|
|
### Can I search publications?
|
|
|
|
Yes, you can search by title, preview, or content. You can also filter by category, author, and sort by date.
|
|
|
|
---
|
|
|
|
## Technical
|
|
|
|
### Which Nostr relay is used?
|
|
|
|
By default, the application uses `wss://relay.damus.io`. Relay configuration is stored in IndexedDB (browser local storage) and can be customized via application settings. The application supports multiple relays with a priority system.
|
|
|
|
### Is data stored on a server?
|
|
|
|
No, the application is decentralized:
|
|
- Publications are published on the Nostr relay (decentralized)
|
|
- Unlocked content is stored locally in your browser (IndexedDB)
|
|
- Notifications are stored locally in your browser
|
|
|
|
### Can I use another Nostr relay?
|
|
|
|
Yes, you can configure another relay via environment variables. However, you will only see publications published on the configured relay.
|
|
|
|
### Does the application work offline?
|
|
|
|
No, the application requires an internet connection to:
|
|
- Connect to the Nostr relay
|
|
- Publish publications
|
|
- Make Lightning payments
|
|
- Receive notifications
|
|
|
|
Already unlocked content remains accessible offline (stored locally).
|
|
|
|
---
|
|
|
|
## Problems and Support
|
|
|
|
### The application is not working
|
|
|
|
Check:
|
|
1. Your internet connection
|
|
2. That the Nostr relay is accessible
|
|
3. The browser console for errors
|
|
4. That JavaScript is enabled in your browser
|
|
|
|
### I cannot create my author page
|
|
|
|
Check:
|
|
1. That you are connected with Nostr
|
|
2. That your Nostr wallet can sign events
|
|
3. That all fields are filled
|
|
|
|
### My unlocked content has disappeared
|
|
|
|
Content is stored locally. If you have:
|
|
- Cleared the browser cache
|
|
- Deleted site data
|
|
- Used another browser or device
|
|
|
|
Content may be lost. You may need to pay again to unlock the publication.
|
|
|
|
### Can I contact support?
|
|
|
|
For now, there is no official support. Consult the documentation or create an issue on the [project Gitea repository](https://git.4nkweb.com/4nk/story-research-zapwall/issues).
|
|
|
|
---
|
|
|
|
**Last updated**: December 2024
|