OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Payments & Stablecoins

LNp2pBot

LNp2pBot is an open-source Telegram bot for coordinating peer-to-peer Bitcoin trades over the Lightning Network. It publishes buy and sell orders pairing satoshi amounts with fiat amounts, coordinates the parties’ payment confirmations, and uses hold invoices to release Lightning payments after the fiat transfer is confirmed. Its public TypeScript repository includes setup requirements for operators using MongoDB, Te

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

LNp2pBot — OpenViST project profile in Payments & Stablecoins.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use LNp2pBot when the trade needs to be coordinated in Telegram and the parties can confirm the fiat transfer before Lightning invoices are settled. Operators can consult its repository when preparing a self-hosted setup.

Who it is for

  • Telegram users seeking to trade Bitcoin with other people using Lightning and fiat transfers.
  • Telegram group administrators who want to facilitate member-to-member Bitcoin trading.
  • Developers or operators interested in hosting or adapting the bot from its public source code.

Documented uses

  • Publish or accept a buy or sell order pairing a Bitcoin amount with a fiat amount.
  • Coordinate fiat-payment confirmation before releasing the associated Lightning payment.
  • Facilitate peer-to-peer Bitcoin trading within a Telegram community.
  • Prepare the documented services and credentials needed to install the bot.
Before you choose

Requirements & limits

The README says users need a Telegram account with a username and must start the bot. Operating a self-hosted instance requires the documented supporting services and credentials.

  • The described trading flow depends on both parties confirming the fiat transfer; disputes are referred to a human solver.
  • If a party does not confirm within the configured period, the bot can send the case information to an administrator.
  • The repository is public and marked MIT-licensed; the described implementation uses TypeScript and connects to LND.
  • Group administrators are described as eligible for transaction commissions and able to offer discounts on bot fees.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Prepare an LNp2pBot installation

Configure the documented prerequisites and install the bot code; the available instructions here do not cover running it.

Before you start

  • MongoDB
  • A Telegram bot API token
  • A Lightning node; the project uses LND
  • LND TLS certificate, macaroon and gRPC host details

Steps

  1. Create a .env file from the project’s sample environment file.

  2. Set the MongoDB variables and Telegram BOT_TOKEN in .env.

  3. Configure LND by setting LND_CERT_BASE64, LND_MACAROON_BASE64 and LND_GRPC_HOST, or place the certificate and macaroon files in the project root and set LND_GRPC_HOST.

  4. Clone the repository and install its dependencies with the command below.

    Documented command
    npm install

Expected outcome

The documented configuration is in place and project dependencies are installed.

Guide limitations

  • These instructions cover prerequisites, configuration and dependency installation, not starting the bot or verifying a working deployment.
  • The project documentation identifies LND as its Lightning node connection.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
13 October 2026
Original website title
lnp2pBot/bot · Official homepage title · retained in its source language
How we review sourcesSuggest a correction