{"id":19178071,"url":"https://github.com/cmdruid/lightning-tip-jar","last_synced_at":"2025-05-07T20:43:39.186Z","repository":{"id":78116412,"uuid":"497438160","full_name":"cmdruid/lightning-tip-jar","owner":"cmdruid","description":"A digital tip jar for collecting satoshis, using LNURL.","archived":false,"fork":false,"pushed_at":"2022-07-30T06:28:19.000Z","size":359,"stargazers_count":4,"open_issues_count":8,"forks_count":1,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-05-07T20:43:34.866Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://sats4.tips","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/cmdruid.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,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-05-28T22:15:43.000Z","updated_at":"2023-06-29T11:07:52.000Z","dependencies_parsed_at":"2023-02-26T12:15:47.041Z","dependency_job_id":null,"html_url":"https://github.com/cmdruid/lightning-tip-jar","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmdruid%2Flightning-tip-jar","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmdruid%2Flightning-tip-jar/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmdruid%2Flightning-tip-jar/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cmdruid%2Flightning-tip-jar/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cmdruid","download_url":"https://codeload.github.com/cmdruid/lightning-tip-jar/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252954140,"owners_count":21830894,"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-11-09T10:36:52.582Z","updated_at":"2025-05-07T20:43:39.164Z","avatar_url":"https://github.com/cmdruid.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# sats4tips\nYour own personalized space for collecting tips in Bitcoin.\n\nThis project aims to be a demonstration of utilizing the Lightning network within a web application. Feel free to re-use any code that you find!\n\n## Features\n\n* Lightning Login (Authentication).\n* Static Pay Requests.\n* Payment Withdraws.\n* Individual custodial accounts.\n* ~~Personal Payment Addresses (coming soon!)~~\n\n## Tech Stack\n```\nLightning Server  : LND (github link)\nAccount Managment : Lnbits (github link)\nApplication Host  : Voltage (site link)\nWebserver Host    : Vercel (site link)\nWeb Framework     : NextJS (site link)\n```\n## Packages\n```\nreact        : React framework.\nnext         : Next framework (uses React).\niron-session : Encrypted client-side sessions.\nsecp256k1    : For secp256k1 signatures.\nbech32       : For bech32 (lnurl) encoding.\nmoment       : For extra time/date features.\nqrcode       : For generating QR codes.\nswr          : For managing fetch / caching responses.\n```\n## Getting Started\n\nBefore getting started, you will need to setup an `.env.local` file with the following:\n\n```\nSECRET_KEY=\u003cA random base64url encoded string. Encrypts server-side data.\u003e\nSESSION_NAME=\u003cReference name of your site. For iron-session cookie.\u003e\nSESSION_KEY=\u003cA random base64url encoded string. Encrypts cookie data.\u003e\nLNBITS_URL=\u003cURL endpoint of your lnbits instance.\u003e\nLNBITS_KEY=\u003cMaster user key of your lnbits instance.\u003e\nMONGO_DBNAME=\u003cName of your project's mongo database.\u003e\nMONGO_DBURI=\u003cFull mongoURI pointing towards your MongoDB instance.\u003e\n```\n\nFrom there, you can start with `yarn` or `npm i` in order to install all package dependencies.\n\nOnce that is complete, you should be able to start a local instance of the project using `yarn dev` or `npm dev`.\n\nOpen [http://localhost:3000](http://localhost:3000) with your browser to see the result!\n\nIf you would like to deploy to vercel, you can install their client using `npm i -g vercel`, then follow the prompts to setup an account and launch a preview build of your project.\n\n## Learn More\n\nTo learn more about the technology behind this project, take a look at the following resources:\n\n- LND documentation\n\n- LNBits documentation\n\n- Voltage documentation\n\n- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.\n- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.\n\nYou can check out [the Next.js GitHub repository](https://github.com/vercel/next.js/) - your feedback and contributions are welcome!\n\n## Deploy on Vercel\n\nThe easiest way to deploy your app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template\u0026filter=next.js\u0026utm_source=create-next-app\u0026utm_campaign=create-next-app-readme) from the creators of Next.js.\n\nCheck out our [Next.js deployment documentation](https://nextjs.org/docs/deployment) for more details.\n\n## Contribution\n\nFeel free to fork this project and contribute to the source code! We are currently still in the process of setting up tests for all the features, and could use some help!\n\n## Resources\n\n**LNUrl Reference Specification**  \nhttps://github.com/fiatjaf/lnurl-rfc\n\n**LNUrl Playground**  \nhttps://lnurl.fiatjaf.com\n\n**LNUrl Decoder** \nhttps://lnurl.fiatjaf.com/codec\n\n**Lightning Invoice Decoder**  \nhttps://lightningdecoder.com\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmdruid%2Flightning-tip-jar","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcmdruid%2Flightning-tip-jar","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcmdruid%2Flightning-tip-jar/lists"}