Lightning Faucet MCP Server

chính thức

Cung cấp cho các tác nhân AI một ví Bitcoin với khả năng thanh toán qua Lightning Network

Tài liệu

Ví Lightning

Trao cho tác nhân AI của bạn một ví Bitcoin. Máy chủ MCP + CLI. Hoạt động với Claude Code, OpenClaw, Cursor và bất kỳ framework tác nhân nào.

Có gì mới trong v1.4

Công cụ update_operator / lw set-email - đặt email người vận hành từ máy khách MCP hoặc CLI; một liên kết xác minh sẽ được gửi qua email cho bạn.
Công cụ claim_promo / lw claim-promo - nhận khuyến mãi satoshi miễn phí khi cài đặt trực tiếp từ tác nhân của bạn. Yêu cầu: email đã xác minh + tài khoản người vận hành ít nhất 3 giờ tuổi.
get_info hoạt động trước khi đăng ký - thông tin dịch vụ không còn yêu cầu khóa API.

100 satoshi miễn phí cho người vận hành mới

lw register --email [email protected] (hoặc công cụ MCP register_operator với một email)
Nhấp vào liên kết xác minh chúng tôi gửi qua email
Sau khi tài khoản của bạn được 3 giờ tuổi: lw claim-promo (hoặc công cụ MCP claim_promo)

Một phần thưởng cho mỗi người vận hành, chỉ dành cho 100 lượt cài đặt đầu tiên, không yêu cầu nạp tiền.

Có gì mới trong v1.3

v1.3.0 - Hỗ trợ giao thức L402 v0 theo thông số kỹ thuật Lightning Labs mới nhất.

Giao thức L402 v0 - Định dạng tiêu đề được cập nhật: version="0", token=, tương thích ngược với macaroon=
Khám phá điểm cuối - .well-known/l402.json trên lightningfaucet.com và certvera.com
Tương thích ngược - Xử lý cả định dạng tiêu đề L402 cũ và mới từ bất kỳ dịch vụ nào

Có gì mới trong v1.1

v1.1.0 - Hỗ trợ giao thức X402 (USDC trên Base) như một phương án dự phòng tự động cùng với L402 (Lightning).

Hỗ trợ X402 - Thanh toán USDC tự động trên Base khi L402 không khả dụng
Tự động phát hiện giao thức - pay_l402_api xử lý liền mạch cả L402 và X402
Webhooks - Thông báo thời gian thực cho các khoản thanh toán và sự kiện
Keysend - Gửi thanh toán không cần hóa đơn bằng khóa công khai nút
Giải mã hóa đơn - Giải mã hóa đơn BOLT11 trước khi thanh toán
Phân tích tác nhân - Theo dõi mô hình chi tiêu và mức sử dụng
Xuất giao dịch - Xuất lịch sử ở định dạng JSON hoặc CSV
Quản lý ngân sách - Nhận trạng thái ngân sách chi tiết và đặt giới hạn
Vòng đời tác nhân - Vô hiệu hóa, kích hoạt lại và xóa tác nhân
Khôi phục tài khoản - Khôi phục tài khoản và xoay vòng khóa API
Chuyển tiền giữa các tác nhân - Di chuyển tiền giữa các tác nhân của bạn

Tại sao chọn Lightning Wallet MCP?

Thanh toán tức thì - Giao dịch Lightning Network được giải quyết trong mili giây
Hỗ trợ giao thức L402 + X402 - Truy cập bất kỳ API trả phí nào một cách tự động (Lightning hoặc USDC)
Phân cấp Người vận hành/Tác nhân - Quản lý nhiều tác nhân với giới hạn chi tiêu
Không rủi ro lưu ký - Mỗi tác nhân có quỹ riêng biệt với sự giám sát của người vận hành
Sẵn sàng cho sản xuất - Cơ sở hạ tầng đã được kiểm nghiệm thực tế, hỗ trợ các giao dịch thực
Thông báo Webhook - Nhận thông báo ngay lập tức khi có thanh toán đến
Khả năng quan sát đầy đủ - Phân tích, xuất dữ liệu và theo dõi trạng thái chi tiết

