Skip to content

docs: clarify SNS ledger fee parameter updates#10609

Open
bjoernek wants to merge 4 commits into
masterfrom
codex/sns-ledger-fee-docs
Open

docs: clarify SNS ledger fee parameter updates#10609
bjoernek wants to merge 4 commits into
masterfrom
codex/sns-ledger-fee-docs

Conversation

@bjoernek

Copy link
Copy Markdown
Contributor

Summary

Clarifies the SNS Governance protobuf/API comments around ledger fee updates:

  • ManageLedgerParameters.transfer_fee is the intended way to change the SNS ledger's actual transfer fee.
  • Successful ManageLedgerParameters execution also syncs NervousSystemParameters.transaction_fee_e8s in Governance.
  • Directly changing NervousSystemParameters.transaction_fee_e8s does not update the ledger.

Why

DAO operators can otherwise infer that changing transaction_fee_e8s through ManageNervousSystemParameters changes the ledger fee. That can leave Governance and the SNS ledger fee out of sync, causing ordinary ledger transfers initiated by Governance to use a stale fee.

Validation

  • git diff --check
  • rustfmt --check rs/sns/governance/src/gen/ic_sns_governance.pb.v1.rs

No runtime tests were run because this is a comment-only documentation change.

@bjoernek bjoernek changed the title [codex] docs: clarify SNS ledger fee parameter updates docs: clarify SNS ledger fee parameter updates Jun 29, 2026
@github-actions github-actions Bot added the docs label Jun 29, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ideally, we'd get rid of this footgun, but ofc, that would require more effort, which we do not want to spend now.

Comment thread rs/sns/governance/proto/ic_sns_governance/pb/v1/governance.proto
@bjoernek bjoernek marked this pull request as ready for review June 30, 2026 11:19
@bjoernek bjoernek requested a review from a team as a code owner June 30, 2026 11:19

@github-actions github-actions Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This pull request changes code owned by the Governance team. Therefore, make sure that
you have considered the following (for Governance-owned code):

  1. Update unreleased_changelog.md (if there are behavior changes, even if they are
    non-breaking).

  2. Are there BREAKING changes?

  3. Is a data migration needed?

  4. Security review?

How to Satisfy This Automatic Review

  1. Go to the bottom of the pull request page.

  2. Look for where it says this bot is requesting changes.

  3. Click the three dots to the right.

  4. Select "Dismiss review".

  5. In the text entry box, respond to each of the numbered items in the previous
    section, declare one of the following:

  • Done.

  • $REASON_WHY_NO_NEED. E.g. for unreleased_changelog.md, "No
    canister behavior changes.", or for item 2, "Existing APIs
    behave as before.".

Brief Guide to "Externally Visible" Changes

"Externally visible behavior change" is very often due to some NEW canister API.

Changes to EXISTING APIs are more likely to be "breaking".

If these changes are breaking, make sure that clients know how to migrate, how to
maintain their continuity of operations.

If your changes are behind a feature flag, then, do NOT add entrie(s) to
unreleased_changelog.md in this PR! But rather, add entrie(s) later, in the PR
that enables these changes in production.

Reference(s)

For a more comprehensive checklist, see here.

GOVERNANCE_CHECKLIST_REMINDER_DEDUP

@zeropath-ai

zeropath-ai Bot commented Jun 30, 2026

Copy link
Copy Markdown

No security or compliance issues detected. Reviewed everything up to df0ab23.

Security Overview
Detected Code Changes
Change Type Relevant files
Enhancement ► rs/sns/governance/proto/ic_sns_governance/pb/v1/governance.proto
    A proposal function that changes the SNS ledger canister's parameters.
► rs/sns/governance/src/gen/ic_sns_governance.pb.v1.rs
    A proposal function that changes the SNS ledger canister's parameters.
Enhancement ► rs/sns/governance/proto/ic_sns_governance/pb/v1/governance.proto
    ManageLedgerParameters: add transfer_fee field with detailed comments
► rs/sns/governance/src/gen/ic_sns_governance.pb.v1.rs
    ManageLedgerParameters: add transfer_fee field with detailed comments
► rs/sns/governance/proto/ic_sns_governance/pb/v1/governance.proto
    NervousSystemParameters: add transaction_fee_e8s field description aligned with governance behavior
► rs/sns/governance/src/gen/ic_sns_governance.pb.v1.rs
    NervousSystemParameters: add transaction_fee_e8s field description aligned with governance behavior

@bjoernek bjoernek enabled auto-merge June 30, 2026 12:29
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants