Differences

This shows you the differences between two versions of the page.

--- poolinfo:payoutaddress [2021/11/04 10:31] – vleesbanaan
+++ poolinfo:payoutaddress [2023/04/19 16:53] (current) – Wording earl
@@ Line 1: / Line 1: @@
 ===== How to change your pool payout address=====
-There are some reasons for which you might want to change the payout address for your pool rewards. Maybe you feel that the keys tied to your plots are compromised after exposing your key to third-party software like [[guides/forks|forks]] or plotting managers and you want to farm directly to a [[guides/security/coldwallet|cold wallet]]. Or on the contrary, you want to send your farmer rewards directly to a [[ecosystem/wallets|third-party hot wallet]] on your phone.
+There are some reasons why you might want to change the payout address for your pool rewards. Maybe you feel that the keys tied to your plots are compromised after exposing your key to third-party software like [[guides/forks|forks]] or plotting managers and you want to farm directly to a [[guides/security/coldwallet|cold wallet]]. Or on the contrary, you want to send your farmer rewards directly to a [[ecosystem/wallets|third-party hot wallet]] on your phone. Whatever the reason you want to change your payout address, note that it is vital that you check whether you have access to the address you input!
-Whatever the reason is you want to change your payout address, note that it is vital that you check whether you have access to the address you input!
+In this guide, you learn how to change payout address by either:
+  * Using the GUI
+  * Using the CLI
+  * Changing the config.yaml (obsoleted by the CLI method)
+  * Using the Farmer RPC API (obsoleted by the CLI method)
+After you change your payout address, check if the change is accepted by the pool in your [[poolinfo/dashboard|SpaceFarmer Dashboard]].
+<WRAP center round important 60%>
+<color #000>**Your payout address is regularly sent to the pool from the Chia farmer service. If you run multiple farmers, ensure that //all// of them are configured to send the //same// payout address. If you have multiple farmers configured with different payout addresses, your payout address as seen by the pool will change around seemingly randomly.**</color>
+</WRAP>
-In this guide you learn how to change payout address by:
-  * using the GUI
-  * changing the config.yaml
-After you change your payout address, make sure to check if the pay-out instruction changed in your [[poolinfo/dashboard|SpaceFarmer Dashboard]].
 ==== Using the GUI ====
-In the GUI, navigate to the Pools tab and navigate to the PlotNFT that you want to change the pay-out address for. Click the three vertical dots and select "Edit Payout Instructions". You will be presented with a field where you can enter the payout address you want your pool rewards to be sent to. Make sure that you have access to the address that you enter in this field!
+In the GUI, navigate to the **Pools** tab, then navigate to the **PlotNFT** for which you want to change the payout address. Click the three vertical dots and select "Edit Payout Instructions". You will be presented with a field where you can enter the payout address for your pool rewards. Make sure that you have access to the address that you enter in this field!
+==== Using the CLI ====
+  - Run ''chia plotnft show'' on your farmer to obtain the launcher ID of the plot NFT for which you want to change the payout address. This will also show you the currently configured payout address.
+  - Run ''chia plotnft change_payout_instructions -l <LAUNCHER_ID> -a <PAYOUT_ADDRESS>'' to change to your desired payout address.
+  - Run ''chia plotnft show'' again, to verify that the plot NFT's payout address changed correctly.
+  - In your farm's "Overview" tab on the pool dashboard, check that the payout address changed correctly. (It can take up to 5 minutes to update.)
 ==== Changing the config.yaml====
+//Warning: this method is easy to get wrong and obsoleted by the GUI/CLI methods above.//
 You can also change the payout instruction through the config.yaml. Do note that you need to convert your receive address to a puzzle hash. The steps below show you how to do this:
-  - Convert your prefered receive address to a puzzle hash, for example with this tool: https://www.chiaexplorer.com/tools/address-puzzlehash-converter
+  - Stop your farmer process: ''chia stop farmer-only''. This is important to not have the farmer mess with your config.yaml while you edit it.
-  - Navigate to the config.yaml file in your .chia folder.
+  - Convert your preferred payout address to a puzzle hash, for example with this tool: https://xchdata.io/convert
+  - Navigate to the ''config.yaml'' file in your ''.chia'' folder.
      * For Windows: ''C:\Users\<username>\.chia\mainnet\config''
      * For Linux: ''~/.chia/mainnet/log/config''
-  - Open the config.yaml and navigate to the ''pool:'' part (e.g. by using the search function). Here you will find a list of all your PlotNFTs.
+  - Open the ''config.yaml'' and navigate to the ''pool:'' part (e.g. by using the search function). Here you will find a list of all your PlotNFTs.
-  - Find the PlotNFT that you want to change the payout instruction for. You can identify your plotNFT by the ''launcher_id:''; make sure to double check!
+  - Find the PlotNFT that you want to change the payout instruction for. You can identify your plotNFT by the ''launcher_id:''; be sure to double-check!
-  - The third line under ''launcher_id:'' is ''payout_instructions:''. Take the puzzlehash output from step 1 **MINUS the** ''0x'' part and change the entry. Make sure the entry should look something like ''payout_instructions: 61751cc01a73d5e64a07d6e37b451eed9f157f04da53e3c7d06f355928ba2113''. You can check if you copied correctly, by converting your number back to a receive address in the tool from step 1.
+  - The third line under ''launcher_id:'' is ''payout_instructions:''. Take the puzzle hash output from step 1 **MINUS the** ''0x'' part and change the entry. Make sure the entry should look something like ''payout_instructions: 61751cc01a73d5e64a07d6e37b451eed9f157f04da53e3c7d06f355928ba2113''. You can check if you copied correctly, by converting your number back to a receive address in the tool from step 1.
-  - save the config.yaml
+  - Save the ''config.yaml''.
+  - Start your farmer again: ''chia start farmer-only''. (Note that if you didn't stop your farmer before editing your config.yaml and you only //restart// the farmer at this point, your config.yaml changes are likely overwritten during farmer shutdown.)
+  - In your farm's "Overview" tab on the pool dashboard, check that the payout address changed correctly. (It can take up to 5 minutes to update.)
+==== Using the Farmer RPC API ====
+//Warning: this method is easy to get wrong and obsoleted by the GUI/CLI methods above.//
+You can also change your payout address using the RPC API. This way, you won't accidentally mess up your config. Here's how to do this:
+  - Obtain the launcher ID for the plot NFT you want to change the payout instructions for. With the CLI: ''chia plotnft show''
+  - Convert your preferred payout address to a puzzle hash, for example with this tool: https://xchdata.io/convert
+  - Paste the following on the machine that runs the farmer(s). Use the puzzle hash output from the previous step **MINUS the ''0x'' part**:<code>
+curl --insecure --no-progress-meter \
+  --cert ~/.chia/mainnet/config/ssl/farmer/private_farmer.crt \
+  --key ~/.chia/mainnet/config/ssl/farmer/private_farmer.key \
+  -H "Content-Type: application/json" \
+  -X POST https://localhost:8559/set_payout_instructions \
+  -d '{"launcher_id": "<YOUR_LAUNCHER_ID>", "payout_instructions": "<YOUR_PUZZLE_HASH>"}'
+</code>
+  - Verify that the plot NFT's payout address changed as you wanted by checking ''chia plotnft show''.