Lightning Faucet MCP Server

आधिकारिक

AI एजेंटों को Lightning Network भुगतान के साथ एक Bitcoin वॉलेट प्रदान करें

दस्तावेज़

लाइटनिंग वॉलेट

अपने AI एजेंट को एक Bitcoin वॉलेट दें। MCP सर्वर + CLI। Claude Code, OpenClaw, Cursor और किसी भी एजेंट फ्रेमवर्क के साथ काम करता है।

v1.4 में नया क्या है

update_operator टूल / lw set-email - MCP क्लाइंट या CLI से अपना ऑपरेटर ईमेल सेट करें; आपको एक सत्यापन लिंक ईमेल किया जाता है।
claim_promo टूल / lw claim-promo - सीधे अपने एजेंट से मुफ्त-sats इंस्टॉल प्रोमो का दावा करें। आवश्यकताएँ: सत्यापित ईमेल + ऑपरेटर खाता कम से कम 3 घंटे पुराना हो।
get_info पंजीकरण से पहले काम करता है - सेवा जानकारी के लिए अब API कुंजी की आवश्यकता नहीं है।

नए ऑपरेटरों के लिए मुफ्त 100 sats

lw register --email [email protected] (या ईमेल के साथ register_operator MCP टूल)
हमारे द्वारा ईमेल किए गए सत्यापन लिंक पर क्लिक करें
आपका खाता 3 घंटे पुराना होने के बाद: lw claim-promo (या claim_promo MCP टूल)

प्रति ऑपरेटर एक बोनस, केवल पहले 100 इंस्टॉल, कोई जमा आवश्यक नहीं।

v1.3 में नया क्या है

v1.3.0 - नवीनतम Lightning Labs स्पेक के अनुसार L402 प्रोटोकॉल v0 समर्थन।

L402 प्रोटोकॉल v0 - अद्यतन हेडर प्रारूप: version="0", token=, macaroon= के साथ पश्चगामी संगत
एंडपॉइंट खोज - lightningfaucet.com और certvera.com पर .well-known/l402.json
पश्चगामी संगत - किसी भी सेवा से पुराने और नए दोनों L402 हेडर प्रारूपों को संभालता है

v1.1 में नया क्या है

v1.1.0 - X402 प्रोटोकॉल समर्थन (Base पर USDC) L402 (Lightning) के साथ स्वचालित फ़ॉलबैक के रूप में।

X402 समर्थन - L402 उपलब्ध न होने पर Base पर स्वचालित USDC भुगतान
प्रोटोकॉल ऑटो-डिटेक्शन - pay_l402_api L402 और X402 दोनों को सहजता से संभालता है
वेबहुक्स - भुगतान और घटनाओं के लिए रीयल-टाइम सूचनाएं
Keysend - नोड pubkeys का उपयोग करके बिना इनवॉइस के भुगतान भेजें
इनवॉइस डिकोडिंग - भुगतान से पहले BOLT11 इनवॉइस को डिकोड करें
एजेंट एनालिटिक्स - खर्च पैटर्न और उपयोग को ट्रैक करें
लेन-देन निर्यात - JSON या CSV प्रारूप में इतिहास निर्यात करें
बजट प्रबंधन - विस्तृत बजट स्थिति प्राप्त करें और सीमाएं सेट करें
एजेंट जीवनचक्र - एजेंटों को निष्क्रिय करें, पुनः सक्रिय करें और हटाएं
खाता पुनर्प्राप्ति - खातों को पुनर्प्राप्त करें और API कुंजियों को घुमाएं
एजेंट-से-एजेंट स्थानांतरण - अपने एजेंटों के बीच धनराशि स्थानांतरित करें

Lightning Wallet MCP क्यों?

तत्काल भुगतान - Lightning Network लेन-देन मिलीसेकंड में निपटते हैं
L402 + X402 प्रोटोकॉल समर्थन - किसी भी सशुल्क API को स्वचालित रूप से एक्सेस करें (Lightning या USDC)
ऑपरेटर/एजेंट पदानुक्रम - खर्च सीमाओं के साथ कई एजेंट प्रबंधित करें
कोई कस्टडी जोखिम नहीं - प्रत्येक एजेंट के पास ऑपरेटर निगरानी के साथ पृथक धनराशि है
उत्पादन के लिए तैयार - वास्तविक लेन-देन को शक्ति प्रदान करने वाला युद्ध-परीक्षित बुनियादी ढांचा
वेबहुक सूचनाएं - भुगतान आने पर तुरंत सूचित हों
पूर्ण अवलोकन क्षमता - एनालिटिक्स, निर्यात और विस्तृत स्थिति ट्रैकिंग

उपयोग करने के दो तरीके

CLI (कोई भी एजेंट फ्रेमवर्क)

CLI-प्रथम एजेंटों के लिए (OpenClaw, Pi, KiloCode, या Bash एक्सेस वाला कोई भी एजेंट):

npm install -g lightning-wallet-mcp

यह 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

आउटपुट डिफ़ॉल्ट रूप से JSON है (jq पर पाइप करें)। पठनीय आउटपुट के लिए --human का उपयोग करें।

सभी कमांड के लिए lw help चलाएं।

MCP सर्वर (Claude Code, Cursor, Windsurf)

MCP-नेटिव क्लाइंट के लिए, MCP सर्वर के रूप में कॉन्फ़िगर करें:

विकल्प A: स्व-पंजीकरण

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

फिर Claude से पूछें: "एक नया Lightning Wallet ऑपरेटर खाता पंजीकृत करें"

विकल्प B: पूर्व-कॉन्फ़िगर API कुंजी

lightningfaucet.com/ai-agents पर API कुंजी प्राप्त करें
Claude Code कॉन्फ़िगर करें (~/.claude/settings.json):

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

टूल संदर्भ

सेवा जानकारी

टूल	विवरण
`get_info`	सेवा स्थिति, संस्करण और समर्थित सुविधाएं प्राप्त करें
`decode_invoice`	राशि, गंतव्य और समाप्ति देखने के लिए BOLT11 इनवॉइस डिकोड करें

संदर्भ और पहचान

टूल	विवरण
`whoami`	वर्तमान संदर्भ प्राप्त करें - दिखाता है कि ऑपरेटर या एजेंट के रूप में काम कर रहा है
`check_balance`	satoshis में वर्तमान Lightning शेष राशि जांचें
`get_rate_limits`	वर्तमान दर सीमा स्थिति और शेष अनुरोध जांचें

भुगतान (एजेंट कुंजी आवश्यक)

टूल	विवरण
`pay_l402_api`	सशुल्क API एक्सेस करें (L402/X402) - प्रोटोकॉल का ऑटो-पता लगाता है और भुगतान करता है
`pay_invoice`	कोई भी BOLT11 Lightning इनवॉइस भुगतान करें
`keysend`	सीधे नोड pubkey पर भुगतान भेजें (कोई इनवॉइस आवश्यक नहीं)
`pay_lightning_address`	Lightning पते पर भुगतान करें ([email protected] प्रारूप)
`create_invoice`	भुगतान प्राप्त करने के लिए इनवॉइस उत्पन्न करें
`get_invoice_status`	जांचें कि क्या इनवॉइस का भुगतान किया गया है
`get_transactions`	लेन-देन इतिहास देखें

LNURL (एजेंट कुंजी आवश्यक)

टूल	विवरण
`lnurl_auth`	LNURL-auth प्रोटोकॉल का उपयोग करके किसी सेवा में प्रमाणित करें
`claim_lnurl_withdraw`	LNURL-withdraw लिंक से धनराशि का दावा करें

ऑपरेटर प्रबंधन

टूल	विवरण
`register_operator`	नया ऑपरेटर खाता बनाएं
`recover_account`	पुनर्प्राप्ति कोड का उपयोग करके खाता पुनर्प्राप्त करें
`rotate_api_key`	नई API कुंजी उत्पन्न करें (निकासी पर 60-मिनट का कूलडाउन)
`get_deposit_invoice`	ऑपरेटर खाते को निधि देने के लिए इनवॉइस बनाएं
`withdraw`	बाहरी Lightning गंतव्य पर धनराशि निकालें
`set_operator_key`	ऑपरेटर क्रेडेंशियल पर स्विच करें

