diff --git a/basicswap-dex/basicswap_explained.rst b/basicswap-dex/basicswap_explained.rst index 466ab0e..3c85903 100644 --- a/basicswap-dex/basicswap_explained.rst +++ b/basicswap-dex/basicswap_explained.rst @@ -76,12 +76,23 @@ Compatible Coins BasicSwap already offers decentralized trading services for the following cryptocurrencies. -* **Bitcoin** -* **Monero** -* **Particl** -* **PIVX** -* **Litecoin** -* **Namecoin** ++----------------------------------+---------------------------------------------+ +| **Coin Name** | **Ticker** | ++----------------------------------+---------------------------------------------+ +| Bitcoin | BTC | ++----------------------------------+---------------------------------------------+ +| Monero | XMR | ++----------------------------------+---------------------------------------------+ +| Litecoin | LTC | ++----------------------------------+---------------------------------------------+ +| Firo | FIRO | ++----------------------------------+---------------------------------------------+ +| PIVX | PIVX | ++----------------------------------+---------------------------------------------+ +| Particl | PART | ++----------------------------------+---------------------------------------------+ +| Namecoin | NMC | ++----------------------------------+---------------------------------------------+ We are looking at adding many other coins, including ETH and its ERC-20 tokens, following the release of the open beta. Any Bitcoin-based and Segwit-enabled :term:`cryptocurrency` can get integrated with minimal effort. Other token-issuing blockchains like Fantom, Solana, Avalanche, Polygon, or BSC may become available on BasicSwap at a later stage of the integration roadmap. @@ -170,4 +181,4 @@ Gateways, each with pros and cons, may display things differently or provide a d - BasicSwap Guides - :doc:`Install and Get Started <../basicswap-guides/basicswapguides_installation>` - BasicSwap Guides - :doc:`How to Use <../basicswap-guides/basicswapguides_usage>` - BasicSwap Guides - :doc:`Add or Remove a Coin <../basicswap-guides/basicswapguides_installation>` - - BasicSwap Guides - :doc:`Apply for Coin Listing <../basicswap-guides/basicswapguides_apply>` \ No newline at end of file + - BasicSwap Guides - :doc:`Apply for Coin Listing <../basicswap-guides/basicswapguides_apply>` diff --git a/basicswap-guides/basicswapguides_apply.rst b/basicswap-guides/basicswapguides_apply.rst index 8d3f731..0d3ef48 100644 --- a/basicswap-guides/basicswapguides_apply.rst +++ b/basicswap-guides/basicswapguides_apply.rst @@ -2,4 +2,114 @@ Apply for Listing ================= -Coming soon™ \ No newline at end of file +.. title:: + BasicSwap DEX Coin Usage Guide + +.. meta:: + :description lang=en: Add your coin to the BasicSwap DEX or apply for listing. + :keywords lang=en: Particl, DEX, Trading, Exchange, Buy Crypto, Sell Crypto, Installation, Quickstart, Blockchain, Privacy, E-Commerce, multi-vendor marketplace, online marketplace + +The :term:`BasicSwap DEX ` lets you trade a range of cryptocurrencies in total privacy and without third-party assistance. And thanks to its open-source framework, anyone can add new coins to the DEX. + +This guide will show you how to add new coins to the BasicSwap DEX; either by manually integrating them or by submitting a coin listing application to the BasicSwap team. + +---- + +.. contents:: Table of Contents + :local: + :backlinks: none + :depth: 2 + +---- + +.. attention:: + + BasicSwap is a cross-chain DEX that makes on-chain swaps. For this reason, each coin integration has to be worked out on a case-by-case basis. If you struggle to integrate a coin manually, consider submitting a listing application request. + +Manual Integration +================== + +Thanks to its open-source nature, it is possible for anyone to submit their own coin integrations on Github. When successfully merged into the code, anyone with an up-to-date version of BasicSwap can then trade that new coin. + +Requirements +------------ + +.. note:: + + The following requirements are up-to-date with BasicSwap's latest version (|BS_version|). + +Because BasicSwap is an entirely cross-chain DEX, there are basic requirements that a coin must possess to be readily integrated. + +**The blockchain...** + +* Uses UTXO scripts +* Has CLTV or CSV +* Has Segwit enabled +* Works with watch-only addresses + +Testing for Requirements +~~~~~~~~~~~~~~~~~~~~~~~~ + +In most cases, BasicSwap's requirements test script can help you quickly determine whether a coin can be readily integrated or not. + +If a coin does not pass the test or misses a few requirements, don't worry; it can probably still be integrated but may require the BasicSwap team to work on a custom integration framework. If that's your case, consider submitting a listing application request. + +.. rst-class:: bignums + + #. Install BasicSwap and ensure you are running the latest version (|BS_version|). + #. Open the `basicswap` folder in a terminal. + #. Navigate to where the test script is located. + + .. code-block:: bash + + cd scripts + #. Run the script by typing the following command while making sure to put the right destination folder for your coin's core. + + .. code-block:: bash + + py requirements.python ~/Applications/particl/bin/particld -d + +Integration Process +------------------- + +If the coin you want to integrate meets all the requirements mentioned above, then there are good chances you will be able to add it to the DEX. + +But remember, new coin integrations remain a case-by-case process that varies depending on what coin is being integrated. + +With this in mind, you can check how other coins that may be similar to yours have been integrated into the DEX and derive your own process from these examples. Click on the numbers next to each coin's name to study their integration code. + + ===================================================================================================================================================================================================================================================================================================== =============== ================== ======= ====== ========= ======================= + Coin UTXO Scripts Bitcoin Version CLTV CSV Segwit Watch-only Addresses + ===================================================================================================================================================================================================================================================================================================== =============== ================== ======= ====== ========= ======================= + Bitcoin Yes 24.0 Yes Yes Yes Yes + Monero No — — — — — + Litecoin Yes 0.21 Yes Yes Yes Yes + Dash (`1 `_, `2 `_, `3 `_) Yes — Yes Yes No Yes + Firo (`1 `_) Yes — Yes Yes No Yes + PIVX (`1 `_) Yes — Yes No No Yes + Particl Yes 24.0 Yes Yes Yes Yes + ===================================================================================================================================================================================================================================================================================================== =============== ================== ======= ====== ========= ======================= + +Apply for a Listing +=================== + +Alternatively, you can send us a `listing application `_. This is a great option if your coin does not meet most of the requirements or if you would rather focus your development resources elsewhere. + +Please note, however, that on top of adding new coins, we are also constantly working on tackling our roadmap; improving and growing BasicSwap in the process. For this reason, we cannot guarantee a swift integration for all applicants. + +To submit a listing application for your coin, follow this link: https://BasicSwapDEX.com/apply + +.. tip:: + + To bump the priority of your application, consider pledging a donation to our open-source developers as part of your application. + +---- + +.. seealso:: + + - BasicSwap Explained - :doc:`BasicSwap Explained <../basicswap-dex/basicswap_explained>` + - BasicSwap Guides - :doc:`Install BasicSwap <../basicswap-guides/basicswapguides_installation>` + - BasicSwap Guides - :doc:`Update BasicSwap <../basicswap-guides/basicswapguides_update>` + - BasicSwap Guides - :doc:`Route BasicSwap Through Tor <../basicswap-guides/basicswapguides_update>` + - BasicSwap Guides - :doc:`Make an Offer <../basicswap-guides/basicswapguides_make>` + - BasicSwap Guides - :doc:`Take an Offer <../basicswap-guides/basicswapguides_take>` diff --git a/glossary.rst b/glossary.rst index 82a3b12..16c9e09 100644 --- a/glossary.rst +++ b/glossary.rst @@ -84,7 +84,7 @@ Particl Terms SecureMessaging (SMSG) SecureMessaging (SMSG) is Particl’s own custom-built and unique P2P messaging network that stands at the very core of its ecosystem. Inspired by the BitMessage protocol, it is a mixnet that acts as a decentralized storage network (DSN). It stores and transfers data across nodes in a privacy-preserving manner, encrypted from end to end (E2EE), and without requiring the use of any central server. It provides Particl’s privacy-first dApps like Particl Marketplace and BasicSwap DEX with advanced capabilities. - Particl Stakeholders + Particl Stakeholders Particl Stakeholders participate in the maintenance and functionality of the Particl Blockchain. Particl Stakeholders collect small PART rewards for staking on the network, and may participate in governance proposal votes and Particl Marketplace’s community-based moderation. The rewards and voting strength that a stakeholder enjoys are generally correlated with the amount of PART tokens being staked by that individual. Particl Core diff --git a/index.rst b/index.rst index fc0c9f3..7bc3e78 100644 --- a/index.rst +++ b/index.rst @@ -172,12 +172,10 @@ Follow step-by-step user guides on how to use BasicSwap DEX and become an expert :maxdepth: 2 :hidden: - basicswap-guides/basicswapguides_installation basicswap-guides/basicswapguides_usage basicswap-guides/basicswapguides_addremovecoins basicswap-guides/basicswapguides_apply -* :doc:`Get Started ` * :doc:`How to Trade ` * :doc:`Add or Remove Coins ` * :doc:`Apply for Listing ` @@ -229,4 +227,4 @@ Resources and Links .. note:: - This documentation is up-to-date with Particl's latest version, |PD version|. Please keep in mind this software is still in :guilabel:`BETA`, and as such, lots of features and improvements are regularly added. \ No newline at end of file + This documentation is up-to-date with Particl's latest version, |PD version|. Please keep in mind this software is still in :guilabel:`BETA`, and as such, lots of features and improvements are regularly added.