📚Bitcoin Wallet Glossary

This glossary is built on the great work of Bitcoin Design and Mastering the Lightnig Network

Address

In Alby Hub there is onchain address and a lightning address.

A bitcoin onchain address is an identifier of 26-35 alphanumeric characters (e.g. bc1...) that is used to receive bitcoin in a bitcoin onchain wallet. Your "Savings Balance" is a bitcoin onchain wallet.

A lightning address is an identifier in the form of xyz@getalby.com that is used to receive bitcoin to a bitcoin lightning wallet.

Your Alby Hub is a comprehensive wallet solution, featuring both a lightning wallet and an integrated bitcoin onchain wallet.

💰Savings Balance👩‍💻Use your lightning address

Anchor Reserve

Anchor Reserve is a feature that enhances the safety and usability of lightning network channels. In order to open or close a channel you you need to publish one bitcoin onchain transaction. The Anchor Reserve sets aside a budget that allows you to increase fees of the closing transaction when needed, ensuring smoother channel closing operations. The lightning node within Alby Hub subtracts the reserve from the onchain balance (i.e. savings balance) and credits back the amount that wasn't used to pay for the closing fees.


Block

Instead of processing each transaction individually, the bitcoin network collects them into blocks. Blocks are created roughly every 10 minutes and can only contain a certain amount of transactions due to a strict file size limit. Once a block is accepted and has several confirmations, it can never be changed again.

You will have to wait for up to 6 block confirmations when making a top-up for your Alby Hub and creating a lightning network channel

⬆️Top up your walletHow to open a channel?

Capacity

The capacity of a payment channel corresponds to the amount of bitcoin provided by the funding transaction which is recorded in the bitcoin blockchain. A high capacity does not ensure that the channel can route payments in both directions but it is essential for the capability to send and receive high payment amounts.

Having a bigger capacity is always better.

❤️Node Health

Closing transaction (closing a channel)

If both channel partners agree to close a channel, they will generate a settlement transaction that reflects the latest commitment transaction. Closing the channel mutually with a closing transaction is advantageous because it requires fewer blockchain transactions to claim all funds compared to unilaterally forcing a channel closure by publishing a commitment transaction (i.e. a force closure). Moreover, the funds for both parties are immediately available for spending from the closing transaction.

In Alby Hub when a channel is closed the funds return to the Savings Balance (the onchain wallet).

How can I close this channel? What happens to the sats in this channel?

Channel Reserve

A channel reserve works as a type of insurance against theft. If a peer tries to cheat in a lightning payment channel, then the other party can submit a penalty transaction. This transaction will then take away all the funds from the other user’s channel. Having the channel reserve in place ensures that there are funds available to take away should this occur.

A channel reserve and anchor outputs are both mechanisms within the Lightning Network that enhance the security and reliability of payment channels.


Channel State

This refers to the state of a lightning channel, i.e. the balances of the local and remote sides of the channel. The channel state changes every time a payment is sent or received. It can also change if the node routes a payment through a channel.


Channel Closure

In the lightning network, payment channels can close in different ways. The two most relevant ones are:

Collaborative Close: A collaborative close is a channel closure where both parties agree to close the channel. Both parties sign off on closing the payment channel and get their funds back immediately.

Force Close: A force close happens for different reasons. To make sure the channel partner does not cheat, there is a time lock that prevents the funds from being spent for a certain period. The consequence might be a waiting time of around 14 days until your see your bitcoin appear in your onchain balance.

Why was my lightning channel closed and what to do next?

Commitment transaction

A commitment transaction is a Bitcoin transaction, signed by both channel partners, that encodes the latest balance of a channel. Every time a new payment is made or forwarded using the channel, the channel balance will update, and a new commitment transaction will be signed by both parties. Since both both channel partners keep their own version of the commitment transaction, at any point, the channel can be closed by either closed by either of them. Submitting an older (outdated) commitment transaction is considered cheating (i.e., a protocol breach) in the lightning network and can be penalized by the other party, claiming all the funds in the channel for themselves, via a penalty transaction.


Fees

In the lightning network, nodes charge routing fees for forwarding payments on behalf of other users. Each node can set its own fee policy, which consists of a fixed base fee plus a fee rate that varies with the payment amount.

In the context of Bitcoin onchain transactions, the sender pays a transaction fee to miners for including the transaction in a block. Onchain transaction fees do not involve a base fee and are calculated linearly based on the transaction's weight, rather than the transaction amount.

In Alby Hub you only have to deal with channels fees if you are a podcaster or a merchant tha need to open public channels.

Should I open a private or public channel?

Funding transaction

The funding transaction is used to open a payment channel. The value (in bitcoin) of the funding transaction is exactly the capacity of the payment channel. The output of the funding transaction is a 2-of-2 multisignature script where each channel partner controls one key. Due to its multisig nature, it can only be spent by mutual agreement between the channel partners. It will eventually be spent by one of the commitment transactions or by the closing transaction.


Fiat

Fiat money is a type of legal tender that is issued by a government. The value of fiat money is not backed by, or tied to a commodity such as gold instead it is derived from the relationship between supply and demand and the stability of the issuing government. Examples of fiat money include the US dollar, Indian rupees, the euro, and the Japanese yen.

⬆️Buy Bitcoin

Gossip protocol

Lightning network nodes exchange information about the network's topology through gossip messages with their peers. Having a good knowledge of the network topology is important for successful payment. While lightning nodes typically connect with their channel partners, they can also connect with other nodes to receive and process gossip messages.


Keys

Bitcoin wallets and addresses have both public and private keys associated to them. The private key controls access to funds and the ability to sign (approve) transactions.

How can I backup my keys

Keysend Payments

Keysend payments are lightning payments sent directly to a recipient’s public node key without requiring an invoice. To receive them, the recipient must have public channels with sufficient liquidity and be online. This method is ideal for spontaneous payments, like tipping or supporting content creators such as podcasters, as it removes the need for generating invoices, making transactions faster and more seamless. Unlike Lightning addresses, keysend payments require no setup, and they also offer privacy benefits, which can be important for some podcasters. This topic is related to making channels Public, because only public channels can receive these keysend payments:

Should I open a private or public channel?

Lightning invoice

Users of the lightning network use a lightning invoice to request a payment. It is defined by BOLT 11 and includes an amount to be paid, destination of the payment, and an optional message. Unlike bitcoin addresses, lightning invoices expire after a set amount of time.

📤Send📥Receive

Lightning network

The lightning network enhances bitcoin by using payment channels to boost transaction speed and reduce costs.

Furthermore lightning offers greater privacy to its users. Transactions occur directly between users and are not publicly broadcast on the bitcoin blockchain.

That's why it is increasingly being adopted and accepted as the preferred method for scaling bitcoin.


Lightning service provider

Liquidity service providers (LSPs) may be counterparties of your payment channels that offer one or several of these services:

  • Opening channels: A LSP opens a channel with a new user's node and confirms its active status. Because the LSP initiates and creates the channel, the user does not need to fund it from their existing on-chain wallet.

  • Incoming capacity: If you manually open a channel, you cannot receive any payments until you spend some of the funds used to open the channel. Spending your bitcoin creates receiving capacity. Your Alby Hub has LSPs integrated that allow you buy a channel from the LSP for a small price. You benefit from immediate receiving capacity. You still need to deposit funds into your Hub but it simplifies your start.

  • Routing: LSPs offer a stable connection to their lightning node and are well-linked with payment channels to the overall lighting network. This setup ensures that you can consistently send and receive payments.

In Alby Hub you interact with LSPs when you Increase your Receiving Capacity.

📥Increase Receiving Capacity

Mempool

Every transaction must be confirmed before the recipient can consider the bitcoin theirs. This queue for new transactions is known as the Mempool. Since the Bitcoin network can only handle a limited number of transactions per day, processing times can be longer during peak periods. Transactions with higher fees are generally processed more quickly.


Node

Node refers to software that participates in the bitcoin network. It exchanges transaction data with other nodes, stores some or all of it, and verifies that transactions are valid.

The primary purpose of a lightning node is to track payment channel states, and calculate routes for payments to take through lightning.

Self-custody on lightning requires a user to run their own node. Alby Hub is a self-custodial wallet. That's why it comes with an integrated lightning node by default.

To send and receive payments your lightning node needs to be online. That's why we recommend users to run Alby Hub on machine that is always online.

Consider Alby Cloud if you prefer a convenient hosting service with premium features for your Hub.

🚰Node

Nostr Wallet Connect (NWC)

Nostr Wallet Connect (NWC) is a protocol that bridges Bitcoin Lightning wallets with various applications, enabling direct interactions. Through NWC, once an app connection is established via a Nostr relay, the app can directly request payments, simplifying transactions by eliminating the need for repetitive invoice generation.

This integration promotes a seamless and direct communication pathway between users' wallets and applications, enhancing the functionality and user experience within the Lightning Network ecosystem.

Alby Hub can be connected to many apps using the NWC and spending sats seamlessly.

🔗App Connections🎮App Store

Onchain and Offchain

Onchain: Transactions and activities that occur directly on the bitcoin blockchain, recorded publicly and securely but can be slower and more expensive.

Offchain: Transactions and activities that occur outside the bitcoin blockchain. Since the lightning network is a second layer scaling technology of bitcoin but outside of the blockchain, lightning transactions are referred to as offchain transactions. In the case of lightning this means your bitcoin transactions are faster and cheaper.

Onchain funds are managed by your Savings Balance. Offchain funds by your Hub's wallet


Payment

A payment is a transaction that occurs over the lightning network. Payments are routed through lightning payment channels and are not recorded in the bitcoin blockchain.


Payment channel

A payment channel is your connection to bitcoin's lightning network. The channel partners can use the channel to send and receive bitcoin without committing all of the transactions to the bitcoin blockchain. They can also send payments beyond their channel peer thanks to the routing capabilities of a lighting node. This means you only need a small number of payment channels to well connected channel peers in order to reach anybody else in the network.


Private key

Every bitcoin address has a public key and a corresponding private key, together they are called a keypair. If you have access to both the public and private key, you effectively control the funds in the address. You are expected to have a backup of the keys of your Alby Hub.


Private channel

A private channel is not announced to the rest of the network. They are better described as "unannounced" channels, because these channels can still be identified through routing hints and commitment transactions. With an unannounced channel, the channel partners can send and receive payments between each other as normal. However, the rest of the network will not be aware of the channel and so cannot typically use it to route payments.

Should I open a private or public channel?

Preimage

The lightning network uses preimages as proof that a lightning invoice has been paid successfully.


Public key

A bitcoin public key can be derived from the private key. The address itself is a hash of the public key.


Recovery phrase

The controlling keypair of a bitcoin wallet can be derived from a recovery phrase such as 12 words.

The recovery phrase provides full access to a bitcoin wallet as it contains the private key and is therefore very valuable. It’s extremely important to keep it safe, both from other people getting access to it and for yourself not to lose it by creating one or several backups of the phrase.

A recovery phrase is also referred to as Seed, Mnemonic, and Backup phrase. You are expected to have a backup of the keys of your Alby Hub.


Routing

On the lightning network, the sender of a payment decides the route of the payment. The payment can be routed through several other lightning nodes along the path until it arrives at the destination node. To be able to route you need at least two public payment channels. All routing nodes do not know the originator of a payment or the final recipient. Your own node may not be directly connected to the recipient in order to send a payment. For a high payment success rate it is crucial to have a lighting node as your channel peer that has good routing capabilities (learn more).

We recomend you to only open private channels so you don't have to worry about the routing inconveniencies. You can learn more about routing and public channels here.


Signature

Since a private key can be used to prove that the holder controls a specific address, it can therefore authorize transactions from the address. This is called a digital signature.

In you Alby Hub you have two types of private keys: for your bitcoin onchain wallet and for your lightning wallet.


Static Channel Backup

A static channel backup can be utilized to recover funds from the lightning network. Although it does not include the latest channel state, it provides sufficient information for a lightning node to request its remote peers to force close the channels. This process delay access to funds but remains a viable solution if the channel state of your lightning node is corrupted or lost.

You will be able to migrate your Alby Hub from one hardware or cloud to another.

How can I migrate Alby Hub to a different machine?

Wallet

In it's original meaning a wallet is a device or program that stores your cryptocurrency keys and allows you to access your coins. That's what Alby Hub is.

However, this term is often used interchangeably for very different things: A user can "download a bitcoin wallet" in the app store, and then the app may offer the option to transact bitcoin without actually giving the user access to his private keys. Such wallets are usually referred to as custodial wallets. You may also encounter that people call the Alby Browser Extension a wallet. However, it effectively works as a remote control for your wallet. You'll need to link your actual wallet first. For example, you can do that by connecting your Alby account, which is powered by Alby Hub.

💰Savings Balance👛Wallet


Thank you for stopping by! This section was created with contributions from Moritz & Jean-Paul

Last updated

Logo

Your bitcoin & nostr companion / from 🐝 with 🧡