Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/niftynei/basic

Code for the LARP miners, aka BASICs
https://github.com/niftynei/basic

base58btc bitcoin-education bitcon larp

Last synced: 2 months ago
JSON representation

Code for the LARP miners, aka BASICs

Awesome Lists containing this project

README

        

# BASIC - hardware modules for the Base58 World Famous LARP

This code is for the dual-purpose hash-finder and hash-verifier device used in the @base58btc
World Famous Bitcoin LARP.

It allows for a user to enter in a previous block hash, transaction commitment, time,
target, and nonce.

If a nonce is provided, the BASIC will show the blockhash produced by the inputs.

If the nonce is left empty or set to zero, the unit will begin hunting for a nonce
that will produce a blockhash underneath the given target value.

Once it finds a suitable nonce, it will display first the winning nonce. You can advance
the screen to the Blockhash that nonce hashes to with the `#` key.

Be sure to write down the winning nonce value before advancing to the Blockhash screen.

To enter a number, and advance to the next input: press the `#` key.

To erase a number: press the `*` key.

## Installing with WebInstaller

Thanks to @dni and @arcbtc we have a WebInstaller available for the LARP BASICs.

Go to [https://basic.lnbits.com/](https://basic.lnbits.com/) to install the latest
build on your own device!

Note: You'll need Chrome or a Chromium browser that supports the WebInstaller protocol.

### Credit/props

Ben Arc and the LNPoS project for the inital form factor, code, and 3D case + build instructions.

Stakamoto and the Houston Astrobits for discovering and building the initial set of BASICs for @base58btc

### Hardware needed

- Lilygo TTGO T-Display
- Keypad membrane (these big ones are easy to find, these smaller ones will be used for workshops by arcbtc).
- Angled male/male GPIO pins

### Arduino software install

- Download/install latest Arduino IDE
- Install ESP32 boards, using boards manager
- Copy these libraries into your Arduino IDE library folder
- Plug in T-Display, from _Tools>Board>ESP32 Boards_ select **TTGO LoRa32 OLED V1**

> _Note: If using MacOS, you will need the CP210x USB to UART Bridge VCP Drivers available here https://www.silabs.com/developers/usb-to-uart-bridge-vcp-drivers_