Setting Up a Bitcoin/Lightning Network Sandbox with Polar on Linux

Jemimah Nagasha — Fri, 15 Mar 2024 09:04:21 +0000

The Bitcoin Lightning Network is a second-layer scaling solution built on top of the Bitcoin blockchain. It is designed to enable faster and cheaper transactions. Developing and testing Lightning Network applications can be challenging, but tools like Polar can simplify the process by providing a user-friendly environment. This article will guide you through the process of setting up a Bitcoin Lightning development environment on Regtest using Polar.

Prerequisites

Docker Server (Installation guide here)
Docker Compose (Installation guide here)

Installing Polar

Polar is a tool developed by Lightning Labs to create and manage Lightning Network nodes for development and testing purposes. To install Polar on Linux, follow these steps:

Download the Polar application package from here.

Because the Polar application is an AppImage package, we will also install the AppImageLauncher to ease the installation of our Polar package.

sudo add-apt-repository ppa:appimagelauncher-team/stable
sudo apt-get update
sudo apt-get install appimagelauncher

When the above is complete, double-click the *“.AppImage ” *package you just downloaded and that will launch your polar application.

Setting Up Lightning Nodes

When you run Polar, the following welcome screen will appear.

Click either the orange “Create a Lightning Network” button in the middle, or Create Network in the top right corner.

After clicking Create Network, the above screen will appear. You can specify how many of each node implementations your network will be composed of. For this guide, create a new Lightning Network with the following parameters:

Network Name = My Network
Number of Managed Nodes:
LND = 2
Core Lightning = 0
Eclair = 0
Bitcoin Core = 1

Note: You will always need at least one Bitcoin Core node!

After clicking the orange Create Network button, Polar will display this new screen.

Polar allows you to play with any version for any implementation, including those in beta by providing the Network Designer Tab on the far right in the above screenshot. You can add a node of any version by dragging and dropping it onto the canvas to add it to the network you created.

Initiate your local network by clicking the Start button located in the top right corner, highlighted in orange. Allow a few seconds for the nodes to initialize; you’ll know the process is complete when the indicator lights turn green. After this, select the “Alice” LND node to access the screen tabs below.

The details on this screen are mostly straightforward. Currently, the local regtest instance is only at Block Height = 1, resulting in both Alice’s Confirmed Balance and Unconfirmed Balance being 0 sats. To change this, navigate to the Actions tab for Alice, confirm that Deposit Funds is configured to 1,000,000 sats, and then click on Deposit.

Starting with 1,000,000 sats in test environments like our local regtest instance provides a reasonable amount of satoshis for testing various Bitcoin functionalities without needing to worry about small fractions constantly. It offers enough satoshis to facilitate transactions, create different spending scenarios, and observe their effects.

Polar’s Mining Simulation

To mine more blocks, click the backend1 node, in the actions tab. A mine button will be visible.

While Polar’s mining simulation might appear similar to real-world mining, it’s not generating real Bitcoin on the main Bitcoin network. Polar creates a regtest environment, which is a separate, simulated network for testing purposes. Regtest coins have no real-world value and cannot be transferred to the main Bitcoin network.

Create and Pay an Invoice

Having funded Alice’s on-chain wallet, the next step is to open a channel. Click on “Open Channel” -> “Outgoing,” choose Bob as the destination, keep the default Capacity at 250,000 sats, and then click the orange “Open Channel” button.

After successfully opening the channel, select the new green line connecting Alice and Bob’s LND nodes to view the channel details below.

Hover over the green dot on Alice’s node to reveal “Source,” and over the blue dot on Bob’s node to display “Destination.” This indicates that the side with a Source Balance of 246,530 sats is Alice’s, while the side with a Destination Balance of 0 sats belongs to Bob.

Since Bob currently has no Destination Balance, right-click on his node to open an Actions panel. Choose “Create Invoice,” accept the default Amount of 50,000 sats, and click the orange “Create Invoice” button. If done successfully, this action should generate the following screen.

Select “Copy & Close,” then right-click on Alice’s node and choose “Pay Invoice.” Paste the invoice copied into the Bolt 11 Invoice field and click the orange “Pay Invoice” button. Upon completion, the dashboards for Alice, Bob, and the channel will resemble the following:

Congratulations! You’ve made your first successful Lightning Network payment on regtest!

You may have noticed a “Launch” button below Terminal in the Actions tab of the different nodes. You can run also cli commands directly on each node you created by launching its terminal.

Polar makes setting up a Bitcoin-Lightning development environment on regtest a breeze. Its intuitive interface and powerful features provide a valuable sandbox for developers to test their applications and gain practical experience working with the Lightning Network.

I hope this article serves as a helpful guide for setting up your Bitcoin-Lightning development environment with Polar. Feel free to explore the additional resources and documentation available within the Lightning ecosystem to further your knowledge and development efforts.

Open Source Contributions — How I Started Contributing To Open Source

Jemimah Nagasha — Mon, 31 Oct 2022 13:15:59 +0000

You've probably heard about the open source community by now. You might have even tried your hand at contributing to a project. But how did you get started? Should you just jump on a project and start contributing? I'm going to share with you my experiences in starting out, what worked for me, and what I've learned so far.

Starting Out

For any tech newbie, contributing to open source projects can seem a daunting fit to accomplish. I chose to start my journey with the Hacktoberfest 2022 challenge.

Hacktoberfest is a month-long celebration run by DigitalOcean to celebrate and give back to open source projects and software. The initiative is open to everyone, and the goal is to encourage everyone in our global community to contribute to open source.

During hacktoberfest, maintainers from all around the world tag issues as "hacktoberfest" and "good-first-issue". Most of the issues are beginner friendly, especially for first time contributors. This was a good time for me to start out because of the worldwide support for contributors.

First PR - Hydrogen (Social media web app)

I found a project to contribute to through the hacktoberfest discord channel. Whenever I am starting something new, I always want to start with something familiar and easy to get a feel of how things are done before diving into the deep end. This project provided a great starting point for me.
Hydrogen is a social media web app powered by SolidJS. My first issue was the simplest; adding a delete account tab in the settings section of the web app. The maintainer was very responsive and helpful. Even though this contribution was tiny, having it merged gave me an immense confidence boost.

More PRs

I had planned to make a total of 4 contributions for the month of October (one for every week). I decided to tackle other issues within the same project, now that I was familiar with the codebase. The other 3 issues I worked on revolved around fixing accessibility issues for various pages. I learned a lot about accessibility and using the lighthouse tool to make checks and improvements. I'll be sharing more about making accessible web pages as I learn. I hope you stick around for that 😉

Lessons

Hacktoberfest 🎃 has come to an end and I am so glad for choosing to participate. And even though getting swag was not my intention, I managed to qualify for it 🤣 yey! Anyway, here are a few take aways;

Start small. All contributions matter.
There is always someone in the community willing to help. Don't be scared to ask.
Always aim to make meaningful contributions to the projects you commit to.
Most importantly, before you make that PR, Read the contribution guide.