README

This library aims to be a tool to decode BOLT #11 Payment Requests into usable PHP objects. Currently, only decoding is supported.

BOLT #11 is a simple, extendable, QR-code-ready protocol for requesting payments over Lightning.

Installation

$ composer require jorijn/bitcoin-bolt11

Usage

$invoice = 'lnbc9678785340p1pwmna7lpp5gc3xfm08u9qy06djf8dfflhugl6p7lgza6dsjxq454gxhj9t7a0sd8dgfkx7cmtwd68yetpd5s9xar0wfjn5gpc8qhrsdfq24f5ggrxdaezqsnvda3kkum5wfjkzmfqf3jkgem9wgsyuctwdus9xgrcyqcjcgpzgfskx6eqf9hzqnteypzxz7fzypfhg6trddjhygrcyqezcgpzfysywmm5ypxxjemgw3hxjmn8yptk7untd9hxwg3q2d6xjcmtv4ezq7pqxgsxzmnyyqcjqmt0wfjjq6t5v4khxxqyjw5qcqp2rzjq0gxwkzc8w6323m55m4jyxcjwmy7stt9hwkwe2qxmy8zpsgg7jcuwz87fcqqeuqqqyqqqqlgqqqqn3qq9qn07ytgrxxzad9hc4xt3mawjjt8znfv8xzscs7007v9gh9j569lencxa8xeujzkxs0uamak9aln6ez02uunw6rd2ht2sqe4hz8thcdagpleym0j'; $decoder = new \Jorijn\Bitcoin\Bolt11\Encoder\PaymentRequestDecoder(); $denormalizer = new \Jorijn\Bitcoin\Bolt11\Normalizer\PaymentRequestDenormalizer(); $paymentRequest = $denormalizer->denormalize($decoder->decode($invoice)); // satoshis: 967878 echo 'satoshis: ' . $paymentRequest->getSatoshis(); // description: Blockstream Store: 88.85 USD for Blockstream Ledger Nano S x 1, "Back In My Day" Sticker x 2, "I Got Lightning Working" Sticker x 2 and 1 more items echo 'description: ' . $paymentRequest->findTagByName(\Jorijn\Bitcoin\Bolt11\Model\Tag::DESCRIPTION)->getData(); // timestamp: DateTime Object // ( // [date] => 2019-10-30 20:51:43.000000 // [timezone_type] => 1 // [timezone] => +00:00 // ) echo 'timestamp: ' . print_r($paymentRequest->getTimestampDateTime(), true); // hop: 0 // public key: 029e03a901b85534ff1e92c43c74431f7ce72046060fcf7a95c37e148f78c77255 // short channel id: 0102030405060708 // fee base msat: 1 // fee proportional millionths 20 // cltv expiry delta: 3 foreach ($paymentRequest->findTagByName(\Jorijn\Bitcoin\Bolt11\Model\Tag::ROUTING_INFO)->getData() as $hop => $routingInfo) { echo 'hop: ' . $hop; echo 'public key: ' . $routingInfo->getPubKey(); echo 'short channel id: ' . $routingInfo->getShortChannelId(); echo 'fee base msat: ' . $routingInfo->getFeeBaseMsat(); echo 'fee proportional millionths ' . $routingInfo->getFeeProportionalMillionths(); echo 'cltv expiry delta: ' . $routingInfo->getCltvExpiryDelta(); }

More examples are available in the examples directory.

Warning

The ->getSatoshis() method will only return a valid number if the invoice is for a whole number of satoshis. If it is in a fractional number of satoshis, and the method returns NULL, the ->getMilliSatoshis() method must be used. 1000 millisatoshis is 1 satoshi.

Thanks

This library is based on other BOLT #11 libraries from other programming languages. Special thanks to:

• https://github.com/lightningnetwork/lnd/blob/master/zpay32/decode.go
• https://github.com/bitcoinjs/bolt11
• https://github.com/nievk/bolt11

CLI tool

There is a CLI tool based on this library. It allows for easy decoding and converting of payment requests into JSON, XML, YAML & CSV. Download and usage here: https://github.com/Jorijn/bitcoin-bolt11-cli