Кошельки

Подключите Blink или Alby, чтобы агент автоматически оплачивал Lightning-инвойсы.

Поддерживаемые кошельки

Кошелёк	Установка	Самостоятельное хранение	Примечания
Blink	встроено	❌ кастодиальный	Простейшая настройка, GraphQL API
Alby Hub	встроено	✅ возможность самостоятельного хостинга	REST API, поддержка собственного Hub
Пользовательский	интерфейс L402Wallet	✅	Используйте собственный кошелёк

---

BlinkWallet

Настройка

1. Зарегистрируйтесь на blink.sv
2. Перейдите в Dashboard → API Keys → создайте ключ
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"],
)

Как это работает

Выполняет вызов Blink GraphQL API с мутацией lnInvoicePaymentSend. Возвращает 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"),
)

Как это работает

Выполняет запрос POST /payments/bolt11 к Alby Hub REST API с токеном Bearer. Возвращает payment_preimage из ответа.

---

Пользовательский кошелёк

Реализуйте интерфейс L402Wallet для использования любого Lightning-кошелька:

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"]

Интерфейс требует реализации одного метода:

Метод	TypeScript	Python
Оплата BOLT11-инвойса	payInvoice(bolt11): Promise<{ preimage: string }>	pay_invoice(bolt11: str) -> str

---

Выбор кошелька

• Тестирование / прототипирование → Blink (кастодиальный, мгновенная настройка, бесплатный тариф)
• Продакшн-агент, максимальный контроль → Alby Hub самостоятельного хостинга (некастодиальный, REST API)
• Высокая пропускная способность / низкие комиссии → Phoenix через пользовательский L402Wallet (некастодиальный, ACINQ)
• Корпоративный сегмент → LNbits самостоятельного хостинга через пользовательский кошелёк