This commit is contained in:
counterweight 2023-12-09 19:27:21 +01:00
commit 896f2b76aa
204 changed files with 4845 additions and 0 deletions

27
bisq/20230710.md Normal file
View file

@ -0,0 +1,27 @@
Wifi: LYVL6BnhPvvRkhHsYvWX
build and clean with gradle
git commit signing
- Get GPG
- Upload to github
- Set up in .gitconfig
-
## Project organization
- Text: i18n module
- We need to improve the learn section (academy.properties in the text files)
Maybe improve texts in the typical bisq easy flow
## Homework
- Introduce myself around Matrix
- Take a look at learn
- Repeat the normal process and change anything
- Add myself to task in bisq2 -> issues -> #1000
- Add my idea on meetups to bisq2

View file

@ -0,0 +1,39 @@
CBeams will make videos for Bisq 2 and Bisq Easy
- Docs
- What is Bisq 2
- User guide for Bisq 2
- Quickstart
- Installing
- Identities
- Backing up
- Networks and privacy
- Chat Rooms
- Supported languages
- Included protocols
- Bisq Easy
- Protocol explained
- Reputation system
- Trade steps
- Mediation systems
- Overview of other protocols
- Becoming a seller
- Relationship between Bisq 1 and Bisq 2
- Oracle nodes
- Reputation
- DAO actions stay in Bisq 1
- Roadmap
- For developers
- Technical overview
- How to contribute
- For other contributors
- How to contribute
- Becoming a mediator
- Becoming a moderator
- Becoming a security manager
- Becoming a release manager
- Becoming a seed node operator
- Becoming a oracle node operator
- Becoming a explorer node operator
- Becoming a market price node operator

View file

