Rename invoice stream method to watch

Rename synchronous and asynchronous invoice SSE method from wait_for_settlement to watch in src/lnbot/client.py and update code examples (also change API key placeholder from "lnbot_..." to "key_..."). Update README to reflect the new method name and add SDK/PyPI/SDK links. Update openapi.json server URL to https://api.ln.bot and expand keywords in pyproject.toml.

Author: realbub

README.md

@@ -12,13 +12,13 @@ Give your AI agents, apps, and services access to Bitcoin over the Lightning Net
 ```python
 from lnbot import LnBot
 
-ln = LnBot(api_key="lnbot_...")
+ln = LnBot(api_key="key_...")
 
 invoice = ln.invoices.create(amount=1000, memo="Coffee")
 ln.payments.create(target="alice@ln.bot", amount=500)
 ```
 
-> LnBot also ships a **[TypeScript SDK](https://www.npmjs.com/package/@lnbot/sdk)**, **[CLI](https://ln.bot/docs)**, and **[MCP server](https://ln.bot/docs)**.
+> LnBot also ships a **[TypeScript SDK](https://www.npmjs.com/package/@lnbot/sdk)**, **[Go SDK](https://pkg.go.dev/github.com/lnbotdev/go-sdk)**, **[Rust SDK](https://crates.io/crates/lnbot)**, **[CLI](https://ln.bot/docs)**, and **[MCP server](https://ln.bot/docs)**.
 
 ---
 
@@ -57,7 +57,7 @@ print(invoice.bolt11)
 ### 3. Wait for payment
 
 ```python
-for event in ln.invoices.wait_for_settlement(invoice.number):
+for event in ln.invoices.watch(invoice.number):
     if event.event == "settled":
         print("Paid!")
 ```
@@ -85,11 +85,11 @@ Every method has an async equivalent via `AsyncLnBot`:
 ```python
 from lnbot import AsyncLnBot
 
-async with AsyncLnBot(api_key="lnbot_...") as ln:
+async with AsyncLnBot(api_key="key_...") as ln:
     wallet = await ln.wallets.current()
     invoice = await ln.invoices.create(amount=1000)
 
-    async for event in ln.invoices.wait_for_settlement(invoice.number):
+    async for event in ln.invoices.watch(invoice.number):
         if event.event == "settled":
             print("Paid!")
 ```
@@ -121,7 +121,7 @@ except LnBotError as e:
 from lnbot import LnBot
 
 ln = LnBot(
-    api_key="lnbot_...",            # or set LNBOT_API_KEY env var
+    api_key="key_...",            # or set LNBOT_API_KEY env var
     base_url="https://api.ln.bot",  # optional — this is the default
     timeout=30.0,                   # optional — request timeout in seconds
 )
@@ -148,7 +148,7 @@ The API key can also be provided via the `LNBOT_API_KEY` environment variable. I
 | `ln.invoices.create(amount=, memo=, reference=)` | Create a BOLT11 invoice |
 | `ln.invoices.list(limit=, after=)` | List invoices |
 | `ln.invoices.get(number)` | Get invoice by number |
-| `ln.invoices.wait_for_settlement(number, timeout=)` | SSE stream for settlement/expiry |
+| `ln.invoices.watch(number, timeout=)` | SSE stream for settlement/expiry |
 
 ### Payments
 
@@ -211,7 +211,13 @@ The API key can also be provided via the `LNBOT_API_KEY` environment variable. I
 - [ln.bot](https://ln.bot) — website
 - [Documentation](https://ln.bot/docs)
 - [GitHub](https://github.com/lnbotdev)
-- [TypeScript SDK](https://www.npmjs.com/package/@lnbot/sdk)
+- [PyPI](https://pypi.org/project/lnbot/)
+
+## Other SDKs
+
+- [TypeScript SDK](https://github.com/lnbotdev/typescript-sdk) · [npm](https://www.npmjs.com/package/@lnbot/sdk)
+- [Go SDK](https://github.com/lnbotdev/go-sdk) · [pkg.go.dev](https://pkg.go.dev/github.com/lnbotdev/go-sdk)
+- [Rust SDK](https://github.com/lnbotdev/rust-sdk) · [crates.io](https://crates.io/crates/lnbot) · [docs.rs](https://docs.rs/lnbot)
 
 ## License
 

openapi.json

@@ -6,10 +6,7 @@
   },
   "servers": [
     {
-      "url": "https://localhost:52749"
-    },
-    {
-      "url": "http://localhost:52750"
+      "url": "https://api.ln.bot"
     }
   ],
   "paths": {

pyproject.toml

@@ -14,13 +14,22 @@ keywords = [
     "lnbot",
     "lightning",
     "lightning-network",
+    "lightning-payments",
+    "lightning-address",
+    "lightning-wallet",
     "bitcoin",
-    "payments",
-    "wallet",
+    "bitcoin-payments",
     "bolt11",
+    "lnurl",
     "sats",
+    "payments",
+    "invoices",
+    "wallet",
+    "micropayments",
     "ai-agent",
+    "ai-payments",
     "mcp",
+    "model-context-protocol",
     "sdk",
 ]
 classifiers = [

src/lnbot/client.py

@@ -137,7 +137,7 @@ def get(self, number: int) -> InvoiceResponse:
         """Get a single invoice by its number."""
         return parse(InvoiceResponse, self._c._get(f"/v1/invoices/{number}"))
 
-    def wait_for_settlement(self, number: int, *, timeout: int | None = None) -> Iterator[InvoiceEvent]:
+    def watch(self, number: int, *, timeout: int | None = None) -> Iterator[InvoiceEvent]:
         """Stream SSE events until the invoice is settled or expires."""
         params = _qs({"timeout": timeout})
         headers = {"Accept": "text/event-stream", "User-Agent": _USER_AGENT}
@@ -280,7 +280,7 @@ def passkey_complete(self, *, session_id: str, assertion: dict[str, Any]) -> Res
 class LnBot:
     """Synchronous LnBot API client.
 
-    >>> with LnBot(api_key="lnbot_...") as ln:
+    >>> with LnBot(api_key="key_...") as ln:
     ...     wallet = ln.wallets.current()
     """
 
@@ -397,7 +397,7 @@ async def get(self, number: int) -> InvoiceResponse:
         """Get a single invoice by its number."""
         return parse(InvoiceResponse, await self._c._get(f"/v1/invoices/{number}"))
 
-    async def wait_for_settlement(self, number: int, *, timeout: int | None = None) -> AsyncIterator[InvoiceEvent]:
+    async def watch(self, number: int, *, timeout: int | None = None) -> AsyncIterator[InvoiceEvent]:
         """Stream SSE events until the invoice is settled or expires."""
         params = _qs({"timeout": timeout})
         headers = {"Accept": "text/event-stream", "User-Agent": _USER_AGENT}
@@ -540,7 +540,7 @@ async def passkey_complete(self, *, session_id: str, assertion: dict[str, Any])
 class AsyncLnBot:
     """Asynchronous LnBot API client.
 
-    >>> async with AsyncLnBot(api_key="lnbot_...") as ln:
+    >>> async with AsyncLnBot(api_key="key_...") as ln:
     ...     wallet = await ln.wallets.current()
     """