Commit b19ebd9
docs: clarify how to change the SNS token transfer fee (#306)
## Summary
A forum discussion surfaced a common point of confusion: changing
`transaction_fee_e8s` via a `ManageNervousSystemParameters` proposal
only updates Governance's stored parameter and does **not** change the
actual SNS ledger transfer fee. The native path is a
`ManageLedgerParameters` proposal with `transfer_fee` set, which updates
the ledger and syncs Governance's `transaction_fee_e8s` automatically.
Confirmed by the SNS team (Björn).
This PR makes that distinction explicit across all three places the
parameter appears:
- **`docs/guides/governance/managing.md`** — adds a `:::caution` under
`ManageNervousSystemParameters` (right after the
`NervousSystemParameters` Candid type) warning against using
`transaction_fee_e8s` to change the fee, and pointing to
`ManageLedgerParameters`.
- **`docs/guides/governance/managing.md`** — adds a sentence to the
`ManageLedgerParameters` section noting that `transfer_fee` is the field
to use and that it syncs Governance automatically, so no separate
proposal is needed.
- **`docs/references/sns-settings.md`** — rewords the
`transaction_fee_e8s` reference row, which previously described it as
the "per-transfer fee on the SNS ledger" (the misleading framing), to
clarify it is Governance's stored copy and that the fee is changed via
`ManageLedgerParameters`.
`npm run build` passes.
---------
Co-authored-by: Bjoern Assmann <bjoern.assmann@dfinity.org>1 parent 8f28fb3 commit b19ebd9
2 files changed
Lines changed: 9 additions & 1 deletion
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
121 | 121 | | |
122 | 122 | | |
123 | 123 | | |
| 124 | + | |
| 125 | + | |
| 126 | + | |
| 127 | + | |
| 128 | + | |
| 129 | + | |
124 | 130 | | |
125 | 131 | | |
126 | 132 | | |
| |||
155 | 161 | | |
156 | 162 | | |
157 | 163 | | |
| 164 | + | |
| 165 | + | |
158 | 166 | | |
159 | 167 | | |
160 | 168 | | |
| |||
| Original file line number | Diff line number | Diff line change | |
|---|---|---|---|
| |||
43 | 43 | | |
44 | 44 | | |
45 | 45 | | |
46 | | - | |
| 46 | + | |
47 | 47 | | |
48 | 48 | | |
49 | 49 | | |
| |||
0 commit comments