Hai cách sử dụng

CLI (Bất kỳ Framework Tác nhân nào)

Dành cho các tác nhân ưu tiên CLI (OpenClaw, Pi, KiloCode hoặc bất kỳ tác nhân nào có quyền truy cập Bash):

npm install -g lightning-wallet-mcp

Thao tác này cài đặt lệnh lw:

# Register and save your API key
export LIGHTNING_WALLET_API_KEY=$(lw register --name "My Bot" | jq -r '.api_key')

# Check balance
lw balance | jq '.balance_sats'

# Pay an L402 API
lw pay-api "https://lightningfaucet.com/api/l402/fortune"

# Create and fund an agent
lw create-agent "Research Bot" --budget 5000
lw fund-agent 1 1000

# Check identity
lw whoami

Đầu ra mặc định là JSON (dẫn đến jq). Sử dụng --human để có đầu ra dễ đọc.

Chạy lw help để biết tất cả các lệnh.

Máy chủ MCP (Claude Code, Cursor, Windsurf)

Đối với các máy khách MCP gốc, cấu hình như một máy chủ MCP:

Tùy chọn A: Tự đăng ký

{
  "mcpServers": {
    "lightning-wallet": {
      "command": "npx",
      "args": ["lightning-wallet-mcp"]
    }
  }
}

Sau đó yêu cầu Claude: "Đăng ký tài khoản người vận hành Lightning Wallet mới"

Tùy chọn B: Khóa API được cấu hình sẵn

Lấy khóa API tại lightningfaucet.com/ai-agents
Cấu hình Claude Code (~/.claude/settings.json):

{
  "mcpServers": {
    "lightning-wallet": {
      "command": "npx",
      "args": ["lightning-wallet-mcp"],
      "env": {
        "LIGHTNING_WALLET_API_KEY": "your-api-key-here"
      }
    }
  }
}

Tham khảo Công cụ

Thông tin Dịch vụ

Công cụ	Mô tả
`get_info`	Nhận trạng thái dịch vụ, phiên bản và các tính năng được hỗ trợ
`decode_invoice`	Giải mã hóa đơn BOLT11 để xem số tiền, đích đến và thời hạn

Ngữ cảnh & Danh tính

Công cụ	Mô tả
`whoami`	Nhận ngữ cảnh hiện tại - hiển thị đang hoạt động với tư cách người vận hành hay tác nhân
`check_balance`	Kiểm tra số dư Lightning hiện tại bằng satoshi
`get_rate_limits`	Kiểm tra trạng thái giới hạn tốc độ hiện tại và số yêu cầu còn lại

Thanh toán (Yêu cầu Khóa Tác nhân)

Công cụ	Mô tả
`pay_l402_api`	Truy cập API trả phí (L402/X402) - tự động phát hiện giao thức và thanh toán
`pay_invoice`	Thanh toán bất kỳ hóa đơn Lightning BOLT11 nào
`keysend`	Gửi thanh toán trực tiếp đến khóa công khai nút (không cần hóa đơn)
`pay_lightning_address`	Thanh toán đến địa chỉ Lightning (định dạng [email protected])
`create_invoice`	Tạo hóa đơn để nhận thanh toán
`get_invoice_status`	Kiểm tra xem hóa đơn đã được thanh toán chưa
`get_transactions`	Xem lịch sử giao dịch

LNURL (Yêu cầu Khóa Tác nhân)

Công cụ	Mô tả
`lnurl_auth`	Xác thực với dịch vụ bằng giao thức LNURL-auth
`claim_lnurl_withdraw`	Nhận tiền từ liên kết LNURL-withdraw

Quản lý Người vận hành

