Lightning Faucet MCP Server

공식

AI 에이전트에게 라이트닝 네트워크 결제가 가능한 비트코인 지갑을 제공합니다

GitHub

문서

Lightning Wallet

AI 에이전트에게 비트코인 지갑을 제공하세요. MCP 서버 + CLI. Claude Code, OpenClaw, Cursor 및 모든 에이전트 프레임워크와 함께 작동합니다.

v1.4의 새로운 기능

update_operator 도구 / lw set-email - MCP 클라이언트 또는 CLI에서 운영자 이메일을 설정하면 인증 링크가 이메일로 전송됩니다.
claim_promo 도구 / lw claim-promo - 에이전트에서 직접 무료 사토시 설치 프로모션을 청구하세요. 요구 사항: 인증된 이메일 + 최소 3시간 이상 된 운영자 계정.
get_info 등록 전에 작동 - 서비스 정보에 더 이상 API 키가 필요하지 않습니다.

신규 운영자에게 100사토시 무료 제공

lw register --email [email protected] (또는 이메일과 함께 register_operator MCP 도구 사용)
이메일로 전송된 인증 링크 클릭
계정 생성 3시간 후: lw claim-promo (또는 claim_promo MCP 도구 사용)

운영자당 1회 보너스, 선착순 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 - L402(Lightning)와 함께 자동 폴백으로 X402 프로토콜 지원(Base의 USDC).

X402 지원 - L402를 사용할 수 없을 때 Base에서 자동 USDC 결제
프로토콜 자동 감지 - pay_l402_api L402와 X402를 원활하게 처리
웹훅 - 결제 및 이벤트에 대한 실시간 알림
Keysend - 노드 공개키를 사용하여 인보이스 없이 결제 전송
인보이스 디코딩 - 결제 전 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`	현재 Lightning 잔액을 사토시 단위로 확인
`get_rate_limits`	현재 속도 제한 상태 및 남은 요청 수 확인

결제 (에이전트 키 필요)

도구	설명
`pay_l402_api`	유료 API 액세스(L402/X402) - 프로토콜 자동 감지 및 결제
`pay_invoice`	모든 BOLT11 Lightning 인보이스 결제
`keysend`	노드 공개키로 직접 결제 전송(인보이스 불필요)
`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 - 무료 사토시 설치 프로모션 청구(인증된 이메일 + 3시간 계정)

에이전트 관리

도구	설명
`create_agent`	운영자 아래 에이전트 생성
`list_agents`	운영자 아래 모든 에이전트 나열
`fund_agent`	운영자에서 에이전트로 사토시 전송
`transfer_to_agent`	에이전트 간 또는 운영자에서 에이전트로 사토시 전송
`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 참조

모든 명령은 JSON을 stdout으로 출력합니다. 오류는 종료 코드 1과 함께 stderr로 출력됩니다.

명령	설명
`lw register [--name "name"]`	운영자 계정 생성, API 키 출력
`lw whoami`	현재 신원(운영자 또는 에이전트)
`lw balance`	사토시 단위 잔액
`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>`	에이전트로 사토시 전송
`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가 우선합니다. 에이전트는 프로토콜에 관계없이 항상 사토시로 결제합니다. 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 금액을 사토시로 변환하고 에이전트 잔액에서 차감
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자 16진수)
amount_sats	number	예	사토시 단위 금액
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는 해당되는 경우 에이전트 승인 상한입니다.

지갑에서 정확히 전송되는 내용. 위의 8개 필드만 훅 엔드포인트로 전송됩니다: 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 zaps. 운영자 범위의 자금 관리(출금, 에이전트 자금 조달, 에이전트 간 전송)는 의도적으로 제어되지 않습니다. 이는 에이전트 지출이 아닌 운영자 작업입니다.

훅 응답 (엔드포인트에서 반환)

{ "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% 플랫폼 수수료 + Lightning 라우팅 수수료
X402 결제: 2% 플랫폼 수수료 + 1% 환율 스프레드(USDC에서 사토시로 변환)
인보이스 결제: 2% 플랫폼 수수료 + Lightning 라우팅 수수료
Keysend 결제: 2% 플랫폼 수수료 + Lightning 라우팅 수수료
운영자 출금: 2% 플랫폼 수수료 + Lightning 라우팅 수수료
교차 운영자 내부 전송: 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 명령은 JSON을 stdout으로, 오류를 stderr로 출력합니다.
X402 지원: L402를 사용할 수 없을 때 X402(Base의 USDC)로 자동 폴백
프로토콜 자동 감지: pay_l402_api이 402 응답 헤더에서 L402 또는 X402 감지
응답 필드: X402 사용 시 payment_protocol 및 usdc_amount 포함
환율: 5분 캐시가 있는 CoinGecko를 통한 실시간 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 에이전트 게임 이론 실험

이 MCP 서버로 구동되는 실제 Bitcoin on Lightning을 사용하여 16개의 AI 에이전트(Claude 8개, GPT-4o 8개)로 100라운드 경제 실험을 실행했습니다. 에이전트는 거래, 동맹 형성, 투자 및 경쟁을 할 수 있었습니다.

결과: 에이전트는 2,839건의 실제 Lightning 거래를 완료했습니다. 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