Lightning Faucet MCP

Lightning Cüzdan

Yapay zeka ajanınıza bir Bitcoin cüzdanı verin. MCP sunucusu + CLI. Claude Code, OpenClaw, Cursor ve herhangi bir ajan çerçevesiyle çalışır.

v1.4'teki Yenilikler

• update_operator aracı / lw set-email - operatör e-postanızı MCP istemcisinden veya CLI'dan ayarlayın; size bir doğrulama bağlantısı e-posta ile gönderilir.
• claim_promo aracı / lw claim-promo - ücretsiz satoshi kurulum promosyonunu doğrudan ajanınızdan talep edin. Gereksinimler: doğrulanmış e-posta + en az 3 saatlik operatör hesabı.
• get_info kayıttan önce çalışır - servis bilgisi artık bir API anahtarı gerektirmez.

Yeni operatörler için ücretsiz 100 satoshi

1. lw register --email [email protected] (veya bir e-posta ile register_operator MCP aracı)
2. Size e-posta ile gönderdiğimiz doğrulama bağlantısına tıklayın
3. Hesabınız 3 saatlik olduktan sonra: lw claim-promo (veya claim_promo MCP aracı)

Operatör başına bir bonus, yalnızca ilk 100 kurulum, depozito gerekmez.

v1.3'teki Yenilikler

v1.3.0 - En son Lightning Labs spesifikasyonuna göre L402 protokolü v0 desteği.

• L402 Protokolü v0 - Güncellenmiş başlık formatı: version="0", token=, macaroon= ile geriye dönük uyumlu
• Uç Nokta Keşfi - lightningfaucet.com ve certvera.com'da .well-known/l402.json
• Geriye Dönük Uyumlu - Herhangi bir servisten gelen eski ve yeni L402 başlık formatlarını işler

v1.1'deki Yenilikler

v1.1.0 - L402 (Lightning) ile birlikte otomatik yedek olarak X402 protokolü desteği (Base'de USDC).

• X402 Desteği - L402 mevcut olmadığında Base'de otomatik USDC ödemeleri
• Protokol Otomatik Algılama - pay_l402_api hem L402 hem de X402'yi sorunsuzca işler
• Webhook'lar - Ödemeler ve olaylar için gerçek zamanlı bildirimler
• Keysend - Düğüm açık anahtarlarını kullanarak fatura olmadan ödeme gönderme
• Fatura Çözme - Ödemeden önce BOLT11 faturalarını çözme
• Ajan Analitiği - Harcama modellerini ve kullanımı takip etme
• İşlem Dışa Aktarma - Geçmişi JSON veya CSV formatında dışa aktarma
• Bütçe Yönetimi - Detaylı bütçe durumu alma ve limit belirleme
• Ajan Yaşam Döngüsü - Ajanları devre dışı bırakma, yeniden etkinleştirme ve silme
• Hesap Kurtarma - Hesapları kurtarma ve API anahtarlarını döndürme
• Ajandan Ajana Transferler - Ajanlarınız arasında fon taşıma

Neden Lightning Wallet MCP?

• Anında Ödemeler - Lightning Network işlemleri milisaniyeler içinde sonuçlanır
• L402 + X402 Protokol Desteği - Herhangi bir ücretli API'ye otomatik olarak erişin (Lightning veya USDC)
• Operatör/Ajan Hiyerarşisi - Harcama limitleriyle birden fazla ajanı yönetin
• Emanet Riski Yok - Her ajan, operatör gözetimiyle izole fonlara sahiptir
• Üretime Hazır - Gerçek işlemleri yürüten, savaşta test edilmiş altyapı
• Webhook Bildirimleri - Ödemeler geldiğinde anında haberdar olun
• Tam Gözlemlenebilirlik - Analitikler, dışa aktarmalar ve detaylı durum takibi

İki Kullanım Yolu

CLI (Herhangi Bir Ajan Çerçevesi)

CLI öncelikli ajanlar için (OpenClaw, Pi, KiloCode veya Bash erişimi olan herhangi bir ajan):

npm install -g lightning-wallet-mcp

Bu, lw komutunu yükler:

# 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

Çıktı varsayılan olarak JSON'dur (jq'a yönlendirin). Okunabilir çıktı için --human kullanın.