Công cụ	Mô tả
`register_operator`	Tạo tài khoản người vận hành mới
`recover_account`	Khôi phục tài khoản bằng mã khôi phục
`rotate_api_key`	Tạo khóa API mới (tạm dừng rút tiền 60 phút)
`get_deposit_invoice`	Tạo hóa đơn để nạp tiền vào tài khoản người vận hành
`withdraw`	Rút tiền đến đích Lightning bên ngoài
`set_operator_key`	Chuyển sang thông tin xác thực người vận hành

update_operator - đặt email người vận hành (gửi liên kết xác minh) và/hoặc tên
claim_promo - nhận khuyến mãi satoshi miễn phí khi cài đặt (email đã xác minh + tài khoản 3h)

Quản lý Tác nhân

Công cụ	Mô tả
`create_agent`	Tạo tác nhân dưới quyền người vận hành
`list_agents`	Liệt kê tất cả tác nhân dưới quyền người vận hành
`fund_agent`	Chuyển satoshi từ người vận hành sang tác nhân
`transfer_to_agent`	Chuyển satoshi giữa các tác nhân hoặc từ người vận hành sang tác nhân
`sweep_agent`	Quét tiền từ tác nhân về lại người vận hành
`deactivate_agent`	Tạm thời vô hiệu hóa một tác nhân
`reactivate_agent`	Kích hoạt lại một tác nhân đã bị vô hiệu hóa
`delete_agent`	Xóa vĩnh viễn một tác nhân (trả lại số dư cho người vận hành)
`get_budget_status`	Nhận giới hạn ngân sách và chi tiêu của tác nhân
`set_budget`	Đặt hoặc cập nhật giới hạn chi tiêu của tác nhân
`set_agent_credentials`	Chuyển sang thông tin xác thực tác nhân

Webhooks

Công cụ	Mô tả
`register_webhook`	Đăng ký URL để nhận thông báo sự kiện
`list_webhooks`	Liệt kê tất cả webhooks đã đăng ký
`delete_webhook`	Xóa một webhook
`test_webhook`	Gửi sự kiện kiểm tra để xác minh kết nối webhook

Sự kiện Webhook:

invoice_paid - Đã nhận thanh toán trên hóa đơn
payment_completed - Thanh toán đi thành công
payment_failed - Thanh toán đi thất bại
balance_low - Số dư giảm xuống dưới ngưỡng
budget_warning - Đã tiêu thụ 80% ngân sách
test - Sự kiện kiểm tra thủ công

Tham khảo CLI

Tất cả các lệnh xuất JSON ra stdout. Lỗi được gửi đến stderr với mã thoát 1.

Lệnh	Mô tả
`lw register [--name "name"]`	Tạo tài khoản người vận hành, in khóa API
`lw whoami`	Danh tính hiện tại (người vận hành hoặc tác nhân)
`lw balance`	Số dư bằng satoshi
`lw info`	Trạng thái và khả năng dịch vụ
`lw deposit <amount>`	Tạo hóa đơn nạp tiền
`lw withdraw <invoice>`	Rút về ví bên ngoài
`lw pay <invoice>`	Thanh toán hóa đơn BOLT11 `[--max-fee <sats>]`
`lw pay-api <url>`	Thanh toán API L402/X402 `[--method GET] [--body "{}"] [--max-sats 1000]`
`lw decode <invoice>`	Giải mã hóa đơn BOLT11
`lw create-agent <name>`	Tạo tác nhân `[--budget <sats>]`
`lw fund-agent <id> <amount>`	Chuyển satoshi cho tác nhân
`lw list-agents`	Liệt kê tất cả tác nhân
`lw transactions`	Giao dịch gần đây `[--limit 10] [--offset 0]`
`lw help`	Hiển thị tất cả lệnh

Ví dụ Quy trình Tác nhân (Bash)

