NIP57

闪电击中

draft optional author:jb55 author:kieran

这个 NIP 定义了一种新的音符类型，称为闪电类型 9735。这些表示由名为的 zapper Lightning 节点发送的已支付的 Lightning 发票收据。我们还定义了另一种票据类型 9734，即 zap request 票据，这将在本文档中进行描述。

在 NOSTR 上拥有闪电收据允许客户显示来自网络上实体的闪电付款。这些可以用于娱乐或垃圾邮件威慑。

定义

zapper -发送 ZAP 注释的 Lightning 节点或服务（种类 9735）

zap request -一种 9734 由电击的人创建的注释

zap invoice -从包含 zap request 注释的自定义 LNURL 端点获取的 BOLT11 发票

协议流

客户端

  1. 从用户配置文件上的 LUD06 或 LUD16 字段计算用户的 LNURL 支付请求 URL

  2. 获取 LNURL 支付请求静态端点（ https://host.com/.well-known/lnurlp/user）并收集 allowsNostr 和 nostrPubkey 字段。如果 allowsNostr 存在并且是 true nostrPubkey 有效的 BIP 340 公钥，则将该信息与用户相关联。 nostrPubkey 是的 zapper 公钥，用于授权发送给该用户的 ZAP.

  3. 如果用户的 LNURL 支付请求端点支持 NOSTR，则客户端可以选择在每个帖子或用户配置文件上显示 Lightning Zap 按钮，客户端应生成一个 zap invoice 而不是普通的 LNURL 发票。

  4. 要生成 zap invoice，请调用设置为 Milli-Satoshi 金额值的 callback URL amount。还必须 nostr 设置 QueryString 值。它是由用户密钥签名的 URI 编码 zap request 注释。 zap request 便笺包含 e 它正在删除的便笺的标记和 p 目标用户的公钥的标记。 e 标签是可选的，允许轮廓倾斜。可选 a 标签允许 Tipping 参数化可替换事件，如 NIP-23 长格式注释。 zap request 注释还必须有一个 relays 标签，该标签是从用户配置的中继中收集的。 zap request 票据应包含一个 amount 标签，该标签是 ZAP 的 Milli-Satoshi 值，客户应验证该值是否等于发票金额。这 content 可以是来自用户的附加评论，当在帖子和配置文件上列出 ZAP 时，可以显示该附加评论。

  5. 支付此发票或将其传递给可以支付发票的应用程序。一旦它被支付，A zap note 将被创建 zapper。

LNURL 服务器端

LNURL 服务器将需要一些额外的信息，以便客户端可以知道支持 ZAP 发票：

  1. 将 a 添加 nostrPubkey 到 lnurl-pay 静态端点 /.well-known/lnurlp/user，其中 nostrPubkey 是创建 Zap Notes 的实体的 nostr pubkey zapper。客户端将使用它来授权 ZAP.

  2. 添加一个 allowsNostr 字段并将其设置为 true.

  3. 在 lnurl-pay 回调 URL 中，注意 nostr 查询字符串，其中注释的内容是 URI 编码 zap request 的 JSON.

  4. 如果存在，必须验证 ZAP 请求注释：

    a. 它必须具有有效的 NOSTR 签名

    b. 它必须有标签。

    c. 它必须至少有一个 P 标签

    d. 它必须有 0 或 1 个电子标签

    e. 应该有一个 relays 标签与继电器发送 zap 通知。

    f. 如果有 amount 标记，它必须等于 amount 查询参数。

    g. 如果有 a 标记，则必须是有效的 NIP-33 事件坐标

  5. 如果有效，则获取描述为此票据且仅此票据的描述哈希发票。描述中不包含其他 LNURL 元数据。

此时，一旦收到付款，Lightning 节点就准备好发送 ZAP 通知。

ZAP 笔记

Zap Notes 是由闪电节点对已付发票作出反应而创建的。只有当发票描述（提交到描述哈希）包含 zap request 注释时，才会创建 ZAP 注释。

ZAP 注释示例：

