https://github.com/bisq-network/bisq2
https://github.com/bisq-network/bisq2
Last synced: 9 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/bisq-network/bisq2
- Owner: bisq-network
- License: agpl-3.0
- Created: 2021-06-01T08:43:24.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2025-04-01T16:10:42.000Z (10 months ago)
- Last Synced: 2025-04-01T17:18:34.075Z (10 months ago)
- Language: Java
- Size: 283 MB
- Stars: 226
- Watchers: 18
- Forks: 83
- Open Issues: 140
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: security/build.gradle.kts
- Support: support/build.gradle.kts
Awesome Lists containing this project
README
# Bisq 2: The Decentralized Trading Platform
Bisq 2 will be the successor to [Bisq v1](https://github.com/bisq-network/bisq) and will support multiple trade
protocols, multiple privacy networks and multiple identities. Read more about Bisq 2 in
the [Bisq wiki](https://bisq.wiki/Bisq_2)
For the initial release Bisq 2 will come with the [Bisq Easy](https://bisq.wiki/Bisq_Easy) protocol only. Work on the
other protocols will start after Bisq 2 has been shipped.
Bisq Easy is designed for novice Bitcoin users with a focus on ease of use and convenience. It does not require that the
user already has Bitcoin and it is based on an easy-to-use chat interface. Security is based on reputation of the
Bitcoin seller. It does not compete with the current Bisq v1 trade protocol but is complementary to it. It serves and
targets a user group which we cannot reach with Bisq v1. You can read more about Bisq Easy
in [the Bisq wiki](https://bisq.wiki/Bisq_Easy).
## Getting Started
### Quick Setup
1. **Clone Bisq 2:**
```bash
git clone https://github.com/bisq-network/bisq2.git
cd bisq2
```
2. **Install Dependencies:**
Bisq requires JDK 21. See our [Installation Guide](./docs/dev/build.md) for detailed instructions.
3. **Setup bitcoind git submodule:**
At project setup run first:
```bash
git submodule update --init --remote
```
In case the submodule has changed after a project update, run:
```bash
cd wallets/bitcoind
git checkout main
git pull
cd ../..
```
Commit the updated submodule
```bash
git add wallets/bitcoind
git commit -m "Update submodule to latest commit on main"
```
4. **Run desktop client:**
```bash
./gradlew apps:desktop:desktop-app:run
```
5. **Run desktop client with custom data directory:**
```bash
apps/desktop/desktop-app/build/install/desktop-app/bin/desktop-app --data-dir=
```
**For Windows environments**: replace ./gradlew with gradle.bat as the previous example shows
## Community and Contributions
Bisq is an open source project and a [Decentralized Autonomous Organization (DAO)](https://bisq.network/dao/).
If you want to contribute to Bisq get in touch on [Matrix](https://matrix.to/#/#bisq.v2.dev:bitcoin.kyoto).
If you are a developer check out the [dev guide](./docs/dev/dev-guide.md).
**Why work on Bisq 2?**
- Compensated Contributions: Unique in open-source, contributors are rewarded for their work.
- Technological Edge: [P2P network](./docs/dev/network.md), Bitcoin, Cryptography,...
- Complex, Rewarding Challenges: Dive into a sophisticated architecture that rewards ingenuity.
## License
Bisq 2 is licensed under the [AGPL-3.0 license](LICENSE). All contributions are subject to this license.
