वॉलेट्स

अपने एजेंट को Lightning इनवॉइस स्वचालित रूप से भुगतान करने देने के लिए Blink या Alby को कनेक्ट करें।

समर्थित वॉलेट्स

वॉलेट	इंस्टॉल	स्व-अभिरक्षा	नोट्स
Blink	built-in	❌ कस्टोडियल	सबसे आसान सेटअप, GraphQL API
Alby Hub	built-in	✅ स्व-होस्टेड विकल्प	REST API, अपना Hub समर्थित
कस्टम	L402Wallet interface	✅	अपना खुद का वॉलेट लाएं

---

BlinkWallet

सेटअप

1. blink.sv पर साइन अप करें
2. Dashboard → API Keys पर जाएं → एक key बनाएं
3. डैशबोर्ड से अपना Wallet ID कॉपी करें

export BLINK_API_KEY="your-api-key"
export BLINK_WALLET_ID="your-wallet-id"

Node.js

import { BlinkWallet } from "l402-kit";

const wallet = new BlinkWallet(
  process.env.BLINK_API_KEY!,
  process.env.BLINK_WALLET_ID!,
);

Python

from l402kit.wallets import BlinkWallet

wallet = BlinkWallet(
    api_key=os.environ["BLINK_API_KEY"],
    wallet_id=os.environ["BLINK_WALLET_ID"],
)

यह कैसे काम करता है

lnInvoicePaymentSend म्यूटेशन के साथ Blink GraphQL API को कॉल करता है। सेटल हुए ट्रांज़ैक्शन से preImage लौटाता है।

---

AlbyWallet

सेटअप

1. getalby.com पर अकाउंट बनाएं
2. Settings → Access Tokens पर जाएं → payments:send स्कोप के साथ एक टोकन बनाएं
3. (वैकल्पिक) स्व-अभिरक्षा के लिए अपना खुद का Alby Hub चलाएं

export ALBY_TOKEN="your-access-token"
# वैकल्पिक — केवल स्व-होस्टेड Hub के लिए आवश्यक:
export ALBY_HUB_URL="https://your-hub.example.com"

Node.js

import { AlbyWallet } from "l402-kit";

// Alby cloud
const wallet = new AlbyWallet(process.env.ALBY_TOKEN!);

// Self-hosted Hub
const wallet = new AlbyWallet(
  process.env.ALBY_TOKEN!,
  process.env.ALBY_HUB_URL,  // optional base URL
);

Python

from l402kit.wallets import AlbyWallet

# Alby cloud
wallet = AlbyWallet(os.environ["ALBY_TOKEN"])

# Self-hosted Hub
wallet = AlbyWallet(
    access_token=os.environ["ALBY_TOKEN"],
    base_url=os.environ.get("ALBY_HUB_URL", "https://api.getalby.com"),
)

यह कैसे काम करता है

Bearer टोकन के साथ Alby Hub REST API पर POST /payments/bolt11 को कॉल करता है। रिस्पॉन्स से payment_preimage लौटाता है।

---

कस्टम वॉलेट

किसी भी Lightning वॉलेट का उपयोग करने के लिए L402Wallet interface को इम्प्लीमेंट करें:

TypeScript

import type { L402Wallet } from "l402-kit";

class PhoenixWallet implements L402Wallet {
  async payInvoice(bolt11: string): Promise<{ preimage: string }> {
    const res = await fetch("http://localhost:9740/payinvoice", {
      method: "POST",
      body: new URLSearchParams({ invoice: bolt11 }),
    });
    const data = await res.json();
    return { preimage: data.paymentPreimage };
  }
}

Python

from l402kit import L402Wallet
import httpx

class PhoenixWallet(L402Wallet):
    def pay_invoice(self, bolt11: str) -> str:
        r = httpx.post(
            "http://localhost:9740/payinvoice",
            data={"invoice": bolt11},
        )
        r.raise_for_status()
        return r.json()["paymentPreimage"]

इस interface के लिए एक एकल मेथड आवश्यक है:

मेथड	TypeScript	Python
BOLT11 इनवॉइस का भुगतान करें	payInvoice(bolt11): Promise<{ preimage: string }>	pay_invoice(bolt11: str) -> str

---

वॉलेट चुनना

• टेस्टिंग / प्रोटोटाइपिंग → Blink (कस्टोडियल, तुरंत सेटअप, फ्री टियर)
• प्रोडक्शन एजेंट, अधिकतम नियंत्रण → Alby Hub स्व-होस्टेड (नॉन-कस्टोडियल, REST API)
• उच्च थ्रूपुट / कम शुल्क → Phoenix कस्टम L402Wallet के ज़रिए (नॉन-कस्टोडियल, ACINQ)
• एंटरप्राइज़ → LNbits स्व-होस्टेड कस्टम वॉलेट के ज़रिए