update_operator - ऑपरेटर ईमेल (सत्यापन लिंक भेजता है) और/या नाम सेट करें
claim_promo - मुफ्त-sats इंस्टॉल प्रोमो का दावा करें (सत्यापित ईमेल + 3 घंटे का खाता)

एजेंट प्रबंधन

टूल	विवरण
`create_agent`	ऑपरेटर के अंतर्गत एजेंट बनाएं
`list_agents`	ऑपरेटर के अंतर्गत सभी एजेंटों की सूची बनाएं
`fund_agent`	ऑपरेटर से एजेंट को sats स्थानांतरित करें
`transfer_to_agent`	एजेंटों के बीच या ऑपरेटर से एजेंट को sats स्थानांतरित करें
`sweep_agent`	एजेंट से ऑपरेटर को वापस धनराशि स्वीप करें
`deactivate_agent`	किसी एजेंट को अस्थायी रूप से अक्षम करें
`reactivate_agent`	निष्क्रिय एजेंट को पुनः सक्षम करें
`delete_agent`	किसी एजेंट को स्थायी रूप से हटाएं (शेष राशि ऑपरेटर को लौटाता है)
`get_budget_status`	एजेंट की बजट सीमा और खर्च प्राप्त करें
`set_budget`	एजेंट की खर्च सीमा सेट या अपडेट करें
`set_agent_credentials`	एजेंट क्रेडेंशियल पर स्विच करें

वेबहुक्स

टूल	विवरण
`register_webhook`	घटना सूचनाएं प्राप्त करने के लिए URL पंजीकृत करें
`list_webhooks`	सभी पंजीकृत वेबहुक्स की सूची बनाएं
`delete_webhook`	वेबहुक हटाएं
`test_webhook`	वेबहुक कनेक्टिविटी सत्यापित करने के लिए परीक्षण घटना भेजें

वेबहुक घटनाएं:

invoice_paid - इनवॉइस पर भुगतान प्राप्त हुआ
payment_completed - आउटगोइंग भुगतान सफल हुआ
payment_failed - आउटगोइंग भुगतान विफल हुआ
balance_low - शेष राशि सीमा से नीचे गिर गई
budget_warning - 80% बजट उपभोग किया गया
test - मैन्युअल परीक्षण घटना

CLI संदर्भ

सभी कमांड stdout पर JSON आउटपुट करते हैं। त्रुटियां निकास कोड 1 के साथ stderr पर जाती हैं।

कमांड	विवरण
`lw register [--name "name"]`	ऑपरेटर खाता बनाएं, API कुंजी प्रिंट करता है
`lw whoami`	वर्तमान पहचान (ऑपरेटर या एजेंट)
`lw balance`	satoshis में शेष राशि
`lw info`	सेवा स्थिति और क्षमताएं
`lw deposit <amount>`	जमा इनवॉइस उत्पन्न करें
`lw withdraw <invoice>`	बाहरी वॉलेट में निकासी करें
`lw pay <invoice>`	BOLT11 इनवॉइस `[--max-fee <sats>]` का भुगतान करें
`lw pay-api <url>`	L402/X402 API `[--method GET] [--body "{}"] [--max-sats 1000]` का भुगतान करें
`lw decode <invoice>`	BOLT11 इनवॉइस डिकोड करें
`lw create-agent <name>`	एजेंट `[--budget <sats>]` बनाएं
`lw fund-agent <id> <amount>`	एजेंट को sats स्थानांतरित करें
`lw list-agents`	सभी एजेंटों की सूची बनाएं
`lw transactions`	हाल के लेन-देन `[--limit 10] [--offset 0]`
`lw help`	सभी कमांड दिखाएं