# 1. Register (one-time)
export LIGHTNING_WALLET_API_KEY=$(lw register --name "My Agent" | jq -r '.api_key')

# 2. Fund the account (pay the invoice with any Lightning wallet)
lw deposit 10000 | jq -r '.bolt11'

# 3. Create an agent with a budget
AGENT=$(lw create-agent "Worker" --budget 5000)
AGENT_ID=$(echo $AGENT | jq -r '.agent_id')
AGENT_KEY=$(echo $AGENT | jq -r '.agent_api_key')

# 4. Fund the agent
lw fund-agent $AGENT_ID 2000

# 5. Switch to agent context and make payments
export LIGHTNING_WALLET_API_KEY=$AGENT_KEY
lw pay-api "https://api.example.com/data" --max-sats 100

# 6. Check what happened
lw transactions --limit 5

Giao thức API Trả phí: L402 + X402

Lightning Wallet MCP hỗ trợ hai giao thức thanh toán HTTP 402:

L402 (chính) - Thanh toán Lightning Network. Giao thức trả tiền theo yêu cầu ban đầu.
X402 (dự phòng) - USDC trên Base (giao thức của Coinbase). Tự động phát hiện khi L402 không khả dụng.

Khi bạn gọi pay_l402_api, máy chủ sẽ tự động phát hiện giao thức mà API sử dụng. L402 luôn được ưu tiên nếu cả hai tiêu đề đều có mặt. Tác nhân luôn thanh toán bằng satoshi bất kể giao thức nào — số tiền X402 được chuyển đổi theo tỷ giá thị trường.

Giao thức L402

Giao thức L402 (trước đây là LSAT) cho phép API tính phí theo yêu cầu bằng Lightning. Khi bạn gọi một điểm cuối được bảo vệ bởi L402:

Máy chủ trả về HTTP 402 với hóa đơn Lightning
Lightning Faucet tự động thanh toán hóa đơn
Yêu cầu hoàn tất với nội dung đã thanh toán

Giao thức X402 (Coinbase)

X402 sử dụng USDC trên Base cho thanh toán API. Quy trình này minh bạch đối với tác nhân:

Máy chủ trả về HTTP 402 với tiêu đề PAYMENT-REQUIRED
Lightning Faucet chuyển đổi số tiền USDC sang satoshi, ghi nợ số dư tác nhân
Ký ủy quyền EIP-712 và thử lại với tiêu đề PAYMENT-SIGNATURE
Yêu cầu hoàn tất — tác nhân thấy định dạng phản hồi giống như L402

Phản hồi bao gồm payment_protocol: "x402" và usdc_amount để tác nhân biết giao thức nào đã được sử dụng.

Sổ đăng ký API L402

Chúng tôi duy trì một thư mục các API hỗ trợ L402 tại lightningfaucet.com/l402-registry - hoàn hảo để kiểm tra tác nhân của bạn.

API L402 Demo

Hãy thử các điểm cuối này để kiểm tra thanh toán L402:

# Get a fortune (costs ~10-50 sats)
pay_l402_api({ url: "https://lightningfaucet.com/api/l402/fortune" })

# Get a joke (costs ~10-50 sats)
pay_l402_api({ url: "https://lightningfaucet.com/api/l402/joke" })

# Get an inspirational quote (costs ~10-50 sats)
pay_l402_api({ url: "https://lightningfaucet.com/api/l402/quote" })

Xem Sổ đăng ký API L402 để biết thêm điểm cuối và tài nguyên.

Ví dụ Quy trình Hoàn chỉnh

// 1. Register as operator (if no API key configured)
register_operator({ name: "My AI Company" })
// Returns: { api_key: "lf_abc...", recovery_code: "xyz...", operator_id: 123 }

// 2. Activate the operator key
set_operator_key({ api_key: "lf_abc..." })

// 3. Check who you are
whoami()
// Returns: { type: "operator", id: 123, name: "My AI Company", balance_sats: 0 }

