name: alby-bitcoin-payments-agent-skill description: Add bitcoin lightning wallet capabilities to your app using Nostr Wallet Connect (NIP-47), LNURL, and WebLN. Send and receive payments, handle payment notifications, fetch wallet balance and transaction list, do bitcoin to fiat currency conversions, query lightning addresses, conditionally settle payments (HOLD invoices), parse BOLT-11 invoices, verify payment preimages. license: Apache-2.0 metadata: author: getAlby version: "1.2.1"

Alby Bitcoin Payments Agent Skill

When to use this skill

Use this skill to understand how to build apps that require bitcoin lightning wallet capabilities.

• NWC Client: Interact with a wallet to do things like sending and receive payments, listen to payment notifications, fetch balance and transaction list and wallet info
• Lightning Tools: Request invoices from a lightning address, parse BOLT-11 invoices, verify a preimage for a BOLT-11 invoice, LNURL-Verify, do bitcoin <-> fiat conversions
• Bitcoin Connect: Browser-only UI components for connecting wallets and accepting payments in React, Vue, or pure HTML web apps

Prefer Typescript

When the user says to use "JS" or "Javascript" or "NodeJS" or something similar, use typescript unless the user explicitly says to not use typescript or the project does not support it.

Imports

Do NOT import from the dist directory.

Read the Typings

Based on what functionality you require, read the relevant typings:

• NWC Client
• Lightning Tools
• Bitcoin Connect
• Bitcoin Connect React

Testing Wallets

If the user doesn't have a wallet yet, or needs one for development or testing, testing wallets can be created with a single request.

Automated Testing

Testing wallets should be used for automated testing.

It is recommended to write tests so that the agent can test its own work and fix bugs itself without requiring human input.

Production Wallet

If they do not have a wallet yet here are some options