Official registry for vetted LNbits extensions

To submit an extension to this registry add your manifest into the extensions.json file in this repository.

Only submit fully working extensions, the review process is not intended to improve the extension code.

Do not add dependencies, LNbits has plenty of dependencies you can use.

The easier an extension is to review, the quicker the review process will be.

The file MUST use the extensions format:

{
    "id": "gerty",
    "repo": "https://github.com/lnbits/gerty",
    "name": "Gerty",
    "version": "0.1.2",
    "short_description": "Your bitcoin assistant",
    "icon": "https://raw.githubusercontent.com/lnbits/gerty/main/static/gerty.png",
    "archive": "https://github.com/lnbits/gerty/archive/refs/tags/0.1.2.zip",
    "hash": "baff0b6162ffb65cc0b4c721a4aa40a7d3d48acd55a3e344cba3eb1d35cf2074"
},

For an exensions local manifest.json use the repos format:

{
    "repos": [
        {
            "id": "gerty",
            "organisation": "lnbits",
            "repository": "gerty"
        }
    ]
}

It is possible for developers to require a payment for their extensions. In order to do so an extension release must have this field:

   "pay_link": "# payment URL"

Example:

{
    "id": "testext",
    "repo": "https://github.com/lnbits/testext",
    "name": "Test Extension",
    "version": "0.5",
    "short_description": "Private Test Extension",
    "icon": "https://raw.githubusercontent.com/lnbits/example/main/static/bitcoin-extension.png",
    "archive": "https://demo.lnbits.com/paywall/download/m2FVCFktJzMcGKXTaHbyhi",
    "pay_link": "https://demo.lnbits.com/paywall/api/v1/paywalls/invoice/m2FVCFktJzMcGKXTaHbyhi",
    "hash": "455527407fcfdc5e8aba93f16802d1083d36dcdfdde829f919cee07420791d61"
}

The Paywall LNbits Extension can be used to serve the extension zip file.

If you do not want to use the Paywall LNbits Extension to server your extension, but instead you want to use your own paywall, then the pay_link endpoint must follow these specifications:

GET pay_link

{
    "amount": 5
}

GET pay_link?amount=5

{
    "payment_hash": "04c33f37d01aff...fd7c407a",
    "payment_request": "lnbc50n1pju...n7h8gucqn2cgau"
}

WS pay_link/{payment_hash}

{"paid": true|false}

In order to download the file one must add the payment_hash and an version (optional) query parameters to the archive URL. Eg:

GET https://demo.lnbits.com/paywall/download/m2FVCFktJzMcGKXTaHbyhi?payment_hash=3bf...7ec&version=v0.1

$ wget -O - https://github.com/lnbits/withdraw/archive/refs/tags/0.1.1.zip 2> /dev/null | sha256sum | cut -d" " -f 1
baff0b6162ffb65cc0b4c721a4aa40a7d3d48acd55a3e344cba3eb1d35cf2074

• documentation, tests and other type of files should not be included in the zip archive generated when a GitHub release is created
• keep the README.md and LICENSE files in the zip as these are required!
• in order to exclude these files one must:
  • create a .gitattributes file (on the top level of the repo)
  • add a line for the ignored files/dirs: tests/ export-ignore

• after editing the manifest.json file in this repo you should run python3 check.py as a sanity check
• you can run python3 check.py foo bar only to run sanity checks on extensions named foo and bar

cloning all extensions into extensions dir. requires jq to be installed.

sh util.sh clone

pulling all extensions from extensions dir

sh util.sh pull

get LNbits env variables for all extensions

sh util.sh env

update a extension in extensions.json with id and version

sh util.sh update_extension example v0.4.2

this uses a github workflow like this: https://github.com/lnbits/example/blob/main/.github/workflows/release.yml

make install-jmeter

make sure LNbits is running and start the mirror server

make start-mirror-server

make test