एजेंट वर्कफ़्लो उदाहरण (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

सशुल्क API प्रोटोकॉल: L402 + X402

Lightning Wallet MCP दो HTTP 402 भुगतान प्रोटोकॉल का समर्थन करता है:

L402 (प्राथमिक) - Lightning Network भुगतान। मूल प्रति-अनुरोध भुगतान प्रोटोकॉल।
X402 (फ़ॉलबैक) - Base पर USDC (Coinbase का प्रोटोकॉल)। L402 उपलब्ध न होने पर ऑटो-डिटेक्ट किया जाता है।

जब आप pay_l402_api कॉल करते हैं, तो सर्वर स्वचालित रूप से पता लगाता है कि API किस प्रोटोकॉल का उपयोग करता है। यदि दोनों हेडर मौजूद हैं तो L402 हमेशा प्राथमिकता लेता है। एजेंट हमेशा प्रोटोकॉल की परवाह किए बिना sats में भुगतान करते हैं — X402 राशियाँ बाजार दर पर परिवर्तित की जाती हैं।

L402 प्रोटोकॉल

L402 प्रोटोकॉल (पूर्व में LSAT) API को Lightning का उपयोग करके प्रति-अनुरोध शुल्क लेने में सक्षम बनाता है। जब आप L402-संरक्षित एंडपॉइंट कॉल करते हैं:

सर्वर Lightning इनवॉइस के साथ HTTP 402 लौटाता है
Lightning Faucet स्वचालित रूप से इनवॉइस का भुगतान करता है
अनुरोध भुगतान की गई सामग्री के साथ पूरा होता है

X402 प्रोटोकॉल (Coinbase)

X402 API भुगतान के लिए Base पर USDC का उपयोग करता है। प्रवाह एजेंटों के लिए पारदर्शी है:

सर्वर PAYMENT-REQUIRED हेडर के साथ HTTP 402 लौटाता है
Lightning Faucet USDC राशि को sats में परिवर्तित करता है, एजेंट शेष राशि डेबिट करता है
EIP-712 प्राधिकरण पर हस्ताक्षर करता है और PAYMENT-SIGNATURE हेडर के साथ पुनः प्रयास करता है
अनुरोध पूरा होता है — एजेंट L402 जैसा ही प्रतिक्रिया प्रारूप देखता है

प्रतिक्रिया में payment_protocol: "x402" और usdc_amount शामिल हैं ताकि एजेंट जान सकें कि कौन सा प्रोटोकॉल उपयोग किया गया था।

L402 API रजिस्ट्री

हम lightningfaucet.com/l402-registry पर L402-सक्षम API की एक निर्देशिका बनाए रखते हैं - आपके एजेंटों के परीक्षण के लिए एकदम सही।

डेमो L402 API

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" })

अधिक एंडपॉइंट और संसाधनों के लिए L402 API रजिस्ट्री देखें।

पूर्ण वर्कफ़्लो उदाहरण

// 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" })

Keysend भुगतान

बिना इनवॉइस की आवश्यकता के सीधे Lightning नोड पर भुगतान भेजें:

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

इनवॉइस डिकोडिंग

भुगतान से पहले इनवॉइस विवरण जांचें:

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

टूल विवरण

get_info

सेवा स्थिति और क्षमताएं प्राप्त करें।

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

वर्तमान संचालन संदर्भ प्राप्त करें।

ऑपरेटर के लिए लौटाता है:

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

एजेंट के लिए लौटाता है:

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

pay_l402_api

स्वचालित भुगतान के साथ सशुल्क API एक्सेस करें। L402 (Lightning) और X402 (Base पर USDC) दोनों प्रोटोकॉल का समर्थन करता है। 402 प्रतिक्रिया हेडर से प्रोटोकॉल का ऑटो-पता लगाया जाता है।

पैरामीटर	प्रकार	आवश्यक	विवरण
url	string	हाँ	अनुरोध करने के लिए URL
method	string	नहीं	HTTP विधि (GET, POST, PUT, DELETE)। डिफ़ॉल्ट: GET
body	string	नहीं	POST/PUT के लिए अनुरोध बॉडी
max_payment_sats	number	नहीं	अधिकतम भुगतान राशि। डिफ़ॉल्ट: 1000

keysend

बिना इनवॉइस के नोड पर भुगतान भेजें।

पैरामीटर	प्रकार	आवश्यक	विवरण
destination	string	हाँ	लक्ष्य नोड सार्वजनिक कुंजी (66 हेक्स वर्ण)
amount_sats	number	हाँ	satoshis में राशि
message	string	नहीं	वैकल्पिक संदेश (अधिकतम 1000 वर्ण)

register_webhook

भुगतान सूचनाएं प्राप्त करने के लिए URL पंजीकृत करें।

पैरामीटर	प्रकार	आवश्यक	विवरण
url	string	हाँ	वेबहुक प्राप्त करने के लिए HTTPS URL
events	array	नहीं	सब्सक्राइब करने के लिए घटना प्रकार। डिफ़ॉल्ट: ["invoice_paid"]

लौटाता है: हस्ताक्षर सत्यापन के लिए वेबहुक ID और HMAC गुप्त।

आर्किटेक्चर

┌─────────────────────────────────────────────────────────┐
│                    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            │
└─────────────────────────────────────────────────────────┘

सुरक्षा सर्वोत्तम अभ्यास

API कुंजियाँ कभी कमिट न करें - पर्यावरण चर का उपयोग करें
बजट सीमाएं सेट करें - अनियंत्रित खर्च से बचाएं
भुगतान के लिए एजेंट कुंजियों का उपयोग करें - ऑपरेटर कुंजी सुरक्षित रखें
वेबहुक हस्ताक्षर सत्यापित करें - पंजीकरण के दौरान लौटाए गए गुप्त का उपयोग करें
लेन-देन की निगरानी करें - गतिविधि की समीक्षा के लिए get_transactions का उपयोग करें
पुनर्प्राप्ति कोड - सुरक्षित रूप से संग्रहीत करें, API कुंजी खो जाने पर आवश्यक
कुंजी रोटेशन - rotate_api_key का उपयोग करके समय-समय पर कुंजियाँ घुमाएं

वेबहुक सुरक्षा

वेबहुक में सत्यापन के लिए HMAC-SHA256 हस्ताक्षर शामिल हैं:

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)

