Skip to content

rodasmith/block-and-jerrys

 
 

Repository files navigation

Block and Jerry's

LAUNCHING SOON: Block and Jerry's is coming to the Bitcoin mainnet March 7th.

Background

Motivated by Starblocks, I wanted to offer the world a dessert to compliment their Testnet coffee. Using Lighting Lab's LND as my gateway to the Lightning Network, I built a React front end to generate invoices for ice cream on top of my LND node.

450 testnet cones later, it's time for the big leagues.

Big Leagues

Disclaimer

This is the pre-alpha version... nuff said.

Getting Started

Prerequisites

export POSTGRES_URI="postgresql://[USERNAME]:[PASSWORD]@localhost/icecream"
export TWILIO_SID=[TWILIO SID]
export TWILIO_AUTH_TOKEN=[TWILIO AUTHORIZATION TOKEN]
export TWILIO_PHONE_NUMBER=[TWILIO PHONE NUMBER]

Setup

  1. Start btcd on simnet or testnet
btcd --testnet --txindex --rpcuser=REPLACEME --rpcpass=REPLACEME
  1. Once btcd is synced, start up lnd
lnd --bitcoin.active --bitcoin.testnet --debuglevel=debug --btcd.rpcuser=kek --btcd.rpcpass=kek --externalip=X.X.X.X
  1. Unlock lnd (or create if this is your first time)
lncli --rpcserver=localhost:10009 create
  1. Create a Postgres database called icecream and create a user with the appropriate privileges
  2. Save all the environment variables from above
  3. Clone Block and Jerry's
cd ~
git clone https://github.com/BlockAndJerrys/blockandjerrys.git
cd blockandjerrys
  1. Copy tls.cert from ~/Library/Application\ Support/Lnd/tls.cert to backend/utils/lightning/tls.cert.
  2. Install dependencies
yarn
  1. Setup DB
yarn sync
  1. Start the web app
yarn start
  1. Start the server Open a new terminal
cd ~/blockandjerrys
yarn testServer // For UI only
yarn server // For real server w/ LND and postgres

Architecture

If you are interested in the architecture of this application, check it out here.

v1 Testnet Release Media:

A how to Medium article.

A demo on Twitter.

A Note to the Community

First of all, thanks for helping out! Block and Jerry's goal is to create a Hands on Bitcoin for the masses, introducing the average Joe to the incredible potential of the Lightning Network. This would not be possible without your help and support.

Why Contribute?

Besides the above, we offer a few tangible incentives for contributing:

  1. A Block and Jerry's sticker of your choice
  2. A mention on the about us community contributors page

About

React Webapp using LND to serve ice cream to the Bitcoin Mainnet

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages

  • JavaScript 93.0%
  • CSS 4.0%
  • HTML 3.0%