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

Publishing Guide

This guide explains how to publish a publication on zapwall.fr with a free preview and paid content.

Prerequisites

Before publishing a publication, you must have:

1. ✅ A Nostr wallet (to connect and sign events)
2. ✅ Your author page created (required, once)
3. ✅ Alby installed (to create the Lightning invoice)
4. ✅ Funds in your Lightning wallet (optional, but recommended for testing)

Publishing Steps

1. Create Your 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:
   • Your description
   • Your Bitcoin mainnet address for sponsoring (optional)
4. Publish your author page

Important

: The author page is required. You cannot publish a publication without creating your author page.

2. Access the Publishing Page

1. Click "Publish a publication" in the main menu
2. You will be redirected to the /publish page

3. Fill in the Form

The form contains several fields:

Title (Required)

• The title of your publication
• Visible to everyone in the publication list
• Example: "Introduction to Nostr"

Preview (Required)

• The free content visible to everyone
• This is what readers will see before paying
• Must be interesting enough to encourage payment
• Example: "Discover the basics of the Nostr protocol and how it revolutionizes decentralized social networks..."

Full Content (Required)

• The full content that will be unlocked after payment
• Sent via encrypted private message (NIP-04) after payment
• Can contain text, images (links), etc.
• Example: "Nostr is a decentralized social network protocol based on cryptographic keys..."

Category (Required)

• Science Fiction: For science fiction content
• Scientific Research: For scientific and research content

Series (Optional)

• You can create a new series or select an existing series
• Series allow you to organize your publications by theme
• Fill in the series information:
  • Title
  • Description
  • Cover image (optional)

4. Publish the Publication

1. Click the "Publish the publication" button
2. If Alby is not installed, you will be invited to install it
3. Authorize Lightning invoice creation in Alby
4. The invoice will be created automatically (800 sats)
5. Your publication will be published on the Nostr relay

5. Confirmation

Once published, you will see:

• ✅ A confirmation message
• You will be automatically redirected to the home page
• Your publication will appear in the publication list

How It Works Technically

1. Preview Publication

The preview is published as a Nostr type 1 event (text note) with the following tags:

• #publication: Content type
• #sciencefiction or #research: Category
• #id_<id>: Unique identifier
• #paywall: Indicates that content is paid
• title: The publication title
• preview: The free preview
• zapAmount: The amount in sats (800 sats)
• invoice: The Lightning invoice (BOLT11)
• paymentHash: The invoice hash

2. Invoice Creation

The Lightning invoice is created via Alby/WebLN when publishing:

• Amount: 800 sats (fixed amount for all publications)
• Description: "Payment for publication: {title}"
• Expiration: 24 hours

3. Full Content Storage

Full content is stored locally in your browser (IndexedDB):

• Associated with the publication ID
• Encrypted with AES-GCM
• Used to send content after payment

4. Sending Content After Payment

When a reader pays:

1. Payment is verified via Nostr zap receipts (NIP-57)
2. Full content is sent via encrypted private message (NIP-04)
3. The private message contains:
   • The encrypted content
   • An e tag linking to the publication
   • A p tag with the recipient's public key

Commissions

On Publication Sales

• Total amount: 800 sats
• To author: 700 sats
• Platform commission: 100 sats
• Transaction fees: Paid by the author

On Sponsoring

• Total amount: 0.046 BTC
• To author: 0.042 BTC
• Platform commission: 0.004 BTC
• Transaction fees: Paid by the author

On Review Thanks

• Total amount: 70 sats
• To reviewer: 49 sats
• Platform commission: 21 sats
• Transaction fees: Paid by the author

Tips for Good Publishing

Writing a Good Preview

The preview is crucial to encourage readers to pay:

• ✅ Give a taste of the full content
• ✅ Ask a question or create curiosity
• ✅ Mention key points that will be developed
• ❌ Don't reveal all the content
• ❌ Don't be too vague

Example of an effective preview:

"Discover how Nostr revolutionizes social networks by eliminating centralized servers. In this article, we will explore the protocol architecture, the benefits of decentralization, and how to create your first Nostr application. You will also learn how to implement Lightning payments directly in your applications."

Payment Amount

The amount is fixed at 800 sats for all publications. This simplifies the user experience and ensures fair pricing.

Quality Content

Full content should:

• ✅ Be substantial and add value
• ✅ Justify the payment amount of 800 sats
• ✅ Be well formatted and readable
• ✅ Include examples or illustrations if relevant

Using Series

Series allow you to organize your publications:

• ✅ Create thematic series
• ✅ Group your publications by subject
• ✅ Facilitate discovery of your content

Managing Published Publications

Viewing Your Publications

1. Click your profile (name/avatar in the top right)
2. The "My Articles" section displays all your publications
3. You can search and filter your publications

Statistics

Currently, you can see:

• The number of published publications
• Payment notifications received

Note

: More detailed statistics will be added in a future version.

Editing and Deleting

Note

: Editing and deleting publications is not yet available. Nostr events are immutable, so once published, a publication cannot be modified. This feature will be added in a future version.

Troubleshooting

I Cannot Publish

Check:

• ✅ That you are connected with Nostr
• ✅ That you have created your author page (required)
• ✅ That your Nostr wallet can sign events
• ✅ That Alby is installed and enabled
• ✅ That all fields are filled

Invoice Does Not Create

Check:

• ✅ That Alby is installed
• ✅ That you have authorized the application in Alby
• ✅ That your Lightning wallet has funds (optional)
• ✅ Your internet connection

Publication Does Not Display After Publishing

Check:

• ✅ That the Nostr relay is accessible
• ✅ Refresh the page
• ✅ Check the browser console for errors

I Am Not Receiving Payments

Check:

• ✅ That readers are actually paying
• ✅ Your notifications (badge in the top right)
• ✅ Your Lightning wallet
• ✅ That the invoice has not expired

Best Practices

Publication Frequency

• Publish regularly to maintain engagement
• Don't publish too often (risk of spam)
• Quality > Quantity

Promotion

• Share your publications on other Nostr platforms
• Mention your publications in your Nostr notes
• Create a community around your content

Engagement with Readers

• Respond to reviews (if this feature is added)
• Create quality content that deserves to be paid
• Listen to feedback from your readers

---

Last updated: December 2024