Difference between revisions of "Main Page"

From PlebNet Wiki
Jump to navigation Jump to search
 
(112 intermediate revisions by 14 users not shown)
Line 1: Line 1:
= PLEBNET for plebs =
<languages/>
<translate>
<!--T:2-->
'''Welcome to PLEBNET!'''


Welcome to the Plebnet! In this guide, we'll take you over the steps required to get yourself up and running with a lightning node.
<!--T:53-->
We've outlined the main 'guide' on this page. Follow the articles here in order to gain a better understanding of the steps required to join PLEBNET, and getting your node up & running. If you'd like to simply browse around, you can view all our pages [[Special:AllPages|Special:AllPages]].


== Getting Started ==


In order join [http://plebnet.org PLEBNET], you need a [https://en.wikipedia.org/wiki/Lightning_Network Lightning Network] node (more on that later) and [https://telegram.org/ Telegram] to chat and connect with us!
== To read first == <!--T:3-->


If you are totally new to the lightning network, and would like to get an overview of how it works before diving in, then read the [https://bitcoiner.guide/lightning/ bitcoiner.guide/lightning] guide.
<!--T:4-->
[[Special:MyLanguage/Welcome to Plebnet|Welcome to PLEBNET]]  


=== Node ===
<!--T:5-->
'''Please read the above link before anything else!''' Contains a useful introduction and tips.


There are several newbie options for getting a Lightning node set up and running. Some of them are software only, some hardware + software.
[[Notes on Privacy | Important points to consider on how to protect your privacy]]


* [https://github.com/rootzoll/raspiblitz RaspbiBlitz] is a great option that runs on Raspberry Pi v4+
== Getting Started == <!--T:6-->
* [https://getumbrel.com/ Umbrel] is a newbie-friendly package that runs on Raspberry Pi v4+
* [https://youtu.be/fppmhqjqh2E BTC SESSIONS] has a good video walkthrough for getting started with Raspberry Pi and Umbrel
* '''Security note for Umbrel:''' ''Your Umbrel node is only as secure as your network (WiFi/LAN).'' Be sure to read the [https://github.com/getumbrel/umbrel/blob/master/SECURITY.md Security Disclosure] from the Umbrel team.
* [https://start9.com/ Start9] is an all-in-one option that includes the necessary hardware * [https://www.mynodebtc.com/ myNode] is another all-in-one with hardware
* [https://stadicus.github.io/RaspiBolt/ RaspiBolt] has some good information on how to set up the necessary services manually


=== Telegram ===
<!--T:7-->
Are you brand new and perhaps don't quite understand lightning? Do you not have your own node yet? Are you not yet in the PLEBNET telegram group?


PLEBNET discussion and coordination happens on the Telegram chat platform.
<!--T:8-->
Please see the [[Special:MyLanguage/Getting started|Getting started]] page.


Download the [https://telegram.org/ Telegram app] and join the [http://kycjelly.com PLEBNET] group.


The companion Telegram channel [https://t.me/plebnetlibrary PLEBNET Library] contains high quality materials collected from chat group traffic.
== Claim your node [optional]== <!--T:9-->


=== CheeseRobot ===
Important: If you are concerned about your privacy, do not claim your node (or for that matter use telegram). There are a few things to be aware of when claiming your node on cheeserobot. CheeseRobot, a closed source software, will link your telegram handle to your node, and subsequently to UTXOs (or bitcoin public addresses) for any public channels that you establish. This may have unintended consequences of doxing your identify (and UTXOs) in case the phone number that is associated with your telegram handle is exposed. Make sure to take basic precautions if you do opt to use the cheeserobot, like making sure that your telegram phone number isn't visible by default and isn't exposed to your contacts.


A Telegram bot that will allow you to join and interact with the PLEBNET.
<!--T:10-->
For telegram, DM [https://t.me/cheeserobot @cheeserobot] and then <code>/claim</code> your node (follow the instructions, you will need to sign a message with your node to prove you are owner of the node).


You’ll want to send a private message to <code>@cheeserobot</code> to claim and add your node. Start with <code>/claim</code> and follow the instructions to get add your node id. Then, in the PLEBNET channel, use <code>/id@cheeserobot</code> to get yourself added to the graph.
<!--T:11-->
Then, in the [https://t.me/plebnet PLEBNET] group announce your node with <code>/node</code>. If you see your own node, success.
Repeat in other groups which support CheeseRobot with <code>/node</code>.


== Opening Channels ==
<!--T:12-->
Additionally, [https://amboss.space Amboss.space] is one of the best websites for looking up nodes and their basic information. People may go to Amboss to browse your node's info. You can claim your node on Amboss which will allow you personalize your node's profile and add additional information. Use these instructions: [[Special:MyLanguage/Claim on Amboss|Claim on Amboss]]


=== Add Liquidity ===
== Opening Channels == <!--T:13-->


Generate a Lightning wallet and add some funds so that you can open channels. Keep in mind that PLEBNET prefers [[#keep-it-girthy|girthy channels]], so fund your node accordingly.
<!--T:14-->
The first question which a pleb has after (or even before) the node is synced "'''who should I open channel with'''"


=== Find Nodes in PLEBNET Telegram Group ===
<!--T:15-->
I would say - '''with a mentor who is willing to spend time with you, teach you the ropes, mentor and guide you to be a better node runner'''


If you’re not yet able or willing to offer girthy channels and just want to get started with a smaller amount of sats, [https://amboss.space/node/0381de1709efbda38f9afd2d47399caa19a2630c0c795acd24755efa442685fc7d Turgidson] is for PLEBNET newbies and will accept channels as low as 20k.
<!--T:16-->
Of course in the age of google, internet, and instant gratification, this thought can be frowned upon but there is no replacement for a mentor in your journey as node runner.


You may want to check out [https://www.youtube.com/watch?v=qnj-ix45tVw Lightning Routing: The First 30 Days] to get some ideas
<!--T:17-->
For information relating to lightning channels, including methods to get inbound liquidity see: [[Special:MyLanguage/Opening channels|Opening channels]]


Otherwise, you’ll need to find some other nodes in PLEBNET to open channels with.
== Rebalance Channels ==


You can go to http://graph.plebnet.org/ to see the current visual graph of nodes, or type <code>/graph@cheeserobot group</code> in the PLEBNET chat. <code>/groupnodes@cheeserobot</code> will output a list of the 50 most recent members and nodes. You can contact plebs form the graph or list and see if they’d like to open a channel.
Keeping your channels properly balanced is critical to your node's routing ability. Ride The Lightning and Thunderhub are good visual tools to start with. As you progress in your journey, the [https://github.com/alexbosworth/balanceofsatoshis Balance of Satoshis] is a command-line tool that provides extra flexibility to rebalance your peers. [https://github.com/itsneski/lightning-jet Lightning Jet] is a fully automated rebalancer that will automatically rebalance all of your channels. See [[Resources]] for links to other available tools.


You can also just ask in the PLEBNET channel if anyone is interested in opening a channel with you.
== Maintaining Proper Node Hygiene == <!--T:18-->


=== Other Channel Sources ===
<!--T:21-->
[[Special:MyLanguage/Node Hardening|Node Hardening]]


If you’re just getting started and want to find some other nodes to open channels with, here’s some places where other plebs have had success:
<!--T:19-->
[[Special:MyLanguage/Maintaining node hygiene|Maintaining node hygiene]]


* [https://lightningnetwork.plus/ Lightning Network Plus]
<!--T:20-->
* [https://community.getumbrel.com/t/instructions-to-get-an-incoming-channel-from-lnbig-with-umbrel/1541 Buying from LNBIG with Umbrel]
[[Special:MyLanguage/Node Hardware|Node Hardware]]
* [https://github.com/Rings-of-Fire/ring-of-fire/wiki Ring of Fire]
* [https://mainnet.lightningconductor.net/ Lightning Conductor]
* [https://community.getumbrel.com/t/opening-channels-requests/66 Umbrel Opening Channel Requests]


=== Keep It Girthy ===
<!--T:22-->
[[Special:MyLanguage/UPS|UPS]] (Uninterrupted Power Supply)


It’s best to have fewer big channels with more sats than it is to have many smaller ones. The recommended minimum channel size is 2 million sats, which would be 1 million per node on the channel.
[[Reduce_channel_database_size | Keeping Channel DB in check ]]


=== Balanced Channels ===
[[Compacting_Channel_DB | Prune and compact channel DB ]]


The idea is to have balanced channels. This means that there is an equal amount of sats between each node on the channel.
== Backup/Recovery == <!--T:23-->


For example, if <code>Node A</code> opens a channel with <code>Node B</code> for 2m sats, it will start entirely on their end. <code>Node A</code> will want to find a way to have 1m sats on each side of the channel.
<!--T:24-->
The following link contains some important information about channel backups and recovery solutions so that you have a better idea of how to keep your funds safe.


There are several different ways to accomplish this.
<!--T:25-->
[[Special:MyLanguage/Backup/Recovery|Backup/Recovery]]


==== “Ghetto Submarine Swap” (aka: ‘trust-required’ dual-funded channel) ====


'''ONLY DO THIS WITH ESTABLISHED AND TRUSTED PLEBNET NODES! IT IS POSSIBLE TO LOSE SATS DOING THIS.'''
== Let’s Get Personal == <!--T:26-->


# <code>Node A</code> opens a channel with X sats
<!--T:27-->
# <code>Node B</code> sends a Lightning invoice for half of the amount X sats that was opened on the channel
Your node can be customized to appear as a name (alias) rather than just a bunch of random letters and numbers. You can also set a color for your node that will show up on various lightning-related websites and programs.
# The <code>Node A</code> operator sends the address of their preferred on-chain Bitcoin wallet to the operator of <code>Node B</code>
# The <code>Node B</code> operator sends half of the amount X sats of the opened channel to the Bitcoin wallet of the operator of <code>Node A</code> from step 3
# <code>Node A</code> pays the Lightning invoice


==== MEG (aka: ‘trustless’ dual-funded channel) - Mutually Exchanged Girth ====
<!--T:28-->
[[Special:MyLanguage/Setting a node alias|Setting a node alias]]


Alex Bosworth’s CLI tool, [https://github.com/alexbosworth/balanceofsatoshis Balance of Satoshis] utilizes keysend to add this functionality to LND (which does not natively support it, yet)


Here’s a high-level overview. NOTE: this is an ''advanced'' technique, and requires familiarity with terminal. It is safe/legit, but the UX is rough. If you mess it up, bad things could happen. ''USE AT YOUR OWN RISK''
== Upgrades == <!--T:29-->


<pre>Pre-req: make sure NODE 1 and NODE 2 have keysend enabled (this is default for Umbrel)
<!--T:30-->
[[Special:MyLanguage/Upgrading Umbrel Node|Upgrading Umbrel Node]]


(NODE 1: Bob)
(0) Run: bos open-balanced-channel
(1) enter remote node public key
(2) enter full channel size
(3) enter fee rate
Open a new terminal window.
(4) Run: bos fund --fee-rate &lt;fee&gt; &lt;address&gt; &lt;amount in sats&gt;
Copy the signed_transaction and go back to 1st window and paste
(5) paste the signed_transaction to bos prompt in 1st window




(NODE 2: Alice)
(0) Run: bos open-balanced-channel (it should see the request from node1 at this point)
(1) agree with funding rate (y/n)
Open a new terminal window.
(2) Run: bos fund --fee-rate &lt;fee&gt; &lt;address&gt; &lt;amount&gt;
Copy the signed_transaction and go back to 1st window and paste
(3) paste the signed_transaction to bos prompt in 1st window
(4) hit enter and this should work.


check via: lncli pendingchannels
Reference video: https://tube.hordearii.fr/videos/watch/318df0b9-8d27-4ac3-ae0c-7a85a1c76bce</pre>
== Maintaining Proper Node Hygiene ==


[[Maintaining node hygiene]]


== UPS ==
== Popular Tools == <!--T:31-->


You should consider setting up your node with an uninterruptible power supply [[UPS]].
=== Balance of Satoshis === <!--T:33-->


== Let’s Get Personal ==
<!--T:35-->
Balance of Satoshis, or BoS, is a set of commands for working with LND balances. It can do similar things as interfaces like ThunderHub or Ride the Lightning. However, your options are much wider with BoS, and you will need it if you want to set up a telegram bot with your node (to get notifications whenever channels are opened/closed, whenever you forward a payment, whenever your node goes offline, and to get automatic channel backups for safety).


[[Setting a node alias]]
<!--T:37-->
For more information, and common BoS commands see: [[Special:MyLanguage/Balance of Satoshis|Balance of Satoshis]].
 
<!--T:52-->
[https://github.com/niteshbalusu11/BOS-Commands-Document See this excellent documentation for bos commands]
 
<!--T:34-->
Installation: process for [[Special:MyLanguage/Umbrel - Installing BoS|Umbrel - Installing BoS]]. Includes instructions for setting up BoS telegram bot.
 
=== Lightning Shell === <!--T:34-->
[https://lightningshell.app/ Lightning Shell] Lightning Shell is a shell for Bitcoin nodes / personal servers. Technically it’s a Docker container with ttyd and additional utilities.
 
It can be installed [https://github.com/ibz/lightning-shell manually] or via the Umbrel/Citadel app stores
 
Lightning shell includes many useful tools and saves you a lot of time installing them:
 
[[Special:MyLanguage/Umbrel - Installing BoS|Balance of Satoshis]]
 
[https://github.com/edouardparis/lntop lntop]
 
lncli
 
[[Special:MyLanguage/Suez| Suez]]
 
 
== LND Configuration Settings Overview == <!--T:35-->
 
<!--T:36-->
Click the link below for information related to setting up channel size limits, predefined fees on new channels, setting up watchtowers, and other optimization settings.
 
<!--T:37-->
[[Special:MyLanguage/LND Configuration Settings|LND Configuration Settings]]
 
 
== Running A Profitable Routing Node == <!--T:38-->
 
<!--T:39-->
Not seeing routing through your node, or your sats are only moving in one direction?
 
<!--T:40-->
Want more information about rebalancing and fees? Want to run a program that auto-adjusts your fees, or one that gives you KPIs (Key Performance Indicators)?
 
<!--T:41-->
'''Your one stop shop for tips on routing node profitability:''' [[Special:MyLanguage/Running A Profitable Routing Node|Running A Profitable Routing Node]]
 
<!--T:42-->
[[Special:MyLanguage/Fees And Profitability|Shortcut to auto-fee and auto-KPI instructions]]
 
 
== Playground / Sandbox == <!--T:43-->
 
<!--T:44-->
Click the image below to get information on PLEBNET Playground, a place where you can learn and use the lightning network without risking any real money (signet).
 
<!--T:45-->
[[File:PlebnetPlayground.jpg|450px|link=Plebnet Playground|alt=Plebnet Playground Logo]]
 
 
== FAQ == <!--T:46-->
 
<!--T:47-->
A selection of questions frequently asked in [https://t.me/plebnet PLEBNET] groups.
[[Special:MyLanguage/FAQ|FAQ]]
 
 
== Resources == <!--T:48-->
 
<!--T:49-->
[[Special:MyLanguage/Resources|Resources]]
 
= All Pages = <!--T:50-->
 
 
 
 
</translate>
{{:Special:Allpages}}
<translate>
</translate>

Latest revision as of 16:59, 6 October 2022

Other languages:
English • ‎Hausa • ‎Türkçe • ‎Wolof • ‎Yorùbá • ‎español • ‎français • ‎العربية • ‎हिन्दी

Welcome to PLEBNET!

We've outlined the main 'guide' on this page. Follow the articles here in order to gain a better understanding of the steps required to join PLEBNET, and getting your node up & running. If you'd like to simply browse around, you can view all our pages Special:AllPages.


To read first

Welcome to PLEBNET

Please read the above link before anything else! Contains a useful introduction and tips.

Important points to consider on how to protect your privacy

Getting Started

Are you brand new and perhaps don't quite understand lightning? Do you not have your own node yet? Are you not yet in the PLEBNET telegram group?

Please see the Getting started page.


Claim your node [optional]

Important: If you are concerned about your privacy, do not claim your node (or for that matter use telegram). There are a few things to be aware of when claiming your node on cheeserobot. CheeseRobot, a closed source software, will link your telegram handle to your node, and subsequently to UTXOs (or bitcoin public addresses) for any public channels that you establish. This may have unintended consequences of doxing your identify (and UTXOs) in case the phone number that is associated with your telegram handle is exposed. Make sure to take basic precautions if you do opt to use the cheeserobot, like making sure that your telegram phone number isn't visible by default and isn't exposed to your contacts.

For telegram, DM @cheeserobot and then /claim your node (follow the instructions, you will need to sign a message with your node to prove you are owner of the node).

Then, in the PLEBNET group announce your node with /node. If you see your own node, success. Repeat in other groups which support CheeseRobot with /node.

Additionally, Amboss.space is one of the best websites for looking up nodes and their basic information. People may go to Amboss to browse your node's info. You can claim your node on Amboss which will allow you personalize your node's profile and add additional information. Use these instructions: Claim on Amboss

Opening Channels

The first question which a pleb has after (or even before) the node is synced "who should I open channel with"

I would say - with a mentor who is willing to spend time with you, teach you the ropes, mentor and guide you to be a better node runner

Of course in the age of google, internet, and instant gratification, this thought can be frowned upon but there is no replacement for a mentor in your journey as node runner.

For information relating to lightning channels, including methods to get inbound liquidity see: Opening channels

Rebalance Channels

Keeping your channels properly balanced is critical to your node's routing ability. Ride The Lightning and Thunderhub are good visual tools to start with. As you progress in your journey, the Balance of Satoshis is a command-line tool that provides extra flexibility to rebalance your peers. Lightning Jet is a fully automated rebalancer that will automatically rebalance all of your channels. See Resources for links to other available tools.

Maintaining Proper Node Hygiene

Node Hardening

Maintaining node hygiene

Node Hardware

UPS (Uninterrupted Power Supply)

Keeping Channel DB in check

Prune and compact channel DB

Backup/Recovery

The following link contains some important information about channel backups and recovery solutions so that you have a better idea of how to keep your funds safe.

Backup/Recovery


Let’s Get Personal

Your node can be customized to appear as a name (alias) rather than just a bunch of random letters and numbers. You can also set a color for your node that will show up on various lightning-related websites and programs.

Setting a node alias


Upgrades

Upgrading Umbrel Node




Popular Tools

Balance of Satoshis

Balance of Satoshis, or BoS, is a set of commands for working with LND balances. It can do similar things as interfaces like ThunderHub or Ride the Lightning. However, your options are much wider with BoS, and you will need it if you want to set up a telegram bot with your node (to get notifications whenever channels are opened/closed, whenever you forward a payment, whenever your node goes offline, and to get automatic channel backups for safety).

For more information, and common BoS commands see: Balance of Satoshis.

See this excellent documentation for bos commands

Installation: process for Umbrel - Installing BoS. Includes instructions for setting up BoS telegram bot.

Lightning Shell

Lightning Shell Lightning Shell is a shell for Bitcoin nodes / personal servers. Technically it’s a Docker container with ttyd and additional utilities.

It can be installed manually or via the Umbrel/Citadel app stores

Lightning shell includes many useful tools and saves you a lot of time installing them:

Balance of Satoshis

lntop

lncli

Suez


LND Configuration Settings Overview

Click the link below for information related to setting up channel size limits, predefined fees on new channels, setting up watchtowers, and other optimization settings.

LND Configuration Settings


Running A Profitable Routing Node

Not seeing routing through your node, or your sats are only moving in one direction?

Want more information about rebalancing and fees? Want to run a program that auto-adjusts your fees, or one that gives you KPIs (Key Performance Indicators)?

Your one stop shop for tips on routing node profitability: Running A Profitable Routing Node

Shortcut to auto-fee and auto-KPI instructions


Playground / Sandbox

Click the image below to get information on PLEBNET Playground, a place where you can learn and use the lightning network without risking any real money (signet).

Plebnet Playground Logo


FAQ

A selection of questions frequently asked in PLEBNET groups. FAQ


Resources

Resources

All Pages

Retrieved from "http://plebnet.wiki/index.php?title=Main_Page&oldid=2431"