Differences

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

--- poolinfo:payoutaddress [2023/04/07 12:08] – [Using the Farmer RPC API] Add warning/obsolete notice, formatting, change address converter earl
+++ 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. 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!
+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!
-In this guide you learn how to change payout address by either:
+In this guide, you learn how to change payout address by either:
   * Using the GUI
@@ Line 10: / Line 10: @@
   * Using the Farmer RPC API (obsoleted by the CLI method)
-After you change your payout address, make sure to check if the change is accepted by the pool in your [[poolinfo/dashboard|SpaceFarmer Dashboard]].
+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 from the Chia farmer service to the pool. 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>
+<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>
@@ Line 19: / Line 19: @@
 ==== Using the GUI ====
-In the GUI, navigate to the **Pools** tab, then 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 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 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.)
-. Verify on the pool dashboard in the "Overview" tab for your farm that the payout address changed correctly. (Can take up to 5 minutes to update.)
@@ Line 37: / Line 36: @@
 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 preferred receive address to a puzzle hash, for example with this tool: https://xchdata.io/convert
+  - 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.
+  - 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.
-  - 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 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''.
+  - 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 ====
@@ Line 52: / Line 55: @@
   - 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 receive address to a puzzle hash, for example with this tool: https://xchdata.io/convert
+  - 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 \