From cc87d2008e22d746c035705c4c4dd5b5326fc19e Mon Sep 17 00:00:00 2001 From: DarthCoin <56997124+Darth-Coin@users.noreply.github.com> Date: Fri, 22 Mar 2024 12:01:37 +0100 Subject: [PATCH 1/7] Update faq.md Updated the section of neutrino peers, with adding the examples and explaining why happen this. --- docs/for-users/embedded-node/faq.md | 15 +++++++++++++-- 1 file changed, 13 insertions(+), 2 deletions(-) diff --git a/docs/for-users/embedded-node/faq.md b/docs/for-users/embedded-node/faq.md index 912e86a..a2dfc94 100644 --- a/docs/for-users/embedded-node/faq.md +++ b/docs/for-users/embedded-node/faq.md @@ -97,13 +97,24 @@ First, you should try doing a rescan by going to `Settings` -> `Embedded node` - If rescan fails to correct the balance, you'll likely have to add some more Neutrino peers, especially if the LND logs display messages about peer connection timeouts. +Why this could happen? Because from your location, your internet conenction have a high latency to the neutrino peer. Neutrino needs a better time response in order to be able to sync faster the blocks information. So if you will have a ping of 300ms from your device to the neutrino peer, is likely to not be able to sync well. So it is recommended to switch to another server that is closer to your location. Remember, this have nothing to do with your internet speed. Time response is not speed, is distance. + To add more Neutrino peers got to `Settings` -> `Embedded node` -> `Peers` -> `Neutrino Peers`. Then uncheck `Connect only to the specified peers`, restart the app, and try another rescan. This will allow your ZEUS wallet node to find new peers to connect to automatically. +Here are some well known public neutrino peers that you can switch to from the default one: +- btcd1.lnolymp.us | btcd2.lnolymp.us +- btcd-mainnet.lightning.computer +- node.blixtwallet.com +- node.eldamar.icu +- noad.sathoarder.com +- bb1.breez.technology | bb2.breez.technology + If you have your own remote node, you may also want manually add it in the Peers list. You can [use this guide to enabled 'Neutrino mode' in Bitcoin Core](https://docs.lightning.engineering/lightning-network-tools/lnd/enable-neutrino-mode-in-bitcoin-core). BTCD has Neutrino on by default. #### If it's lightning funds that have gone missing -Go to the Channels view by hitting the icon in the bottom right corner of the main view then, hit the header at the top of the Channels view to toggle between open, pending, and closed channels. Mutually closed channels should return to your on-chain balance once they settle on-chain. Force closed channels can take up to two weeks to return to your on-chain wallet. These channels will appear in the pending channels list until settled. +Go to the Channels view by hitting the icon in the bottom right corner of the main view then, and first thing try to refresh the screen by swiping down, few times. +If still do not appear online, hit the header at the top of the Channels view to toggle between open, pending, and closed channels. Mutually closed channels should return to your on-chain balance once they settle on-chain. Force closed channels can take up to two weeks to return to your on-chain wallet. These channels will appear in the pending channels list until settled. ## I'm having payments sending lightning payments with ZEUS @@ -123,4 +134,4 @@ This typically happens when either the blockchain headers or lightning network g 3. Go to `Settings` -> `Embedded node` -> `Express Graph Sync` and enable the second toggle labeled `Reset express graph sync on startup`, then restart the app. This will resync your lightning network graph data. - 4. Restarting the app to jostle the state and get it online again. \ No newline at end of file + 4. Restarting the app to jostle the state and get it online again. From fd6dd4681eb817edf48b9cbd50ce679841df1f3f Mon Sep 17 00:00:00 2001 From: DarthCoin <56997124+Darth-Coin@users.noreply.github.com> Date: Fri, 14 Jun 2024 15:04:53 +0200 Subject: [PATCH 2/7] Update fees.md Adding some more details (for noobs) about when zeus apply fees --- docs/lightning-address/fees.md | 14 +++++++++++++- 1 file changed, 13 insertions(+), 1 deletion(-) diff --git a/docs/lightning-address/fees.md b/docs/lightning-address/fees.md index 6734d7f..8c5aa15 100644 --- a/docs/lightning-address/fees.md +++ b/docs/lightning-address/fees.md @@ -16,4 +16,16 @@ Our self-custodial lightning address incurs the following fees: You're paying not only for us to host the infrastructure and process payments, but to hold the payments up to 24 hours; there's a real cost to keeping those sats in transit and using an HTLC slot on our channel. -Learn about [how Zaplocker payments work](https://github.com/supertestnet/zaplocker#how-it-works). \ No newline at end of file +Learn about [how Zaplocker payments work](https://github.com/supertestnet/zaplocker#how-it-works). + +# More details about Zeus fees + +When people send sats to your ZeusPay lightning address, that 2.5% fee applies. + +If you make an invoice and let them pay the invoice, the 2.5% fee does NOT apply, the payer pay the fees. Same with payments you do, no 2.5% fee. + +It is receiving via your ZeusPay lightning address only. + +Zeus doesn't receive only through a LN address and only through a single channel. + +You can make LN invoices and receive through multiple channels with many different routing fees. Learn more about channel fees [here](https://docs.lightning.engineering/lightning-network-tools/lnd/channel-fees). From b8d6508a8183902fcfb63492b2c2c792e38cd65c Mon Sep 17 00:00:00 2001 From: DarthCoin <56997124+Darth-Coin@users.noreply.github.com> Date: Fri, 14 Jun 2024 15:07:51 +0200 Subject: [PATCH 3/7] Update fees.md adding more details for new user to know when zeus fees apply --- docs/lsp/fees.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/lsp/fees.md b/docs/lsp/fees.md index 26fd40d..a240aac 100644 --- a/docs/lsp/fees.md +++ b/docs/lsp/fees.md @@ -29,3 +29,15 @@ Our self-custodial lightning address incurs the following fees: | <= 20 sats | 10% | | <= 100 sats | 5% | | > 100 sats | 2.5% | + +# More details about Zeus fees + +When people send sats to your ZeusPay lightning address, that 2.5% fee applies. + +If you make an invoice and let them pay the invoice, the 2.5% fee does NOT apply, the payer pay the fees. Same with payments you do, no 2.5% fee. + +It is receiving via your ZeusPay lightning address only. + +Zeus doesn't receive only through a LN address and only through a single channel. + +You can make LN invoices and receive through multiple channels with many different routing fees. Learn more about channel fees [here](https://docs.lightning.engineering/lightning-network-tools/lnd/channel-fees). From 8c6259a7aeb386b12e58f98e6fd82375c78958ef Mon Sep 17 00:00:00 2001 From: DarthCoin <56997124+Darth-Coin@users.noreply.github.com> Date: Fri, 14 Jun 2024 16:13:38 +0200 Subject: [PATCH 4/7] Update tips.md add more details about neutrino peers --- docs/for-users/getting-started/tips.md | 30 +++++++++++++++++++++++++- 1 file changed, 29 insertions(+), 1 deletion(-) diff --git a/docs/for-users/getting-started/tips.md b/docs/for-users/getting-started/tips.md index c8ad1b5..e022a7e 100644 --- a/docs/for-users/getting-started/tips.md +++ b/docs/for-users/getting-started/tips.md @@ -29,4 +29,32 @@ At the left hand side, we can see the the inputs and its corresponding outpoints Anchor outputs are additional outputs added to a commitment transaction in a channel, with each party having one output. These outputs are encumbered with a CSV condition, acting as timelocks, allowing parties to bump fees using Child Pays for Parent (CPFP) to facilitate transaction confirmation. This mechanism enables users to set fees for closing transactions, enhancing flexibility and security within the Lightning Network. -Anchor outputs address the challenge of delayed confirmation due to preset transaction fees at the time of crafting commitment transactions. By allowing parties to adjust fees post-transaction creation, anchor outputs empower users to adapt to changing fee dynamics, ensuring timely and efficient transaction processing. +Anchor outputs address the challenge of delayed confirmation due to preset transaction fees at the time of crafting commitment transactions. By allowing parties to adjust fees post-transaction creation, anchor outputs empower users to adapt to changing fee dynamics, ensuring timely and efficient transaction processing. + +# What is a Neutrino peer ? + +Neutrino is a lightweight Bitcoin Core client (that was implemented with [BIP157](https://github.com/bitcoin/bips/blob/master/bip-0157.mediawiki)) which enable our Bitcoin node to serve block data to remote LND nodes in a private P2P mode and with minimum data storage needed (almost insignificant), ideal for mobile LN nodes like Zeus. + +More Neutrino nodes, well distributed across the world, will help a lot the use of mobile LN nodes like Zeus, with a more decentralized distribution of neutrino peers. A lower response time (ping) it means that is closer to your location and will reduce drastically the sync issues of your Zeus node. A higher response time (in ms) it means you are too far to the neutrino peer and the communication could have a serious impact onto your Zeus sync. + +This can be useful if we are already running a fully synced Bitcoin node somewhere and want to use it for one or multiple remote instances of LND. If we have the additional bandwidth and storage available, we might also want to make our existing Bitcoin node available to the public as a free service. + +Easily available public Neutrino instances help the network grow more robust and remove bottlenecks. Such services are a prerequisite to light clients, which do not have a copy of the Bitcoin Blockchain available locally. + +If you run a full Bitcoin Core node you can connect your Zeus embedded node with it by amend your Core node bitcoin.conf, add the following paramenters: +``` +blockfilterindex=1 +peerblockfilters=1 +``` + +Once you restart your node, it will resync the Blockchain and build the blockfilterindex. This may take a while depending on your node’s available memory and computing power. + +As soon as Bitcoin Core is running, it will now advertise itself to the network if you have set this in your configuration. To disable discovery, you may set `discover=0` in your bitcoin.conf. + +Connect from your Zeus embedded node: + +This option is good in case you are connecting from a location where the default Neutrino peers provided in Zeus will have a high latency that could not provide a good sync time. So connecting directly to your local node will improve a lot the use of Zeus. + +Go to Zeus `Settings --> Embedded Node --> Peers --> Neutrino peers` then add your Bitcoin Neutrino node IP (or FQDN if you have one). It must be delivered over clearnet. + +If your Bitcoin node operate only over Tor network it will not serve too much for this purpose, due to high latency offeered over Tor and will not offer more privacy anyways (Neutrino already offer enough privacy). From b09a999730ebaed01c8daecb786e64dee3e013f5 Mon Sep 17 00:00:00 2001 From: DarthCoin <56997124+Darth-Coin@users.noreply.github.com> Date: Fri, 14 Jun 2024 16:32:58 +0200 Subject: [PATCH 5/7] Update faq.md little details about neutrino --- docs/for-users/embedded-node/faq.md | 16 +++++++++------- 1 file changed, 9 insertions(+), 7 deletions(-) diff --git a/docs/for-users/embedded-node/faq.md b/docs/for-users/embedded-node/faq.md index 943ed05..588d0a4 100644 --- a/docs/for-users/embedded-node/faq.md +++ b/docs/for-users/embedded-node/faq.md @@ -101,13 +101,15 @@ Why this could happen? Because from your location, your internet conenction have To add more Neutrino peers got to `Settings` -> `Embedded node` -> `Peers` -> `Neutrino Peers`. Then uncheck `Connect only to the specified peers`, restart the app, and try another rescan. This will allow your ZEUS wallet node to find new peers to connect to automatically. -Here are some well known public neutrino peers that you can switch to from the default one: -- btcd1.lnolymp.us | btcd2.lnolymp.us -- btcd-mainnet.lightning.computer -- node.blixtwallet.com -- node.eldamar.icu -- noad.sathoarder.com -- bb1.breez.technology | bb2.breez.technology +You can also have a preferred list of peers if you like. Here are some well known public neutrino peers that you can switch to from the default one: +- btcd1.lnolymp.us | btcd2.lnolymp.us (works better with users from North American continent) +- btcd-mainnet.lightning.computer (works better with users from North American continent) +- node.blixtwallet.com (works better with users from European continent) +- node.eldamar.icu (works better with users from North American continent) +- noad.sathoarder.com (works better with users from North American continent) +- bb1.breez.technology | bb2.breez.technology (works better with users from North American continent) + +Keep in mind that this list of public neutrino peers might not exist in the future or servers name will be changed or relocated. Also there's a new Neutrino code release in the pipeline that will improve drastically the sync issues and more tolerant to high response time. In any case, faster is better. If you have your own remote node, you may also want manually add it in the Peers list. You can [use this guide to enabled 'Neutrino mode' in Bitcoin Core](https://docs.lightning.engineering/lightning-network-tools/lnd/enable-neutrino-mode-in-bitcoin-core). BTCD has Neutrino on by default. From 53c0659b2b34e8232a6fd7ea7f02e487d9d8aeaa Mon Sep 17 00:00:00 2001 From: DarthCoin <56997124+Darth-Coin@users.noreply.github.com> Date: Fri, 14 Jun 2024 16:41:58 +0200 Subject: [PATCH 6/7] Update faq.md --- docs/for-users/embedded-node/faq.md | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/docs/for-users/embedded-node/faq.md b/docs/for-users/embedded-node/faq.md index 588d0a4..cbd4d85 100644 --- a/docs/for-users/embedded-node/faq.md +++ b/docs/for-users/embedded-node/faq.md @@ -101,13 +101,20 @@ Why this could happen? Because from your location, your internet conenction have To add more Neutrino peers got to `Settings` -> `Embedded node` -> `Peers` -> `Neutrino Peers`. Then uncheck `Connect only to the specified peers`, restart the app, and try another rescan. This will allow your ZEUS wallet node to find new peers to connect to automatically. -You can also have a preferred list of peers if you like. Here are some well known public neutrino peers that you can switch to from the default one: -- btcd1.lnolymp.us | btcd2.lnolymp.us (works better with users from North American continent) -- btcd-mainnet.lightning.computer (works better with users from North American continent) -- node.blixtwallet.com (works better with users from European continent) -- node.eldamar.icu (works better with users from North American continent) -- noad.sathoarder.com (works better with users from North American continent) -- bb1.breez.technology | bb2.breez.technology (works better with users from North American continent) +You can also have a preferred list of peers if you like. Here are some well known public neutrino peers that you can switch to from the default one. + +These ones works better with users from North American continent: +- btcd1.lnolymp.us | btcd2.lnolymp.us +- btcd-mainnet.lightning.computer +- node.eldamar.icu +- noad.sathoarder.com +- bb1.breez.technology | bb2.breez.technology + +These one works better with users from European continent: +- node.blixtwallet.com + +If you want to look for some closer to your loceation, here is a full live list of4 Bitcoin neds with Neutrino activated (remember that these could change or disappear in time so review your neutrino peers ping if you notice issues and switch to better ones): +- [https://bitnodes.io/nodes/?q=NODE_COMPACT_FILTERS](https://bitnodes.io/nodes/?q=NODE_COMPACT_FILTERS) Keep in mind that this list of public neutrino peers might not exist in the future or servers name will be changed or relocated. Also there's a new Neutrino code release in the pipeline that will improve drastically the sync issues and more tolerant to high response time. In any case, faster is better. From 3e1620d8e2c353f15c3d24071558d5ededc0b127 Mon Sep 17 00:00:00 2001 From: DarthCoin <56997124+Darth-Coin@users.noreply.github.com> Date: Fri, 14 Jun 2024 16:48:41 +0200 Subject: [PATCH 7/7] Update faq.md --- docs/for-users/embedded-node/faq.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/for-users/embedded-node/faq.md b/docs/for-users/embedded-node/faq.md index cbd4d85..86eb357 100644 --- a/docs/for-users/embedded-node/faq.md +++ b/docs/for-users/embedded-node/faq.md @@ -110,7 +110,7 @@ These ones works better with users from North American continent: - noad.sathoarder.com - bb1.breez.technology | bb2.breez.technology -These one works better with users from European continent: +This one works better with users from European continent: - node.blixtwallet.com If you want to look for some closer to your loceation, here is a full live list of4 Bitcoin neds with Neutrino activated (remember that these could change or disappear in time so review your neutrino peers ping if you notice issues and switch to better ones):