| name | alby-bitcoin-builder |
| description | Add bitcoin lightning wallet capabilities to your app using Nostr Wallet Connect (NIP-47), LNURL, and WebLN. Send and receive payments, subscribe to real-time payment notifications (use this instead of polling), fetch wallet balance and transactions, 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.3.2"} |
Usage
Use this skill to understand how to build apps that require bitcoin lightning wallet capabilities.
- NWC Client: Interact with a wallet to send and receive payments, subscribe to real-time payment notifications (preferred over polling), fetch balance, 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:
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
