pull down to refresh

A step by step guide about how to start using Green wallet with Lightning, a good option for new LN users.

This guide is available on my substack in English and Spanish.
Many of my readers were asking me to write this guide, even that most of the documentation can be found on Blockstream website.
I hope @blockstream_official will like this "getting started" guide even that I took some excerpts from their docs then added some of my observations and recommendations and put them together into this short guide to have it at hand for new users.
The long awaited Lightning wallet on Blockstream Green have arrived. At the time writing this guide, IS STILL IN BETA PHASE, but if you want to test its functionalities, is ready to be used on Bitcoin mainnet.
At the end of this guide you will find all the links to download it so I am sure you read first the IMPORTANT steps you should do.

INTRODUCTION

The Green wallet is a multi account application, where you could start using multiple Bitcoin accounts (singlesig, multisig, watch-only, HW-connect) and now also was introduced the Lightning account.

What's the difference between wallets and accounts?

Wallets

A Green wallet lets you store and spend you funds securely and conveniently. I's self-custodial, so it means that it stores or manages the keys to access your bitcoin, so you are in control.
To start sending and receiving funds on Blockstream Green, you must create at least one wallet, but you can have create or import multiple ones.
For each wallet you create, need to back up your primary key. The backup consists of a 12 or 24-word recovery phrase.
Each wallet can be accessed via PIN or biometrics and even be exported across multiple devices.

Accounts

An account is a subsection of wallets that allows you to separate funds based on your needs, for more security, or instant payments. You can manage multiple additional accounts in each wallet.
Accounts are tied to the primary key in which they are created. The recovery phrase backup of your primary key, unlocks access to all accounts inside that wallet. If you lose access to your wallet, you lose access to all accounts inside the wallet.

What Is the Purpose of Using Multiple Accounts?

Some of the benefits of using multiple accounts include:

Instant transactions

Top up your instant account to send instant cheap transactions to everyone on the Lightning Network, with our unique self-custody solution for Bitcoin Lightning payments.

Increased Security

You can create a 2FA protected account, where spending funds from requires authenticating with a separate 2FA of your choice among Authenticator app, email, sms, or call.

Easier Accounting

Maintaining multiple accounts can be useful if you want to keep track of different income streams or budgets without having to write down and store a new recovery phrase for each balance.

Stronger Privacy

Your account balance shows the total value of all UTXOs in your account. When you make a transaction, your Blockstream Green app may combine transaction outputs in order to send the required amount of funds. Combining UTXOs can compromise your privacy as it links multiple addresses to the same sender.
By creating separate accounts within the same wallet, you can control which UTXOs are combined and which aren’t. Blockstream Green will never combine UTXOs from two different accounts, even if they are part of the same wallet.
In Blockstream Green, your funds are stored inside accounts, which are stored inside wallets. Accounts enable you to conveniently separate your funds in one wallet. For example, you might use one account for daily spending and another for stacking securely with 2FA protection.

LET’S GET STARTED

To play around and test it, you would need to activate the “experimental” features and open a “Lightning Account”, is actually a CLN node using Greenlight, where the keys stays on your device.
First step is to create a simple Bitcoin wallet, single sig, from which will be derived the keys for your Lightning Account (node).
You do not have to deposit any BTC into this onchain wallet and then later open a LN channel (as you are used to do with regular LN nodes). The Lightning node could receive straight away sats directly from a LN invoice. Greenlight (Blockstream backend node hosting) is providing all the liquidity and channels management as the main LSP.
For a regular new user, this is a very simple way to start with Lightning without all the hassle of running a full LN node and managing the liquidity, channels etc.
After you create a main Bitcoin wallet, then go to App Settings (top left drawer on main screen) and activate “Experimental features”.
Once you’ve done that, go back to Accounts screen and click on “Create new account“ button from top right. Then on the bottom, click on “Advanced features”. You will see that now you can create a “Lightning Account”.

Some aspects to remember:

  • This LN account will have maximum 4M sats capacity.
  • Green is using splicing, to expand channel capacity (same as Phoenix).
  • You will be asked to encrypt the node keys on your device with YOUR device PIN. Be aware, some users the tried using a new PIN, but is actually your device security PIN. It is NOT the Green app PIN, that you normally set for opening.
  • Save the LN nose seed for backup !
  • Save the nodeID for backup and later use !
  • The node liquidity is offered ONLY through Blockstream Greenlight LSP (similar with Phoenix), but the keys stays on your device.
  • Green is supporting fully LNURL, except LUD-18 and 02. And it works pretty well.
###How Liquidity works in Green LN wallet?
Let’s explain a bit, for new users, how the liquidity works in Green so they have it clear in their mind from the beginning.
So, Green is dedicating a maximum 4M sats capacity for this LN account. That means you can deposit a max 4M sats initially or during the whole use of Green, through smaller amounts until you reach that max limit.
When you are inside the LN account, if you click on the top right corner menu and open the “Node Info” option, you will see your LN node ID and also displaying the liquidity available.
You better save that nodeID info together with your LN seed words that are separate from your main Bitcoin wallet !
So let’s say you deposited 50k sats initially.
As you can see, on the balance it says 47199 sats (represent the 50k - 2500 sats fee - some tests I did) and bellow it says 28174 sats “receive capacity”. That means I can still receive 28174 sats WITHOUT paying an additional 2500 sats fee to expand the capacity of that channel, through splicing.
This is a nice way that Green is offering to users to have like 40-50% more inbound capacity on top of what they already deposited.
Now come the interesting part. Let’s say you deposit more than that extra capacity of 28174 sats, you deposit 900k sats. In that moment the channel is expanded using splicing LN feature, you pay an extra fee of 2500 sats and now you have a bigger channel. But is still full and you will still get a smaller inbound liquidity on top.
Remember you cannot go further than 4M sats. I think this is a limitation for beta phase and not be too much reckless. But 4M sats for mobile LN wallet is more than enough.
What happen if you swap out those 900k sats now? Let’s say you want to move them to an onchain wallet. Fine, use any swap service to move out those sats, but not all, just leave in the channel at least 1%.
In that moment you will remain with an almost empty channel, ready to receive more sats over LN, without paying those extra fees of 2500 sats for each deposit. That’s why is recommended to start with a bigger initial deposit, so you will pay only once that fee, instead of each time you deposit.
For the moment I could find a way to swap out directly into main Bitcoin wallet, you have to use an external service.
But the swap in function works just fine.
Click on LN account main screen the “Receive” button and in that screen, before you put the amount, you will see at the bottom “Show onchain Address”. Will generate a new BTC address to deposit.
In the next screen you will get the BTC address and also a warning saying that min and max limit for that deposit. Also a fee for the splicing will be applied.
As you can see is limiting the max deposit to 900k sats. I don’t know why exactly this limit, but I supposed is specific to beta phase and also maybe for a better channels management and not being abused. But is more than enough for the moment.
So this onchain deposit practically will expand your channel capacity with the amount of sats you deposited + what you already had inside + a little bit more inbound capacity.

OBSERVATION

Another very interesting aspect to be mentioned is that this LN wallet is offering more privacy when you RECEIVE sats over LN. Why? Because is using wrapped invoices.
I did a test, creating an invoice in Green and then decode it into LN decoder to see possible tracing of the LN invoice. You can see that end up as “destination” node a BreezC node, that I supposed is the LSP for Greenlight, using the new C= specs.
So in this way, your Green nodeID is not revealed in a payment, offering more privacy.

CONCLUSION

I think this is a nice, simple and elegant way for new users to start using Lightning without any complications, with self-custody of their keys.
This wallet is a good alternative to all those custodial accounts, some of them even KYC and closed source. It still have some limitations, but for a not so technical user is a very good option.
Green is free, open source software, that can be installed from Google Play Store, Apple Store, F-Droid and also straight from Github repository (you can use Obtainium for updates)
where are the downsides? - is there anything you don't like about it 👀
reply
For me personally? Not too many downsides. I like simple things. If you want the whole LN node management, liquidity and channels, fees etc, you will not have them. For that you have many other apps and node bundles.
For a total noob I found this an excellent way to start using LN.
reply
I will have a test - I didn't too tempting to test this wallet before because it sounds too corporate to me 😂
I like those darkhorse style hahha
reply
Even that is in beta phase, I found it safe to use it. I did a recovery test and works as designed.
What I didn't tested yet, is what happen when you close the channel (called "remove LN account") and if the funds goes back to main onchain bitcoin wallet, as I suppose will do.
reply
Would you prefer/suggest Green or Phoenix then for onboarding a newb?
reply
Could be both. Only that Green offers the option to have multiple accounts, onchain and LN. Also Green splicing fee structure is better.
Green is still new, is in beta still. Phoenix is already at v0.2 and with some years ahead, stable.
reply
For a total noob I found this an excellent way to start suing LN.
expect the competition between this and Phoenix, then...
reply
Yes, I found them very similar, only that with Green you have more options in the same app.
reply
Thanks @DarthCoin. Are there risks with running an appimage on Linux and using the same wallet and account for the iOS app, at the same time? Would they stay relatively synced and not break things?
reply
Not sure is possible that right now. I didn"t test it yet. It should be possible anyways because the node files are not on your device so there is no risk to overwrite the database. Anyways, I would not recommend that. Yet. Is still beta, let's just test it with caution.
reply
Thanks!
I've been waiting for this.
Might wait a little more for fees to come down.
reply
Thanks @DarthCoinfor this great info. I'll wait for @blockstream_official to add this features to the desktop version.
reply
Thanks Darth
reply
great great, thank you
reply
Just tried opening a 900k sat channel. Both my embedded Zeus (with fee set really high even) and Strike failed to find a route. Anyone having issues with Green Lightning right now?
reply
Me too. I think I did a mistake writing this guide and too many people jumped into testing it. Must be their beta testing low liquidity broken. Patience... this is just for testing man, not for regular use. Not YET!
reply
No better way to test with some sats in my opinion. I’ve been early testing of Zeus in alpha and Mutiny too.
reply
Did you tried also to make a new deposit but from onchain not from LN invoice? You have that option in the invoice screen, at the bottom to show onchain address.
reply
I’ll do that tonight. The channel opening fees seem pretty reasonable for the fee environment.
reply
How does sender privacy compare to Zeus? Is the route construction performed locally on the device?
reply
I love all these easy to use self-custodial wallets coming out. I’m a huge fan of Zeus, but for users of the Green app and Jade, this feature will be excellent. Will play around with it but this or Zeus might become my go to for introducing people to Lightning.
reply
Do accounts work in a similar way that they do with Sparrow wallet?
reply
deleted by author
reply
reply
Awesome! I misread your post, so deleted before you commented lol
reply
deleted by author
reply
Yes Onions, this Green could be a good start for you to use LN, without the hassle of channels management and worries of not using a self-custodial node.
reply
I've already saved it in my browser bookmarks to check out later. Learning never exhausts the mind. Thanks for the guide.
reply
Is really cool because is also for desktop. I still have to test if I can use same LN account on mobile and on desktop. I suppose not in the same time, but still could be an option.
reply
Thats great if one can swap between devices. Thanks for this write-up 🤙
reply
deleted by author
reply
No, all liquidity is managed by Greenlight backend, the user keeping the custody of the keys. Is similar to Phoenix and also to OBW with hosted channels. You do not have any channel management. You do not need turbo channels in Green.
reply
deleted by author
reply