{"id":25891642,"url":"https://github.com/lnbits/bolt11","last_synced_at":"2026-03-05T04:03:34.957Z","repository":{"id":55024891,"uuid":"228003671","full_name":"lnbits/bolt11","owner":"lnbits","description":"Lightning BOLT11 implementation for Python.","archived":false,"fork":false,"pushed_at":"2026-01-28T11:11:51.000Z","size":310,"stargazers_count":12,"open_issues_count":1,"forks_count":14,"subscribers_count":3,"default_branch":"main","last_synced_at":"2026-01-29T00:58:23.391Z","etag":null,"topics":["bolt11","lightning-network","python-package"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/bolt11","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lnbits.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-12-14T10:23:12.000Z","updated_at":"2026-01-28T11:10:40.000Z","dependencies_parsed_at":"2023-11-17T01:09:58.479Z","dependency_job_id":"85816461-936b-4905-80af-fe283b2c9585","html_url":"https://github.com/lnbits/bolt11","commit_stats":{"total_commits":45,"total_committers":5,"mean_commits":9.0,"dds":0.1333333333333333,"last_synced_commit":"fb91c4fce464813598e7303160a91eeaaf165fef"},"previous_names":["python-ln/bolt11"],"tags_count":15,"template":false,"template_full_name":null,"purl":"pkg:github/lnbits/bolt11","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnbits%2Fbolt11","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnbits%2Fbolt11/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnbits%2Fbolt11/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnbits%2Fbolt11/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lnbits","download_url":"https://codeload.github.com/lnbits/bolt11/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnbits%2Fbolt11/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30109077,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-05T03:40:26.266Z","status":"ssl_error","status_checked_at":"2026-03-05T03:39:15.902Z","response_time":93,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["bolt11","lightning-network","python-package"],"created_at":"2025-03-02T20:28:56.390Z","updated_at":"2026-03-05T04:03:34.939Z","avatar_url":"https://github.com/lnbits.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"Lightning BOLT11 utils\n======================\n\n[![github-tests-badge]][github-tests]\n[![github-mypy-badge]][github-mypy]\n[![codecov-badge]][codecov]\n[![pypi-badge]][pypi]\n[![pypi-versions-badge]][pypi]\n[![license-badge]](LICENSE)\n\n\nThis is an implementation of the Lightning BOLT11 specification,\nbased on previous work by [Rusty Russell][rusty], the [Electrum Wallet team][electrum],\nand the LNbits bolt11 helpers created by [@fiatjaf][fiatjaf].\n\n\n[github-tests]: https://github.com/lnbits/bolt11/actions?query=workflow%3A%22tests%22\n[github-tests-badge]: https://github.com/lnbits/bolt11/workflows/tests/badge.svg\n[github-mypy]: https://github.com/lnbits/bolt11/actions?query=workflow%3A%22mypy%22\n[github-mypy-badge]: https://github.com/lnbits/bolt11/workflows/mypy/badge.svg\n[codecov]: https://codecov.io/gh/lnbits/bolt11\n[codecov-badge]: https://codecov.io/gh/lnbits/bolt11/branch/master/graph/badge.svg\n[pypi]: https://pypi.org/project/bolt11/\n[pypi-badge]: https://badge.fury.io/py/bolt11.svg\n[pypi-versions-badge]: https://img.shields.io/pypi/pyversions/bolt11.svg\n[license-badge]: https://img.shields.io/badge/license-MIT-blue.svg\n\n[electrum]: https://github.com/spesmilo/electrum\n[fiatjaf]: https://github.com/fiatjaf\n[rusty]: https://github.com/rustyrussell/lightning-payencode\n\n\n### resources\n* [Bolt11 Spec](https://github.com/lightning/bolts/blob/master/11-payment-encoding.md )\n* [bolt11.org](https://www.bolt11.org/)\n* [lightningdecoder](https://lightningdecoder.com/)\n\n\n### installing\n```console\n$ git clone https://github.com/lnbits/bolt11\n$ cd bolt11\n$ uv sync\n```\n\n### running CLI\n```console\n$ uv run bolt11 --help\n$ uv run bolt11 decode\n```\n\n### run all checks and tests\n```console\n$ make\n```\n\n### using pre-commit as git hook\n```console\n$ uv run pre-commit install\n```\n\n\n### running CLI\n```console\n$ uv run bolt11 --help\n```\n\n### running CLI decode\n```\n$ uv run bolt11 decode lnbc20m1pvjluez.....\n{\n  \"currency\": \"bc\",\n  \"amount\": 2000000000,\n  \"timestamp\": 1496314658,\n  \"signature\": \"6a6586db4e8f6d40e3a5bb92e4df5110c627e9ce493af237e20a046b4e86ea200178c59564ecf892f33a9558bf041b6ad2cb8292d7a6c351fbb7f2ae2d16b54e\",\n  \"description_hash\": \"3925b6f67e2c340036ed12093dd44e0368df1b6ea26c53dbe4811f58fd5db8c1\",\n  \"features\": {\n    \"var_onion_optin\": \"required\",\n    \"payment_secret\": \"required\"\n  },\n  \"fallback\": \"1RustyRX2oai4EYYDpQGWvEL62BBGqN9T\",\n  \"route_hints\": [\n    {\n      \"public_key\": \"029e03a901b85534ff1e92c43c74431f7ce72046060fcf7a95c37e148f78c77255\",\n      \"short_channel_id\": \"66051x263430x1800\",\n      \"base_fee\": 1,\n      \"ppm_fee\": 20,\n      \"cltv_expiry_delta\": 3\n    },\n    {\n      \"public_key\": \"039e03a901b85534ff1e92c43c74431f7ce72046060fcf7a95c37e148f78c77255\",\n      \"short_channel_id\": \"197637x395016x2314\",\n      \"base_fee\": 2,\n      \"ppm_fee\": 30,\n      \"cltv_expiry_delta\": 4\n    }\n  ],\n  \"min_final_cltv_expiry\": 9,\n  \"payment_hash\": \"0001020304050607080900010203040506070809000102030405060708090102\",\n  \"payment_secret\": \"1111111111111111111111111111111111111111111111111111111111111111\",\n  \"payee\": \"03e7156ae33b0a208d0744199163177e909e80176e55d97a2f221ede0f934dd9ad\"\n}\n```\n\n### running CLI encode\n```\n$ uv run bolt11 encode '{\n  \"currency\": \"bc\",\n  \"amount_msat\": 1000,\n  \"date\": 1590000000,\n  \"payment_hash\": \"0001020304050607080900010203040506070809000102030405060708090102\",\n  \"payment_secret\": \"1111111111111111111111111111111111111111111111111111111111111111\",\n  \"description\": \"description\"\n}' e126f68f7eafcc8b74f54d269fe206be715000f94dac067d1c04a8ca3b2db734\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flnbits%2Fbolt11","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flnbits%2Fbolt11","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flnbits%2Fbolt11/lists"}