litd-grpc

Manage litd gRPC accounts, macaroons, payments, and LNC sessions.

57|18|Updated Feb 6, 2026
One-click install
npx skills add https://github.com/lightninglabs/lightning-agent-tools --skill litd-grpc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: litd-grpc
Source: https://github.com/lightninglabs/lightning-agent-tools/tree/main/skills/litd-grpc
Command: npx skills add https://github.com/lightninglabs/lightning-agent-tools --skill litd-grpc

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill removes the friction of working with litd's Lightning Terminal gRPC API when you need to manage accounts, control access, and inspect account-scoped payments or sessions. It is especially useful when you want to interact with Lightning Terminal safely from Go without repeatedly rediscovering authentication and caveat rules.

Core Features & Use Cases

  • Account lifecycle management: List, create, credit, debit, update, and remove accounts through litrpc.
  • Macaroon and permission handling: Bake supermacaroons or account-scoped macaroons with the right caveats and permission sets.
  • LNC session operations: Create readonly, admin, custom, autopilot, or account-tied sessions, then check state or revoke them.
  • Payment visibility: Query outgoing payments and incoming invoices for a specific account using the correct connection pattern.
  • Use case: A developer building an automation tool can use this Skill to issue scoped access for a wallet, rotate credentials, and list only the payments that belong to one customer account.

Quick Start

Use the litd-grpc skill to connect to litd, bake the appropriate macaroon, and create or inspect the account and LNC session data you need.

Frequently Asked Questions about litd-grpc

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I manage litd accounts and bake macaroons with the right caveats in Go?

You can manage litd accounts and bake macaroons in Go by connecting to the litd gRPC interface, then using litrpc to create accounts and bake supermacaroons or account-scoped macaroons with the correct permission sets and caveats.

How do I create and revoke LNC sessions for Lightning Terminal?

To create and revoke LNC sessions for Lightning Terminal, use the litd gRPC API to provision readonly, admin, autopilot, or custom sessions, then check their state and revoke them when access is no longer needed.

What is the best way to query account-scoped payments in a Lightning Terminal daemon?

The best way to query account-scoped payments in a Lightning Terminal daemon is through the litd gRPC connection pattern, which allows you to retrieve outgoing payments and incoming invoices specifically tied to a single customer account.

Does litd gRPC require TLS and macaroon metadata for authentication?

Yes, litd gRPC requires TLS for secure connectivity and macaroon metadata for authentication. You must handle these correctly alongside account caveats and session state when managing Lightning Terminal access.

Can I automate credential rotation and scoped wallet access using litd?

Yes, you can automate credential rotation and scoped wallet access using litd by baking account-scoped macaroons and provisioning LNC sessions that grant specific permission sets to individual wallet users.