पेलोड के विरुद्ध X-Webhook-Signature हेडर की जांच करें।

पूर्व-भुगतान नीति हुक

एक वैकल्पिक, विक्रेता-तटस्थ हुक किसी बाहरी नीति एंडपॉइंट को भुगतान निष्पादित होने से पहले उसे अनुमति या अस्वीकार करने देता है। यह डिफ़ॉल्ट रूप से बंद है — जब PRE_PAYMENT_HOOK_URL सेट नहीं है, व्यवहार बिल्कुल पहले जैसा ही है। जब सेट हो, तो हर आउटगोइंग भुगतान (pay_l402_api, pay_invoice, keysend, pay_lightning_address) पहले आपके एंडपॉइंट के विरुद्ध जाँचा जाता है; अस्वीकृति किसी भी धनराशि के स्थानांतरण से पहले भुगतान को रोक देती है।

यह खर्च नीतियों, अनुमोदन कार्यप्रवाह, अनुपालन जाँच, या किसी बाहरी प्राधिकरण परत के लिए उपयोगी है। हुक प्रोटोकॉल सामान्य है, इसलिए नीचे दिए गए अनुरोध/प्रतिक्रिया अनुबंध को लागू करने वाली कोई भी सेवा केवल कॉन्फ़िगरेशन द्वारा जोड़ी जा सकती है।

कॉन्फ़िगरेशन

एन्व वर	डिफ़ॉल्ट	विवरण
`PRE_PAYMENT_HOOK_URL`	(सेट नहीं)	प्रत्येक भुगतान प्रस्ताव को POST करने के लिए नीति एंडपॉइंट। सेट न होने पर हुक पूरी तरह अक्षम हो जाता है।
`PRE_PAYMENT_HOOK_TIMEOUT_MS`	`3000`	प्रति-अनुरोध टाइमआउट मिलीसेकंड में।
`PRE_PAYMENT_HOOK_FAIL_MODE`	`closed`	`closed` हुक में त्रुटि या टाइमआउट होने पर भुगतान अस्वीकार करता है; `open` इसे आगे बढ़ने देता है। डिफ़ॉल्ट फेल-क्लोज्ड है।

{
  "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"
      }
    }
  }
}

हुक अनुरोध (क्लाइंट से POST)