// 4. Fund your operator account
get_deposit_invoice({ amount_sats: 10000 })
// Pay this invoice with any Lightning wallet

// 5. Create an agent with budget limit
create_agent({ name: "Research Assistant", budget_limit_sats: 5000 })
// Returns: { agent_id: 456, agent_api_key: "agent_def..." }

// 6. Fund the agent
fund_agent({ agent_id: 456, amount_sats: 1000 })

// 7. Set up a webhook for payment notifications
register_webhook({
  url: "https://your-server.com/webhooks/lightning",
  events: ["invoice_paid", "payment_completed"]
})
// Returns: { webhook_id: 1, secret: "..." }  <- Save this secret!

// 8. Switch to agent mode for payments
set_agent_credentials({ api_key: "agent_def..." })

// 9. Check budget status
get_budget_status()
// Returns: { budget_limit_sats: 5000, total_spent_sats: 0, remaining_sats: 5000 }

// 10. Make payments!
pay_l402_api({ url: "https://api.example.com/premium-data" })

Thanh toán Keysend

Gửi thanh toán trực tiếp đến một nút Lightning mà không cần hóa đơn:

// Send 100 sats to a node with an optional message
keysend({
  destination: "03864ef025fde8fb587d989186ce6a4a186895ee44a926bfc370e2c366597a3f8f",
  amount_sats: 100,
  message: "Hello from my AI agent!"
})

Giải mã Hóa đơn

Kiểm tra chi tiết hóa đơn trước khi thanh toán:

decode_invoice({ invoice: "lnbc1000n1..." })
// Returns: {
//   amount_sats: 1000,
//   description: "Test payment",
//   destination: "03abc...",
//   expires_at: "2026-01-16T12:00:00Z",
//   is_expired: false
// }

Chi tiết Công cụ

get_info

Nhận trạng thái và khả năng dịch vụ.

{
  "success": true,
  "version": "1.0.1",
  "api_version": "1.0",
  "status": "operational",
  "max_payment_sats": 1000000,
  "min_payment_sats": 1,
  "supported_features": ["l402", "x402", "webhooks", "lightning_address", "keysend"]
}

whoami

Nhận ngữ cảnh hoạt động hiện tại.

Trả về cho Người vận hành:

{
  "type": "operator",
  "id": 123,
  "name": "My Company",
  "balance_sats": 50000,
  "agent_count": 3
}

Trả về cho Tác nhân:

{
  "type": "agent",
  "id": 456,
  "name": "Research Bot",
  "balance_sats": 1000,
  "budget_limit_sats": 5000,
  "operator_id": 123
}

pay_l402_api

Truy cập API trả phí với thanh toán tự động. Hỗ trợ cả giao thức L402 (Lightning) và X402 (USDC trên Base). Giao thức được tự động phát hiện từ các tiêu đề phản hồi 402.

Tham số	Loại	Bắt buộc	Mô tả
url	string	Có	URL để yêu cầu
method	string	Không	Phương thức HTTP (GET, POST, PUT, DELETE). Mặc định: GET
body	string	Không	Nội dung yêu cầu cho POST/PUT
max_payment_sats	number	Không	Số tiền thanh toán tối đa. Mặc định: 1000

keysend

Gửi thanh toán đến một nút mà không cần hóa đơn.

Tham số	Loại	Bắt buộc	Mô tả
destination	string	Có	Khóa công khai nút đích (66 ký tự hex)
amount_sats	number	Có	Số tiền bằng satoshi
message	string	Không	Tin nhắn tùy chọn (tối đa 1000 ký tự)

register_webhook

Đăng ký URL để nhận thông báo thanh toán.

Tham số	Loại	Bắt buộc	Mô tả
url	string	Có	URL HTTPS để nhận webhooks
events	array	Không	Các loại sự kiện để đăng ký. Mặc định: ["invoice_paid"]

