{"id":25891653,"url":"https://github.com/lnbits/free-lnaddress-extension","last_synced_at":"2025-10-11T08:02:54.424Z","repository":{"id":65660084,"uuid":"596549349","full_name":"lnbits/free-lnaddress-extension","owner":"lnbits","description":"Give out free lnaddress","archived":false,"fork":false,"pushed_at":"2023-03-17T19:31:26.000Z","size":65,"stargazers_count":3,"open_issues_count":0,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-04-14T18:48:51.589Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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}},"created_at":"2023-02-02T12:35:55.000Z","updated_at":"2023-08-08T12:50:41.000Z","dependencies_parsed_at":"2023-02-18T01:01:02.454Z","dependency_job_id":null,"html_url":"https://github.com/lnbits/free-lnaddress-extension","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnbits%2Ffree-lnaddress-extension","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnbits%2Ffree-lnaddress-extension/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnbits%2Ffree-lnaddress-extension/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnbits%2Ffree-lnaddress-extension/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lnbits","download_url":"https://codeload.github.com/lnbits/free-lnaddress-extension/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241567351,"owners_count":19983477,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","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":[],"created_at":"2025-03-02T20:29:02.301Z","updated_at":"2025-10-11T08:02:49.397Z","avatar_url":"https://github.com/lnbits.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Free Lightning Address extends LNURLp\n\n## CAVEAT: Use this extension if your lnbits is older than February 2023, and be sure to read the release notes\n## If you have the latest Lnbits, just use the new LNURLp extension\n\n- Basically extends Lnurlp functionality with [LN Addresses](https://lightningaddress.com/)\n- See also [LUD-16: Paying to static internet identifiers.](https://github.com/lnurl/luds/blob/luds/16.md)\n- The `\u003cusername\u003e` is limited to `a-z0-9-_.`.  Please note that this is way more strict than common email addresses as it allows fewer symbols and only lowercase characters.\n\n## Purpose and Contraints\n\n- This is an admin extension\n- This extension is for small projects, games, applications \n- This extensions is not meant for production or for high volume applications\n- No Cloudflare. No separate domain, uses the current LNBits domain only.\n- All LN addresses are free.\n- Users can add, delete or modify their LN Address. \n- LNaddress must be unique name per wallet that follows naming specification\n\n## Usage Notes\n\n**IMPORTANT: Edit your .env to be the following:**\n\n```\n# Disable extensions for all users, use \"all\" to disable all extensions\n# lnaddress (paid lightning address extension) and lnaddy (free lightning address extension)\n# cannot be used at the same time. To avoid conflict, one or the other must be disabled. \nLNBITS_DISABLED_EXTENSIONS=\"amilk, lnaddress\"\n```\n\n\n## Create a static QR code people can use to pay over Lightning Network\n\nLNURL is a range of lightning-network standards that allow us to use lightning-network differently. An LNURL-pay is a link that wallets use to fetch an invoice from a server on-demand. The link or QR code is fixed, but each time it is read by a compatible wallet a new invoice is issued by the service and sent to the wallet.\n\n[**Wallets supporting LNURL**](https://github.com/fiatjaf/awesome-lnurl#wallets)\n\n## Usage\n\n1. Create a Lightning Address with LNURLp (New Pay link)\\\n   ![create lnurlp](https://i.imgur.com/Ht7ds9e.png)\n\n   - select your wallets\n   - Pick a unique username for lightning address\n   - make a small description\n   - enter amount\n   - if _Fixed amount_ is unchecked you'll have the option to configure a Max and Min amount\n   - you can set the currency to something different than sats. For example if you choose EUR, the satoshi amount will be calculated when a user scans the LNURLp\n   - You can ask the user to send a comment that will be sent along with the payment (for example a comment to a blog post)\n   - Webhook URL allows to call an URL when the LNURLp is paid\n   - Success mesage, will send a message back to the user after a successful payment, for example a thank you note\n   - Success URL, will send back a clickable link to the user. Access to some hidden content, or a download link\n\n2. Use the shareable link or view the LNURLp you just created\n   ![demo](https://user-images.githubusercontent.com/73979971/216545379-9094141f-7fad-4b92-ab80-6901e8934d03.png)\n\n   \n   - you can now open your LNURLp and copy the LNURL, get the shareable link or print it\\\n     ![view lnurlp](https://i.imgur.com/4n41S7T.jpg)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flnbits%2Ffree-lnaddress-extension","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flnbits%2Ffree-lnaddress-extension","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flnbits%2Ffree-lnaddress-extension/lists"}