{
    "id": "67b48a14fb66c60c8f9070bdeb37afdfcc3d08ad01989460448e4081eddda446",
    "pubkey": "9630f464cca6a5147aa8a35f0bcdd3ce485324e732fd39e09233b1d848238f31",
    "created_at": 1674164545,
    "kind": 9735,
    "tags": [
      [
        "p",
        "32e1827635450ebb3c5a7d12c1f8e7b2b514439ac10a67eef3d9fd9c5c68e245"
      ],
      [
        "e",
        "3624762a1274dd9636e0c552b53086d70bc88c165bc4dc0f9e836a1eaf86c3b8"
      ],
      [
        "bolt11",
        "lnbc10u1p3unwfusp5t9r3yymhpfqculx78u027lxspgxcr2n2987mx2j55nnfs95nxnzqpp5jmrh92pfld78spqs78v9euf2385t83uvpwk9ldrlvf6ch7tpascqhp5zvkrmemgth3tufcvflmzjzfvjt023nazlhljz2n9hattj4f8jq8qxqyjw5qcqpjrzjqtc4fc44feggv7065fqe5m4ytjarg3repr5j9el35xhmtfexc42yczarjuqqfzqqqqqqqqlgqqqqqqgq9q9qxpqysgq079nkq507a5tw7xgttmj4u990j7wfggtrasah5gd4ywfr2pjcn29383tphp4t48gquelz9z78p4cq7ml3nrrphw5w6eckhjwmhezhnqpy6gyf0"
      ],
      [
        "description",
        "{\"pubkey\":\"32e1827635450ebb3c5a7d12c1f8e7b2b514439ac10a67eef3d9fd9c5c68e245\",\"content\":\"\",\"id\":\"d9cc14d50fcb8c27539aacf776882942c1a11ea4472f8cdec1dea82fab66279d\",\"created_at\":1674164539,\"sig\":\"77127f636577e9029276be060332ea565deaf89ff215a494ccff16ae3f757065e2bc59b2e8c113dd407917a010b3abd36c8d7ad84c0e3ab7dab3a0b0caa9835d\",\"kind\":9734,\"tags\":[[\"e\",\"3624762a1274dd9636e0c552b53086d70bc88c165bc4dc0f9e836a1eaf86c3b8\"],[\"p\",\"32e1827635450ebb3c5a7d12c1f8e7b2b514439ac10a67eef3d9fd9c5c68e245\"],[\"relays\",\"wss://relay.damus.io\",\"wss://nostr-relay.wlvs.space\",\"wss://nostr.fmt.wiz.biz\",\"wss://relay.nostr.bg\",\"wss://nostr.oxtr.dev\",\"wss://nostr.v0l.io\",\"wss://brb.io\",\"wss://nostr.bitcoiner.social\",\"ws://monad.jb55.com:8080\",\"wss://relay.snort.social\"]]}"
      ],
      [
        "preimage",
        "5d006d2cf1e73c7148e7519a4c68adc81642ce0e25a432b2434c99f97344c15f"
      ]
    ],
    "content": "",
    "sig": "b0a3c5c984ceb777ac455b2f659505df51585d5fd97a0ec1fdb5f3347d392080d4b420240434a3afd909207195dac1e2f7e3df26ba862a45afd8bfe101c2b1cc"
  }

  • ZAP 便笺必须具有 bolt11 包含说明哈希螺栓 11 发票的标记。

  • ZAP 票据必须包含 description 作为发票说明的标签。

  • SHA256(description) 必须与 BOLT11 发票中的描述哈希匹配。

  • ZAP 票据可以包含 preimage 与 Bolt11 发票的支付散列匹配的。这不是真正的付款证明，没有真正的方法来证明发票是真实的或已经支付。你信任 ZAP 票据的作者，以确保付款的合法性。

ZAP 票据并不是付款凭证，它所能证明的只是某个 NOSTR 用户拿到了一张发票。ZAP 票据的存在意味着发票已支付，但考虑到流氓实现，它可能是一个谎言。

创建 Zap 便笺

当收到付款时，执行以下步骤：

  1. 获取发票的说明。这需要在生成描述哈希发票的过程中保存在某个位置。它通过 CLN 自动保存，CLN 是这里使用的参考实现。

  2. 将 Bolt11 描述解析为 JSON NOSTR 注释。你应该检查已解析注释的签名以确保其有效。这是 zap request 由正在切换的实体创建的注释。

  3. 注释必须只有一个 p 标记

  4. 注释必须有 0 或 1 个 e 标记

  5. 创建包含 p 标记和可选 e 标记的 NOSTR 类型 9735 注释。内容应该是空的。创建 _ 的日期应设置为发票支付 _ 的日期，以确保等效性。

  6. 将票据发送给发票描述中的 zap request 票据中声明的 relays。

Zapper 的参考实现如下：Zapper

客户行为

客户可以在帖子和个人资料上获取 ZAP 注释：

{“种类”：[9735]，“#E ”：[..]}

要授权这些注释，客户端必须从用户配置的 Lightning 地址或 LNURL 获取 nostrPubkey，并确保其帖子的 ZAP 是由此公钥创建的。如果客户不这样做，任何人都可以伪造未经授权的 ZAP.

一旦获得授权，客户可以在帖子上记录 ZAP，并将其列在个人资料中。如果 ZAP 请求注释包含非空 content，则可能显示 ZAP 注释。通常，客户端应向用户 zap request 显示注释，并使用 zap note 显示“ZAP Authorized by..”，但这是可选的。

未来的工作

通过对目标用户的 ZAP 请求注释进行加密，可以将 ZAP 扩展为更加私密，但为了简单起见，它已被排除在此初始草案之外。

PreviousNIP56NextNIP58

Last updated