{"id":13499380,"url":"https://github.com/interledger-deprecated/ilp-lightning-demo","last_synced_at":"2026-02-01T09:17:47.180Z","repository":{"id":92526733,"uuid":"98879929","full_name":"interledger-deprecated/ilp-lightning-demo","owner":"interledger-deprecated","description":"Demo sending payments between Bitcoin and Litecoin Lightning Networks using Interledger","archived":false,"fork":false,"pushed_at":"2017-08-02T09:33:53.000Z","size":26,"stargazers_count":17,"open_issues_count":3,"forks_count":8,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-08-06T01:18:52.379Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/interledger-deprecated.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2017-07-31T11:06:28.000Z","updated_at":"2024-06-26T16:04:12.000Z","dependencies_parsed_at":null,"dependency_job_id":"be090dfe-291f-4afc-83fc-b61cda43068b","html_url":"https://github.com/interledger-deprecated/ilp-lightning-demo","commit_stats":null,"previous_names":["interledgerjs/ilp-lightning-demo"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interledger-deprecated%2Filp-lightning-demo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interledger-deprecated%2Filp-lightning-demo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interledger-deprecated%2Filp-lightning-demo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interledger-deprecated%2Filp-lightning-demo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/interledger-deprecated","download_url":"https://codeload.github.com/interledger-deprecated/ilp-lightning-demo/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":246140565,"owners_count":20729797,"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-07-31T22:00:32.616Z","updated_at":"2026-02-01T09:17:47.137Z","avatar_url":"https://github.com/interledger-deprecated.png","language":"JavaScript","funding_links":[],"categories":["Developer Resources"],"sub_categories":["Example Projects"],"readme":"# BTC -\u003e LTC Lightning Demo\n\u003e Send payments between Lightning Networks using Interledger\n\nThis demo sends payments between instances of the [Lightning Network](https://lightning.network) on Bitcoin and Litecoin using an [Interledger Connector](https://github.com/interledgerjs/ilp-connector) and the [Lightning Ledger Plugin](https://github.com/interledgerjs/ilp-plugin-lightning).\n\n## Prerequisites\n\n- Node.js \u003e= v7.10.0\n- Docker (only to run local Lightning nodes)\n\n## Running the Demo\n\n### 0. Set Up Lightning Networks\n\n_You can skip this step if you already have 2 lightning nodes setup on the Bitcoin Lightning Network and 2 on the Litecoin Lightning Network._\n\nThe following uses BitFury's [`simple-simnet`](https://github.com/BitfuryLightning/simple-simnet) to run local testnets and Lightning daemons for both Bitcoin and Litecoin.\n\nIn one terminal run:\n```sh\ngit clone https://github.com/BitfuryLightning/simple-simnet\ncd simple-simnet\n./bitcoin/build.sh\n./bitcoin/start.sh\n```\n\nIn another terminal run:\n```sh\ncd simple-simnet\n./litecoin/build.sh\n./litecoin/start.sh\n```\n\n### 1. Run an Interledger Connector\n\nThis will run a connector and automatically configure it to connect to the `lnd` nodes started in the previous step.\n\nIn a new terminal run:\n```sh\ngit clone https://github.com/interledgerjs/ilp-lightning-demo\ncd ilp-lightning-demo\nnpm install\nnode run-connector.js\n```\n\nTo configure the connector to use different `lnd` nodes, set the environment variables `BITCOIN_LND_1`, `BITCOIN_LND_2`, `LITECOIN_LND_1`, `LITECOIN_LND_2` to those `lnd` nodes' RPC endpoints.\n\n### 2. Send a Payment\n\nFrom another terminal run the following to send a payment from one of the Bitcoin `lnd` nodes to a Litecoin `lnd` node.\n\n```sh\nnode send.js\n```\n\n(Run with the environment variable `DEBUG=ilp*` to see additional details of what is happening.)\n\n## How it Works\n\nInterledger is a protocol for connecting payment networks or _ledgers_.\n\n_Connectors_ use [ledger plugins](https://interledger.org/rfcs/0004-ledger-plugin-interface/) to connect to different types of ledgers. This demo uses [`ilp-plugin-lightning`](https://github.com/interledgerjs/ilp-plugin-lightning) to send payments through instances of the Lightning Network.\n\nThe [Interledger packet](https://interledger.org/rfcs/0003-interledger-protocol/) is attached to transfers across individual ledgers and instructs connectors where to forward payments. [Hashed-Timelock _Agreements_ (HTLAs)](https://github.com/interledger/rfcs/blob/master/0022-hashed-timelock-agreements/0022-hashed-timelock-agreements.md), a generalization of HTLCs, are used to secure Interledger payments.\n\nFor more information on Interledger, see [interledger.org](https://interledger.org) or the [Interledger RFCs](https://github.com/interledger/rfcs) for the protocol specs.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finterledger-deprecated%2Filp-lightning-demo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finterledger-deprecated%2Filp-lightning-demo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finterledger-deprecated%2Filp-lightning-demo/lists"}