Tüm komutlar için lw help çalıştırın.

MCP Sunucusu (Claude Code, Cursor, Windsurf)

MCP yerel istemcileri için, bir MCP sunucusu olarak yapılandırın:

Seçenek A: Kendi Kendine Kayıt

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

Ardından Claude'a sorun: "Yeni bir Lightning Wallet operatör hesabı kaydet"

Seçenek B: Önceden Yapılandırılmış API Anahtarı

1. lightningfaucet.com/ai-agents adresinden bir API anahtarı alın
2. Claude Code'u yapılandırın (~/.claude/settings.json):

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

Araç Referansı

Servis Bilgisi

Araç	Açıklama
get_info	Servis durumunu, sürümünü ve desteklenen özellikleri alın
decode_invoice	Miktarı, hedefi ve son kullanma süresini görmek için bir BOLT11 faturasını çözün

Bağlam ve Kimlik

Araç	Açıklama
whoami	Mevcut bağlamı alın - operatör veya ajan olarak çalışıp çalışmadığını gösterir
check_balance	Satoshi cinsinden mevcut Lightning bakiyesini kontrol edin
get_rate_limits	Mevcut hız limiti durumunu ve kalan istekleri kontrol edin

Ödemeler (Ajan Anahtarı Gerekli)

Araç	Açıklama
pay_l402_api	Ücretli API'lere erişin (L402/X402) - protokolü otomatik algılar ve öder
pay_invoice	Herhangi bir BOLT11 Lightning faturasını ödeyin
keysend	Doğrudan bir düğüm açık anahtarına ödeme gönderin (fatura gerekmez)
pay_lightning_address	Bir Lightning adresine ödeme yapın ([email protected] formatı)
create_invoice	Ödeme almak için fatura oluşturun
get_invoice_status	Bir faturanın ödenip ödenmediğini kontrol edin
get_transactions	İşlem geçmişini görüntüleyin

LNURL (Ajan Anahtarı Gerekli)

Araç	Açıklama
lnurl_auth	LNURL-auth protokolünü kullanarak bir servise kimlik doğrulaması yapın
claim_lnurl_withdraw	Bir LNURL-withdraw bağlantısından fon talep edin

Operatör Yönetimi

Araç	Açıklama
register_operator	Yeni operatör hesabı oluşturun
recover_account	Kurtarma kodu kullanarak hesabı kurtarın
rotate_api_key	Yeni bir API anahtarı oluşturun (para çekme işlemlerinde 60 dakikalık bekleme süresi)
get_deposit_invoice	Operatör hesabına fon yüklemek için fatura oluşturun
withdraw	Harici bir Lightning hedefine fon çekin
set_operator_key	Operatör kimlik bilgilerine geçin

• update_operator - operatör e-postasını ayarlayın (doğrulama bağlantısı gönderir) ve/veya adını
• claim_promo - ücretsiz satoshi kurulum promosyonunu talep edin (doğrulanmış e-posta + 3 saatlik hesap)

Ajan Yönetimi

Araç	Açıklama
create_agent	Operatör altında ajan oluşturun
list_agents	Operatör altındaki tüm ajanları listeleyin
fund_agent	Operatörden ajana satoshi transfer edin
transfer_to_agent	Ajanlar arasında veya operatörden ajana satoshi transfer edin
sweep_agent	Ajandaki fonları operatöre geri çekin
deactivate_agent	Bir ajanı geçici olarak devre dışı bırakın
reactivate_agent	Devre dışı bırakılmış bir ajanı yeniden etkinleştirin
delete_agent	Bir ajanı kalıcı olarak silin (bakiyeyi operatöre iade eder)
get_budget_status	Ajanın bütçe limitini ve harcamasını alın
set_budget	Ajanın harcama limitini ayarlayın veya güncelleyin
set_agent_credentials	Ajan kimlik bilgilerine geçin

Webhook'lar

Araç	Açıklama
register_webhook	Olay bildirimleri almak için bir URL kaydedin
list_webhooks	Kayıtlı tüm webhook'ları listeleyin
delete_webhook	Bir webhook'u silin
test_webhook	Webhook bağlantısını doğrulamak için bir test olayı gönderin

Webhook Olayları:

• invoice_paid - Bir faturada ödeme alındı
• payment_completed - Giden ödeme başarılı oldu
• payment_failed - Giden ödeme başarısız oldu
• balance_low - Bakiye eşiğin altına düştü
• budget_warning - Bütçenin %80'i tüketildi
• test - Manuel test olayı

CLI Referansı

Tüm komutlar stdout'a JSON çıktısı verir. Hatalar, çıkış kodu 1 ile stderr'e gider.

Komut	Açıklama
lw register [--name "name"]	Operatör hesabı oluşturur, API anahtarını yazdırır
lw whoami	Mevcut kimlik (operatör veya ajan)
lw balance	Satoshi cinsinden bakiye
lw info	Servis durumu ve yetenekleri
lw deposit <amount>	Para yatırma faturası oluşturur
lw withdraw <invoice>	Harici cüzdana para çeker
lw pay <invoice>	BOLT11 faturası öder [--max-fee <sats>]
lw pay-api <url>	L402/X402 API'sine ödeme yapar [--method GET] [--body "{}"] [--max-sats 1000]
lw decode <invoice>	BOLT11 faturasını çözer
lw create-agent <name>	Ajan oluşturur [--budget <sats>]
lw fund-agent <id> <amount>	Ajana satoshi transfer eder
lw list-agents	Tüm ajanları listeler
lw transactions	Son işlemler [--limit 10] [--offset 0]
lw help	Tüm komutları gösterir

Ajan İş Akışı Örneği (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

Ücretli API Protokolleri: L402 + X402

Lightning Wallet MCP iki HTTP 402 ödeme protokolünü destekler:

• L402 (birincil) - Lightning Network ödemeleri. Orijinal istek başına ödeme protokolü.
• X402 (yedek) - Base'de USDC (Coinbase'in protokolü). L402 mevcut olmadığında otomatik algılanır.

pay_l402_api'i çağırdığınızda, sunucu API'nin hangi protokolü kullandığını otomatik olarak algılar. Her iki başlık da mevcutsa L402 her zaman önceliklidir. Ajanlar, protokolden bağımsız olarak her zaman satoshi cinsinden ödeme yapar — X402 tutarları piyasa kurundan dönüştürülür.

L402 Protokolü

L402 protokolü (eski adıyla LSAT), API'lerin Lightning kullanarak istek başına ücretlendirme yapmasını sağlar. L402 korumalı bir uç noktayı çağırdığınızda:

1. Sunucu, bir Lightning faturası ile HTTP 402 döndürür
2. Lightning Faucet faturayı otomatik olarak öder
3. İstek, ödenen içerikle tamamlanır

X402 Protokolü (Coinbase)

X402, API ödemeleri için Base'de USDC kullanır. Akış ajanlar için şeffaftır:

1. Sunucu, PAYMENT-REQUIRED başlığı ile HTTP 402 döndürür
2. Lightning Faucet, USDC miktarını satoshi'ye dönüştürür, ajan bakiyesinden düşer
3. Bir EIP-712 yetkilendirmesi imzalar ve PAYMENT-SIGNATURE başlığı ile yeniden dener
4. İstek tamamlanır — ajan, L402 ile aynı yanıt formatını görür

Yanıt, ajanların hangi protokolün kullanıldığını bilmesi için payment_protocol: "x402" ve usdc_amount içerir.

L402 API Kaydı

Ajanlarınızı test etmek için mükemmel olan lightningfaucet.com/l402-registry adresinde L402 etkin API'lerin bir dizinini tutuyoruz.

Demo L402 API'leri

L402 ödemelerini test etmek için bu uç noktaları deneyin:

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

Daha fazla uç nokta ve kaynak için L402 API Kaydı'na bakın.

Tam İş Akışı Örneği

// 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 Ödemeleri

Faturaya ihtiyaç duymadan doğrudan bir Lightning düğümüne ödeme gönderin:

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

Fatura Çözme

Ödemeden önce fatura ayrıntılarını kontrol edin:

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

Araç Detayları

get_info

Servis durumunu ve yeteneklerini alın.

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

Mevcut çalışma bağlamını alın.

Operatör için Döndürür:

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

Ajan için Döndürür:

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

pay_l402_api

Otomatik ödeme ile ücretli API'lere erişin. Hem L402 (Lightning) hem de X402 (Base'de USDC) protokollerini destekler. Protokol, 402 yanıt başlıklarından otomatik olarak algılanır.

Parametre	Tür	Gerekli	Açıklama
url	string	Evet	İstek yapılacak URL
method	string	Hayır	HTTP metodu (GET, POST, PUT, DELETE). Varsayılan: GET
body	string	Hayır	POST/PUT için istek gövdesi
max_payment_sats	number	Hayır	Maksimum ödeme miktarı. Varsayılan: 1000

keysend

Fatura olmadan bir düğüme ödeme gönderin.

Parametre	Tür	Gerekli	Açıklama
destination	string	Evet	Hedef düğüm açık anahtarı (66 hex karakter)
amount_sats	number	Evet	Satoshi cinsinden miktar
message	string	Hayır	İsteğe bağlı mesaj (maks. 1000 karakter)

register_webhook

Ödeme bildirimleri almak için bir URL kaydedin.

Parametre	Tür	Gerekli	Açıklama
url	string	Evet	Webhook'ları alacak HTTPS URL'si
events	array	Hayır	Abone olunacak olay türleri. Varsayılan: ["invoice_paid"]

Döndürür: İmza doğrulaması için Webhook kimliği ve HMAC sırrı.

Mimari

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

Güvenlik En İyi Uygulamaları

• API anahtarlarını asla commit etmeyin - Ortam değişkenlerini kullanın
• Bütçe limitleri belirleyin - Kontrolsüz harcamaya karşı koruyun
• Ödemeler için ajan anahtarlarını kullanın - Operatör anahtarını güvende tutun
• Webhook imzalarını doğrulayın - Kayıt sırasında döndürülen sırrı kullanın
• İşlemleri izleyin - Aktiviteyi gözden geçirmek için get_transactions kullanın
• Kurtarma kodları - Güvenli bir şekilde saklayın, API anahtarı kaybolursa gereklidir
• Anahtar döndürme - rotate_api_key kullanarak anahtarları periyodik olarak döndürün

Webhook Güvenliği

Webhook'lar, doğrulama için HMAC-SHA256 imzaları içerir:

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)

Yüke karşı X-Webhook-Signature başlığını kontrol edin.

Ön Ödeme Politikası Kancası

İsteğe bağlı, satıcıdan bağımsız bir kanca, harici bir politika uç noktasının bir ödeme yürütülmeden önce buna izin vermesini veya reddetmesini sağlar. Varsayılan olarak kapalıdır — PRE_PAYMENT_HOOK_URL ayarlanmadığında, davranış tamamen eskisi gibidir. Ayarlandığında, her giden ödeme (pay_l402_api, pay_invoice, keysend, pay_lightning_address) önce sizin uç noktanıza karşı kontrol edilir; bir ret, herhangi bir fon hareket etmeden önce ödemeyi iptal eder.

