diff --git a/rs/nns/governance/api/src/ic_nns_governance.pb.v1.rs b/rs/nns/governance/api/src/ic_nns_governance.pb.v1.rs index e7a3a46ffd6..eb1957b21cc 100644 --- a/rs/nns/governance/api/src/ic_nns_governance.pb.v1.rs +++ b/rs/nns/governance/api/src/ic_nns_governance.pb.v1.rs @@ -99,10 +99,14 @@ pub struct NeuronInfo { #[prost(enumeration = "Visibility", optional, tag = "12")] pub visibility: Option, /// The last time that voting power was "refreshed". There are two ways to - /// refresh the voting power of a neuron: set following, or vote directly. When - /// this becomes > 6 months ago, the amount of voting power that this neuron - /// can exercise decreases linearly down to 0 over the course of 1 month. After - /// that, following is cleared, except for ManageNeuron proposals. + /// refresh the voting power of a neuron: set following, or vote directly. In + /// the future, there will be a dedicated API for refreshing. Note that direct + /// voting implies that refresh also occurs when a proposal is created, because + /// direct voting is part of proposal creation. + /// + /// Effect: When this becomes > 6 months ago, the amount of voting power that + /// this neuron can exercise decreases linearly down to 0 over the course of 1 + /// month. After that, following is cleared, except for ManageNeuron proposals. /// /// This will always be populated. If the underlying neuron was never /// refreshed, this will be set to 2024-11-05T00:00:01 UTC (1730764801 seconds @@ -268,14 +272,18 @@ pub struct Neuron { #[prost(enumeration = "Visibility", optional, tag = "23")] pub visibility: Option, /// The last time that voting power was "refreshed". There are two ways to - /// refresh the voting power of a neuron: set following, or vote directly. When - /// this becomes > 6 months ago, the amount of voting power that this neuron - /// can exercise decreases linearly down to 0 over the course of 1 month. After - /// that, following is cleared, except for ManageNeuron proposals. + /// refresh the voting power of a neuron: set following, or vote directly. In + /// the future, there will be a dedicated API for refreshing. Note that direct + /// voting implies that refresh also occurs when a proposal is created, because + /// direct voting is part of proposal creation. + /// + /// Effect: When this becomes > 6 months ago, the amount of voting power that + /// this neuron can exercise decreases linearly down to 0 over the course of 1 + /// month. After that, following is cleared, except for ManageNeuron proposals. /// - /// When this is not populated (the Rust field is set to None), the Neuron is - /// treated as though this is set to 2024-11-05T00:00:01 UTC (1730764801 - /// seconds after the UNIX epoch). + /// This will always be populated. If the underlying neuron was never + /// refreshed, this will be set to 2024-11-05T00:00:01 UTC (1730764801 seconds + /// after the UNIX epoch). #[prost(uint64, optional, tag = "24")] pub voting_power_refreshed_timestamp_seconds: ::core::option::Option, /// At any time, at most one of `when_dissolved` and diff --git a/rs/nns/governance/proto/ic_nns_governance/pb/v1/governance.proto b/rs/nns/governance/proto/ic_nns_governance/pb/v1/governance.proto index d0b20a0f8f5..ec7e095bde3 100644 --- a/rs/nns/governance/proto/ic_nns_governance/pb/v1/governance.proto +++ b/rs/nns/governance/proto/ic_nns_governance/pb/v1/governance.proto @@ -247,10 +247,14 @@ message NeuronInfo { // See the Visibility enum. optional Visibility visibility = 12; // The last time that voting power was "refreshed". There are two ways to - // refresh the voting power of a neuron: set following, or vote directly. When - // this becomes > 6 months ago, the amount of voting power that this neuron - // can exercise decreases linearly down to 0 over the course of 1 month. After - // that, following is cleared, except for ManageNeuron proposals. + // refresh the voting power of a neuron: set following, or vote directly. In + // the future, there will be a dedicated API for refreshing. Note that direct + // voting implies that refresh also occurs when a proposal is created, because + // direct voting is part of proposal creation. + // + // Effect: When this becomes > 6 months ago, the amount of voting power that + // this neuron can exercise decreases linearly down to 0 over the course of 1 + // month. After that, following is cleared, except for ManageNeuron proposals. // // This will always be populated. If the underlying neuron was never // refreshed, this will be set to 2024-11-05T00:00:01 UTC (1730764801 seconds @@ -441,14 +445,18 @@ message Neuron { optional Visibility visibility = 23; // The last time that voting power was "refreshed". There are two ways to - // refresh the voting power of a neuron: set following, or vote directly. When - // this becomes > 6 months ago, the amount of voting power that this neuron - // can exercise decreases linearly down to 0 over the course of 1 month. After - // that, following is cleared, except for ManageNeuron proposals. - // - // When this is not populated (the Rust field is set to None), the Neuron is - // treated as though this is set to 2024-11-05T00:00:01 UTC (1730764801 - // seconds after the UNIX epoch). + // refresh the voting power of a neuron: set following, or vote directly. In + // the future, there will be a dedicated API for refreshing. Note that direct + // voting implies that refresh also occurs when a proposal is created, because + // direct voting is part of proposal creation. + // + // Effect: When this becomes > 6 months ago, the amount of voting power that + // this neuron can exercise decreases linearly down to 0 over the course of 1 + // month. After that, following is cleared, except for ManageNeuron proposals. + // + // This will always be populated. If the underlying neuron was never + // refreshed, this will be set to 2024-11-05T00:00:01 UTC (1730764801 seconds + // after the UNIX epoch). optional uint64 voting_power_refreshed_timestamp_seconds = 24; } diff --git a/rs/nns/governance/src/gen/ic_nns_governance.pb.v1.rs b/rs/nns/governance/src/gen/ic_nns_governance.pb.v1.rs index 645690f6be4..d617a969144 100644 --- a/rs/nns/governance/src/gen/ic_nns_governance.pb.v1.rs +++ b/rs/nns/governance/src/gen/ic_nns_governance.pb.v1.rs @@ -114,10 +114,14 @@ pub struct NeuronInfo { #[prost(enumeration = "Visibility", optional, tag = "12")] pub visibility: ::core::option::Option, /// The last time that voting power was "refreshed". There are two ways to - /// refresh the voting power of a neuron: set following, or vote directly. When - /// this becomes > 6 months ago, the amount of voting power that this neuron - /// can exercise decreases linearly down to 0 over the course of 1 month. After - /// that, following is cleared, except for ManageNeuron proposals. + /// refresh the voting power of a neuron: set following, or vote directly. In + /// the future, there will be a dedicated API for refreshing. Note that direct + /// voting implies that refresh also occurs when a proposal is created, because + /// direct voting is part of proposal creation. + /// + /// Effect: When this becomes > 6 months ago, the amount of voting power that + /// this neuron can exercise decreases linearly down to 0 over the course of 1 + /// month. After that, following is cleared, except for ManageNeuron proposals. /// /// This will always be populated. If the underlying neuron was never /// refreshed, this will be set to 2024-11-05T00:00:01 UTC (1730764801 seconds @@ -288,14 +292,18 @@ pub struct Neuron { #[prost(enumeration = "Visibility", optional, tag = "23")] pub visibility: ::core::option::Option, /// The last time that voting power was "refreshed". There are two ways to - /// refresh the voting power of a neuron: set following, or vote directly. When - /// this becomes > 6 months ago, the amount of voting power that this neuron - /// can exercise decreases linearly down to 0 over the course of 1 month. After - /// that, following is cleared, except for ManageNeuron proposals. + /// refresh the voting power of a neuron: set following, or vote directly. In + /// the future, there will be a dedicated API for refreshing. Note that direct + /// voting implies that refresh also occurs when a proposal is created, because + /// direct voting is part of proposal creation. + /// + /// Effect: When this becomes > 6 months ago, the amount of voting power that + /// this neuron can exercise decreases linearly down to 0 over the course of 1 + /// month. After that, following is cleared, except for ManageNeuron proposals. /// - /// When this is not populated (the Rust field is set to None), the Neuron is - /// treated as though this is set to 2024-11-05T00:00:01 UTC (1730764801 - /// seconds after the UNIX epoch). + /// This will always be populated. If the underlying neuron was never + /// refreshed, this will be set to 2024-11-05T00:00:01 UTC (1730764801 seconds + /// after the UNIX epoch). #[prost(uint64, optional, tag = "24")] pub voting_power_refreshed_timestamp_seconds: ::core::option::Option, /// At any time, at most one of `when_dissolved` and