Build

Making your very own LightingPiggy is squealy easy. Here are the steps you need to follow:

Source the parts.
Create a wallet.
Flash the firmware.
Make a case and assemble the parts.

💡

IMPORTANT: This is not a toy. It contains small parts which could be a choking and ingestion hazard. There are also sharp edges. It should not be handled by children under 4 years of age. Assembly and use of this product is at your own risk. We take no responsibility for any losses that may be incurred.

1. Source the parts

Single Board Computer (SBC): LILYGO T5 V2.3.1 e-paper device with a 2.13 inch screen (DEPG0213BN) and a 9102 chip. Available direct from LILYGo or from resellers.

Rechargeable battery: Voltage: 3.7V Connector: JST 2pin 1.25mm. Available from...

Aliexpress 1200mAh.
MakerFocus 1000mAh. Note: The size of this battery 26 * 44 * 9 mm (1.02 * 1.73 * 0.35 inch) doesn't fit perfectly in the Genesis and Robotechy pig cases.

Case: One homemade case using materials of your choice.

Micro USB data cable: Available cheaply for bulk purchases from Aliexpress or Amazon if you don't have one lying around.

💡

IMPORTANT: Improper assembly and/or the use of improper/faulty batteries can present a fire hazard. We recommend using only high quality LiPo rechargeable batteries.

Before connecting the battery check the connector is correctly wired. The red wire needs to align with the positive "+" terminal, and the black wire needs to align with the negative "-" terminal. If the battery you have sourced has the polarity switched, it's possible to swop the wires by carefully lifting the plastic JST connecter retainers.

Note: The device can operate without a battery if powered via using the micro USB port.

Here's an image showing your piggy's controls:

2. Create a wallet in LNbits

LNbits is a versatile wallet and account management solution for the Lightning Network. It can be configured to work with a wide variety of funding sources, offering flexibility for different user needs. Built on top of the Lightning Network protocol, which itself operates on the Bitcoin protocol, LNbits seamlessly integrates with this new global financial system.

Here are three options for running LNbits, depending on your technical expertise and goals:

a) Running LNbits on your own hardware.

This option is ideal for users comfortable with the technical aspects of managing their own node and seeking a fully independent solution.

Pros

Complete self-sovereignty: You retain full control over your node and data.
Utilises your own hardware for maximum privacy and independence.

Cons

Difficult to set up for the purpose of connecting your LightingPiggy to interact with the outside world.
Ideally needs dedicated hardware, such as a Raspberry Pi or a compatible server, to operate effectively.

How: Install bitcoin, lightning and LNbits on your dedicated hardware device such as your own computer/server, Raspiblitz, Start 9 or Umbrel device. Please refer to the set-up and configuration instructions provided by your hardware node supplier.

b) Running LNbits on Someone Else’s Hardware While Retaining Custody of Your Funds. Recommended!

This setup strikes a balance between control and convenience and is ideal for those who want a simpler yet sovereign solution, with the added flexibility and power of a VPS. In fact, we use this configuration for our demo server.

Pros

Maintains full self-sovereignty over your funds.
Easier to set-up and maintain compared to running a node on your own hardware.

Cons

Requires some technical knowledge to configure.
Involves some additional fees (only a few sats) for a Virtual Private Server (VPS) and a Lightning Service Provider (LSP) for channel and liquidity management.

How: Check out this excellent guide from Ereignishorizont.

c) Using an LNbits Service Provider in the Cloud.

This is the quickest and easiest way to get started with LNbits. It's great for beginners or those who want to test LNbits features before committing to a more self-sovereign setup.

Pros

Fast and simple: No setup or technical knowledge required.
Immediate access: You can quickly explore and use LNbits features without delay.

Cons

Third-party reliance: Your funds and data depend on the security and trustworthiness of the service provider.
Reduced privacy and control: Not as secure or private as self-hosting.
“Not your keys, not your coins”: You don’t have full custody of your funds.
Service fees: Some providers may charge fees for usage.

How: Visit LNbits or egg or any other trusted public instance and start using it without any complicated set-up or maintenance.

For testing (with small amounts) here is a LNbits demo server instance.

Select create a new wallet, give it a name (we'll use Satoshi in this example), and follow the on screen instructions.

Be sure to bookmark/save the wallet webpage otherwise the wallet is unrecoverable.

A wallet list should be show on the lefthand side of the page (1), if not expand the page, or click the burger icon in the top lefthand corner of the screen (2).

Give your wallet a name using the Rename wallet button (3) if you didn't already do this at the beginning.

Under the Wallets header should be Extensions (4). Click this and find the Pay Links extension (5). Enable it by clicking Enable.

Now the Pay Links extension will appear under your wallets' list (6). Click it and select New Pay Link (7).

Choose your wallet from the dropdown list (8), give it a description, and add a Lightning Address if you wish. Deselect Fixed amount (9) and configure the Min and Max amounts of satoshis your wallet can receive.

We suggest using 1 Min and 10,000,000 Max (10). Click to expand the Advanced options area (11), and enter the maximum number of characters you wish to allow when someone leaves a message with a payment in the Comment maximum characters box (12). We recommend using 100. Enable nostr zaps if you wish and then click Create Pay Link to save the settings.

Your LNURLp payment link will now be attached to your wallet. Now click on your wallet name (13) and expand the API docs list on the righthand side of the page (14). Select and copy the Invoice/read key (15) associated with this wallet, you'll need it in part 3 below, "Flash the firmware".

3. Flash the firmware

Use our custom built web installer to configure and flash the firmware to the device.

You will need the following credentials:

Your wifi "ssid" and "password"

Your "server name" eg "https://demo.lnpiggy.com"

Your "invoice/read key" eg "db400dfba...." (copied from your LNbits Wallet API toggle)

Web Installer

Works with Google Chrome or Microsoft Edge.

4. Make a case and assemble the parts

Time to get creative! Build your very own LightningPiggy case out of any material you wish to use, and assemble the parts.

💡

IMPORTANT: When installed correctly, the battery and/or board components should not get hot when it is being charged, i.e. the USB is connected to power and the battery is installed.

Check out our new case options.

Cases

If you would like to share your design with others, please email your creation to oink@lightningpiggy.com for inclusion on this website.

Join our telegram chat for help or inspiration, or to share your work with other LightningPiggy builders.