diff --git a/.gitignore b/.gitignore index 280ca79..cfbefd0 100644 --- a/.gitignore +++ b/.gitignore @@ -20,4 +20,5 @@ yarn-debug.log* yarn-error.log* # Backups -docusaurus.config copy.js \ No newline at end of file +docusaurus.config copy.js +_reference/ diff --git a/docs/about/coin-compatibility.md b/docs/about/coin-compatibility.md new file mode 100644 index 0000000..f302b0c --- /dev/null +++ b/docs/about/coin-compatibility.md @@ -0,0 +1,799 @@ +--- +sidebar_position: 3 +title: Coin Compatibility Matrix +description: "Complete matrix showing which coins can be swapped with each other and supported swap types" +--- + + + +
+ +
+
+
+
+
A · Adaptor Signature
+
Advanced cryptographic protocol
+
+
+
+
+
+
H · Secret Hash
+
Time-locked contract (HTLC)
+
+
+
+
+
+
V · VES Protocol
+
Verifiably encrypted signatures
+
+
+
+
+
+
- · Not Compatible
+
Pair not supported
+
+
+
+ +
+
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Maker · You Send
BTCBCHDASHDCRDOGEFIROLTCNMCPARTPART ANONPART BLINDPIVXWOWXMR
Taker · You ReceiveBTC
-
A
BTC ↔ BCH
Adaptor Signature
A,H
BTC ↔ DASH
AdaptorHash
A,H
BTC ↔ DCR
AdaptorHash
A
BTC ↔ DOGE
Adaptor Signature
A
BTC ↔ FIRO
Adaptor Signature
A,H
BTC ↔ LTC
AdaptorHash
A,H
BTC ↔ NMC
AdaptorHash
A,H
BTC ↔ PART
AdaptorHash
A
BTC ↔ PART ANON
Adaptor Signature
A
BTC ↔ PART BLIND
Adaptor Signature
A,H
BTC ↔ PIVX
AdaptorHash
A
BTC ↔ WOW
Adaptor Signature
A
BTC ↔ XMR
Adaptor Signature
BCH
A
BCH ↔ BTC
Adaptor Signature
-
-
BCH ↔ DASH
Not Compatible
A
BCH ↔ DCR
Adaptor Signature
-
BCH ↔ DOGE
Not Compatible
-
BCH ↔ FIRO
Not Compatible
A
BCH ↔ LTC
Adaptor Signature
A
BCH ↔ NMC
Adaptor Signature
A
BCH ↔ PART
Adaptor Signature
V
BCH ↔ PART ANON
VES Protocol
A
BCH ↔ PART BLIND
Adaptor Signature
-
BCH ↔ PIVX
Not Compatible
V
BCH ↔ WOW
VES Protocol
V
BCH ↔ XMR
VES Protocol
DASH
A,H
DASH ↔ BTC
AdaptorHash
-
DASH ↔ BCH
Not Compatible
-
A,H
DASH ↔ DCR
AdaptorHash
-
DASH ↔ DOGE
Not Compatible
-
DASH ↔ FIRO
Not Compatible
A,H
DASH ↔ LTC
AdaptorHash
A,H
DASH ↔ NMC
AdaptorHash
A,H
DASH ↔ PART
AdaptorHash
-
DASH ↔ PART ANON
Not Compatible
A
DASH ↔ PART BLIND
Adaptor Signature
H
DASH ↔ PIVX
Secret Hash
-
DASH ↔ WOW
Not Compatible
-
DASH ↔ XMR
Not Compatible
DCR
A,H
DCR ↔ BTC
AdaptorHash
A
DCR ↔ BCH
Adaptor Signature
A,H
DCR ↔ DASH
AdaptorHash
-
A
DCR ↔ DOGE
Adaptor Signature
A
DCR ↔ FIRO
Adaptor Signature
A,H
DCR ↔ LTC
AdaptorHash
A,H
DCR ↔ NMC
AdaptorHash
A,H
DCR ↔ PART
AdaptorHash
A
DCR ↔ PART ANON
Adaptor Signature
A
DCR ↔ PART BLIND
Adaptor Signature
A,H
DCR ↔ PIVX
AdaptorHash
A
DCR ↔ WOW
Adaptor Signature
A
DCR ↔ XMR
Adaptor Signature
DOGE
A
DOGE ↔ BTC
Adaptor Signature
-
DOGE ↔ BCH
Not Compatible
-
DOGE ↔ DASH
Not Compatible
A
DOGE ↔ DCR
Adaptor Signature
-
-
DOGE ↔ FIRO
Not Compatible
A
DOGE ↔ LTC
Adaptor Signature
A
DOGE ↔ NMC
Adaptor Signature
A
DOGE ↔ PART
Adaptor Signature
-
DOGE ↔ PART ANON
Not Compatible
A
DOGE ↔ PART BLIND
Adaptor Signature
-
DOGE ↔ PIVX
Not Compatible
-
DOGE ↔ WOW
Not Compatible
-
DOGE ↔ XMR
Not Compatible
FIRO
A
FIRO ↔ BTC
Adaptor Signature
-
FIRO ↔ BCH
Not Compatible
-
FIRO ↔ DASH
Not Compatible
A
FIRO ↔ DCR
Adaptor Signature
-
FIRO ↔ DOGE
Not Compatible
-
A
FIRO ↔ LTC
Adaptor Signature
A
FIRO ↔ NMC
Adaptor Signature
A
FIRO ↔ PART
Adaptor Signature
-
FIRO ↔ PART ANON
Not Compatible
A
FIRO ↔ PART BLIND
Adaptor Signature
-
FIRO ↔ PIVX
Not Compatible
-
FIRO ↔ WOW
Not Compatible
-
FIRO ↔ XMR
Not Compatible
LTC
A,H
LTC ↔ BTC
AdaptorHash
A
LTC ↔ BCH
Adaptor Signature
A,H
LTC ↔ DASH
AdaptorHash
A,H
LTC ↔ DCR
AdaptorHash
A
LTC ↔ DOGE
Adaptor Signature
A
LTC ↔ FIRO
Adaptor Signature
-
A,H
LTC ↔ NMC
AdaptorHash
A,H
LTC ↔ PART
AdaptorHash
A
LTC ↔ PART ANON
Adaptor Signature
A
LTC ↔ PART BLIND
Adaptor Signature
A,H
LTC ↔ PIVX
AdaptorHash
A
LTC ↔ WOW
Adaptor Signature
A
LTC ↔ XMR
Adaptor Signature
NMC
A,H
NMC ↔ BTC
AdaptorHash
A
NMC ↔ BCH
Adaptor Signature
A,H
NMC ↔ DASH
AdaptorHash
A,H
NMC ↔ DCR
AdaptorHash
A
NMC ↔ DOGE
Adaptor Signature
A
NMC ↔ FIRO
Adaptor Signature
A,H
NMC ↔ LTC
AdaptorHash
-
A,H
NMC ↔ PART
AdaptorHash
A
NMC ↔ PART ANON
Adaptor Signature
A
NMC ↔ PART BLIND
Adaptor Signature
A,H
NMC ↔ PIVX
AdaptorHash
A
NMC ↔ WOW
Adaptor Signature
A
NMC ↔ XMR
Adaptor Signature
PART
A,H
PART ↔ BTC
AdaptorHash
A
PART ↔ BCH
Adaptor Signature
A,H
PART ↔ DASH
AdaptorHash
A,H
PART ↔ DCR
AdaptorHash
A
PART ↔ DOGE
Adaptor Signature
A
PART ↔ FIRO
Adaptor Signature
A,H
PART ↔ LTC
AdaptorHash
A,H
PART ↔ NMC
AdaptorHash
-
A
PART ↔ PART ANON
Adaptor Signature
A
PART ↔ PART BLIND
Adaptor Signature
A,H
PART ↔ PIVX
AdaptorHash
A
PART ↔ WOW
Adaptor Signature
A
PART ↔ XMR
Adaptor Signature
PART ANON
A
PART ANON ↔ BTC
Adaptor Signature
V
PART ANON ↔ BCH
VES Protocol
-
PART ANON ↔ DASH
Not Compatible
A
PART ANON ↔ DCR
Adaptor Signature
-
PART ANON ↔ DOGE
Not Compatible
-
PART ANON ↔ FIRO
Not Compatible
A
PART ANON ↔ LTC
Adaptor Signature
A
PART ANON ↔ NMC
Adaptor Signature
A
PART ANON ↔ PART
Adaptor Signature
-
A
PART ANON ↔ PART BLIND
Adaptor Signature
-
PART ANON ↔ PIVX
Not Compatible
-
PART ANON ↔ WOW
Not Compatible
-
PART ANON ↔ XMR
Not Compatible
PART BLIND
A
PART BLIND ↔ BTC
Adaptor Signature
A
PART BLIND ↔ BCH
Adaptor Signature
A
PART BLIND ↔ DASH
Adaptor Signature
A
PART BLIND ↔ DCR
Adaptor Signature
A
PART BLIND ↔ DOGE
Adaptor Signature
A
PART BLIND ↔ FIRO
Adaptor Signature
A
PART BLIND ↔ LTC
Adaptor Signature
A
PART BLIND ↔ NMC
Adaptor Signature
A
PART BLIND ↔ PART
Adaptor Signature
A
PART BLIND ↔ PART ANON
Adaptor Signature
-
-
PART BLIND ↔ PIVX
Not Compatible
A
PART BLIND ↔ WOW
Adaptor Signature
A
PART BLIND ↔ XMR
Adaptor Signature
PIVX
A,H
PIVX ↔ BTC
AdaptorHash
-
PIVX ↔ BCH
Not Compatible
H
PIVX ↔ DASH
Secret Hash
A,H
PIVX ↔ DCR
AdaptorHash
-
PIVX ↔ DOGE
Not Compatible
-
PIVX ↔ FIRO
Not Compatible
A,H
PIVX ↔ LTC
AdaptorHash
A,H
PIVX ↔ NMC
AdaptorHash
A,H
PIVX ↔ PART
AdaptorHash
-
PIVX ↔ PART ANON
Not Compatible
-
PIVX ↔ PART BLIND
Not Compatible
-
-
PIVX ↔ WOW
Not Compatible
-
PIVX ↔ XMR
Not Compatible
WOW
A
WOW ↔ BTC
Adaptor Signature
V
WOW ↔ BCH
VES Protocol
-
WOW ↔ DASH
Not Compatible
A
WOW ↔ DCR
Adaptor Signature
-
WOW ↔ DOGE
Not Compatible
-
WOW ↔ FIRO
Not Compatible
A
WOW ↔ LTC
Adaptor Signature
A
WOW ↔ NMC
Adaptor Signature
A
WOW ↔ PART
Adaptor Signature
-
WOW ↔ PART ANON
Not Compatible
A
WOW ↔ PART BLIND
Adaptor Signature
-
WOW ↔ PIVX
Not Compatible
-
-
WOW ↔ XMR
Not Compatible
XMR
A
XMR ↔ BTC
Adaptor Signature
V
XMR ↔ BCH
VES Protocol
-
XMR ↔ DASH
Not Compatible
A
XMR ↔ DCR
Adaptor Signature
-
XMR ↔ DOGE
Not Compatible
-
XMR ↔ FIRO
Not Compatible
A
XMR ↔ LTC
Adaptor Signature
A
XMR ↔ NMC
Adaptor Signature
A
XMR ↔ PART
Adaptor Signature
-
XMR ↔ PART ANON
Not Compatible
A
XMR ↔ PART BLIND
Adaptor Signature
-
XMR ↔ PIVX
Not Compatible
-
XMR ↔ WOW
Not Compatible
-
+
+
+ +
+

