{"id":13499205,"url":"https://github.com/benharold/voltage","last_synced_at":"2025-03-29T04:30:55.770Z","repository":{"id":147397072,"uuid":"119908646","full_name":"benharold/voltage","owner":"benharold","description":"Voltage is a macOS GUI for c-lightning","archived":false,"fork":false,"pushed_at":"2018-08-24T15:49:12.000Z","size":8036,"stargazers_count":28,"open_issues_count":0,"forks_count":1,"subscribers_count":4,"default_branch":"master","last_synced_at":"2024-10-31T17:39:16.608Z","etag":null,"topics":["bitcoin","lightning-network"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/benharold.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","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":"2018-02-02T00:02:19.000Z","updated_at":"2023-07-15T06:12:01.000Z","dependencies_parsed_at":"2023-05-22T12:00:19.894Z","dependency_job_id":null,"html_url":"https://github.com/benharold/voltage","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benharold%2Fvoltage","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benharold%2Fvoltage/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benharold%2Fvoltage/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benharold%2Fvoltage/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/benharold","download_url":"https://codeload.github.com/benharold/voltage/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":["bitcoin","lightning-network"],"created_at":"2024-07-31T22:00:30.813Z","updated_at":"2025-03-29T04:30:54.186Z","avatar_url":"https://github.com/benharold.png","language":"Shell","readme":"# Voltage\n\nThe only wallet with a HODL button.\n\nVoltage is a GUI for `c-lightning` on macOS.\n\nIf you've got a `c-lightning` node and a Mac, then this project *might* be of remote interest to **you**!\n\n## Current Status\n\nRight now Voltage has six tabs:\n\n- Money - Send and receieve on-chain Bitcoin, create and pay lightning invoices\n- Invoices - Corresponds to `lightning-cli listinvoices`\n- Payments - Corresponds to `lightning-cli listpayments`\n- Peers - Corresponds to `lightning-cli listpeers`\n- Channels - Corresponds to `lightning-cli listchannels`\n- Info - Corresponds to `lightning-cli getinfo`\n\nPlease be aware that there are no confirmations when you receive testnet Bitcoin. Just hit the reload button after the next block is found and your balances will be updated.\n\n### Short Term Goals\n\n- [X] Receive on-chain payments\n- [X] Send on-chain payments\n- [ ] Open lightning channels\n- [ ] Close lightning channels\n- [X] Create lightning invoices\n- [X] Pay lightning invoices\n- [X] Make all of the lists sortable\n- [ ] Integrate [CoreBitcoin](https://github.com/oleganza/CoreBitcoin)\n- [X] Getinfo from the \"About Voltage\" menu item maybe?\n- [X] Make RPC calls in a background thread\n- [X] Use `NotificationCenter` to handle RPC errors\n- [ ] Pre-load all tables when application launches (meh)\n- [X] Pre-load receiving address for \"Get Money\" button\n- [ ] Validate lightning invoices\n- [ ] ~~Use a single socket instance for all RPC calls~~ bad idea\n- [ ] Remove `Faker` as a dependency in the Voltage target. It should only be required in tests.\n- [ ] Figure out code signing\n- [ ] Store transaction data locally (meh)\n\n## Usage\n\n### Local\n\nVoltage requires an active `c-lightning` node. If you are running `c-lightning` on your Mac, the default settings should work for you.\n\nIf you are using a non-standard data directory for `c-lightning`, you can use the preferences pane to change the socket path.\n\n### Remote\n\nIf you're like me and you don't have  `bitcoind` and/or `c-lightning` on your laptop, fret not! `c-lightning` can be operated remotely over an SSH tunnel.\n\nIf you have public key authentication setup between your local machine and your remote `c-lightning` server, you can configure Voltage to connect to your remote node. Just go to \"Voltage\" -\u003e \"Preferences...\" and click on \"Remote\". Then enter the necessary information and hit \"Test Connection.\"\n\nThere are still some bugs to work out. If you have problems, just setup an `ssh` tunnel to your node's socket manually.\n\nThe following command will tunnel to the socket located at `/home/user/.lightning/lightning-rpc` on your remote machine and link to a new socket on your local machine at `~/.lightning/lightning-rpc`:\n\n    ssh -NL ~/.lightning/lightning-rpc:/home/user/.lightning/lightning-rpc user@example.com\n\nOnce you've established the socket, Voltage should work. If you setup the socket in a location other than `~/.lightning/lightning-rpc` you'll need to update the \"Socket Path\" setting in the preferences pane.\n\n## Errors\n\nCommon errors include:\n\n### Error code: -9988(0x-2704), No such file or directory\n\nThe path to the `c-lightning` socket as defined in Preferences does not lead to a file.\n\n### Error code: -9988(0x-2704), Connection refused\n\nVoltage found the socket, but the connection was refused. This usually happens if you are using an ssh tunnel to connect to `c-lightning` and the session gets disconnected.\n\n### Voltage.SocketError.no_response\n\nThe RPC query was sent, but zero bytes of data came back over the wire. Check to make sure `c-lightning` is running.\n\n### SSH Tunnell Error\n\n`channel 1: open failed: connect failed: open failed` - double check your \"Remote Socket Path\"\n\n## Contributing\n\nPull requests are welcome! Criticism encouraged!\n\n## License\n\n[BSD 3-Clause](LICENSE.md)\n","funding_links":[],"categories":["Applications"],"sub_categories":["Desktop Interfaces"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenharold%2Fvoltage","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenharold%2Fvoltage","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenharold%2Fvoltage/lists"}