प्रस्ताव केवल प्रस्तावित भुगतान का वर्णन करता है — इसमें आपकी वॉलेट API कुंजी कभी शामिल नहीं होती।

{
  "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 l402, x402, bolt11, keysend, lnaddress में से एक है। amount_sats सटीक राशि है जब यह हुक समय पर ज्ञात हो: keysend और lnaddress के लिए यह अनुरोधित राशि है, और bolt11 के लिए इसे इनवॉइस से स्थानीय रूप से डिकोड किया जाता है (कोई अतिरिक्त API कॉल नहीं)। l402/x402 के लिए यह null है क्योंकि राशि निष्पादन समय पर भुगतान चुनौती द्वारा निर्धारित होती है — यहाँ हुक पहले से max_payment_sats (एजेंट-अधिकृत सीमा) लागू करता है, और सटीक निपटान राशि बाद में वेबहुक्स के माध्यम से उपलब्ध होती है। max_payment_sats एजेंट-अधिकृत सीमा है जब लागू हो।

बिल्कुल वही जो वॉलेट छोड़ता है। केवल ऊपर के आठ फ़ील्ड आपके हुक एंडपॉइंट पर भेजे जाते हैं: proposal_id, agent_id, protocol, destination_or_url, amount_sats, max_payment_sats, method, ts। वॉलेट API कुंजी और कोई अन्य क्रेडेंशियल कभी शामिल नहीं किए जाते।

कवरेज। हुक हर एजेंट-आरंभित खर्च को नियंत्रित करता है: pay_l402_api, pay_invoice, keysend, pay_lightning_address, और Nostr जैप्स। ऑपरेटर-स्कोप्ड फंड प्रबंधन (निकासी, एजेंट फंडिंग, एजेंट-से-एजेंट स्थानांतरण) जानबूझकर नियंत्रित नहीं है — वे ऑपरेटर क्रियाएँ हैं, एजेंट खर्च नहीं।

हुक प्रतिक्रिया (आपका एंडपॉइंट लौटाता है)

{ "decision": "allow" }

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

allow → भुगतान आगे बढ़ता है।
deny → भुगतान निरस्त होता है और उपकरण reason.message को दर्शाने वाली PolicyDenied त्रुटि लौटाता है।
एक वैकल्पिक attestation फ़ील्ड (कोई भी JSON) क्लाइंट द्वारा अपारदर्शी माना जाता है — इसे stderr पर लॉग किया जाता है और अन्यथा अनदेखा किया जाता है, ताकि एक नीति सेवा डाउनस्ट्रीम ऑडिटिंग के लिए हस्ताक्षरित निर्णय लौटा सके।

हुक त्रुटि, टाइमआउट, या अपरिचित प्रतिक्रिया पर, PRE_PAYMENT_HOOK_FAIL_MODE लागू होता है (डिफ़ॉल्ट रूप से अस्वीकार)।

मूल्य निर्धारण

Lightning Faucet आउटगोइंग भुगतानों पर 2% प्लेटफ़ॉर्म शुल्क (न्यूनतम 1 सैट) लेता है:

L402 भुगतान: 2% प्लेटफ़ॉर्म शुल्क + लाइटनिंग रूटिंग शुल्क
X402 भुगतान: 2% प्लेटफ़ॉर्म शुल्क + 1% विनिमय दर स्प्रेड (USDC से सैट्स रूपांतरण)
इनवॉइस भुगतान: 2% प्लेटफ़ॉर्म शुल्क + लाइटनिंग रूटिंग शुल्क
कीसेंड भुगतान: 2% प्लेटफ़ॉर्म शुल्क + लाइटनिंग रूटिंग शुल्क
ऑपरेटर निकासी: 2% प्लेटफ़ॉर्म शुल्क + लाइटनिंग रूटिंग शुल्क
क्रॉस-ऑपरेटर आंतरिक स्थानांतरण: 2% प्लेटफ़ॉर्म शुल्क (कोई रूटिंग शुल्क नहीं)
समान-ऑपरेटर एजेंट स्थानांतरण: मुफ़्त
जमा: मुफ़्त
भुगतान प्राप्त करना: मुफ़्त
वेबहुक्स: मुफ़्त

सभी भुगतान प्रतिक्रियाओं में पूर्ण पारदर्शिता के लिए platform_fee_sats, routing_fee_sats, और total_cost शामिल हैं।

बदलाव लॉग

v1.1.0 (2026-02-16)

CLI इंटरफ़ेस: CLI-प्रथम एजेंटों (OpenClaw, Pi, KiloCode, कोई भी Bash एजेंट) के लिए नया lw कमांड
समान पैकेज, दो इंटरफ़ेस: npm install -g lightning-wallet-mcp आपको MCP सर्वर और CLI दोनों देता है
JSON-प्रथम आउटपुट: सभी CLI कमांड stdout पर JSON आउटपुट करते हैं, stderr पर त्रुटियाँ
X402 समर्थन: जब L402 उपलब्ध न हो तो X402 (Base पर USDC) पर स्वचालित फ़ॉलबैक
प्रोटोकॉल ऑटो-डिटेक्शन: pay_l402_api 402 प्रतिक्रिया हेडर से L402 या X402 का पता लगाता है
प्रतिक्रिया फ़ील्ड: X402 उपयोग होने पर payment_protocol और usdc_amount शामिल
विनिमय दर: CoinGecko के माध्यम से 5-मिनट कैश के साथ रीयल-टाइम BTC/USD रूपांतरण

v1.0.3 (2026-02-05)

प्लेटफ़ॉर्म शुल्क: सभी आउटगोइंग भुगतानों और क्रॉस-ऑपरेटर स्थानांतरणों पर 2% शुल्क (न्यूनतम 1 सैट)
शुल्क पारदर्शिता: सभी भुगतान प्रतिक्रियाओं में अब platform_fee_sats, routing_fee_sats, और total_cost शामिल हैं
समान-ऑपरेटर एजेंट स्थानांतरण मुफ़्त रहते हैं

v1.0.0 (2026-02-04)

lightning-faucet-mcp से lightning-wallet-mcp में रीब्रांडेड
पर्यावरण चर का नाम बदला गया: LIGHTNING_FAUCET_API_KEY → LIGHTNING_WALLET_API_KEY
सभी 37 उपकरण पूरी तरह परीक्षित और उत्पादन-तैयार
कोई ब्रेकिंग API परिवर्तन नहीं - केवल पैकेज का नाम

पिछले रिलीज़ (lightning-faucet-mcp के रूप में)

v1.6.0 से v2.0.7 इतिहास के लिए lightning-faucet-mcp बदलाव लॉग देखें।

बुनियादी भुगतान और इनवॉइस

प्रदर्शन: AI एजेंट गेम थ्योरी प्रयोग

हमने लाइटनिंग पर वास्तविक Bitcoin का उपयोग करके 16 AI एजेंटों (8 Claude, 8 GPT-4o) के साथ 100-राउंड का आर्थिक प्रयोग चलाया। एजेंट व्यापार कर सकते थे, गठबंधन बना सकते थे, निवेश कर सकते थे, और प्रतिस्पर्धा कर सकते थे — सभी इस MCP सर्वर द्वारा संचालित।

परिणाम: एजेंटों ने 2,839 वास्तविक लाइटनिंग लेन-देन पूरे किए। Claude एजेंटों ने आक्रामक प्रारंभिक व्यापार के माध्यम से प्रभुत्व स्थापित किया जबकि GPT-4o एजेंटों ने रूढ़िवादी रणनीतियाँ अपनाईं।

प्रयोग रेपो: github.com/pfergi42/lf-game-theory
ब्लॉग पोस्ट: lightningfaucet.com/blog/ai-game-theory

समर्थन

दस्तावेज़ीकरण: lightningfaucet.com/ai-agents/docs
डेमो: lightningfaucet.com/ai-agents/demo
मुद्दे: github.com/lightningfaucet/lightning-wallet-mcp/issues
ईमेल: [email protected]

लाइसेंस

MIT लाइसेंस - विवरण के लिए LICENSE देखें।

Bitcoin के साथ निर्मित | Lightning Faucet