bootstrap.bolt12.org: bitcoin Examples
Here are several simple examples you can use for testing.
Simple non-recurring examples
The simplest possible offer: no amount specified.
Created by command: lightning-cli offer any "Offer by rusty's node"
- offer_id
-
- bolt12
- lno1pg257enxv4ezqcneype82um50ynhxgrwdajx293pqglnyxw6q0hzngfdusg8umzuxe8kquuz7pjl90ldj8wadwgs0xlmc (decode)
- QR code:
-
Here's the how you'd fetch an invoice from it (in this case, for 100 msat):
/fetchinvoice//100
An offer with a fixed amount (technically a minimum: you can tip), with a quantity so you can order more than one. It also has a issuer field.
Created by command: lightning-cli offer amount=50 description="50msat multi-quantity offer" issuer="rustcorp.com.au" quantity_max=0
- offer_id
-
- bolt12
- lno1pqqnyzsmx5cx6umpwssx6atvw35j6ut4v9h8g6t50ysx7enxv4epyrmjw4ehgcm0wfczucm0d5hxzag5qqtzzq3lxgva5qlw9xsjmeqs0ek9cdj0vpec9ur972l7mywa66u3q7dlhs (decode)
- QR code:
-
Here's the how you'd fetch an invoice from it (default amount, quantity 2):
/fetchinvoice/lno1pqqnyzsmx5cx6umpwssx6atvw35j6ut4v9h8g6t50ysx7enxv4epyrmjw4ehgcm0wfczucm0d5hxzag5qqtzzq3lxgva5qlw9xsjmeqs0ek9cdj0vpec9ur972l7mywa66u3q7dlhs//2
Recurring examples
Simple offer asks for 100msat every minute:
Created by command: lightning-cli offer amount=100msat description="100msat every minute" issuer="rusty.ozlabs.org" recurrence=1minute
- offer_id
-
- bolt12
- lno1pqqkgzs5xycrqmtnv96zqetkv4e8jgrdd9h82ar9zgg8yatnw3ujumm6d3skyuewdaexw93pqglnyxw6q0hzngfdusg8umzuxe8kquuz7pjl90ldj8wadwgs0xlmcxszqq7q (decode)
-
Here's the how you'd fetch the first invoice, using your super-secret payerkey of 010101...01:
/fetchinvoicerecurring/lno1pqqkgzs5xycrqmtnv96zqetkv4e8jgrdd9h82ar9zgg8yatnw3ujumm6d3skyuewdaexw93pqglnyxw6q0hzngfdusg8umzuxe8kquuz7pjl90ldj8wadwgs0xlmcxszqq7q/0101010101010101010101010101010101010101010101010101010101010101/0
Note that you cannot fetch the next invoice until that one is paid! (Hurry up, you only have a minute!). Once you did, you could fetch again::
Offer asks for 100msat every minute, but only three times:
Created by command: lightning-cli offer amount=100msat description="100msat every minute, up to three times" issuer="rusty.ozlabs.org" recurrence=1minute recurrence_limit=2
- offer_id
-
- bolt12
- lno1pqqkgz38xycrqmtnv96zqetkv4e8jgrdd9h82ar99ss82upqw3hjqargwfjk2gr5d9kk2ucjzpe82um50yhx77nvv938xtn0wfn3vggz8uepnksrac56zt0yzplxchpkfas88qhsvhetlmv3mhttjyreh77p5qsq8s0qzqs (decode)
- QR code:
-
Offer asks for 100msat every day, first period being 1 Jan 2021 (you can start at any period though):
Created by command: lightning-cli offer amount=100msat description="100msat every day, from 1-Jan-2021" issuer="rusty.ozlabs.org" recurrence=1day recurrence_base=$(date +%s -d 2021-01-01)
- offer_id
-
- bolt12
- lno1pqqkgz3zxycrqmtnv96zqetkv4e8jgryv9ujcgrxwfhk6gp3949xzm3dxgcryvgjzpe82um50yhx77nvv938xtn0wfn3vggz8uepnksrac56zt0yzplxchpkfas88qhsvhetlmv3mhttjyreh77p5qspqysq2q2laenqq (decode)
- QR code:
-
You need to calculate the current period, which depends on the current time (UTC). I ran echo $(( ( $(date +%s) - $(date +%s -d 2021-01-01) ) / 3600 / 24 )) and it told me it was day 183 (it's 2021-07-03), so I can request invoices for 183 or 184 (default paywindow is that you can pay the current or nex period).
It's currently 996 days, so you can fetch your first invoice, using that super-secret payerkey of 010101...01:
/fetchinvoicerecurring/lno1pqqkgz3zxycrqmtnv96zqetkv4e8jgryv9ujcgrxwfhk6gp3949xzm3dxgcryvgjzpe82um50yhx77nvv938xtn0wfn3vggz8uepnksrac56zt0yzplxchpkfas88qhsvhetlmv3mhttjyreh77p5qspqysq2q2laenqq/0101010101010101010101010101010101010101010101010101010101010101/0/996
Offer asks for up to 1000msat every 10 days, first period being 1 Jan 2021 (you can start at any period though), but you can pay 1 hour early, or up to 60 seconds into the period
Created by command: lightning-cli offer amount=1000msat description="1000msat every 10 days, from 1-Jan-2021, pay 1hr before to 60 seconds late" issuer="rusty.ozlabs.org" recurrence=10days recurrence_base=$(date +%s -d 2021-01-01) recurrence_paywindow=-3600+60
- offer_id
-
- bolt12
- lno1pqpq86q2fgcnqvpsd4ekzapqv4mx2uneyqcnqgryv9uhxtpqveex7mfqxyk55ctw95erqv339ss8qcteyqcksu3qvfjkvmmjv5s8gmeqxcczqum9vdhkuernypkxzar9zgg8yatnw3ujumm6d3skyuewdaexw93pqglnyxw6q0hzngfdusg8umzuxe8kquuz7pjl90ldj8wadwgs0xlmcxszqy9pcpsqqq8pqqpuyqzszhlwvcqq (decode)
- QR code:
-
Offer asks for up to 1000msat every 10 days, first period being 1 Jan 2021 (you can start at any period though), but you pay a percentage of the 10 days remaining (you can pay up to 10 days before)
Created by command: lightning-cli offer amount=1000msat description="1000msat every 10 days, from 1-Jan-2021, pro-rata" issuer="rusty.ozlabs.org" recurrence=10days recurrence_base=$(date +%s -d 2021-01-01) recurrence_paywindow=-864000+864000%
- offer_id
-
- bolt12
- lno1pqpq86q2xycnqvpsd4ekzapqv4mx2uneyqcnqgryv9uhxtpqveex7mfqxyk55ctw95erqv339ss8qun094exzarpzgg8yatnw3ujumm6d3skyuewdaexw93pqglnyxw6q0hzngfdusg8umzuxe8kquuz7pjl90ldj8wadwgs0xlmcxszqy9pczqqp5hsqqgd9uqzqpgptlhxvqq (decode)
- QR code:
-
Offer asks for up to $10 USD every day
Created by command: lightning-cli offer amount=10USD description="10USD every day" issuer="rusty.ozlabs.org" recurrence=1day
- offer_id
-
- bolt12
- lno1qcp4256ypqpq86q2pucnq42ngssx2an9wfujqerp0yfpqun4wd68jtn00fkxzcnn9ehhyeckyypr7vsemgp7u2dp9hjpqlnvtsmy7crnstcxtu4lakgam44ezpuml0q6qgqsz (decode)
- QR code:
-