Trả về: ID Webhook và bí mật HMAC để xác minh chữ ký.

Kiến trúc

┌─────────────────────────────────────────────────────────┐
│                    OPERATOR                              │
│  • Holds main funds                                      │
│  • Creates and manages agents                            │
│  • Sets spending limits                                  │
│  • Receives webhook notifications                        │
│  • Can recover account with recovery code                │
├─────────────────────────────────────────────────────────┤
│     AGENT 1          AGENT 2          AGENT 3           │
│   ┌─────────┐      ┌─────────┐      ┌─────────┐        │
│   │ 1000 sat│      │ 5000 sat│      │ 2500 sat│        │
│   │ Budget: │      │ Budget: │      │ Budget: │        │
│   │ 5000    │      │ 10000   │      │ Unlimited│        │
│   └─────────┘      └─────────┘      └─────────┘        │
│       │                │                │               │
│   L402 APIs        Keysend          Receive             │
│   Pay Invoice      Payments         Payments            │
└─────────────────────────────────────────────────────────┘

Thực hành Bảo mật Tốt nhất

Không bao giờ commit khóa API - Sử dụng biến môi trường
Đặt giới hạn ngân sách - Bảo vệ chống lại chi tiêu mất kiểm soát
Sử dụng khóa tác nhân để thanh toán - Giữ khóa người vận hành an toàn
Xác minh chữ ký webhook - Sử dụng bí mật được trả về trong quá trình đăng ký
Giám sát giao dịch - Sử dụng get_transactions để xem xét hoạt động
Mã khôi phục - Lưu trữ an toàn, cần thiết nếu mất khóa API
Xoay vòng khóa - Xoay vòng khóa định kỳ bằng rotate_api_key

Bảo mật Webhook

Webhooks bao gồm chữ ký HMAC-SHA256 để xác minh:

import hmac
import hashlib

def verify_webhook(payload, signature, secret):
    expected = hmac.new(
        secret.encode(),
        payload.encode(),
        hashlib.sha256
    ).hexdigest()
    return hmac.compare_digest(signature, expected)

Kiểm tra tiêu đề X-Webhook-Signature dựa trên tải trọng.

Hook Chính sách Trước Thanh toán

Một hook trung lập với nhà cung cấp, không bắt buộc, cho phép một điểm cuối chính sách bên ngoài cho phép hoặc từ chối một khoản thanh toán trước khi nó được thực thi. Hook này bị tắt theo mặc định — khi PRE_PAYMENT_HOOK_URL không được đặt, hành vi hoàn toàn giống như trước đây. Khi được đặt, mọi khoản thanh toán đi (pay_l402_api, pay_invoice, keysend, pay_lightning_address) đều được kiểm tra với điểm cuối của bạn trước; một sự từ chối sẽ hủy bỏ khoản thanh toán trước khi bất kỳ khoản tiền nào được di chuyển.

Điều này hữu ích cho các chính sách chi tiêu, quy trình phê duyệt, kiểm tra tuân thủ, hoặc bất kỳ lớp ủy quyền bên ngoài nào. Giao thức hook là chung, vì vậy bất kỳ dịch vụ nào triển khai hợp đồng yêu cầu/phản hồi dưới đây đều có thể được kết nối chỉ bằng cấu hình.

Cấu hình

Biến môi trường	Mặc định	Mô tả
`PRE_PAYMENT_HOOK_URL`	(chưa đặt)	Điểm cuối chính sách để POST mỗi đề xuất thanh toán đến. Không đặt sẽ tắt hoàn toàn hook.
`PRE_PAYMENT_HOOK_TIMEOUT_MS`	`3000`	Thời gian chờ cho mỗi yêu cầu tính bằng mili giây.
`PRE_PAYMENT_HOOK_FAIL_MODE`	`closed`	`closed` từ chối thanh toán nếu hook gặp lỗi hoặc hết thời gian chờ; `open` cho phép nó tiếp tục. Mặc định là đóng khi lỗi.

