# @gandlaf21/bolt11-decode 中文文档

规范地址：https://npmcn.com/package/%40gandlaf21/bolt11-decode/

版本：3\.1\.1
npm 元数据更新时间：2024-03-15T01:11:56.016Z
中文译文更新时间：2026-11-15T22:33:12.991Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40gandlaf21/bolt11-decode
原文对照：https://npmcn.com/package/%40gandlaf21/bolt11-decode/?lang=original
项目主页：https://github.com/gandlafbtc/light-bolt11-decoder#readme
源码仓库：https://github.com/gandlafbtc/light-bolt11-decoder

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：44.8 kB，8 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：3 个
- 首次发布：2023-01-04T12:06:26.198Z
- 最新版本发布：2024-03-15T01:11:54.979Z
- 近 30 天下载量：2183（2026-10-16 至 2026-11-14，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 0 个）

## 中文简介

用于解码闪电网络付款请求的轻量级和幼稚文库 [BOLT 第11号](https://github.com/lightningnetwork/lightning-rfc/blob/master/11-payment-encoding.md)。 。 。 .

## 安装

```sh
npm install @gandlaf21/bolt11-decode
```

也可以使用：`pnpm add @gandlaf21/bolt11-decode`、`yarn add @gandlaf21/bolt11-decode`、`bun add @gandlaf21/bolt11-decode`

## README

# 螺栓11-解码

用于解码闪电网络付款请求的轻量级和幼稚文库 [BOLT 第11号](https://github.com/lightningnetwork/lightning-rfc/blob/master/11-payment-encoding.md)。 。 。 .

它不从签名中恢复收款人,不检查签名,不剖析倒置地址,也不做任何编码——因此依赖性非常微小(这里没有libsecp256k1).

代码来源于 [螺栓11](https://npmjs.com/package/bolt11),它有完全的功能,但它是一个痛苦运行在浏览器.

## 安装

```shell
npm i @gandlaf21/bolt11-decode
```

### 使用量

```javascript
import { decode } from "@gandlaf21/bolt11-decode";

decode('{invoice}', 'optional: network')

```

输出示例 :

```json
{
  "paymentRequest": "lnbc20u1p3y0x3hpp5743k2g0fsqqxj7n8qzuhns5gmkk4djeejk3wkp64ppevgekvc0jsdqcve5kzar2v9nr5gpqd4hkuetesp5ez2g297jduwc20t6lmqlsg3man0vf2jfd8ar9fh8fhn2g8yttfkqxqy9gcqcqzys9qrsgqrzjqtx3k77yrrav9hye7zar2rtqlfkytl094dsp0ms5majzth6gt7ca6uhdkxl983uywgqqqqlgqqqvx5qqjqrzjqd98kxkpyw0l9tyy8r8q57k7zpy9zjmh6sez752wj6gcumqnj3yxzhdsmg6qq56utgqqqqqqqqqqqeqqjq7jd56882gtxhrjm03c93aacyfy306m4fq0tskf83c0nmet8zc2lxyyg3saz8x6vwcp26xnrlagf9semau3qm2glysp7sv95693fphvsp54l567",
  "sections": [
    {
      "name": "lightning_network",
      "letters": "ln"
    },
    {
      "name": "coin_network",
      "letters": "bc",
      "value": {
        "bech32": "bc",
        "pubKeyHash": 0,
        "scriptHash": 5,
        "validWitnessVersions": [
          0
        ]
      }
    },
    {
      "name": "amount",
      "letters": "20u",
      "value": "2000000"
    },
    {
      "name": "separator",
      "letters": "1"
    },
    {
      "name": "timestamp",
      "letters": "p3y0x3h",
      "value": 1648859703
    },
    {
      "name": "payment_hash",
      "tag": "p",
      "letters": "pp5743k2g0fsqqxj7n8qzuhns5gmkk4djeejk3wkp64ppevgekvc0js",
      "value": "f5636521e98000697a6700b979c288ddad56cb3995a2eb07550872c466ccc3e5"
    },
    {
      "name": "description",
      "tag": "d",
      "letters": "dqcve5kzar2v9nr5gpqd4hkuete",
      "value": "fiatjaf:  money"
    },
    {
      "name": "payment_secret",
      "tag": "s",
      "letters": "sp5ez2g297jduwc20t6lmqlsg3man0vf2jfd8ar9fh8fhn2g8yttfkq",
      "value": "c8948517d26f1d853d7afec1f8223becdec4aa4969fa32a6e74de6a41c8b5a6c"
    },
    {
      "name": "expiry",
      "tag": "x",
      "letters": "xqy9gcq",
      "value": 172800
    },
    {
      "name": "min_final_cltv_expiry",
      "tag": "c",
      "letters": "cqzys",
      "value": 144
    },
    {
      "name": "feature_bits",
      "tag": "9",
      "letters": "9qrsgq",
      "value": {
        "word_length": 3,
        "option_data_loss_protect": {
          "required": false,
          "supported": false
        },
        "initial_routing_sync": {
          "required": false,
          "supported": false
        },
        "option_upfront_shutdown_script": {
          "required": false,
          "supported": false
        },
        "gossip_queries": {
          "required": false,
          "supported": false
        },
        "var_onion_optin": {
          "required": true,
          "supported": false
        },
        "gossip_queries_ex": {
          "required": false,
          "supported": false
        },
        "option_static_remotekey": {
          "required": false,
          "supported": false
        },
        "payment_secret": {
          "required": true,
          "supported": false
        },
        "basic_mpp": {
          "required": false,
          "supported": false
        },
        "option_support_large_channel": {
          "required": false,
          "supported": false
        },
        "extra_bits": {
          "start_bit": 20,
          "bits": [],
          "has_required": false
        }
      }
    },
    {
      "name": "route_hint",
      "tag": "r",
      "letters": "rzjqtx3k77yrrav9hye7zar2rtqlfkytl094dsp0ms5majzth6gt7ca6uhdkxl983uywgqqqqlgqqqvx5qqjq",
      "value": [
        {
          "pubkey": "02cd1b7bc418fac2dc99f0ba350d60fa6c45fde5ab6017ee14df6425df485fb1dd",
          "short_channel_id": "72edb1be53c78472",
          "fee_base_msat": 1000,
          "fee_proportional_millionths": 50000,
          "cltv_expiry_delta": 144
        }
      ]
    },
    {
      "name": "route_hint",
      "tag": "r",
      "letters": "rzjqd98kxkpyw0l9tyy8r8q57k7zpy9zjmh6sez752wj6gcumqnj3yxzhdsmg6qq56utgqqqqqqqqqqqeqqjq",
      "value": [
        {
          "pubkey": "034a7b1ac1239ff2ac8438ce0a7ade1048514b77d4322f514e96918e6c13944861",
          "short_channel_id": "5db0da3400535c5a",
          "fee_base_msat": 0,
          "fee_proportional_millionths": 100,
          "cltv_expiry_delta": 144
        }
      ]
    },
    {
      "name": "signature",
      "letters": "7jd56882gtxhrjm03c93aacyfy306m4fq0tskf83c0nmet8zc2lxyyg3saz8x6vwcp26xnrlagf9semau3qm2glysp7sv95693fphvsp",
      "value": "f49b4d1cea42cd71cb6f8e0b1ef7044922fd6ea903d70b24f1c3e7bcace2c2be621111874473698ec055a34c7fea1258677de441b523e4807d06169a2c521bb201"
    },
    {
      "name": "checksum",
      "letters": "54l567"
    }
  ],
  "expiry": 172800,
  "route_hints": [
    [
      {
        "pubkey": "02cd1b7bc418fac2dc99f0ba350d60fa6c45fde5ab6017ee14df6425df485fb1dd",
        "short_channel_id": "72edb1be53c78472",
        "fee_base_msat": 1000,
        "fee_proportional_millionths": 50000,
        "cltv_expiry_delta": 144
      }
    ],
    [
      {
        "pubkey": "034a7b1ac1239ff2ac8438ce0a7ade1048514b77d4322f514e96918e6c13944861",
        "short_channel_id": "5db0da3400535c5a",
        "fee_base_msat": 0,
        "fee_proportional_millionths": 100,
        "cltv_expiry_delta": 144
      }
    ]
  ]
}
```

## 自由主义 [麻省理工学院](https://npmcn.com/package/%40gandlaf21/bolt11-decode/LICENSE)

## 常见问题

### @gandlaf21/bolt11-decode 是什么？

用于解码闪电网络付款请求的轻量级和幼稚文库 BOLT 第11号。 。 。 \.

### 如何安装 @gandlaf21/bolt11-decode？

在项目目录运行 npm install @gandlaf21/bolt11-decode，或使用 pnpm add / yarn add / bun add。

### @gandlaf21/bolt11-decode 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @gandlaf21/bolt11-decode 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @gandlaf21/bolt11-decode 可以商用吗？

@gandlaf21/bolt11-decode 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @gandlaf21/bolt11-decode 的下载量有多少？

根据 npm 官方下载统计，@gandlaf21/bolt11-decode 在 2026/10/16 – 2026/11/14 这 30 天内被下载 2,183 次，日均约 73 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @gandlaf21/bolt11-decode 还在维护吗？

最新版本 3\.1\.1 发布于 2024/03/15（2 年前）；至今共发布 8 个版本，其中过去 12 个月发布了 0 个；首次发布于 2023/01/04。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。

