OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
Developer Tools

Ln Service

Ln Service is a JavaScript package that provides a gRPC interface for Node.js projects to interact with LND, the Lightning Network daemon. Its documented methods cover node information and operations including invoices, payments, channels, peers and on-chain transactions.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Ln Service — OpenViST project profile in Developer Tools.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use Ln Service when a Node.js project needs a package interface to LND’s gRPC methods and you can provide the node connection details and any required credentials.

Who it is for

  • Node.js developers integrating applications with an LND node.
  • Teams building Lightning node administration or integration tools in JavaScript.

Documented uses

  • Create an LND connection from a Node.js application using gRPC.
  • Read wallet and node information or perform documented Lightning and on-chain operations.
  • Subscribe to LND events, with error handling for connection loss or node shutdown.
Before you choose

Requirements & limits

The repository lists an MIT license and documents package installation through npm.

  • The package is a developer interface to LND, so an LND node is a prerequisite for node interactions.
  • Authenticated methods require LND credentials; the README identifies the TLS certificate and admin macaroon.
  • Supported LND versions listed are beta releases in the 0.20 and 0.21 series.
  • Some APIs require LND build tags or permissions, and method documentation includes version-specific limits.
  • The README points to a separate project for TypeScript-ready methods.

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

Connect a Node.js project to an authenticated LND node

Install Ln Service and create an authenticated gRPC connection using LND credentials.

Before you start

  • A Node.js project and an LND node.
  • The node’s tls.cert and admin.macaroon files.
  • LND connection socket, such as the README example 127.0.0.1:10009.

Steps

  1. Install the package with npm install ln-service.

  2. Encode the TLS certificate and admin macaroon as base64, avoiding newline characters in the credential values.

  3. Pass the encoded certificate and macaroon, plus the LND socket, to authenticatedLndGrpc to obtain an LND API object.

  4. Call a documented method with that object; the README illustrates getWalletInfo using either callback or promise syntax.

Expected outcome

The Node.js application has an authenticated LND API object it can pass to package methods.

Guide limitations

  • Supported LND versions listed in the README are v0.20.0-beta to v0.20.5-beta and v0.21.0-beta to v0.21.4-beta.
  • Individual methods can require specific permissions, LND versions or build tags.
  • The README documents unauthenticatedLndGrpc for unlocker methods; authenticated methods require credentials.
Documentation 1 ↗
Evidence and transparency

Sources & review

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