whatisgithub

What is sentinelle?

slashbinslashnoname/sentinelle — explained in plain English

Analysis updated 2026-05-18

1TypeScriptAudience · developerComplexity · 4/5Setup · moderate

In one sentence

A self-hosted invoicing gateway that lets a shop accept Bitcoin, Lightning, Ethereum, and Solana payments without ever holding private keys.

Mindmap

mindmap
  root((Sentinelle))
    What it does
      Crypto invoicing gateway
      Watch only no private keys
      Multi rail payments
    Tech stack
      TypeScript
      Node.js
      React
      SQLite
    Use cases
      Bitcoin and Lightning
      Ethereum and Solana
      Accounting export
    Audience
      Shop operators
      Developers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Add Bitcoin, Lightning, Ethereum, and Solana payment options to an online shop without exposing private keys to the server.

USE CASE 2

Generate a time-limited invoice and get real-time WebSocket updates the moment it's paid.

USE CASE 3

Export a compliant accounting record of orders with the fiat to BTC rate locked at order time.

USE CASE 4

Run the whole payment gateway self-hosted via Docker with no third-party payment processor.

What is it built with?

TypeScriptNode.jsReactTailwind CSSSQLiteDocker

How does it compare?

slashbinslashnoname/sentinelle0xkinno/neuralvault0xmayurrr/ai-contractauditor
Stars111
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderatehardeasy
Complexity4/54/52/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires generating a watch-only xpub and optionally running your own phoenixd Lightning node.

The README does not state a license, so terms of use are unclear.

So what is it?

Sentinelle is a self hosted crypto invoicing gateway that a shop can plug into to accept payment in Bitcoin, Ethereum, Solana, or their supported stablecoins, while showing prices in Bitcoin, euros, or dollars. When an order is created, it generates an invoice that stays valid for a set window of time, fifteen minutes by default, and can be paid across whichever payment rails the shop operator turns on. Its main safety feature is that it never holds spending power. Every rail is watch only, meaning only public keys or addresses are stored on the server. Bitcoin and Ethereum addresses are derived from a public account key called an xpub, so a fresh receiving address can be generated for each invoice without the server ever having access to a private key that could move funds. Solana payments instead use a unique per invoice reference tied to a single wallet address. Lightning payments are handled through the operator's own phoenixd node and confirmed in real time over a WebSocket connection. The system also guards against a few subtle bugs common in payment software. It tracks Bitcoin and Ethereum address indexes carefully so they cannot overflow, and it recycles the addresses of invoices that expire unpaid instead of burning them forever. All monetary amounts are stored as whole numbers of satoshis or cents rather than floating point numbers, avoiding rounding errors. Sentinelle ships with a React and Tailwind based admin dashboard for managing settings, API keys, and a sortable list of invoices, plus real time payment notifications over WebSocket and email, manual reimbursements, and an accounting export in CSV or XLSX format with the exchange rate locked at the moment of each order. It runs as a Node.js server backed by a SQLite database, is available as a prebuilt Docker image, and exposes a simple HTTP API for creating invoices that shops can integrate with directly.

Copy-paste prompts

Prompt 1
Help me set up Sentinelle as a self-hosted Bitcoin and Lightning payment gateway for my shop.
Prompt 2
Show me how to create an invoice using Sentinelle's API and check its payment status over WebSocket.
Prompt 3
Explain how Sentinelle derives a watch-only Bitcoin address from an xpub for each invoice.
Prompt 4
Write a Docker compose file to run Sentinelle with a persistent SQLite volume.

Frequently asked questions

What is sentinelle?

A self-hosted invoicing gateway that lets a shop accept Bitcoin, Lightning, Ethereum, and Solana payments without ever holding private keys.

What language is sentinelle written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, React.

What license does sentinelle use?

The README does not state a license, so terms of use are unclear.

How hard is sentinelle to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is sentinelle for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.