包简介

A payment splitter using lightning addresses

README 文档

README

This library allows you to easily split a lightning payment to multiple lightning addresses.

Installation

composer require utxo-one/lightning-prism-php

Usage

use LightningPrism\LightningPrism;
use LightningPrism\LightningPrismSettings;

$settings = [
    'utxo@testnet.nodeless.io' => 10,
    'nostr@testnet.nodeless.io' => 40,
    'testing@testnet.nodeless.io' => 50,
];

$lightningPrism = new LightningPrism(
    settings: $settings,
    amount: 2371,
    host: $this->host,
    port: $this->port,
    macaroon: $this->macaroon,
    tlsCertificate: $this->tlsCertificate,
);

$response = $lightningPrism->zap();

Response

array(3) {
  ["utxo@testnet.nodeless.io"]=>
  object(UtxoOne\LndPhp\Responses\Lightning\SendResponse)#307 (1) {
    ["data":"UtxoOne\LndPhp\Responses\Lightning\SendResponse":private]=>
    array(4) {
      ["payment_error"]=>
      string(0) ""
      ["payment_preimage"]=>
      string(44) "3KKpToqROgTCoOun1xnEvdr7QrzQKKJ05Kh3WOK0yVE="
      ["payment_route"]=>
      array(6) {
        ["total_time_lock"]=>
        int(2440088)
        ["total_fees"]=>
        string(1) "0"
        ["total_amt"]=>
        string(3) "237"
        ["hops"]=>
        array(1) {
          [0]=>
          array(13) {
            ["chan_id"]=>
            string(19) "2655259008430833665"
            ["chan_capacity"]=>
            string(7) "5000000"
            ["amt_to_forward"]=>
            string(3) "237"
            ["fee"]=>
            string(1) "0"
            ["expiry"]=>
            int(2440088)
            ["amt_to_forward_msat"]=>
            string(6) "237000"
            ["fee_msat"]=>
            string(1) "0"
            ["pub_key"]=>
            string(66) "038802f80e3e1ca7ea80e4c5951fa29a08f274209195de9fe5d47017afca36ecc5"
            ["tlv_payload"]=>
            bool(true)
            ["mpp_record"]=>
            array(2) {
              ["payment_addr"]=>
              string(44) "47GEVx8PDiy1mcRzMjz+F34o168o8gCxDrZQObqZ6No="
              ["total_amt_msat"]=>
              string(6) "237000"
            }
            ["amp_record"]=>
            NULL
            ["custom_records"]=>
            array(0) {
            }
            ["metadata"]=>
            string(0) ""
          }
        }
        ["total_fees_msat"]=>
        string(1) "0"
        ["total_amt_msat"]=>
        string(6) "237000"
      }
      ["payment_hash"]=>
      string(44) "GjYPtDnFDjYweITH1Ce+mKQ0xmB9CI7F6AB+6m6hgM8="
    }
  }
  ["nostr@testnet.nodeless.io"]=>
  object(UtxoOne\LndPhp\Responses\Lightning\SendResponse)#99 (1) {
    ["data":"UtxoOne\LndPhp\Responses\Lightning\SendResponse":private]=>
    array(4) {
      ["payment_error"]=>
      string(0) ""
      ["payment_preimage"]=>
      string(44) "ziXkRdHXDxgHzrB4Q/dQCIlz6bfWrYx611NrolBuQJI="
      ["payment_route"]=>
      array(6) {
        ["total_time_lock"]=>
        int(2440088)
        ["total_fees"]=>
        string(1) "0"
        ["total_amt"]=>
        string(3) "948"
        ["hops"]=>
        array(1) {
          [0]=>
          array(13) {
            ["chan_id"]=>
            string(19) "2655259008430833665"
            ["chan_capacity"]=>
            string(7) "5000000"
            ["amt_to_forward"]=>
            string(3) "948"
            ["fee"]=>
            string(1) "0"
            ["expiry"]=>
            int(2440088)
            ["amt_to_forward_msat"]=>
            string(6) "948000"
            ["fee_msat"]=>
            string(1) "0"
            ["pub_key"]=>
            string(66) "038802f80e3e1ca7ea80e4c5951fa29a08f274209195de9fe5d47017afca36ecc5"
            ["tlv_payload"]=>
            bool(true)
            ["mpp_record"]=>
            array(2) {
              ["payment_addr"]=>
              string(44) "6qS6dtHj3QQhWIwm1W+2WFz4i97WTwS+3sdZ8SRgiQ4="
              ["total_amt_msat"]=>
              string(6) "948000"
            }
            ["amp_record"]=>
            NULL
            ["custom_records"]=>
            array(0) {
            }
            ["metadata"]=>
            string(0) ""
          }
        }
        ["total_fees_msat"]=>
        string(1) "0"
        ["total_amt_msat"]=>
        string(6) "948000"
      }
      ["payment_hash"]=>
      string(44) "kNTTR9wpZQH7m5DXHtPV1GCdCB+nzSJnv56vEcSgMkc="
    }
  }
  ["testing@testnet.nodeless.io"]=>
  object(UtxoOne\LndPhp\Responses\Lightning\SendResponse)#596 (1) {
    ["data":"UtxoOne\LndPhp\Responses\Lightning\SendResponse":private]=>
    array(4) {
      ["payment_error"]=>
      string(0) ""
      ["payment_preimage"]=>
      string(44) "UlqmGjHVBYOfwqJ8uRi3D7O4e3YN9hFjTOupd7jWIU0="
      ["payment_route"]=>
      array(6) {
        ["total_time_lock"]=>
        int(2440088)
        ["total_fees"]=>
        string(1) "0"
        ["total_amt"]=>
        string(4) "1186"
        ["hops"]=>
        array(1) {
          [0]=>
          array(13) {
            ["chan_id"]=>
            string(19) "2655259008430833665"
            ["chan_capacity"]=>
            string(7) "5000000"
            ["amt_to_forward"]=>
            string(4) "1186"
            ["fee"]=>
            string(1) "0"
            ["expiry"]=>
            int(2440088)
            ["amt_to_forward_msat"]=>
            string(7) "1186000"
            ["fee_msat"]=>
            string(1) "0"
            ["pub_key"]=>
            string(66) "038802f80e3e1ca7ea80e4c5951fa29a08f274209195de9fe5d47017afca36ecc5"
            ["tlv_payload"]=>
            bool(true)
            ["mpp_record"]=>
            array(2) {
              ["payment_addr"]=>
              string(44) "UmjuFmoLxVLAI37l68GLQG4bXclmN5H0kBi9LtrxCeY="
              ["total_amt_msat"]=>
              string(7) "1186000"
            }
            ["amp_record"]=>
            NULL
            ["custom_records"]=>
            array(0) {
            }
            ["metadata"]=>
            string(0) ""
          }
        }
        ["total_fees_msat"]=>
        string(1) "0"
        ["total_amt_msat"]=>
        string(7) "1186000"
      }
      ["payment_hash"]=>
      string(44) "Os2zAL8a4lPnjxDgQrxee11Gz3fCXqwzooQo+01qcyo="
    }
  }
}

Run Tests

You must setup a .env file in tests/Feature. See .env.example to set it up.

./vendor/bin/pest pest

utxo-one/lightning-prism-php 适用场景与选型建议

utxo-one/lightning-prism-php 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 19 次下载、GitHub Stars 达 6，最近一次更新时间为 2023 年 07 月 03 日，在 PHP 生态内属于活跃度较高的组件。

我们在过去多个企业项目中使用过 utxo-one/lightning-prism-php 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 utxo-one/lightning-prism-php 我们能提供哪些服务？

定制开发 / 二次开发

基于 utxo-one/lightning-prism-php 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发

utxo-one/lightning-prism-php

包简介