From 5fdaa654ff573c171bd0c174c55a17086236961a Mon Sep 17 00:00:00 2001
From: Diwaker Gupta <15990+diwakergupta@users.noreply.github.com>
Date: Wed, 13 Jan 2021 09:49:45 -0500
Subject: [PATCH] Update stacks-node configuration option docs.

- add warning to `working_dir`
- add `satoshis_per_byte` and note about total transaction cost
- remove `burnchain_op_tx_fee`
---
 .../references/stacks-node-configuration.md   | 23 +++++++------------
 1 file changed, 8 insertions(+), 15 deletions(-)

diff --git a/src/pages/references/stacks-node-configuration.md b/src/pages/references/stacks-node-configuration.md
index 0c94e4f3..ed4e0df2 100644
--- a/src/pages/references/stacks-node-configuration.md
+++ b/src/pages/references/stacks-node-configuration.md
@@ -117,6 +117,7 @@ miner = true
 #### working_dir (optional)
 
 Absolute path to the directory which the stacks-node will use for storing various data.
+Until [issue 1576](https://github.com/blockstack/stacks-blockchain/issues/1576) is resolved, this option is unsupported -- use at your own risk.
 
 Example:
 
@@ -404,35 +405,27 @@ Example:
 peer_port = 8333
 ```
 
-#### process_exit_at_block_height (optional)
+#### burn_fee_cap (optional)
 
-Block height of the burnchain at which the stacks-node will self-terminate. Used during the testnet phases for various testing cycles.
+Maximum amount (in Satoshis) of "burn commitment" to broadcast for the next block's leader election.
 
 Example:
 
 ```toml
-process_exit_at_block_height = 5340
+burn_fee_cap = 30000
 ```
 
-#### burnchain_op_tx_fee (optional)
+#### satoshis_per_byte (optional)
 
-Transaction fee per burnchain operation.
+Amount (in Satoshis) per [virtual byte](https://en.bitcoin.it/wiki/Weight_units). This is used to compute the transaction fees.
 
 Example:
 
 ```toml
-burnchain_op_tx_fee = 5500
+satoshis_per_byte = 50
 ```
 
-#### burn_fee_cap (optional)
-
-Max burn fee for a transaction.
-
-Example:
-
-```toml
-burn_fee_cap = 30000
-```
+So total transaction cost would be `(estimated_tx_size * satoshis_per_byte) + burn_fee_cap`.
 
 #### commit_anchor_block_within (optional)