Skip to content

Latest commit

 

History

History
94 lines (64 loc) · 6.1 KB

README.md

File metadata and controls

94 lines (64 loc) · 6.1 KB

Monero support plugin

This plugin extends BTCPay Server to enable users to receive payments via Monero.

Warning

This plugin shares a single Monero wallet across all the stores in the BTCPay Server instance. Use this plugin only if you are not sharing your instance.

Checkout

Configuration

Configure this plugin using the following environment variables:

Environment variable Description Example
BTCPAY_XMR_DAEMON_URI Required. The URI of the monerod RPC interface. http://127.0.0.1:18081
BTCPAY_XMR_DAEMON_USERNAME Optional. The username for authenticating with the daemon. john
BTCPAY_XMR_DAEMON_PASSWORD Optional. The password for authenticating with the daemon. secret
BTCPAY_XMR_WALLET_DAEMON_URI Required. The URI of the monero-wallet-rpc RPC interface. http://127.0.0.1:18082
BTCPAY_XMR_WALLET_DAEMON_WALLETDIR Optional. The directory where BTCPay Server saves wallet files uploaded via the UI (See this blog post for more details). /home/cypherpunk/Monero/wallets/

BTCPay Server's Docker deployment simplifies the setup by automatically configuring these variables. For further details, refer to this blog post.

For maintainers

If you are a developer maintaining this plugin, in order to maintain this plugin, you need to clone this repository with --recurse-submodules:

git clone --recurse-submodules https://github.com/btcpayserver/btcpayserver-monero-plugin

Then run the tests dependencies

docker-compose up -d dev

Then create the appsettings.dev.json file in btcpayserver/BTCPayServer, with the following content:

{
  "DEBUG_PLUGINS": "..\\..\\Plugins\\Monero\\bin\\Debug\\net8.0\\BTCPayServer.Plugins.Monero.dll",
  "XMR_DAEMON_URI": "http://127.0.0.1:18081",
  "XMR_WALLET_DAEMON_URI": "http://127.0.0.1:18082",
  "XMR_CASHCOW_WALLET_DAEMON_URI": "http://127.0.0.1:18092",
}

This will ensure that BTCPay Server loads the plugin when it starts.

Then start the development dependencies via docker-compose:

docker-compose up -d dev

Finally, set up BTCPay Server as the startup project in Rider or Visual Studio.

If you want to reset the environment you can run:

docker-compose down -v
docker-compose up -d dev

Note: Running or compiling the BTCPay Server project will not automatically recompile the plugin project. Therefore, if you make any changes to the project, do not forget to build it before running BTCPay Server in debug mode.

We recommend using Rider for plugin development, as it supports hot reload with plugins. You can edit .cshtml files, save, and refresh the page to see the changes.

Visual Studio does not support this feature.

When debugging in regtest, BTCPay Server will automatically create an configure two wallets. (cashcow and merchant) You can trigger payments or mine blocks on the invoice's checkout page.

About docker-compose deployment

BTCPay Server maintains its own deployment stack project to enable users to easily update or deploy additional infrastructure (such as nodes).

Monero nodes are defined in this Docker Compose file.

The Monero images are also maintained in the dockerfile-deps repository. While using the dockerfile-deps for future versions of Monero Dockerfiles is optional, maintaining the Docker Compose Fragment is necessary.

Users can install Monero by configuring the BTCPAYGEN_CRYPTOX environment variables.

For example, after ensuring BTCPAYGEN_CRYPTO2 is not already assigned to another cryptocurrency:

BTCPAYGEN_CRYPTO2="xmr"
. btcpay-setup.sh -i

This will automatically configure Monero in their deployment stack. Users can then run btcpay-update.sh to pull updates for the infrastructure.

Note: Adding Monero to the infrastructure is not recommended for non-advanced users. If the server specifications are insufficient, it may become unresponsive.

Lunanode, a VPS provider, offers an easy way to provision the infrastructure for BTCPay Server, then it installs the Docker Compose deployment on the provisioned VPS. The user can select Monero during provisioning, then the resulting VPS have a Monero deployed automatically, without the need for the user to use the command line. (But the user will still need to install this plugin manually)

Licence

MIT