feat: implement nodeless payments processor (#305)

* chore: hide powered by zebedee if payment processor is not

* chore: add nodeless as payments processor to settings

* fix: bad content type on zebedee callback req handler

* chore(release): 1.23.0 [skip ci]

# [1.23.0](v1.22.6...v1.23.0) (2023-05-12)

### Bug Fixes

* add SECRET as env variable ([#298](#298)) ([58a1254](58a1254))
* invoice auto marked as paid ([be6d6f1](be6d6f1))
* issues with invoices ([#271](#271)) ([e1561e7](e1561e7))

### Features

* add LNURL processor ([#202](#202)) ([f237400](f237400))
* allow lightning zap receipts on paid relays ([#303](#303)) ([14bc96f](14bc96f))

* feat: implement nodeless payments processor

* docs: add accepting payments section

* chore: validate nodeless webhook secret

* chore: hide powered-by-zebedee for non-zebedee processors

---------

Co-authored-by: semantic-release-bot <[email protected]>

Author: cameri

README.md

@@ -86,6 +86,18 @@ Install Docker from their [official guide](https://docs.docker.com/engine/instal
 - [Set up a Paid Nostr relay with Nostream and ZBD](https://andreneves.xyz/p/how-to-setup-a-paid-nostr-relay) by [André Neves](https://snort.social/p/npub1rvg76s0gz535txd9ypg2dfqv0x7a80ar6e096j3v343xdxyrt4ksmkxrck) (CTO & Co-Founder at [ZEBEDEE](https://zebedee.io/))
 - [Set up a Nostr relay in under 5 minutes](https://andreneves.xyz/p/set-up-a-nostr-relay-server-in-under) by [André Neves](https://twitter.com/andreneves) (CTO & Co-Founder at [ZEBEDEE](https://zebedee.io/))
 
+### Accepting payments
+
+1. Zebedee
+  - You must set ZEBEDEE_API_KEY with an API Key from one of your projects in your Zebedee Developer Dashboard. Contact @foxp2zeb on Telegram or npub1rvg76s0gz535txd9ypg2dfqv0x7a80ar6e096j3v343xdxyrt4ksmkxrck on Nostr requesting access to the Zebedee Developer Dashboard. See the Zebedee full guide on how to set up a paid relay.
+
+2. Nodeless.io
+  - Sign up for a new account at https://nodeless.io and create a new store. Take note of the store ID.
+  - Create a store webhook and make sure to check all of the events. Grab the store webhook secret.
+  - Go to Profile > API Tokens and generate a new key and keep note of it.
+  - Set NODELESS_API_KEY and NODELESS_WEBHOOK_SECRET environment variables with generated key and webhook secret, respectively.
+  - On your .nostr/settings.yaml file, update the field `paymentsProcessors.nodeless.storeId1 with your store ID.
+
 ## Quick Start (Docker Compose)
 
 Install Docker following the [official guide](https://docs.docker.com/engine/install/).
@@ -201,10 +213,7 @@ You may want to use `openssl rand -hex 128` to generate a secret.
   # Secret shortened for brevity
   ```
 
-In addition, if using Zebedee for payments, you must also set ZEBEDEE_API_KEY with
-an API Key from one of your projects in your Zebedee Developer Dashboard. Contact
-@foxp2zeb on Telegram or npub1rvg76s0gz535txd9ypg2dfqv0x7a80ar6e096j3v343xdxyrt4ksmkxrck on Nostr requesting
-access to the Zebedee Developer Dashboard.
+### Initializing the database
 
 Create `nostr_ts_relay` database:
 

docker-compose.yml

@@ -46,6 +46,9 @@ services:
       TOR_CONTROL_PORT: 9051
       TOR_PASSWORD: nostr_ts_relay
       HIDDEN_SERVICE_PORT: 80
+      # Nodeless.io
+      NODELESS_API_KEY: ${NODELESS_API_KEY}
+      NODELESS_WEBHOOK_SECRET: ${NODELESS_WEBHOOK_SECRET}
       # Enable DEBUG for troubleshooting. Examples:
       # DEBUG: "primary:*"
       # DEBUG: "worker:*"

resources/default-settings.yaml

@@ -29,6 +29,9 @@ paymentsProcessors:
     callbackBaseURL: https://nostream.your-domain.com/callbacks/lnbits
   lnurl:
     invoiceURL: https://getalby.com/lnurlp/your-username
+  nodeless:
+    baseURL: https://nodeless.io
+    storeId: your-nodeless-io-store-id
 network:
   maxPayloadSize: 524288
   # Comment the next line if using CloudFlare proxy

resources/index.html

@@ -58,7 +58,7 @@ <h1 class="mt-4 mb-4 text-center text-nowrap">{{name}}</h1>
             <button id="submitBtn" class="btn btn-lg btn-warning" type="submit">Pay {{amount}} sats</button>
           </div>
         </div>
-        <div class="row">
+        <div class="row d-none" id="powered-by-zebedee">
           <div class="d-flex justify-content-center mb-3 mt-4">
             <a href="https://zeb.gg/nostr-zbd-quickstart" target="_blank">
               <img class="poweredbyzbd-img" src="https://cdn.zebedee.io/an/nostr/poweredbyzbd.png" />
@@ -129,6 +129,7 @@ <h5 class="modal-title">Terms of Service</h5>
     </div>
     <script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/js/bootstrap.min.js" integrity="sha384-cuYeSxntonz0PPNlHhBs68uyIAVpIIOZZ5JqeqvYYIcEL727kskC66kF92t6Xl2V" crossorigin="anonymous"></script>
     <script>
+      var processor = "{{processor}}"
       function attemptGetPubkey() {
         const maxRetries = 10
         function getPubKey(retries) {
@@ -147,6 +148,9 @@ <h5 class="modal-title">Terms of Service</h5>
 
       function onLoad() {
         setTimeout(attemptGetPubkey, 300)
+        if (processor === 'zebedee') {
+          document.getElementById('powered-by-zebedee').classList.remove('d-none')
+        }
       }
     </script>
   </body>

resources/invoices.html

@@ -86,7 +86,7 @@ <h2 class="text-danger">Invoice expired!</h2>
             <button class="btn btn-lg btn-primary" type="submit">Get another invoice</button>
           </div>
         </div>
-        <div class="row">
+        <div class="row d-none" id="powered-by-zebedee">
           <div class="d-flex justify-content-center mb-3 mt-4">
             <a href="https://zeb.gg/nostr-zbd-quickstart" target="_blank">
               <img class="poweredbyzbd-img" src="https://cdn.zebedee.io/an/nostr/poweredbyzbd.png" />
@@ -104,6 +104,7 @@ <h2 class="text-danger">Invoice expired!</h2>
       var invoice = "{{invoice}}";
       var pubkey = "{{pubkey}}"
       var expiresAt = "{{expires_at}}"
+      var processor = "{{processor}}"
       var timeout
       var paid = false
       var fallbackTimeout
@@ -254,6 +255,9 @@ <h2 class="text-danger">Invoice expired!</h2>
       sendPayment().catch(() => {
         document.getElementById('sendPaymentBtn').classList.remove('d-none')
       })
+      if (processor === 'zebedee') {
+        document.getElementById('powered-by-zebedee').classList.remove('d-none')
+      }
     </script>
   </body>
 </html>

src/@types/invoice.ts

@@ -8,7 +8,8 @@ export enum InvoiceUnit {
 
 export enum InvoiceStatus {
   PENDING = 'pending',
-  COMPLETED = 'completed'
+  COMPLETED = 'completed',
+  EXPIRED = 'expired',
 }
 
 export interface Invoice {

src/@types/repositories.ts

@@ -23,6 +23,10 @@ export interface IEventRepository {
 export interface IInvoiceRepository {
   findById(id: string, client?: DatabaseClient): Promise<Invoice | undefined>
   upsert(invoice: Partial<Invoice>, client?: DatabaseClient): Promise<number>
+  updateStatus(
+    invoice: Pick<Invoice, 'id' | 'status'>,
+    client?: DatabaseClient,
+  ): Promise<Invoice | undefined>
   confirmInvoice(
     invoiceId: string,
     amountReceived: bigint,

src/@types/services.ts

@@ -9,7 +9,7 @@ export interface IPaymentsService {
     description: string,
   ): Promise<Invoice>
   updateInvoice(invoice: Partial<Invoice>): Promise<void>
-  updateInvoiceStatus(invoice: Partial<Invoice>): Promise<void>
+  updateInvoiceStatus(invoice: Pick<Invoice, 'id' | 'status'>): Promise<Invoice>
   confirmInvoice(
     invoice: Pick<Invoice, 'id' | 'amountPaid' | 'confirmedAt'>,
   ): Promise<void>

src/@types/settings.ts

@@ -157,15 +157,26 @@ export interface ZebedeePaymentsProcessor {
   ipWhitelist: string[]
 }
 
-export interface LNbitsPaymentProcessor {
+export interface NodelessPaymentsProcessor {
+  baseURL: string
+  storeId: string
+}
+
+export interface LNbitsPaymentsProcessor {
   baseURL: string
   callbackBaseURL: string
 }
 
+export interface NodelessPaymentsProcessor {
+  baseURL: string
+  storeId: string
+}
+
 export interface PaymentsProcessors {
   lnurl?: LnurlPaymentsProcessor,
   zebedee?: ZebedeePaymentsProcessor
-  lnbits?: LNbitsPaymentProcessor
+  lnbits?: LNbitsPaymentsProcessor
+  nodeless?: NodelessPaymentsProcessor
 }
 
 export interface Local {

src/adapters/web-server-adapter.ts

@@ -33,10 +33,10 @@ export class WebServerAdapter extends EventEmitter implements IWebServerAdapter
   }
 
   private onClientError(error: Error, socket: Duplex) {
-    console.error('web-server-adapter: client socket error:', error)
     if (error['code'] === 'ECONNRESET' || !socket.writable) {
       return
     }
+    console.error('web-server-adapter: client socket error:', error)
     socket.end('HTTP/1.1 400 Bad Request\r\nContent-Type: text/html\r\n')
   }