lnget — 原生支持 Lightning 的 HTTP 客户端

lnget 是一个类似 wget/curl 的命令行工具，原生支持 L402（Lightning HTTP 402）认证。当服务器返回 HTTP 402 状态及 L402 挑战时，lnget 会自动支付对应的 Lightning 发票，并携带已支付凭证重试请求。

源码地址：github.com/lightninglabs/lnget

快速开始

# 1. 安装 lnget
skills/lnget/scripts/install.sh

# 2. 初始化配置（自动检测本地 lnd）
lnget config init

# 3. 获取受 L402 保护的资源
lnget --max-cost 1000 https://api.example.com/paid-data

安装

skills/lnget/scripts/install.sh

该脚本将执行以下操作：

• 验证 Go 是否已安装
• 运行 go install github.com/lightninglabs/lnget/cmd/lnget@latest
• 验证 lnget 是否已在 $PATH 中

如需手动安装：

go install github.com/lightninglabs/lnget/cmd/lnget@latest

或从源码构建：

git clone https://github.com/lightninglabs/lnget.git
cd lnget
make install

基本用法

下载

# 获取 URL（输出至标准输出）
lnget https://api.example.com/data.json

# 保存为文件
lnget -o data.json https://api.example.com/data.json

# 静默模式（适用于管道处理）
lnget -q https://api.example.com/data.json | jq .

# 断点续传
lnget -c -o largefile.zip https://api.example.com/largefile.zip

# 自定义 HTTP 方法并发送数据
lnget -X POST -d '{"query":"test"}' https://api.example.com/search

# 自定义 HTTP 头部
lnget -H "Accept: text/plain" https://api.example.com/data

支付控制

# 设置最大自动支付金额（单位：satoshi）
lnget --max-cost 5000 https://api.example.com/expensive.json

# 设置最大路由手续费
lnget --max-fee 50 https://api.example.com/data.json

# 预览但不支付（显示 402 挑战详情）
lnget --no-pay https://api.example.com/data.json

# 自定义支付超时时间
lnget --payment-timeout 120s https://api.example.com/data.json

输出模式

# JSON 格式输出（默认，适合程序化调用）
lnget --json https://api.example.com/data.json

# 人类可读格式输出
lnget --human https://api.example.com/data.json

# 详细模式（显示 L402 流程细节）
lnget -v https://api.example.com/data.json

# 禁用进度条
lnget --no-progress -o file.zip https://api.example.com/file.zip

子命令

令牌管理（lnget tokens）

令牌按域名缓存于 ~/.lnget/tokens//token.json，后续对该域名的请求将自动复用已缓存令牌。

# 列出所有已缓存令牌
lnget tokens list

# 显示指定域名的令牌
lnget tokens show api.example.com

# 删除某域名的令牌（强制重新认证）
lnget tokens remove api.example.com

# 清空全部令牌
lnget tokens clear --force

配置（lnget config）

# 在 ~/.lnget/config.yaml 初始化配置文件
lnget config init

# 显示当前配置
lnget config show

# 显示配置文件路径
lnget config path

Lightning 后端（lnget ln）

# 检查后端连接状态
lnget ln status

# 显示节点详细信息
lnget ln info

LNC（Lightning Node Connect）

# 使用 LNC 配对短语与节点配对
lnget ln lnc pair "your-pairing-phrase"

# 临时配对（不持久化会话）
lnget ln lnc pair "phrase" --ephemeral

# 列出已保存的 LNC 会话
lnget ln lnc sessions

# 撤销某一会话
lnget ln lnc revoke 

Neutrino（嵌入式钱包）

# 初始化嵌入式 Neutrino 钱包
lnget ln neutrino init

# 获取充值地址
lnget ln neutrino fund

# 查询钱包余额
lnget ln neutrino balance

# 显示同步状态
lnget ln neutrino status

配置文件

配置文件位于 ~/.lnget/config.yaml。运行 lnget config init 可创建该文件。

注意：由于 lnget 源码中缺少 YAML 结构体标签（struct tags），lnget config init 生成的 YAML 键名可能不正确（例如生成 tlscertpath 和 macaroonpath，而非正确的 tls_cert 和 macaroon）。请以如下示例配置为准。若配置文件由 lnget config init 生成，请确认其中 ln.lnd 下的字段名与下方格式一致。

l402:
  max_cost_sats: 1000       # 允许自动支付的最大发票金额（单位：satoshi）
  max_fee_sats: 10           # 允许的最大路由手续费（单位：satoshi）
  payment_timeout: 60s       # 支付超时时间
  auto_pay: true             # 启用自动支付

http:
  timeout: 30s
  max_redirects: 10
  user_agent: "lnget/0.1.0"
  allow_insecure: false

ln:
  mode: lnd                  # 可选值：lnd、lnc、neutrino
  lnd:
    host: localhost:10009
    tls_cert: ~/.lnd/tls.cert
    macaroon: ~/.lnd/data/chain/bitcoin/mainnet/admin.macaroon
    network: mainnet

output:
  format: json
  progress: true
  verbose: false

tokens:
  dir: ~/.lnget/tokens

环境变量可覆盖配置项，前缀为 LNGET_：

export LNGET_L402_MAX_COST_SATS=5000
export LNGET_LN_MODE=lnc
export LNGET_LN_LND_HOST=localhost:10009

退出码

L402 流程

当 lnget 收到 402 响应时，执行以下流程：

1. 解析 WWW-Authenticate: L402 macaroon="...", invoice="..." 头部
2. 解码 macaroon 和 BOLT11 发票
3. 比对发票金额与 --max-cost 设置
4. 存储待定令牌（支持崩溃恢复）
5. 通过已配置的 Lightning 后端支付发票
6. 将已支付令牌及 preimage 存储至 ~/.lnget/tokens//
7. 携带 Authorization: L402 : 重试请求

后续对该域名的请求将直接复用缓存令牌，无需再次支付。

Agent 集成模式

预算感知式获取

# 获取前先检查成本
result=$(lnget --no-pay --json https://api.example.com/data.json)
cost=$(echo "$result" | jq -r '.invoice_amount_sat // 0')

if [ "$cost" -le "$BUDGET" ]; then
    lnget --max-cost "$BUDGET" -q https://api.example.com/data.json
fi

解析 JSON 输出

# 仅提取响应体
lnget --json -q https://api.example.com/data.json | jq '.body'

# 检查是否发生了支付
lnget --json https://api.example.com/data.json | jq '.l402_paid'

使用非安全连接进行测试

# 本地开发时对接 aperture（无 TLS）
lnget -k https://localhost:8081/api/data

文件路径