lnbits_skill

Overview

This skill enables safe management of an LNbits Lightning wallet: check balance, create invoices, and send payments. It follows strict security protocols to avoid exposing secrets and requires explicit user confirmation for outgoing payments. Use it to automate common Lightning operations while keeping sensitive data private.

How this skill works

The skill interacts with the LNbits API or a local CLI wrapper to query wallet balance, generate Bolt11 invoices, decode incoming invoices, and execute payments. Before any send action it always checks balance and decodes the invoice details, then prompts the user for a clear Yes/No confirmation. Errors returned by the LNbits API are summarized in plain language without exposing raw stack traces or secret values.

When to use it

• Check available sats before attempting a send or when reconciling funds.
• Create a Bolt11 invoice to receive a payment from another Lightning user.
• Decode a received Bolt11 invoice to verify amount and memo before paying.
• Send funds when you have confirmed balance and obtained explicit confirmation.
• Set up a new LNbits wallet on a demo or self-hosted instance when needed.

Best practices

• Never display or transmit Admin Keys, User IDs, or Wallet IDs—always keep them secret.
• Always call balance first to avoid insufficient-funds errors.
• Decode invoices to confirm amount and memo before initiating payment.
• Ask for and require an explicit Yes/No confirmation in this exact format before any pay: "I am about to send [Amount] sats to [Memo/Dest]. Proceed? (y/n)"
• Summarize API errors for the user; do not show raw JSON stacks or internal debug data.
• Instruct users to store base_url and adminkey securely (e.g., environment variables or a secrets manager).

Example use cases

• Create a wallet on a demo LNbits server and provide setup instructions for storing base_url and API key.
• Generate a 1000-sat Bolt11 invoice with a memo like "Coffee" and return the invoice string for the payer.
• Decode an incoming Bolt11 string to show the amount and memo, then check balance and request confirmation before paying.
• Handle a payment failure by summarizing the error (e.g., "Insufficient funds") and suggesting next steps.