@ -0,0 +1,164 @@
# How to buy Bitcoin on Bisq Easy
Buying Bitcoin with Bisq Easy is recommended for small fiat amounts, or as a starting point if you still have no Bitcoin that you can use for the security deposits of other trade protocols.
You can opt for two ways to find a trading partner to get some Bitcoin: taking an existing offer or creating one.
## Taking an existing offer (Buy)
Taking an existing offer is the fastest and simplest way to find a partner and start trading. Follow along to learn how to navigate to your preferred market and pick an existing offer in it.
Begin by opening up Bisq 2. Once the application has started, you should select ''Bisq Easy'' on the left panel, and ''Getting started'' on the top tab.
![[taking_offer_to_buy_1.png]]
On this page, click on the ''Start trade wizard''. This is the easiest way to get started. A small note: once you become more experienced, you might prefer to use the ''Offerbook'' page to do your trades. But for the first trades, we advice using the trade wizard.
![[taking_offer_to_buy_2.png]]
With this, you will enter the trade wizard, which will guide you step by step through the process of taking an existing offer to buy some Bitcoin. In the first screen, select ''Buy Bitcoin'' and click on ''Next''.
![[taking_offer_to_buy_3.png]]
In the following screen, you need to indicate which national currency you want to use to pay your trading partner. Since we want to use Euros for this trade, we select that currency in the list. Once you have selected your currency, click on ''Next'' to move on.
![[taking_offer_to_buy_4.png]]
On the next screen, you will have to select which Payment Methods are you willing to use. You should select at least one, but you can also select multiple of them. The more Payment Methods you add, the more chances you will have of finding a willing trade peer. In this example, we initially select ''SEPA'' and ''Revolut''.
![[create_buy_offers_screenshot_5.png]]
Once you are done selecting Payment Methods, you can move on by clicking ''Next''.
On the next screen, you will have to set how much Bitcoin you want to buy or, putting it the other way around, how much fiat currency you want to sell. The minimum and maximum amounts for Bisq Easy are 0.0001 BTC (or 10,000 sats) and 0.01 BTC (or 1,000,000 sats). You can write the fiat amount, the BTC amount, or simply move the slider around.
![[taking_offer_to_buy_5.png]]
For this example, let's imagine we would like to buy 150€ worth of Bitcoin. We set the value and click on ''Next'' to move on.
In the following screen, you will be presented a list of offers that match your needs. You can select any of the offers presented, but we advice taking the first offer. By default, offers will be presented by decreasing reputation, so the most trusted trades will be on the top of the list. You can check other offers that might have more interesting prices, but be aware that the lower the reputation of the trader, the higher the risk you will face. If you want to keep things safe and simple, simply pick the first offer that you see. Once you have settled for an offer, click on ''Next'' to move on.
![[taking_offer_to_buy_6.png]]
The final screen will allow you to review all the details. Make sure you are happy with all the details of the trade, since once you move on, you will effectively commit to doing the trade. If there's anything you want to change, you can always navigate back and modify any of the trade details. Once you are ready, click on ''Confirm trade''.
![[taking_offer_to_buy_7.png]]
Once you have done this, the offer is taken and you can begin the trade process. You can read more about the trade process here (LIIIIIIIIIIIIIIIINK).
Remember that when you take an offer, you commit to follow through. Be aware that, once you take it, you can't simply back down without consequences.
Note that there is also a chance that no offers are found matching your needs. If this is the case, you will see a screen like the one below. You can wait some time and try again later, or you can instead create your own offer. You can read more about creating an offer here (LIIIIIIIIIIIIIIIIIIINK)
![[taking_offer_to_buy_8.png]]
## Creating a new offer (Buy)
Creating an offer is a great way to establish your own terms and simply wait for someone to match what you are after. It is also the right option if you don't find any offers with the right premium or payment methods in the market you want to trade in. Follow along to learn how to navigate to your preferred market and create a new offer in it:
Begin by opening up Bisq 2. Once the application has started, you should select ''Bisq Easy'' on the left panel, and ''Offerbook'' on the top tab.
![[create_buy_offers_screenshot_1.png]]
Each different national currency has its own market. You can click on the displayed pair to open a selector where you can choose the currency you would like to trade in. In this example, we are interested in buying some Bitcoin by paying with Euros, so we will select the ''BTC/EUR'' pair, but you should select whatever currency you are using. Afterward, click on the ''Create offer'' button on the right-hand side.
![[create_buy_offers_screenshot_2.png]]
You will now enter the offer creation wizard. The first step will be to choose between buying or selling Bitcoin. Select ''Buy Bitcoin'' and click on ''Next''.
![[create_buy_offers_screenshot_3.png]]
On the following screen, you will be asked for confirmation on which currency you want to pay your Bitcoin with. The selected currency will be the one you selected in the previous ''Offerbook'' screen. You can change your mind here if needed. Since for this example we want to move forward with Euros, we don't need to change anything on this screen, and we can simply click ''Next''.
![[create_buy_offers_screenshot_4.png]]
On the next screen, you will have to select which Payment Methods are you willing to use. You should select at least one, but you can also select multiple of them. The more Payment Methods you add, the more chances you will have of finding a willing trade peer. In this example, we initially select ''SEPA'' and ''Revolut''.
![[create_buy_offers_screenshot_5.png]]
Besides the presented Payment Methods, you can also add customized Payment Methods to your offer. For instance, for this offer, I would be happy to make a cash deposit at a Rabobank physical branch. I can use the bottom input to add this method to my offer.
![[create_buy_offers_screenshot_8.png]]
Once you are done selecting Payment Methods, you can move on by clicking ''Next''.
![[create_buy_offers_screenshot_7.png]]
On the next screen, you will have to set how much Bitcoin you want to buy or, putting it the other way around, how much fiat currency you want to sell. The minimum and maximum amounts for Bisq Easy are 0.0001 BTC (or 10,000 sats) and 0.01 BTC (or 1,000,000 sats). You can write the fiat amount, the BTC amount, or simply move the slider around.
![[create_buy_offers_screenshot_9.png]]
You also have the option of defining a range instead of a fixed value for the trade amount. By doing that, you set a minimum and maximum amount, and you signal to the market that you are willing to trade any amount between those two numbers. For this example, we will create an offer with a range between 100€ and 200€. Once you have set your fixed value or a range, click ''Next'' to move on.
![[create_buy_offers_screenshot_10.png]]
With this, you will reach the final step of the offer creation wizard. The final screen shows a summary of all the details you have defined. Now is the time for you to review whether everything is fine. This is important because, once you click on ''Create offer'', the offer will be available for anyone to take and, once that happens, it will be binding. So, make sure you are happy with the details you see. Once you are sure, click on ''Create offer'' and your offer will be added to the market.
![[create_buy_offers_screenshot_11.png]]
Your order is finally ready. Now, you will have to wait until another peer takes it. If your offer remains unpicked for longer than you would like to, consider modifying it to add additional payment methods or adding a more flexible range of values that could attract different users.
![[create_buy_offers_screenshot_12.png]]
Once a peer takes your offer, you will receive a notification and be able to see the started trade in the ''Open Trades'' panel of Bisq Easy. Also, keep in mind that offers remain open until you close them. If you only want to transact once, you should close it after it gets taken, or more peers could keep taking it!
## Creating a new offer (Sell)
Creating an offer is a great way to establish your own terms and simply wait for someone to match what you are after. It is also the right option if you don't find any offers with the right premium or payment methods in the market you want to trade in. Follow along to learn how to navigate to your preferred market and create a new offer in it:
Begin by opening up Bisq 2. Once the application has started, you should select ''Bisq Easy'' on the left panel, and ''Offerbook'' on the top tab.
![[create_buy_offers_screenshot_1.png]]
Each different national currency has its own market. You can click on the displayed pair to open a selector where you can choose the currency you would like to trade in. In this example, we are interested in selling some Bitcoin and receiving Euros, so we will select the ''BTC/EUR'' pair, but you should select whatever currency you are using. Afterward, click on the ''Create offer'' button on the right-hand side.
![[create_buy_offers_screenshot_2.png]]
You will now enter the offer creation wizard. The first step will be to choose between buying or selling Bitcoin. Select ''Sell Bitcoin''''(if you currently have no reputation, you will receive an informative warning. It's probably wise for you to learn about how reputation works in Bisq Easy. You can read more about it in this section of the wiki: (LIIIIIIIIIIINK))''. To move on with creating your offer, click on ''Next''.
![[create_sell_offers_screenshoot_1.png]]
On the following screen, you will be asked for confirmation on which currency you want to use to receive your payment. The selected currency will be the one you selected in the previous ''Offerbook'' screen. You can change your mind here if needed. Since for this example we want to move forward with Euros, we don't need to change anything on this screen, and we can simply click ''Next''.
![[create_buy_offers_screenshot_4.png]]
The next screen will allow you to set at which price do you want to sell your Bitcoin. Here you have two options: setting a percentage price or a fixed price. By default, you can set your price as a % over the normal market price. So, for example, if you set a percentage price of 10%, and Bitcoin is currently trading at 10,000 €/BTC, your selling price would be 11,000 €/BTC. You can also set negative percentages: if you set the price at -10%, the price would be 9,000 €/BTC. A percentage price of 0% indicates you are happy to sell at the current market price. The price will get updated in real-time as the market price of Bitcoin moves, so you don't have to worry for sudden changes in the market leaving your offer in a bad position.
Your other option is to set a fixed price. This allows you to set an exact price that won't change under any circumstance. You can alternate between the two options with the small arrows icon on the right side.
For this guide, we will set a percentage price of 5% for the offer. Once you are happy with the price, click on ''Next'' to continue.
![[create_sell_offers_screenshoot_2.png]]
On the next screen, you will have to select which Payment Methods are you willing to use. You should select at least one, but you can also select multiple of them. The more Payment Methods you add, the more chances you will have of finding a willing trade peer. In this example, we initially select ''SEPA'' and ''Revolut''.
![[create_buy_offers_screenshot_5.png]]
Besides the presented Payment Methods, you can also add customized Payment Methods to your offer. For instance, for this offer, I would be happy to receive a cash deposit at a Rabobank physical branch. I can use the bottom input to add this method to my offer.
![[create_buy_offers_screenshot_6.png]]
Once you are done selecting Payment Methods, you can move on by clicking ''Next''.
On the next screen, you will have to set how much Bitcoin you want to sell or, putting it the other way around, how much fiat currency you want to buy. The minimum and maximum amounts for Bisq Easy are 0.0001 BTC (or 10,000 sats) and 0.01 BTC (or 1,000,000 sats). You can write the fiat amount, the BTC amount, or simply move the slider around.
![[create_sell_offers_screenshoot_3.png]]
You also have the option of defining a range instead of a fixed value for the trade amount. By doing that, you set a minimum and maximum amount, and you signal to the market that you are willing to trade any amount between those two numbers. For this example, we will create an offer with a range between 100€ and 200€. Once you have set your fixed value or a range, click ''Next'' to move on.
![[create_sell_offers_screenshoot_4.png]]
With this, you will reach the final step of the offer creation wizard. The final screen shows a summary of all the details you have defined. Now is the time for you to review whether everything is fine. This is important because, once you click on ''Create offer'', the offer will be available for anyone to take and, once that happens, it will be binding. So, make sure you are happy with the details you see. Once you are sure, click on ''Create offer'' and your offer will be added to the market.
![[create_sell_offers_screenshoot_5.png]]
Your order is finally ready. Now, you will have to wait until another peer takes it. If your offer remains unpicked for longer than you would like to, consider modifying it to add additional payment methods or adding a more flexible range of values that could attract different users.
![[create_sell_offers_screenshoot_6.png]]
Once a peer takes your offer, you will receive a notification and be able to see the started trade in the ''Open Trades'' panel of Bisq Easy. Also, keep in mind that offers remain open until you close them. If you only want to transact once, you should close it after it gets taken, or more peers could keep taking it!

View file

@ -0,0 +1,21 @@
- [x] Buy create offer
- [ ] Buy take offer
- [x] Sell create offer
- [ ] Sell take offer
- [ ] Identities
- [ ] Webpage
https://bisq.wiki/Bisq_Easy
https://bisq.wiki/Identity
Timetrack
- 1
- 2
- 1
---
- 1

Binary file not shown.

After

Width:  |  Height:  |  Size: 10 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 50 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 60 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 22 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 39 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 58 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 69 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 8.8 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 41 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 46 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 51 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 62 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 33 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 45 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 21 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 44 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 54 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 43 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 43 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 54 KiB

Binary file not shown.

After

Width:  |  Height:  |  Size: 48 KiB

29
bisq/Call 20231122.md Normal file
View file

@ -0,0 +1,29 @@
Closer to the launch
What are the missing pieces:
- UI for mediator (hopefully done in the next few days)
- Lot of testing to do with Tor network, but looking well.
- Seed node and oracle nodes being set up.
- Windows build is still lacking some stuff, but doesn't seem like a risk.
- Single pager on Bisq 2 and Bisq Easy
- Work in progress on wiki
- Video
- Roles and bonding
- Guarantee sellers? Write an onboarding guide? Bisq Easy introduction for sellers?
- Contact influencers and tutorial builders so they can prepare content?
- Write a mediator guide?
Will there be an easy way to roughly estimate the scam %?
---
Actions:
- Write Getting started page for sellers
- Finish other wiki stuff
- Give it a shot at finding a Jekyll experienced dev
- Talk with Manfred on whether I would like to be a moderator
- Get in touch with Fede, Hackber to judge if they would be interested
- Try to set up full dev environment to test out being a moderator

View file

@ -0,0 +1,49 @@
Install IntelliJ IDEA
---
Upload the public GPG key to Github.
Modify the `.gitconfig` file to commit messages properly. An example template:
```
[user]
name = counterweight
email = counterweightoperator@protonmail.com
signingkey = key goes here
[core]
autocrlf = input
[gpg]
program = gpg
[commit]
gpgsign = true
[merge]
gpgsign = true
[credential]
helper = cache
```
The signing key field can be obtained from Github. It appears after adding the public key, named `Key ID`.
You can also probably obtain it from your GPG software.
---
Create three run configs. On each run config, you should click the `Modify options` text and activate the `Add VM options`. A new filed will appear in the Run config modal. You should paste the
Alice, with the following code
```
-Dapplication.network.supportedTransportTypes.2=CLEAR -Dapplication.network.seedAddressByTransportType.clear.0=127.0.0.1:8000 -Dapplication.network.seedAddressByTransportType.clear.1=127.0.0.1:8001
```
Bob, with the following code
```
-Dapplication.network.supportedTransportTypes.2=CLEAR -Dapplication.network.seedAddressByTransportType.clear.0=127.0.0.1:8000 -Dapplication.network.seedAddressByTransportType.clear.1=127.0.0.1:8001
```
Seed node, with the following code
```
-Dapplication.appName=bisq_seed1_(bisq2) -Dapplication.network.defaultNodePortByTransportType.clear=8000 -Dapplication.network.supportedTransportTypes.2=CLEAR -Dapplication.network.seedAddressByTransportType.clear.1=127.0.0.1:8001
```

View file

@ -0,0 +1,35 @@
- There are known pain points (only onchain, need BTC for first trade).
- Bisq 1 is hard to modify as an old code base
- No single trade protocol is perfect. There are always trade offs.
- Bisq 2 wants to tackle all of this:
- New codebase to overcome technical debt
- Multiple trade protocols to adapt for different needs
- First protocol: bisq easy
- Other protocols: will come later.
- Eventually, bisq 2 should eat and deprecate bisq 1 eventually.
bisq 2 stuff
- 4 identities
- nickname
- bot id
- image
- public key
- "Follow the green"
- Specify amount -> Why not sats instead of BTC???
- Lightning+Liquid to Fiat market -> Complex under the hood, trivial for users (Has the issue about needing submarine swap providers)
- Lightning from the crazy genius -> No fucking body understands how it works
Questions and comments
- Why should seller's premium in the UI?
- Boostraping reputation system?
- Carry over from bisq?
- Trade guide for first time users
- The instructions feel like something that could use some visuals or even animations. Not saying the text should not be there, but I think it can confuse noobs that have little abstraction abilities.
- Who has the central authority to ban identities?
- Automatic checking of transaction ID?
- At what point is the price set, when the taker takes?
-

View file

@ -0,0 +1 @@
,pablo,olifant,14.09.2023 18:41,file:///home/pablo/.config/libreoffice/4;

View file

@ -0,0 +1,129 @@
1. Develop a Bisq 2 training kit
1. Slides
2. Instructor tips
3. Contact point for interested instructors
2. Execute locally
3. Kickstart regionally and translate
1. Spain (2140meetups) (and LATAM)
2. Germany (Einundzwanzig)
3. UK (https://bitcoin-only.com)(https://bitcoinevents.uk/uk-bitcoin-meetup-map/)
4. Italy (https://www.satoshibeer.org)(Satoshi Spritz)
5. France (Decouvre Bitcoin )
6. Austria, Poland, Czech Republic: einundzwazing forks
4. Open questions:
1. How to maximize promotion across meetups (as in, incentivize meetups to hold trainings)
2. How to measure success
3. How to move beyond Europe
- Idea summary
- Goals
- Rationale
- Budget
- Plan
- Open issues
## Summary
Create open-source materials for Bisq 2 workshops and promote them in an organic way through the flourishing meetups and communities scene in several European countries to kick-start Bisq 2 adoption in the euro area.
## Goals
The end goal is to increase adoption of Bisq 2/Easy and improve awareness of Bisq across European communities, with a focus on newcomers to the Bitcoin space.
This is achieved with the following subgoals:
- Create a great training material set in several languages so that anyone who would like to teach others how to use Bisq 2 can do so in an easy and high-quality way.
- Promote awareness of the launch of Bisq 2 and the existence of this material through direct contact with several Bitcoin communities in Europe with the hope that they will take the plunge and do live workshops of Bisq 2 in the area, either one-offs or ideally with some regularity.
## Rationale
### Onboarding friction
Bisq (both 1 and 2) offers a very different experience from that of CEXs. Understanding the trade system, the Bisq network itself and other elements is not straightforward at all for newcomers. In a way, Bisq is not only adopted, but it's actually *learned*. Learning about Bisq is a requirement to use it for two reasons: one, because otherwise it's impossible to go through the trade process. And two, because only with some understanding of Bisq can a user be sure that he is not being scammed. Many users are reluctant at first and get a sketchy impression, which is probably natural and healthy. Understanding what is going on under the hood, at least partially, is necessary to feel comfortable trading one's funds in Bisq.
Unfortunately, the fact that Bisq must be learned is a (unavoidable) hurdle for adoption. The friction of learning prevents many potential users from joining the network. Some of them don't want to invest the time and effort to do so. Some others might have troubles due to a lack of background knowledge in topics such as Bitcoin, privacy, open source networks and open protocols, etc. Their only hope is for someone to take them by the hand and patiently guide them through the learning journey.
### Meetup wave
During the past couple of years, the meetup scene in Europe has experienced great growth. National or language-driven networks like Einundzwanzig (DE), Meetups 2140 (ES) or SatoshiSpritz (IT) are motivating more and more people to start Bitcoin-only groups in their cities and towns. These organizations support in the form of materials, webpages, meetup playbooks, white papers and social capital in the form of experienced meetup runner directories are helping the communities grow exponentially, both in terms of meetup counts and assistant counts to each one.
These meetups and meetup networks provide value to their members in several ways. On the one hand, many Bitcoiners simply find pleasure in sharing their passion with others through discussions and gatherings. Meetups have also become valuable P2P trading platforms, both for Fiat<>Bitcoin exchange and for the trading of goods and services for Bitcoin. Bitcoiners with their own Bitcoin-related projects, both hobby and professional grade, find in meetups a great place to associate with other entrepreneurs or to find users/clients. And finally, and most relevant for this proposal, many meetups have also become teaching and knowledge-sharing spaces, where more experienced Bitcoiners hold talks, workshops, and courses to help others learn more about Bitcoin and the surrounding technologies.
### The challenge and opportunity
The launch of Bisq 2, initially only with the Bisq Easy trade protocol, is going to face the classic chicken-and-egg problem. No users will mean no liquidity, and without liquidity, no users will be attracted. I believe that the social networks building out throughout Europe can help fight this and get Bisq Easy to pick up and grow organically.
The plan presented below, in simple terms, is about promoting teaching sessions about Bisq Easy throughout the different European communities. A successful execution would look like dozens of Bisq Easy workshops being organized and managed by the meetups themselves, which in turn should drive hundreds or thousands of new users towards Bisq Easy (and hopefully, the other protocols after some time).
Several factors make this both attractive and feasible. Meetup sessions are a perfect onboarding method for newcomers to Bisq Easy. They can benefit from the experience of a veteran user to learn about Bisq in a personalized way. They also do this in a familiar environment, which helps beat the initial sketchiness skepticism. Bisq status as the OG DEX is a great presentation card. Many experienced meetup organizers are already familiar with Bisq, and probably many of them are also experienced with Bisq 1.
I believe the approach below also fits nicely with Bisq's philosophy as a project. It's resource-efficient, organic, community driven and exhibits low time preference. Besides helping new users join Bisq, it would also present the added benefit of refreshing and improving Bisq's brand awareness as a humble, community and pleb-driven project, with a completely different approach than the multi-million dollar marketing budget behemoths like Binance or Coinbase.
## Plan
The execution plan is divided into three parts. I plan on taking care of the bulk of the execution, although additional help could be very useful in the third part.
*Note: I am one of the organizers of the Barcelona Bitcoin Only meetup, and I'm also in touch with a few other meetup organizers from different communities in Spain. This context should help better understand parts 1 and 2.*
### Part 1
The first part of the plan is to create a Workshop Kit. This kit would consist of a series of materials aimed at helping experienced users execute a session where they show less experienced users how to use Bisq 2. The materials would be open source and accessible for anyone to use without any cost or permission required. Initially, I would include:
- A modular presentation deck with slides to cover different topics around Bisq, Bisq 2 and Bisq Easy.
- A guideline document for presenters with advice on how to successfully perform a workshop.
- Instructions on how to set up a demo environment for Bisq 2, or alternatively, demo materials such as screenshots and videos.
The first version of the kit would be developed in Spanish, and I would personally use it to perform a Bisq 2 workshop in the Barcelona Bitcoin Only community. The community regularly holds both large-audience talks and smaller, teaching-oriented workshops. My workshop would fall into the second category. I would take the opportunity of testing this in the real world to adjust the contents of the kit as best I could and incorporate any lessons learned into them.
At the end of part 1, the deliverables would be the Spanish version of the kit along with any useful takeaways I could produce from my experience. I expect to be able to finalize this by Octoboer/November.
### Part 2
The second part of the plan would be spreading this content throughout the Spanish meetup scene with the hope that more meetup organizers would take the lead and perform workshops in their local communities. To achieve this, I would leverage my social network, as well as propose some sort of collaboration with the Meetups 2140 organization (https://2140meetups.com/), the largest Spanish-speaking meetup network. (I could also potentially go to other cities to run workshops myself if agenda, budget and the organizer's willingness allow. But I would strongly prefer this campaign to be grassroots and to have the organizers of each local community take care of it. I have no intent to become a one-man army).
The Spanish expansion would be a new opportunity to, on one hand, obtain even more feedback from the workshop runners to enrich and improve the Workshop Kit. On the other hand, it would also help me understand what the biggest blockers are for a community to hold a workshop like this, with the hope that this information can be used to improve the next efforts.
At the end of the part 2, the deliverables would be a potentially improved Spanish version of the workshop kit and a report on the workshops that took place. I would consider a time period of around three months to call part 2 closed (even though more workshops can keep happening afterwards). This would leave us somewhere around January/February 2024.
### Part 3
The third and final part of the plan consists of leveraging the existing effort and the European meetup networks to spread Bisq workshops across Europe. This part could have some degree of overlap with part 2. And also, here efforts can be parallelized across different languages and regions. There is no need to execute different ones sequentially.
So far, I have spotted the following candidate networks/languages/regions:
- Einundzwanzig (https://einundzwanzig.space/meetups/) - German - Germany, Austria, Switzerland
- Decouvre Bitcoin (http://decouvrebitcoin.com/ambassadeurs/) - French - France
- Satoshi Spritz (http://satoshispritz.it/) - Italian - Italy
- Bitcoin Events (https://bitcoinevents.uk/uk-bitcoin-meetup-map/) - English - UK and Ireland
For each of these regions, execution would consist on:
- Translating the Workshop Kit to the corresponding language.
- Establishing contact with organizers of both the Meetup networks themselves as well as with the organizers of specific meetups.
- Provide advice, support and guidance to meetup organizers and community members on how to execute the Workshops.
The deliverables for part 3 would be the Workshop Kit translated into the different languages and reports on the workshops that took place. I think a three-month period is also reasonable here (even though more workshops can keep happening afterwards). Given my lack of social connections outside the Spanish meetup scene, help would be appreciated, and my hope is that at some point, things get a life of their own and Bisq and the training material spread organically across the networks.
### Potential next steps
The scope of my proposal is limited to what is described above. Nevertheless, a few lines of work can be foreseen already:
- Expanding the viral effort to other languages and regions.
- Maintenance work on the Workshop Kit to keep up with new Bisq 2 releases and anything new that comes around.
## Open issues
There are a few areas where things are not 100% clear to me and I would appreciate your feedback or suggestions:
- Measuring the success of this is rather difficult. There is no way to distinguish adoption generated by this proposal from adoption coming organically or from other initiatives. Any input here would be welcome, but I don't this has any decent solution.
- Keeping a list of workshops that have taken place, along with details on them such as the assistance count would be a proxy measure. For the Spanish community, I will probably be capable of roughly keeping track of that. But beyond that, I think I would have a hard time, plus me chasing events is not reliable or scalable. I haven't found any creative solutions or workarounds yet. One way would be to lock down the content and only provide it upon request, but I think that wouldn't fit our philosophy and would also introduce a lot of friction. I would rather have people use it without us knowing than sacrifice that to keep track of who's using it. Suggestions will be appreciated here.
- I also think it would be interesting to have incentives that could be provided to meetups and their organizers. In my opinion, any kind of financial compensation should be out of the question. I don't think it aligns with the grassroots attitude of the project, it could potentially attack greedy mercenaries who really don't care about Bitcoin or their communities and it would send the wrong message. I would trust someone from my community running the workshop because they think the app and system are great, but I would be suspicious if that person was getting paid for it. Perhaps offering a free small merch pack with a few t-shirts, stickers and such to communities that will hold a workshop could help both on this point and the previous one. Anyway, any incentive ideas will be more than welcome.
- If you are aware of any other interesting meetup network that I have missed, I'll be happy to know about it and include it in the list.
- As well, if you are related to any of these networks or run a meetup and want to help spread the message, it would be great to hear from you.
## Related ideas
Some proposals with some degree of overlap have been discussed in the past. Here is non-exhaustive list:
- https://github.com/bisq-network/growth/issues/204
- https://github.com/bisq-network/growth/issues/257

View file

@ -0,0 +1,176 @@
- Six sections
- Bisq
- Bitcoin
- Security
- Privacy
- Wallets
- Open source
- What is my word budget?
- 4 sections per domain
- 600 words per domain
## Bisq
### Exchange, decentralized
Bisq is an exchange application where you can buy and sell Bitcoin for national currencies or other cryptocurrencies. Unlike most exchange alternatives, Bisq is both decentralized and peer-to-peer.
It is decentralized because it does not depend nor is it controlled by any single company, team or government. Decentralization makes Bisq a resilient network: just like Bitcoin, it exists because of users like you. Since there is no single element on which everything relies, it is significantly hard for anybody to stop or hurt the network.
It is peer-to-peer because each trade you perform is matched with another user just like you. This helps you protect your privacy from centralized elements like governments and traditional financial institutions. It also makes Bisq permissionless: you don't need anybody's authorization to use it, and nobody can stop you from doing it.
Currently, two applications exist: Bisq 1 and Bisq 2. Bisq 2 is the application where you are reading this. We recommend you to get familiar with Bisq 2 before you try to learn more about Bisq 1.
### Why Bisq
For many users, Bisq is the preferred method to buy or sell Bitcoin in exchange for national currencies. This is because Bisq's nature results in a completely different experience to that of Centralized Exchanges.
Many users value the privacy-respecting nature of Bisq. You don't need to provide any kind of personal information to use Bisq. Whenever you trade, you only need to share your payment details with your trade partner. Nobody else has access to this data, and there is no central database where all of your information and transactions will end up stored for years or decades.
Bisq also allows users to overcome any lack of permissions that can be imposed arbitrarily by their local governments or financial institutions. Examples of this can be governments that declare Bitcoin possession or trading illegal, or banks that forbid customers from sending their own money to exchange institutions. Users in these situations find in Bisq a way to work around them being excluded from the traditional financial system for any kind of reason.
Finally, Bisq is a safe way to exchange Bitcoin and national currencies. The existing trade protocols and reputation systems prevent bad actors from stealing your funds. Mediators are always available to support you if another peer is not behaving properly and will step in if necessary to work out a solution for your case. The result: Bisq users can happily trade with others without having to worry about losing their funds.
### Trade safely
Exchanging your Bitcoin and national currencies with other peers comes with great benefits like not depending on companies or protecting your privacy. But you might be wondering: how can I know if the peer I'm trading with is honest? Won't I get scammed? Those are valid concerns that you should always keep in mind and that Bisq addresses in several ways to allow safe trading.
The different trade protocols (you can think a protocol as the rules you and your peer will have to follow) minimize the risk of any actor scamming his peer during a trade. You can read more in detail about the different protocols available in Bisq 1 and Bisq 2 here #TODO: add link. There is usually a trade-off between security and convenience: some protocols are more robust, others are more convenient and fast. It is up to you to decide which protocol to use on each trade, depending on your preferences and needs, as well as the traded amount. Protocols like Bisq Easy are recommended for small sums of money, while more robust and structured protocols like Bisq Multisig are advisable for larger amounts.
If your trade ends up in a conflict with your trade peer, or the peer simply disappears and becomes unresponsive, you will not be left alone. Mediators and arbitrators are always available to advice and provide solutions in these situations. These roles will observe each case, propose friendly solutions between the traders, and potentially make final decisions if no agreements are reached. If you have acted honestly and followed the rules, the outcomes will be in your favor and you will never lose your funds. You can read more about mediation and arbitration here #TODO: add link.
In summary, Bisq is designed to minimize the need for trusting other peers and to discourage scamming and other bad behaviors. This translates in very few trades having any kind of conflict, and those which do will always be solved in a reasonable way through mediation and/or arbitration. The result: trading in Bisq is a safe and smooth experience.
## Bitcoin
A peer-to-peer electronic cash that allows online payments to be sent directly without intermediaries.
### What is Bitcoin
Bitcoin is the largest and most popular cryptocurrency in the world. It is a digital form of cash that allows anybody to send value to other people without the need for intermediaries. It started out in 2009 and has grown massively since then, gaining adoption throughout the world because of its unique and appealing properties.
Bitcoin differs from all national currencies in several aspects. Bitcoin is not controlled or issued by any government or institution. It is decentralized, and it exists only because of the thousands of people across the world who use it. This makes it neutral money, where nobody is in a privileged position that allows abuse. This also means that you are free to use Bitcoin without requiring any kind of permission, and nobody in the system has more power than you. It's an open system that welcomes everyone. Another important property is that you can hold Bitcoin in self-custody. In other words, you can own it yourself without depending on any other company or entity. Comparing it to traditional currencies, it's more similar to cash in your pocket (which you completely control) than to a balance in a bank account (where you are subject to the bank's conditions and wishes). Because of this, you are also always free to send Bitcoin: you don't need anybody's approval to do so, and your transactions can't be stopped or reversed. A third interesting aspect is that Bitcoin's supply is limited to a maximum of 21 million. This means that the value of each bitcoin, unlike the value of each dollar for example, can't be debased by creating more of it. Bitcoin is created through a costly process called mining, and the amount and schedule that can be created through mining is strictly defined and can't be modified. This makes the supply limited and certain, making Bitcoin attractive due to its scarcity.
### Why use Bitcoin
Bitcoin's properties make it a unique asset that attracts different people for different reasons. How Bitcoin appeals to you depends on your profile and needs.
One of the most common reasons for people to use Bitcoin is its capacity to protect value over time. The national currencies of most countries in the world lose value continuously over time due to currency debasement. This means that by holding your savings in cash or in a bank account, you are gradually losing them because their value goes down over time. Bitcoin's limited supply prevents this from happening, so even if it behaves in a volatile way in the short term, it is a powerful tool to preserve your wealth in the long term.
Another reason for individuals to use Bitcoin is to protect themselves from the actions and decisions of governments and financial institutions. Since Bitcoin is something you can own, send, and receive in a permission-less way, the value stored in it is not affected by situations like a central bank printing more units of its national currency, a bank deciding to block your transfers for arbitrary reasons, or a government imposing confiscations on its population. With Bitcoin, the rules of the game are well-known and predictable, and you can count on the network being fair and treating everyone equally.
Bitcoin is also very attractive for those who engage in international trade and seek to send or receive money to other countries or regions. Bitcoin has no concept of borders and works the same whether you send some to your neighbor or to someone on the other side of the world. Since making payments to people or companies in different regions of the world usually means long waiting times, significant fees, and cumbersome red tape, some people chose Bitcoin as a simple and convenient alternative for their cross-region payments. It also means that you can use it to send money to countries that your government or bank have decided to block.
Finally, some people chose Bitcoin for its simplicity and convenience. Bitcoin presents many advantages in this sense with respect to traditional currencies. With it, you don't need to deal with contracts and long bureaucratic processes to do simple things like opening an account. You can easily access your money on all your devices. You can send it anywhere and to anyone without the need for different forms of payment (cash, bank transfers of different sorts, credit cards, etc.). You can easily protect and secure your funds with the right knowledge, and you will enjoy not having to worry about someone stealing your wallet or credit card details.
Bitcoin is a huge and innovative step forward in the world of money and payments. There is almost certainly some reason for which Bitcoin can be attractive and useful for your needs, so we encourage you to learn more and to become familiar with it.
- What is Bitcoin
- Why Bitcoin
- How to obtain and use
## Security
Because Bitcoin is quite different from national currencies in the way it works, the precautions you need to take are also quite different from what you are probably used to. This is also a highly important topic because, while Bitcoin provides you with a lot of power and freedom, it also makes you responsible for taking care of your funds. Therefore, you should invest some time and effort to learn how to do so securely.
While security is a complex topic, we can boil things down to three main goals: to ensure that other people never have access to your private keys, to ensure that you always have access to your private keys, and to avoid accidentally sending your bitcoin away to scammers and other untrusted peers.
### Securing your keys
First of all, you must understand one simple idea: not your keys, not your coins. This means that, in order for you to truly own your Bitcoin, it should be stored in a wallet where you, and only you, own the keys. This means that a Bitcoin balance in entities such as banks and centralized exchanges is not really Bitcoin that you own since it's those entities, and not you, who hold the keys to your funds. If you truly want to own your bitcoin, you must store it in a wallet for which only you control the keys.
There are many Bitcoin wallets out there, each with its own unique design and features. What they all have in common is that, somehow, somewhere, they will store your private keys. These keys provide access to your funds. Whatever wallet you use, you must make sure that only you, or people you fully trust, have access to these keys. If anyone else has access to them, they will be able to steal your funds from you, and nothing can be done to reverse this transaction. On the other hand, losing the keys yourself is equally terrible. If you lose your keys, you will not be able to send your funds anymore, and there is no way to take back control of them. While this might sound daunting, you can easily avoid these situations with a bit of learning and good practices.
Most bitcoin wallets will provide you with a 12 or 24 words long backup, commonly known as the mnemonic phrase or simply the seedphrase. This backup phrase allows you to restore your wallet on any device, making it the most important element for you to secure. It is generally advised to store these backup in analogical form, mostly by writing it in a piece of paper or in a small metal sheet, and to have multiple copies of it. You should also store it so that you can find it if you need it, but no one else can access it.
For significant amounts of Bitcoin, it's usual to employ specialized devices called Hardware Wallets to store your keys. These devices offer a superior level of security with respect to storing your keys in a smartphone or laptop wallet, while providing a convenient experience when it comes to making transaction. You can learn more about these and other types of wallets in the Wallets section of Bisq Learn.
Finally, make sure to avoid overly complicated storage schemes.An advanced storage plan with many details and subtleties will keep thieves away from your funds, there is also a significant chance that you might not be able to access your own wallet due to mistakes, confusion, or simply forgetting how you organized the backups. Aim for a balance between a set-up that is too simple and anybody could easily break (like storing your seedphrase in a plain text file in your laptop's desktop) and one that is so complex that not even you can crack (like storing the words of your phrase across 12 books in 12 different locations).
### Avoid scams
Another source of problems and risks are scams. Bitcoin's transactions are irreversible, which means that if someone tricks you into sending them some Bitcoin and then runs away with it, there isn't really much that you can do about it. Because of this, it is common to encounter different schemes where people will try to convince you to send some Bitcoin to them. Most of the time, scammers will present you with some wonderful "opportunity" for you to earn money easily, which tends to sound too good to be true. The specific stories and details surrounding these scams are extremely diverse and creative, but the common pattern will always look the same: you will be offered some wonderful returns, but first, you will have to send bitcoin in advance. Once the Bitcoin is sent, you will probably never see it come back to you. Defending yourself against these scams is simple: interact only with reputable and trusted companies and people. If you feel some entity is sketchy, ask for references or simply steer away from it. If you are offered an opportunity that feels almost too good to be true, it probably is, and you should stay away from it.
## Privacy
Keeping your financial information and identity private is a common need among Bitcoin users. It is natural and logical to not want other people to know about your funds and transactions without your consent. After all, you wouldn't wear a T-shirt with your bank account balance and credit card reports while you walked down the street, would you? Privacy is an important topic in Bitcoin because the transparent nature of Bitcoin transactions and addresses makes mistakes in this area especially costly. In this section, we cover some points on privacy in your Bitcoin journey.
### Why privacy is relevant
Many users value the freedom that Bitcoin provides them to own their property and transact freely and without permission with others. But without good privacy practices, these features of Bitcoin get seriously eroded. Disclosing information about yourself and your Bitcoin funds will put you at risk of several kinds of attacks from others that will restrict your own freedom. Reflecting on what data you are sharing and being mindful of this will prevent you from making costly mistakes that you might regret down the line.
The first obvious issue with revealing your identity and details about your funds is personal safety. If someone knows details such as how much bitcoin you hold, where you live, and what kind of wallet you are using, they could easily plot a physical attack against you in order to get hold of your keys. This is especially tempting in comparison with national currency bank accounts, since Bitcoin transactions are irreversible. Thus, if a thief manages to force you to send your bitcoin to an address of his own, or just steals your wallet keys and does so himself, there will be no way to cancel that transaction and your bitcoin won't be yours anymore. Keeping your identity and financial details private prevents you from becoming a target of this kind of attack.
Another good reason to keep your details private is the danger posed by hostile government regulations and actions. Governments throughout the world have repeatedly taken actions against their citizens' private property in various ways. A great example of this is Executive Order 6102, which made it illegal for US citizens to hold gold and caused a unilateral confiscation of gold for millions of citizens. Just like with regular thieves, ensuring that government entities and personnel hold no information about you and your funds protects you in case the government starts a negative policy against owners of Bitcoin.
Finally, overall, you probably just don't want others to know how much Bitcoin you hold or what transactions you perform. Just like we protect our bank accounts with various methods so that only we can check our balances and movements, it makes sense to ensure others don't have the ability to view the transactions and their details, such as when, how much, or with whom we transact.
### How we give up our privacy
There are many ways in which one can voluntarily or accidentally disclose personal details. Most times, these are easy to prevent with a bit of common sense, since we frequently just give our details away by not being thoughtful about it. Some more subtle leaks will require some technical knowledge and time. But the good news is that, with minimal effort, the most significant issues can be avoided.
The clear champion of privacy mistakes, both because of how frequent and how terrible it is, is simply providing your ID when buying or selling Bitcoin. Nowadays, most centralized exchanges (companies like Coinbase, Kraken, Binance, etc.) are subject to government KYC regulations (KYC stands for Know Your Customer). This means that governments force these companies to ask for your passport, national identity card, driver's license, or similar documents so that this information can be associated with your account. From the moment you give these away, every purchase and sale you make will be recorded and linked to you. Furthermore, the exchange and government agencies will have full visibility of your balances at any time. Even if you decide to take your Bitcoin out of these exchanges and into a wallet you custody yourself, these parties will be able to track which addresses your funds were sent to. And if this is not worrisome enough, there is another concern to keep in mind: if any hacker gains access to the databases of these companies, your information could be leaked publicly to the internet, enabling anyone in the world to know all your stored personal and financial information. This is a situation that has happened many times in the past few years, with terrible consequences for some of the affected customers of the exchanges.
Another area where attention must be paid is address re-use. Every time you provide someone with an address of your wallet in order to receive a transaction from them, this person learns that this address belongs to you. This means that, from this point on, the person could monitor the address and all its activity. If you reuse this address repeatedly, every person you interact with will be able to see the different transactions going through the address, including when they happen, where the funds are coming from and going to, and the amounts being transacted.
Finally, relying on other people's nodes to read blockchain data means that the node runner could potentially monitor what addresses your wallet is interested in. When handling significant amounts of Bitcoin, it pays off to learn how to run your own node and connect your wallet to it. Or, at least, be mindful about which node you are connecting to and choose one from a person or organization you trust, such as a friend who is more experienced in Bitcoin or a local Bitcoin community.
### Bisq helps protect your privacy
Bisq allows you to buy and sell Bitcoin from other peers. This simple difference comes with a world of advantages regarding privacy when compared to using centralized exchanges. By using Bisq, you protect your safety and privacy from governments, companies, and other hostile third parties that would otherwise record and use your data against your own interests.
When you transact in Bisq, only your peer and you know the details of the transaction. And even between both of you, the information that needs to be shared is completely minimized and restricted to the strictly necessary payment details, like, for example, your bank account number if you want to receive a fiat payment in your bank account. This means there is no need to provide information like your ID, address, etc. Furthermore, the ability to interact with different peers on every trade prevents any single individual from accumulating data about you over time, thus distributing your transaction history across different counterparties and preventing any single entity from holding a complete view of your financial life. Bisq also allows you to receive any bitcoin you purchase directly into an address of a wallet you control, enabling you to keep control of your funds at all times, and to distribute them across different addresses so that no single peer can monitor your entire wallet.
Finally, remember that Bisq is just a piece of software that runs in your computer, and only connects to the internet through privacy friendly networks like Tor and I2P. You don't even need to sign up anywhere in a pseudonymous way. Because of this, nobody can even know that you are using Bisq, and your communication with other participants can't be monitored, tracked or accessed by third parties.
## Wallets
### What is a wallet
Wallets are your tool to perform the most fundamental actions in Bitcoin: receiving it, storing it and sending it. Since Bitcoin is an open system, anyone can build a wallet for it, and many different ones exist. This is great because it means you have plenty of different options in the market from which to choose, and you can even use multiple different wallets to cover different needs.
Generally, a wallet is a piece of software that does several things for you: it reads the blockchain to check the balance of the addresses you control. It can build and send transactions when you want to pay someone else. And it holds your keys so that you can sign your transactions. Some of these features look different in different wallets, and some wallets only cover parts of them. To understand this better, it's useful to be familiar with the different characteristics that make wallets different from each other.
First, you should understand the difference between a hot wallet and a cold wallet. A hot wallet is a software wallet where the keys that control your bitcoin are stored on an internet-connected device. A cold wallet, on the other hand, is a setup where your keys are stored on a device that is never connected to the internet, and you use a different software to track your balance and prepare and send transactions. Hot wallets are typically a simple app on your phone or laptop. A cold wallet, on the other hand, means you use a software in your phone or laptop that does not hold your keys, and you combine that with a second device that holds the keys and never connects to the internet. This second device could be a dedicated laptop or smartphone, or more commonly, a hardware wallet. Hot wallets are simpler to manage and use, but they are also less secure. Cold wallets require a slightly more complex and cumbersome setup, but offer a much higher degree of safety against hacks and mistakes when handling keys. How to handle the risks of managing your funds is a personal decision, but it is generally recommended to use hot wallets like your traditional wallet for bills and coins in your pocket, and cold wallets like a safe box in a bank. You wouldn't carry a million dollars in your wallet. And you wouldn't use the contents of your safe box to pay for a coffee.
Hardware wallets are special physical devices that are designed and manufactured with the sole purpose of storing the keys to your funds and signing transactions with those keys. They offer a convenient way to sign transactions to spend your funds, while storing your keys in a safe way that prevents leaking them to others. Using a hardware wallet improves your safety by orders of magnitude in comparison to using a hot wallet on your main computer or smartphone. If you are getting started on your Bitcoin journey, you don't need to have a wallet since day one, but you probably want to obtain one once you start accumulating an amount of bitcoin that would hurt to lose. There are many hardware wallets on the market, with typical prices being around $100.
And a final note: a balance in a centralized exchange is not a wallet. Since you don't control the keys, you are relying on and trusting the centralized exchange to actually hold your bitcoin. If, for any reason, they do not send it to you when you decide to withdraw, there is no way for you to get hold of it. Remember: not your keys, not your coins.
### How to pick a wallet
Choosing the right wallet for you is a decision that depends on many factors, such as how you are going to use Bitcoin, what amounts you will be handling, or what devices you own. Nevertheless, there are a few general recommendations that you can follow and specific wallets that have a good track record.
The first and most important general advice is to pick an open source wallet. Ensuring your wallet's code is verifiable is paramount. You can learn more about this in the Open Source section of Bisq Learn. Another important recommendation is to pick a wallet that doesn't support other cryptocurrencies besides Bitcoin. Wallets that handle multiple cryptocurrencies need to use more complex code to work with the different supported currencies, which introduces bigger security risks. Hence, it is better to choose a Bitcoin-only wallet for your funds. Finally, try to look for wallets that have been around for a while, have strong user bases and have a good reputation. It is best to leave brand-new wallets for advanced usage or experiments at most.
If you plan on using your wallet on your smartphone, we advise looking into one of the following wallets: Bluewallet, Blockstream Green or Nunchuk. On the other hand, if you want to use a PC, we would suggest using one of the following: Sparrow, Bluewallet, Electrum, Blockstream Green or Nunchuk. These are all good wallets for beginners. You can try several of them to find which one suits you better, or even use multiple ones simultaneously if you want to. As you acquire more experience and knowledge, you might start developing preferences depending on the more advanced features that make these wallets a bit different from each other.
Once you have enough funds to start taking security even more seriously, it will probably make sense to acquire a hardware wallet. With a hardware wallet, you will be able to store your keys in it and sign transactions with it, while you can still use a software like Sparrow, Bluewallet or Nunchuk to read your balances and prepare transactions. When it comes to hardware wallets, most of the same advice applies: pick wallets that have transparent and public designs, that only support Bitcoin and that have a good reputation and track record. Some well-known brands are Coldcard, Bitbox, Trezor or Foundation.
The world of wallets is rich and diverse, which is both great and confusing. It's perfectly fine to be a bit overwhelmed at first. If you are just starting out, we would advise researching a bit, trying on some of the options we have shared with you, and, once you find one with which you feel comfortable, stick to it. As you keep learning more about Bitcoin, you can always explore new and more advanced options and switch to any other wallet, or use multiple of them, whenever you like.
## Open source
### Bitcoin and open source software
Open source software is software for which the code is publicly accessible and anyone can read, copy and modify that code in any way they see fit. This is in contrast with closed-source or proprietary software, where the original author decides to keep the code to himself and no one else has access or permission to it. Even though this might feel like a technical topic, it is in your interest to understand the implications of open source software on your Bitcoin journey. Let's dive into it.
The world of Bitcoin is deeply influenced by and related to open source software. The Bitcoin software itself has been open source since day one. Bisq is also an open source project. Many other surrounding technologies, like Lightning clients, mixing services or mining firmware, are typically built as open source projects. Many wallets are also open source, and as we discuss in the Wallets section of Bisq Learn, we heavily recommend that you pick wallets that are open source.
Why is this so? Closed source software is usually built and kept private by companies and individuals that want to charge others for licenses and keep full control of the project. In the Bitcoin space, this is rarely the case. Bitcoin is an open and welcoming system by nature, and the code is a representation of this. Anyone can see the code, modify it, share copies of his own version with others, and, put simply, do as he pleases with it. Bisq is also an open source project where everyone is welcome to participate, expand the application, and make improvements in different ways.
### How open source benefits you
You might think that, since you are not a software developer, whether the code of some software is public or not has little relevance to you. This is not the case at all. Even if you don't plan to look at or modify the code of the apps you are using, your experience with them will be deeply affected by whether the code is open or closed source. This is even more critical when we are talking about the software that will run your financial life and support your ability to save, receive and send money. Generally, using open source software will be more beneficial to you than using closed source equivalents. Let's break down a few important reasons that make this important to you.
A highly important reason to choose open source software is security. Since open source software can be read by anyone, hackers and malicious actors regularly try to find errors and security holes in it. You might think that this is dangerous, but it is actually the other way around! This is because the fact that the code is open to everyone means that anyone can look for security issues and either point to them, fix them themselves or exploit them maliciously. Collectively, the community of users and developers around the project will be able to spot and fix most errors quickly, often even before they are released. And if someone uses this error in a malicious way to exploit the software, it won't be long until it gets noticed and solutions are applied. On closed source software, only the small, paid team behind the project is reviewing the code, which translates into a much higher chance of errors going unnoticed. More eyes, fewer bugs. And companies also have an incentive to not disclose the fact that their closed source products have security issues, which leads to many bugs and hacks being kept secret instead of disclosed. Finally, since in closed source projects only the developing team can see the code, how can you or anyone else be fully confident that the software is safe? This links with one common saying in the Bitcoin culture: don't trust, verify. Overall, open source software leads to much more secure and robust results than closed source software.
Another great reason to choose open source software over closed source is the long term continuity of the former. Code that is public does not depend on any single entity or individual to be maintained over time. Even if the original team behind a project eventually disappears, others can take over and continue maintaining and evolving it. The greatest example of this is Bitcoin itself: even though its pseudonymous creator, Satoshi Nakamoto, disappeared more than ten years ago, the project has kept growing and thriving beyond all expectations. Thus, every time you choose open source software over closed source, you are dramatically reducing the chances that some company or developer will leave you stranded with some unmaintained software that fades and becomes outdated.
Finally, open source projects with widespread usage, like Bitcoin, Bisq or wallets such as Electrum, tend to lead to high-quality products by attracting the best talent. The open nature of the projects allows anyone to collaborate, and many great developers in the space would rather collaborate by building on top of a good project than start a duplicate effort from scratch. Over time, the cumulative contributions of these individuals lead to impressive results that frequently eclipse what most companies, even well-funded ones, could ever achieve.
Summing up, choosing open source options for your Bitcoin tooling comes with a great set of advantages that help you enjoy safe and useful products of high quality. We hope that you become curious about the nature of the code that you use in your daily life and that you make informed choices over the software you run.

BIN
bisq/timesheet.ods Normal file

Binary file not shown.

View file

@ -0,0 +1,66 @@
## Tab 1
- Tab title: Intro
- Main title: Get ready to receive your first Bitcoin
- Body:
In Bisq Easy, the Bitcoin you receive goes straight to your pocket without any intermediaries. That's a great advantage, but it also means you need to have a wallet that you control yourself to receive it!
In this quick wallet guide, we will show you in a few simple steps how you can create a simple wallet. With it, you will be able to receive and store your freshly purchased bitcoin.
If you are already familiar with on-chain wallets and have one, you can skip this guide and simply use your wallet.
## Tab 2
- Tab title: Download
- Main title: Downloading your wallet
- Body:
There are many wallets out there that you can use. In this guide, we will show you how to use Bluewallet. Bluewallet is great and, at the same time, very simple, and you can use it to receive your bitcoin from Bisq Easy.
You can download Bluewallet on your phone, regardless of whether you have an Android or iOS device. To do so, you can visit the official webpage at bluewallet.io. Once you are there, click on App Store or Google Play depending on the device you are using.
[![image.png](https://i.postimg.cc/nzXvTtFx/image.png)](https://postimg.cc/34H4JV0f)
**An important note:** for your safety, make sure that you download the app from the official app store of your device. The official app is provided by 'Bluewallet Services, S.R.L.', and you should be able to see this in your app store. Downloading a malicious copycat could put your funds at risk.
- Bottom link:
- Text: Click here to visit Bluewallet's page
- Link: https://bluewallet.io/
## Tab 3
- Tab title: New wallet
- Main title: Creating your new wallet
- Body:
Bluewallet allows you to create several wallets for different purposes. For now, you only need to have one wallet. Once you enter Bluewallet, you will see a message suggesting you add a new wallet. Once you do that, enter a name for your wallet and pick the option *Bitcoin* under the *Type* section. You can leave all other options as they appear and click on *Create*.
[![image.png](https://i.postimg.cc/4y6xMgQc/image.png)](https://postimg.cc/V0Nwr2Ts)
When you move to the next step, you will be presented with 12 words. These 12 words are the backup that allows you to recover your wallet if something happens to your phone. Write them down on a piece of paper (not digitally) in the same order in which they are presented, store this paper safely and make sure only you have access to it. You can read more about how to secure your wallet in the Learn sections of Bisq 2 dedicated to wallets and security.
Once you are done, click on *Ok, I wrote it down*. Congratulations! You have created your wallet! Let's move on to how to receive your bitcoin in it.
## Tab 4
- Tab title: Receiving
- Main title: Receiving bitcoin in your wallet
- Body:
To receive your Bitcoin, you are going to need to obtain an address from your wallet. To do so, click on your newly created wallet, and afterwards click on the Receive button at the bottom of the screen.
[![image.png](https://i.postimg.cc/wjZ7bHCW/image.png)](https://postimg.cc/Mn06nkKR)
Bluewallet will display an address of your wallet, both as a QR code and as a chain of letters and numbers. This address is what you will need to provide in Bisq Easy to your peer so that he can send you the Bitcoin you are buying. You can move the address to your laptop by scanning the QR code with your laptop's camera, by sending the address with an email or chat message, or even simply by typing it directly into your laptop.
[![image.png](https://i.postimg.cc/0Qf5xq41/image.png)](https://postimg.cc/JDsCcSmp)
Once you complete the trade, Bluewallet will notice the incoming Bitcoin and update your balance with the new funds. As you do more trades, you can and should always get a new address for each to protect your privacy.
These are the basics you need to know to start receiving Bitcoin in your own wallet. If you want to learn more about Bluewallet, we recommend checking out the videos listed below.
# Links
- Bluewallet with BTC Sessions: https://www.youtube.com/watch?v=imMX7i4qpmg&list=PLxdf8G0kzsUUE7HHNTGTWBFxzt2oudiyS&index=3
- Bluewallet with Anita Posch: https://www.youtube.com/watch?v=NqY3wBhloH4