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 1204 days, so you can fetch your first invoice, using that super-secret payerkey of 010101...01:
/fetchinvoicerecurring/lno1pqqkgz3zxycrqmtnv96zqetkv4e8jgryv9ujcgrxwfhk6gp3949xzm3dxgcryvgjzpe82um50yhx77nvv938xtn0wfn3vggz8uepnksrac56zt0yzplxchpkfas88qhsvhetlmv3mhttjyreh77p5qspqysq2q2laenqq/0101010101010101010101010101010101010101010101010101010101010101/0/1204

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: