Permalink
Branch: master
Find file Copy path
ccfb580 Jan 29, 2019
2 contributors

Users who have contributed to this file

@pavlenex @dalijolijo
63 lines (48 sloc) 2.94 KB

Altcoins Frequently Asked Questions

This page answers some of the common questions about alternative cryptocurrencies - altcoins.

Which coins BTCPay Server supports?

Besides, Bitcoin as the core focus of the project, BTCPay natively supports following alternative cryptocurrencies:

  • Bitcoin Gold (BTG)
  • Bitcoin Plus (XBC)
  • Bitcore (BTX)
  • Dash (DASH)
  • Dogecoin (DOGE)
  • Feathercoin (FTC)
  • Groestlcoin (GRS)
  • Litecoin (LTC)
  • Monacoin (MONA)
  • Polis (POLIS)
  • Viacoin (VIA)

Native support means that these coins are using full nodes and that the payments are direct. There are certain third-party providers integrated which enable merchants to accept a more significant number of coins. Alternative coins are maintained by their respective communities.

Can an XYZ coin be added in BTCPay?

No. BTCPay developers can't add alternative coins on request. Adding a new coin explicitly depends on the community and developers of those coins. Furthermore, BTCPay developers do not spend excessive time testing nor maintaining the altcoins. If you're submitting a PR for a new coin, make sure that it works. If the altcoin integration is not actively maintained it will be removed.

How to an altcoin in BTCPay?

To add a new coin to BTCPay, please follow the instructions here.

How to add an altcoin to an existing BTCPay deployment?

If you want to expand the number of coins in your existing BTCPayServer installation, make sure that you have enough storage space.

In this example, we only have Bitcoin, and we're adding Litecoin to our docker deployment.

The coin structure:

BTCPAYGEN_CRYPTO1: First supported cryptocurrency (e.g., BTC, LTC. Default: btc)
BTCPAYGEN_CRYPTO2: Second supported crypto currency (e.g. btc, ltc. Default: (empty))
BTCPAYGEN_CRYPTON: N'th supported crypto currency where N is 9 at maximum. (eg. btc, ltc. Default: (empty))

To add Litecoin, as your second coin (CRYPTO2) do this :

sudo su -
export BTCPAYGEN_CRYPTO2="ltc"
. ./btcpay-setup.sh -i

How to remove a coin from BTCPay?

In the example above we've added Litecoin as the second coin. To remove a particular coin, use the following command:

sudo su -
export BTCPAYGEN_CRYPTO2=""
. ./btcpay-setup.sh -i

Where CRYPTO02 should be replaced with a coin number you wish to remove. If you have an XYZ coin as BTCPAYGEN_CRYPTO3, and you want to remove it, you should use CRYPTO3.