{
  "mcpServers": {
    "lightning-wallet": {
      "command": "npx",
      "args": ["lightning-wallet-mcp"],
      "env": {
        "LIGHTNING_WALLET_API_KEY": "your-api-key",
        "PRE_PAYMENT_HOOK_URL": "https://your-policy-endpoint.example/hook"
      }
    }
  }
}

Yêu cầu hook (POST từ máy khách)

Đề xuất chỉ mô tả khoản thanh toán được đề xuất — nó không bao giờ bao gồm khóa API ví của bạn.

{
  "proposal_id": "f7e1…",
  "agent_id": 42,
  "protocol": "l402",
  "destination_or_url": "https://api.example/paid-endpoint",
  "amount_sats": null,
  "max_payment_sats": 1000,
  "method": "GET",
  "ts": "2026-06-06T18:00:00.000Z"
}

protocol là một trong l402, x402, bolt11, keysend, lnaddress. amount_sats là số tiền chính xác khi nó được biết tại thời điểm hook: đối với keysend và lnaddress thì đó là số tiền được yêu cầu, và đối với bolt11 thì nó được giải mã cục bộ từ hóa đơn (không cần gọi API thêm). Đối với l402/x402 thì nó là null vì số tiền được đặt bởi thử thách thanh toán tại thời điểm thực thi — ở đó hook thực thi max_payment_sats (mức trần được tác nhân ủy quyền) trước, và số tiền quyết toán chính xác có sẵn sau đó qua webhooks. max_payment_sats là mức trần được tác nhân ủy quyền khi áp dụng.

Chính xác những gì rời khỏi ví. Chỉ tám trường trên được gửi đến điểm cuối hook của bạn: proposal_id, agent_id, protocol, destination_or_url, amount_sats, max_payment_sats, method, ts. Khóa API ví và bất kỳ thông tin xác thực nào khác không bao giờ được bao gồm.

Phạm vi. Hook kiểm soát mọi chi tiêu do tác nhân khởi tạo: pay_l402_api, pay_invoice, keysend, pay_lightning_address, và Nostr zaps. Quản lý quỹ ở phạm vi người vận hành (rút tiền, cấp vốn cho tác nhân, chuyển tiền giữa các tác nhân) được cố ý không kiểm soát — đó là các hành động của người vận hành, không phải chi tiêu của tác nhân.

Phản hồi hook (điểm cuối của bạn trả về)

{ "decision": "allow" }

{ "decision": "deny", "reason": { "code": "over_limit", "message": "Exceeds per-transaction limit" } }

allow → khoản thanh toán được tiếp tục.
deny → khoản thanh toán bị hủy bỏ và công cụ trả về lỗi PolicyDenied hiển thị reason.message.
Một trường attestation tùy chọn (JSON bất kỳ) được máy khách coi là không trong suốt — nó được ghi vào stderr và bỏ qua nếu không, vì vậy một dịch vụ chính sách có thể trả về một quyết định đã ký để kiểm toán sau.

Khi hook gặp lỗi, hết thời gian chờ, hoặc phản hồi không được nhận dạng, PRE_PAYMENT_HOOK_FAIL_MODE được áp dụng (từ chối theo mặc định).

Giá cả

Lightning Faucet tính phí nền tảng 2% (tối thiểu 1 sat) trên các khoản thanh toán đi:

Thanh toán L402: phí nền tảng 2% + phí định tuyến Lightning
Thanh toán X402: phí nền tảng 2% + chênh lệch tỷ giá 1% (chuyển đổi USDC sang sats)
Thanh toán hóa đơn: phí nền tảng 2% + phí định tuyến Lightning
Thanh toán Keysend: phí nền tảng 2% + phí định tuyến Lightning
Rút tiền của người vận hành: phí nền tảng 2% + phí định tuyến Lightning
Chuyển tiền nội bộ giữa các người vận hành: phí nền tảng 2% (không có phí định tuyến)
Chuyển tiền giữa các tác nhân cùng người vận hành: Miễn phí
Nạp tiền: Miễn phí
Nhận thanh toán: Miễn phí
Webhooks: Miễn phí