Bu, harcama politikaları, onay iş akışları, uyumluluk kontrolleri veya herhangi bir harici yetkilendirme katmanı için kullanışlıdır. Kanca protokolü geneldir, bu nedenle aşağıdaki istek/yanıt sözleşmesini uygulayan herhangi bir hizmet, yalnızca yapılandırma ile bağlanabilir.

Yapılandırma

Ortam değişkeni	Varsayılan	Açıklama
PRE_PAYMENT_HOOK_URL	(ayarlanmamış)	Her ödeme teklifinin POST edileceği politika uç noktası. Ayarlanmaması kancayı tamamen devre dışı bırakır.
PRE_PAYMENT_HOOK_TIMEOUT_MS	3000	İstek başına milisaniye cinsinden zaman aşımı.
PRE_PAYMENT_HOOK_FAIL_MODE	closed	closed kanca hata verir veya zaman aşımına uğrarsa ödemeyi reddeder; open devam etmesine izin verir. Varsayılan kapalıyken-başarısız olur.

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

Kanca isteği (istemciden POST)

Teklif yalnızca önerilen ödemeyi tanımlar — cüzdan API anahtarınızı asla içermez.

{
  "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 şunlardan biridir: l402, x402, bolt11, keysend, lnaddress. amount_sats kanca zamanında bilindiğinde tam miktardır: keysend ve lnaddress için talep edilen miktardır ve bolt11 için faturadan yerel olarak çözülür (ek API çağrısı yok). l402/x402 için null olur çünkü miktar yürütme zamanında ödeme zorluğu tarafından belirlenir — burada kanca max_payment_sats (ajan tarafından yetkilendirilmiş tavan) değerini önceden uygular ve kesinleşen miktar daha sonra web kancaları aracılığıyla kullanılabilir. max_payment_sats geçerli olduğunda ajan tarafından yetkilendirilmiş tavandır.

Cüzdandan tam olarak ne çıkar. Kanca uç noktanıza yalnızca yukarıdaki sekiz alan gönderilir: proposal_id, agent_id, protocol, destination_or_url, amount_sats, max_payment_sats, method, ts. Cüzdan API anahtarı ve diğer kimlik bilgileri asla dahil edilmez.

Kapsam. Kanca, ajan tarafından başlatılan her harcamayı denetler: pay_l402_api, pay_invoice, keysend, pay_lightning_address ve Nostr zap'leri. Operatör kapsamlı fon yönetimi (çekimler, ajan fonlaması, ajanlar arası transferler) kasıtlı olarak denetlenmez — bunlar ajan harcamaları değil, operatör eylemleridir.

Kanca yanıtı (uç noktanız döndürür)

{ "decision": "allow" }

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

• allow → ödeme devam eder.
• deny → ödeme iptal edilir ve araç reason.message değerini yüzeye çıkaran bir PolicyDenied hatası döndürür.
• İsteğe bağlı bir attestation alanı (herhangi bir JSON) istemci tarafından opak olarak ele alınır — stderr'e kaydedilir ve aksi takdirde yok sayılır, böylece bir politika hizmeti aşağı akış denetimi için imzalı bir karar döndürebilir.

Bir kanca hatası, zaman aşımı veya tanınmayan yanıt durumunda, PRE_PAYMENT_HOOK_FAIL_MODE uygulanır (varsayılan olarak reddet).

Fiyatlandırma

Lightning Faucet giden ödemelerde %2 platform ücreti (min 1 sat) alır:

• L402 ödemeleri: %2 platform ücreti + Lightning yönlendirme ücreti
• X402 ödemeleri: %2 platform ücreti + %1 döviz kuru farkı (USDC'den sat'a dönüşüm)
• Fatura ödemeleri: %2 platform ücreti + Lightning yönlendirme ücreti
• Keysend ödemeleri: %2 platform ücreti + Lightning yönlendirme ücreti
• Operatör çekimleri: %2 platform ücreti + Lightning yönlendirme ücreti
• Operatörler arası dahili transferler: %2 platform ücreti (yönlendirme ücreti yok)
• Aynı operatör ajan transferleri: Ücretsiz
• Para yatırma: Ücretsiz
• Ödeme alma: Ücretsiz
• Web kancaları: Ücretsiz

Tüm ödeme yanıtları tam şeffaflık için platform_fee_sats, routing_fee_sats ve total_cost içerir.

Değişiklik Günlüğü

v1.1.0 (2026-02-16)

• CLI arayüzü: CLI öncelikli ajanlar (OpenClaw, Pi, KiloCode, herhangi bir Bash ajanı) için yeni lw komutu
• Aynı paket, iki arayüz: npm install -g lightning-wallet-mcp size hem MCP sunucusu hem de CLI sağlar
• JSON öncelikli çıktı: Tüm CLI komutları stdout'a JSON, stderr'e hatalar çıkarır
• X402 desteği: L402 mevcut olmadığında X402'ye (Base üzerinde USDC) otomatik geri dönüş
• Protokol otomatik algılama: pay_l402_api 402 yanıt başlıklarından L402 veya X402'yi algılar
• Yanıt alanları: X402 kullanıldığında payment_protocol ve usdc_amount dahil edilir
• Döviz kuru: CoinGecko üzerinden 5 dakikalık önbellek ile gerçek zamanlı BTC/USD dönüşümü

v1.0.3 (2026-02-05)

• Platform ücreti: Tüm giden ödemelerde ve operatörler arası transferlerde %2 ücret (min 1 sat)
• Ücret şeffaflığı: Tüm ödeme yanıtları artık platform_fee_sats, routing_fee_sats ve total_cost içerir
• Aynı operatör ajan transferleri ücretsiz kalmaya devam eder

v1.0.0 (2026-02-04)

• lightning-faucet-mcp'dan lightning-wallet-mcp'a yeniden markalandı
• Ortam değişkeni yeniden adlandırıldı: LIGHTNING_FAUCET_API_KEY → LIGHTNING_WALLET_API_KEY
• 37 aracın tümü tamamen test edildi ve üretime hazır
• Kırıcı API değişikliği yok - yalnızca paket adı

Önceki sürümler (lightning-faucet-mcp olarak)

v1.6.0'dan v2.0.7'ye kadar olan geçmiş için lightning-faucet-mcp değişiklik günlüğüne bakın.

• Temel ödemeler ve faturalar

Vitrin: Yapay Zeka Ajan Oyun Teorisi Deneyi

Bu MCP sunucusu tarafından desteklenen, Lightning üzerinde gerçek Bitcoin kullanan 16 yapay zeka ajanı (8 Claude, 8 GPT-4o) ile 100 turlu bir ekonomik deney gerçekleştirdik. Ajanlar ticaret yapabildi, ittifaklar kurabildi, yatırım yapabildi ve rekabet edebildi.

Sonuçlar: Ajanlar 2.839 gerçek Lightning işlemi tamamladı. Claude ajanları agresif erken ticaretle baskın çıkarken, GPT-4o ajanları muhafazakar stratejiler benimsedi.

• Deney deposu: github.com/pfergi42/lf-game-theory
• Blog yazısı: lightningfaucet.com/blog/ai-game-theory

Destek

• Dokümantasyon: lightningfaucet.com/ai-agents/docs
• Demo: lightningfaucet.com/ai-agents/demo
• Sorunlar: github.com/lightningfaucet/lightning-wallet-mcp/issues
• E-posta: [email protected]

Lisans

MIT Lisansı - ayrıntılar için LICENSE dosyasına bakın.

---

Bitcoin ile İnşa Edildi | Lightning Faucet