https://github.com/wbobeirne/run-lnd-store
A simple site for selling shirts with Lightning
https://github.com/wbobeirne/run-lnd-store
lightning lightning-network lnd webln
Last synced: 7 days ago
JSON representation
A simple site for selling shirts with Lightning
- Host: GitHub
- URL: https://github.com/wbobeirne/run-lnd-store
- Owner: wbobeirne
- Created: 2019-03-29T21:48:11.000Z (over 6 years ago)
- Default Branch: master
- Last Pushed: 2020-10-01T16:21:04.000Z (about 5 years ago)
- Last Synced: 2025-08-05T08:46:30.802Z (2 months ago)
- Topics: lightning, lightning-network, lnd, webln
- Language: TypeScript
- Homepage: http://runlnd.wbobeirne.com
- Size: 713 KB
- Stars: 3
- Watchers: 2
- Forks: 1
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# RUN LND
This is a small side project to sell a limited edition run of some dope shirts, while testing out proof of node ownership with message signing.
This project makes no attempt to be reusable as an eCommerce platform, nor as a gold standard of code quality. It was purely made for fun, and to potentially be used by others as an example of some interactions with an LND node on a production site.
## Development
You need to have `node >= 8` installed, an LND node with the GRPC API enabled and exposed, and a PostgreSQL database.
* Run `yarn` to install dependencies
* Run `cp .env.example .env` and configure the environement variables
* Run `yarn dev` to have nodemon run and watch for changes
Changes will automatically restart the server and recompile the client code, but there's no hot reloading here. Sorry folks, I'm too lazy.
## Production
* Run `yarn build` to build compiled production code & assets
* Run `yarn start` to run said code
## FAQ
### Why not use invoices for proof of node, instead of message signing?
A signed message not only proves that you're running you're node, but that you're running LND. At the time of writing, LND is the only node implementation with message signing, so it was a good proxy for ensuring that the node was an LND node, and not another implementation. And if you're gonna be repping a RUN LND shirt, you'd best be running LND.
### Why not use the admin macaroon?
In case the server hosting the site is compromised, the worst someone could do without the admin macaroon is DDOS your node, or generate an annoyingly large number of invoices. It's great that LND allows for you to have a site like this that only needs to accept money without exposing your funds.
## Shoutouts
* To [Lightning Labs](https://github.com/lightninglabs) and all of the contributors on LND, it's a mighty fine piece of software
* To the folks at [Radar ION](https://ion.radar.tech) for writing a [damn good typed RPC library](https://github.com/RadarTech/lnrpc) for LND
* To [@jamesob](https://github.com/jamesob) and [@mikeob](https://github.com/mikeob) for helping test and catching some bugs