Tất cả các phản hồi thanh toán đều bao gồm platform_fee_sats, routing_fee_sats, và total_cost để minh bạch hoàn toàn.

Nhật ký thay đổi

v1.1.0 (2026-02-16)

Giao diện CLI: Lệnh lw mới cho các tác nhân ưu tiên CLI (OpenClaw, Pi, KiloCode, bất kỳ tác nhân Bash nào)
Cùng gói, hai giao diện: npm install -g lightning-wallet-mcp cung cấp cho bạn cả máy chủ MCP và CLI
Đầu ra ưu tiên JSON: Tất cả các lệnh CLI xuất JSON ra stdout, lỗi ra stderr
Hỗ trợ X402: Tự động chuyển sang X402 (USDC trên Base) khi L402 không khả dụng
Tự động phát hiện giao thức: pay_l402_api phát hiện L402 hoặc X402 từ tiêu đề phản hồi 402
Trường phản hồi: payment_protocol và usdc_amount được bao gồm khi X402 được sử dụng
Tỷ giá: Chuyển đổi BTC/USD thời gian thực qua CoinGecko với bộ nhớ đệm 5 phút

v1.0.3 (2026-02-05)

Phí nền tảng: Phí 2% (tối thiểu 1 sat) trên tất cả các khoản thanh toán đi và chuyển tiền giữa các người vận hành
Minh bạch phí: Tất cả các phản hồi thanh toán giờ đây bao gồm platform_fee_sats, routing_fee_sats, và total_cost
Chuyển tiền giữa các tác nhân cùng người vận hành vẫn miễn phí

v1.0.0 (2026-02-04)

Đổi thương hiệu từ lightning-faucet-mcp thành lightning-wallet-mcp
Biến môi trường được đổi tên: LIGHTNING_FAUCET_API_KEY → LIGHTNING_WALLET_API_KEY
Tất cả 37 công cụ đã được kiểm tra đầy đủ và sẵn sàng cho sản xuất
Không có thay đổi API phá vỡ - chỉ là tên gói

Các bản phát hành trước (dưới tên lightning-faucet-mcp)

Xem nhật ký thay đổi lightning-faucet-mcp để biết lịch sử từ v1.6.0 đến v2.0.7.

Thanh toán cơ bản và hóa đơn

Trình diễn: Thí nghiệm Lý thuyết Trò chơi Tác nhân AI

Chúng tôi đã chạy một thí nghiệm kinh tế 100 vòng với 16 tác nhân AI (8 Claude, 8 GPT-4o) sử dụng Bitcoin thực trên Lightning. Các tác nhân có thể giao dịch, thành lập liên minh, đầu tư và cạnh tranh — tất cả được hỗ trợ bởi máy chủ MCP này.

Kết quả: Các tác nhân đã hoàn thành 2.839 giao dịch Lightning thực. Các tác nhân Claude thống trị thông qua giao dịch sớm tích cực trong khi các tác nhân GPT-4o áp dụng chiến lược bảo thủ.

Kho thí nghiệm: github.com/pfergi42/lf-game-theory
Bài blog: lightningfaucet.com/blog/ai-game-theory

Hỗ trợ

Tài liệu: lightningfaucet.com/ai-agents/docs
Demo: lightningfaucet.com/ai-agents/demo
Vấn đề: github.com/lightningfaucet/lightning-wallet-mcp/issues
Email: [email protected]

Giấy phép

Giấy phép MIT - xem LICENSE để biết chi tiết.

Được xây dựng bằng Bitcoin | Lightning Faucet