Coin Categories

+
+
+
+

Scriptless

+
+
XMR · WOW · PART_ANON · FIRO · DOGE
+

+ Require adaptor signatures. Lack native scripting but participate through advanced cryptographic protocols. Cannot swap with other scriptless coins. +

+
+ +
+
+

Adaptor-Only

+
+
PART_BLIND · BCH
+

+ Exclusively use adaptor signatures. Can swap with scriptless and regular coins. Require Segwit in counterparty coins. +

+
+ +
+
+

No-Segwit

+
+
PIVX · DASH
+

+ Support both secret hash and adaptor signatures with compatible coins. Cannot swap with scriptless coins. Adaptor swaps not possible between no-segwit coins. +

+
+ +
+
+

Regular

+
+
PART · BTC · LTC · DCR · NMC
+

+ Maximum flexibility with both adaptor signatures and secret hash swaps. Adapt to counterparty coin requirements automatically. +

+
+
+
+ +
diff --git a/docs/about/under-the-hood.md b/docs/about/under-the-hood.md index 40fe4e4..e03620e 100644 --- a/docs/about/under-the-hood.md +++ b/docs/about/under-the-hood.md @@ -56,13 +56,17 @@ BasicSwap implements two distinct atomic swap protocols: HTLC ('Secret Hash') an

