{"id":13666683,"url":"https://github.com/lnbits/boltz","last_synced_at":"2025-03-02T20:28:44.291Z","repository":{"id":73758097,"uuid":"594901253","full_name":"lnbits/boltz","owner":"lnbits","description":null,"archived":false,"fork":false,"pushed_at":"2024-11-29T07:58:03.000Z","size":368,"stargazers_count":3,"open_issues_count":6,"forks_count":3,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-19T11:03:22.296Z","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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-01-30T00:29:33.000Z","updated_at":"2024-10-30T06:56:57.000Z","dependencies_parsed_at":"2023-06-17T07:00:59.337Z","dependency_job_id":"6bd99d93-edad-43ff-a5c5-48556f8deb03","html_url":"https://github.com/lnbits/boltz","commit_stats":null,"previous_names":["lnbits/boltz"],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnbits%2Fboltz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnbits%2Fboltz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnbits%2Fboltz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lnbits%2Fboltz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lnbits","download_url":"https://codeload.github.com/lnbits/boltz/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240710058,"owners_count":19845039,"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":"2024-08-02T06:01:23.566Z","updated_at":"2025-03-02T20:28:44.265Z","avatar_url":"https://github.com/lnbits.png","language":"Python","funding_links":[],"categories":["Uncategorized"],"sub_categories":["Uncategorized"],"readme":"# LNbits Extension for [Boltz](https://boltz.exchange)\n\nSwap **IN** and **OUT** of the **Lightning Network** while remaining in full control of your bitcoin at all times.\n\n- [Boltz CLN](https://amboss.space/node/02d96eadea3d780104449aca5c93461ce67c1564e2e1d73225fa67dd3b997a6018) | [Boltz LND](https://amboss.space/node/026165850492521f4ac8abd9bd8088123446d126f648ca35e60f88177dc149ceb2)\n- [Documentation](https://docs.boltz.exchange)\n- [Discord](https://discord.com/invite/QBvZGcW)\n- [X/Twitter](https://twitter.com/Boltzhq)\n\n# Usage\n\nThis extension lets you swap in (chain -\u003e lightning), swap out (lightning -\u003e chain) and, in the case of failure, refund your bitcoin. Supported chains are [liquid](https://liquid.net/) and the [bitcoin mainchain](https://bitcoin.org/).\n\n## Swap In (Onchain -\u003e Lightning)\n\n1. Click on the \"Swap (IN)\" button to open the following dialog, select a wallet, choose an amount within the min-max range and choose an onchain address for your refund in case the swap fails after you already sent onchain bitcoin.\n\n---\n\n## ![Create Swap](https://imgur.com/OyOh3Nm.png)\n\n2. After you confirmed, the following dialog with a QR code for the onchain transaction, onchain- address and amount, will pop up.\n\n---\n\n## ![Pay Onchain TX](https://imgur.com/r2UhwCY.png)\n\n3. After you sent the exact amount of onchain bitcoin to this address, Boltz will pay your lightning invoice and the sats will appear in your wallet.\n\n### Refund of Swap In (Onchain -\u003e Lightning)\n\nIf a Swap In fails, you can refund your bitcoin after the timeout blockheight was reached. A swap can fail because Boltz, for instance, can't find a route to your lightning node or wallet. In case that happens, there is an info icon in the Swap (In) list which opens following dialog:\n\n---\n\n## ![Refund](https://imgur.com/pN81ltf.png)\n\nWhen the timeout blockheight was reached you can either press refund and lnbits will do the refunding to the address you specified when creating the swap OR you can download the refund file so you can manually refund your onchain bitcoin to a different address via the [boltz.exchange website](https://boltz.exchange/refund). If you need help or have questions you can contact us in the [LNbits Telegram](https://t.me/lnbits) or the Boltz Team on [Discord](https://discord.gg/d6EK85KK). In a recent update we added anl _automated check_; lnbits now checks every 15 minutes if it can refund your failed swap.\n\n## Swap Out (Lightning -\u003e Onchain)\n\n1. Click on the \"Swap (OUT)\" button to open the following dialog, select a wallet, choose an amount within the min-max range and choose an onchain address to receive your funds on. Instant settlement: means that LNbits will create the onchain claim transaction if it sees Boltz's lockup transaction in the mempool, but it is not confirmed yet. For urgent swaps we advise to leave this enabled.\n\n---\n\n## ![Reverse Swap](https://imgur.com/UEAPpbs.png)\n\nIf a Swap Out fails, no further action is required, the lightning payment just \"bounces back\".\n\n# Development\n\n## manual testcases for boltz startup checks\n\nA. normal swaps\n\n1. test: create -\u003e kill -\u003e start -\u003e startup invoice listeners -\u003e pay onchain funds -\u003e should complete\n2. test: create -\u003e kill -\u003e pay onchain funds -\u003e mine block -\u003e start -\u003e startup check -\u003e should complete\n3. test: create -\u003e kill -\u003e mine blocks and hit timeout -\u003e start -\u003e should go timeout/failed\n4. test: create -\u003e kill -\u003e pay to less onchain funds -\u003e mine blocks hit timeout -\u003e start lnbits -\u003e should be refunded\n\nB. reverse swaps\n\n1. test: create instant -\u003e kill -\u003e boltz does lockup -\u003e not confirmed -\u003e start lnbits -\u003e should claim/complete\n2. test: create -\u003e kill -\u003e boltz does lockup -\u003e not confirmed -\u003e start lnbits -\u003e mine blocks -\u003e should claim/complete\n3. test: create -\u003e kill -\u003e boltz does lockup -\u003e confirmed -\u003e start lnbits -\u003e should claim/complete\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flnbits%2Fboltz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flnbits%2Fboltz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flnbits%2Fboltz/lists"}