PTLC Protocol (Adaptor Sigs)

-

Employs adaptor signatures to enable atomic swaps with unscriptable coins like Monero while providing better privacy.

+

Employs adaptor signatures to enable atomic swaps with unscriptable coins like Monero while providing better privacy.

+:::tip Coin Compatibility +Different coins support different swap protocols based on their technical capabilities. Check the [Coin Compatibility Matrix](/docs/about/coin-compatibility) to see which swap types are available for specific trading pairs. +::: + ### Technical Implementation Both protocols are open-source developments from the broader cryptocurrency community and their scope is intentionally narrow — they do not match orders or provide a complete DEX framework. Instead, they focus exclusively on secure, trustless execution of exchanges directly on the respective blockchains without intermediaries. @@ -141,7 +145,7 @@ The SMSG network enables BasicSwap to offer functionality beyond what atomic swa * Automating complex swap procedures from the user's perspective * Facilitating secure communication between independent blockchain networks -In practice, BasicSwap functions as a decentralized alternative to SWIFT—providing a messaging protocol that enables direct peer-to-peer communication for executing atomic swaps using official coin cores (Bitcoin Core, Litecoin Core, etc.). +In practice, BasicSwap functions as a decentralized alternative to SWIFT in that it provides a messaging protocol that enables direct peer-to-peer communication for executing atomic swaps using official coin cores (Bitcoin Core, Litecoin Core, etc.) or [Electrum light wallets](/docs/user-guides/lightweight-modes) for supported coins (currently Bitcoin and Litecoin), or [remote nodes](/docs/user-guides/lightweight-modes#monero-remote-nodes) for Monero and Wownero. It's important to understand that BasicSwap itself does not process, initiate, or execute the actual swaps. Its role is strictly limited to enabling secure communication between trading parties and simplifying the complex process of performing atomic swaps across different blockchains. diff --git a/docs/intro.md b/docs/intro.md index b7444c4..9d2715d 100644 --- a/docs/intro.md +++ b/docs/intro.md @@ -167,11 +167,15 @@ BasicSwap's primary function is to help users establish a secure communication c

+:::tip Coin Compatibility Matrix +View the complete [Coin Compatibility Matrix](/docs/about/coin-compatibility) to see which coins can be swapped with each other and what swap types (Adaptor Signature, Secret Hash, or VES) are supported for each trading pair. +::: +