@dfinity/nns 10.2.0 → 10.3.1-next-2025-10-15

package/dist/candid/governance_test.did

@@ -1,4 +1,4 @@
-// Generated from IC repo commit ff761f3619 (2025-10-03) 'rs/nns/governance/canister/governance_test.did' by import-candid
+// Generated from IC repo commit c211885f7c (2025-10-09) 'packages/nns/candid/governance_test.did.tmp' by import-candid
 
 type AccountIdentifier = record {
   hash : blob;
@@ -154,6 +154,7 @@ type FolloweesForTopic = record {
 type SetFollowingResponse = record {
 };
 
+// KEEP THIS IN SYNC WITH ManageNeuronCommandRequest!
 type Command = variant {
   Spawn : Spawn;
   Split : Split;
@@ -170,6 +171,8 @@ type Command = variant {
   RefreshVotingPower : RefreshVotingPower;
   DisburseMaturity : DisburseMaturity;
   SetFollowing : SetFollowing;
+
+  // KEEP THIS IN SYNC WITH ManageNeuronCommandRequest!
 };
 
 type Command_1 = variant {
@@ -448,6 +451,10 @@ type KnownNeuronData = record {
   name : text;
   description : opt text;
   links : opt vec text;
+  // The first `opt` makes it so that the field can be renamed/deprecated in the future, and
+  // the second `opt` makes it so that an older client not recognizing a new variant can still
+  // get the rest of the `vec`.
+  committed_topics : opt vec opt TopicToFollow;
 };
 
 type LedgerParameters = record {
@@ -461,11 +468,20 @@ type ListKnownNeuronsResponse = record {
   known_neurons : vec KnownNeuron;
 };
 
+// Parameters of the list_neurons method.
 type ListNeurons = record {
-  include_public_neurons_in_full_neurons : opt bool;
+  // These fields select neurons to be in the result set.
   neuron_ids : vec nat64;
-  include_empty_neurons_readable_by_caller : opt bool;
   include_neurons_readable_by_caller : bool;
+
+  // Only has an effect when include_neurons_readable_by_caller.
+  include_empty_neurons_readable_by_caller : opt bool;
+
+  // When a public neuron is a member of the result set, include it in the
+  // full_neurons field (of ListNeuronsResponse). This does not affect which
+  // neurons are part of the result set.
+  include_public_neurons_in_full_neurons : opt bool;
+
   page_number: opt nat64;
   page_size: opt nat64;
   neuron_subaccounts: opt vec NeuronSubaccount;
@@ -475,9 +491,19 @@ type NeuronSubaccount = record {
   subaccount : blob;
 };
 
+// Output of the list_neurons method.
 type ListNeuronsResponse = record {
+  // Per the NeuronInfo type, this is a redacted view of the neurons in the
+  // result set consisting of information that require no special privileges to
+  // view.
   neuron_infos : vec record { nat64; NeuronInfo };
+
+  // If the caller has the necessary special privileges (or the neuron is
+  // public, and the request sets include_public_neurons_in_full_neurons to
+  // true), then all the information about the neurons in the result set is made
+  // available here.
   full_neurons : vec Neuron;
+
   total_pages_available: opt nat64;
 };
 
@@ -519,12 +545,15 @@ type MakeProposalResponse = record {
   proposal_id : opt ProposalId;
 };
 
+// Not to be confused with ManageNeuronRequest. (Yes, this is very structurally
+// similar to that, but not actually exactly equivalent.)
 type ManageNeuron = record {
   id : opt NeuronId;
   command : opt Command;
   neuron_id_or_subaccount : opt NeuronIdOrSubaccount;
 };
 
+// KEEP THIS IN SYNC WITH COMMAND!
 type ManageNeuronCommandRequest = variant {
   Spawn : Spawn;
   Split : Split;
@@ -541,15 +570,26 @@ type ManageNeuronCommandRequest = variant {
   RefreshVotingPower : RefreshVotingPower;
   DisburseMaturity : DisburseMaturity;
   SetFollowing : SetFollowing;
+
+  // KEEP THIS IN SYNC WITH COMMAND!
 };
 
+// Parameters of the manage_neuron method.
 type ManageNeuronRequest = record {
-  id : opt NeuronId;
-  command : opt ManageNeuronCommandRequest;
+  // Which neuron to operate on.
   neuron_id_or_subaccount : opt NeuronIdOrSubaccount;
+
+  // What operation to perform on the neuron.
+  command : opt ManageNeuronCommandRequest;
+
+  // Deprecated. Use neuron_id_or_subaccount instead.
+  id : opt NeuronId;
 };
 
+// Output of the manage_neuron method.
 type ManageNeuronResponse = record {
+  // Corresponds to the command field in ManageNeuronRequest, which determines
+  // what operation was performed.
   command : opt Command_1;
 };
 
@@ -573,7 +613,6 @@ type MergeResponse = record {
   source_neuron_info : opt NeuronInfo;
 };
 
-
 type MonthlyNodeProviderRewards = record {
   minimum_xdr_permyriad_per_icp : opt nat64;
   registry_version : opt nat64;
@@ -624,6 +663,7 @@ type VotingPowerEconomics = record {
   //
   // Initially, set to 1/12 years.
   clear_following_after_seconds : opt nat64;
+
   // The minimum dissolve delay a neuron must have in order to be eligible to vote.
   //
   // Neurons with a dissolve delay lower than this threshold will not have 
@@ -658,8 +698,66 @@ type Neuron = record {
   known_neuron_data : opt KnownNeuronData;
   spawn_at_timestamp_seconds : opt nat64;
   voting_power_refreshed_timestamp_seconds : opt nat64;
+
+  // The amount of "sway" this neuron has when voting on proposals.
+  //
+  // When a proposal is created, each eligible neuron gets a "blank" ballot. The
+  // amount of voting power in that ballot is set to the neuron's deciding
+  // voting power at the time of proposal creation. There are two ways that a
+  // proposal can become decided:
+  //
+  //   1. Early: Either more than half of the total voting power in the ballots
+  //   votes in favor (then the proposal is approved), or at least half of the
+  //   votal voting power in the ballots votes against (then, the proposal is
+  //   rejected).
+  //
+  //   2. The proposal's voting deadline is reached. At that point, if there is
+  //   more voting power in favor than against, and at least 3% of the total
+  //   voting power voted in favor, then the proposal is approved. Otherwise, it
+  //   is rejected.
+  //
+  // If a neuron regularly refreshes its voting power, this has the same value
+  // as potential_voting_power. Actions that cause a refresh are as follows:
+  //
+  //     1. voting directly (not via following)
+  //     2. set following
+  //     3. refresh voting power
+  //
+  // (All of these actions are performed via the manage_neuron method.)
+  //
+  // However, if a neuron has not refreshed in a "long" time, this will be less
+  // than potential voting power. See VotingPowerEconomics. As a further result
+  // of less deciding voting power, not only does it have less influence on the
+  // outcome of proposals, the neuron receives less voting rewards (when it
+  // votes indirectly via following).
+  //
+  // For details, see https://dashboard.internetcomputer.org/proposal/132411.
+  //
+  // Per NNS policy, this is opt. Nevertheless, it will never be null.
   deciding_voting_power : opt nat64;
+
+  // The amount of "sway" this neuron can have if it refreshes its voting power
+  // frequently enough.
+  //
+  // Unlike deciding_voting_power, this does NOT take refreshing into account.
+  // Rather, this only takes three factors into account:
+  //
+  //     1. (Net) staked amount - This is the "base" of a neuron's voting power.
+  //        This primarily consists of the neuron's ICP balance.
+  //
+  //     2. Age - Neurons with more age have more voting power (all else being
+  //        equal).
+  //
+  //     3. Dissolve delay - Neurons with longer dissolve delay have more voting
+  //        power (all else being equal). Neurons with a dissolve delay of less
+  //        than six months are not eligible to vote. Therefore, such neurons
+  //        are considered to have 0 voting power.
+  //
+  // Per NNS policy, this is opt. Nevertheless, it will never be null.
   potential_voting_power : opt nat64;
+
+  // The maturity disbursements in progress, i.e. the disbursements that are initiated but not
+  // finalized. The finalization happens 7 days after the disbursement is initiated.
   maturity_disbursements_in_progress : opt vec MaturityDisbursement;
 };
 
@@ -699,20 +797,56 @@ type NeuronInFlightCommand = record {
   timestamp : nat64;
 };
 
+type GetNeuronIndexRequest = record {
+  exclusive_start_neuron_id: opt NeuronId;
+  page_size: opt nat32;
+};
+
+type NeuronIndexData = record {
+  neurons: vec NeuronInfo;
+};
+
+type GetNeuronIndexResult = variant {
+  Ok : NeuronIndexData;
+  Err : GovernanceError;
+};
+
+// A limit view of Neuron that allows some aspects of all neurons to be read by
+// anyone (i.e. without having to be the neuron's controller nor one of its
+// hotkeys).
+//
+// As such, the meaning of each field in this type is generally the same as the
+// one of the same (or at least similar) name in Neuron.
 type NeuronInfo = record {
   dissolve_delay_seconds : nat64;
   recent_ballots : vec BallotInfo;
   neuron_type : opt int32;
   created_timestamp_seconds : nat64;
   state : int32;
+
+  // The amount of ICP (and staked maturity) locked in this neuron.
+  //
+  // This is the foundation of the neuron's voting power.
+  //
+  // cached_neuron_stake_e8s - neuron_fees_e8s + staked_maturity_e8s_equivalent
   stake_e8s : nat64;
+
   joined_community_fund_timestamp_seconds : opt nat64;
   retrieved_at_timestamp_seconds : nat64;
   visibility : opt int32;
   known_neuron_data : opt KnownNeuronData;
   age_seconds : nat64;
-  voting_power_refreshed_timestamp_seconds : opt nat64;
+
+  // Deprecated. Use either deciding_voting_power or potential_voting_power
+  // instead. Has the same value as deciding_voting_power.
+  //
+  // Previously, if a neuron had < 6 months dissolve delay (making it ineligible
+  // to vote), this would not get set to 0 (zero). That was pretty confusing.
+  // Now that this is set to deciding_voting_power, this actually does get
+  // zeroed out.
   voting_power : nat64;
+
+  voting_power_refreshed_timestamp_seconds : opt nat64;
   deciding_voting_power : opt nat64;
   potential_voting_power : opt nat64;
 };
@@ -1219,6 +1353,31 @@ type MaturityDisbursement = record {
   account_identifier_to_disburse_to : opt AccountIdentifier;
 };
 
+// A topic that can be followed. It is almost the same as the topic on the
+// proposal, except that the `CatchAll` is a special value and following on this
+// `topic` will let the neuron follow the votes on all topics except for
+// Governance and SnsAndCommunityFund.
+type TopicToFollow = variant {
+  CatchAll;
+  NeuronManagement;
+  ExchangeRate;
+  NetworkEconomics;
+  Governance;
+  NodeAdmin;
+  ParticipantManagement;
+  SubnetManagement;
+  Kyc;
+  NodeProviderRewards;
+  IcOsVersionDeployment;
+  IcOsVersionElection;
+  SnsAndCommunityFund;
+  ApiBoundaryNodeManagement;
+  SubnetRental;
+  ApplicationCanisterManagement;
+  ProtocolCanisterManagement;
+  ServiceNervousSystemManagement;
+};
+
 service : (Governance) -> {
   claim_gtc_neurons : (principal, vec NeuronId) -> (Result);
   claim_or_refresh_neuron_from_account : (ClaimOrRefreshNeuronFromAccount) -> (
@@ -1237,6 +1396,7 @@ service : (Governance) -> {
     ) query;
   get_network_economics_parameters : () -> (NetworkEconomics) query;
   get_neuron_ids : () -> (vec nat64) query;
+  get_neuron_index: (GetNeuronIndexRequest) -> (GetNeuronIndexResult) query;
   get_neuron_info : (nat64) -> (Result_5) query;
   get_neuron_info_by_id_or_subaccount : (NeuronIdOrSubaccount) -> (
       Result_5,
@@ -1264,6 +1424,8 @@ service : (Governance) -> {
     ) -> (SettleNeuronsFundParticipationResponse);
   simulate_manage_neuron : (ManageNeuronRequest) -> (ManageNeuronResponse);
   transfer_gtc_neuron : (NeuronId, NeuronId) -> (Result);
-  update_neuron : (Neuron) -> (opt GovernanceError);
   update_node_provider : (UpdateNodeProvider) -> (Result);
+
+  // The following are methods for feature = "test"
+  update_neuron : (Neuron) -> (opt GovernanceError);
 }

package/dist/candid/governance_test.idl.js

@@ -262,8 +262,29 @@ export const idlFactory = ({ IDL }) => {
     'total' : IDL.Nat64,
     'timestamp_seconds' : IDL.Nat64,
   });
+  const TopicToFollow = IDL.Variant({
+    'Kyc' : IDL.Null,
+    'ServiceNervousSystemManagement' : IDL.Null,
+    'ApiBoundaryNodeManagement' : IDL.Null,
+    'ApplicationCanisterManagement' : IDL.Null,
+    'SubnetRental' : IDL.Null,
+    'NeuronManagement' : IDL.Null,
+    'NodeProviderRewards' : IDL.Null,
+    'SubnetManagement' : IDL.Null,
+    'ExchangeRate' : IDL.Null,
+    'CatchAll' : IDL.Null,
+    'NodeAdmin' : IDL.Null,
+    'IcOsVersionElection' : IDL.Null,
+    'ProtocolCanisterManagement' : IDL.Null,
+    'NetworkEconomics' : IDL.Null,
+    'IcOsVersionDeployment' : IDL.Null,
+    'ParticipantManagement' : IDL.Null,
+    'Governance' : IDL.Null,
+    'SnsAndCommunityFund' : IDL.Null,
+  });
   const KnownNeuronData = IDL.Record({
     'name' : IDL.Text,
+    'committed_topics' : IDL.Opt(IDL.Vec(IDL.Opt(TopicToFollow))),
     'description' : IDL.Opt(IDL.Text),
     'links' : IDL.Opt(IDL.Vec(IDL.Text)),
   });
@@ -706,6 +727,10 @@ export const idlFactory = ({ IDL }) => {
     'Ok' : MonthlyNodeProviderRewards,
     'Err' : GovernanceError,
   });
+  const GetNeuronIndexRequest = IDL.Record({
+    'page_size' : IDL.Opt(IDL.Nat32),
+    'exclusive_start_neuron_id' : IDL.Opt(NeuronId),
+  });
   const NeuronInfo = IDL.Record({
     'dissolve_delay_seconds' : IDL.Nat64,
     'recent_ballots' : IDL.Vec(BallotInfo),
@@ -723,6 +748,11 @@ export const idlFactory = ({ IDL }) => {
     'voting_power' : IDL.Nat64,
     'age_seconds' : IDL.Nat64,
   });
+  const NeuronIndexData = IDL.Record({ 'neurons' : IDL.Vec(NeuronInfo) });
+  const GetNeuronIndexResult = IDL.Variant({
+    'Ok' : NeuronIndexData,
+    'Err' : GovernanceError,
+  });
   const Result_5 = IDL.Variant({ 'Ok' : NeuronInfo, 'Err' : GovernanceError });
   const GetNeuronsFundAuditInfoRequest = IDL.Record({
     'nns_proposal_id' : IDL.Opt(ProposalId),
@@ -982,6 +1012,11 @@ export const idlFactory = ({ IDL }) => {
         ['query'],
       ),
     'get_neuron_ids' : IDL.Func([], [IDL.Vec(IDL.Nat64)], ['query']),
+    'get_neuron_index' : IDL.Func(
+        [GetNeuronIndexRequest],
+        [GetNeuronIndexResult],
+        ['query'],
+      ),
     'get_neuron_info' : IDL.Func([IDL.Nat64], [Result_5], ['query']),
     'get_neuron_info_by_id_or_subaccount' : IDL.Func(
         [NeuronIdOrSubaccount],
@@ -1309,8 +1344,29 @@ export const init = ({ IDL }) => {
     'total' : IDL.Nat64,
     'timestamp_seconds' : IDL.Nat64,
   });
+  const TopicToFollow = IDL.Variant({
+    'Kyc' : IDL.Null,
+    'ServiceNervousSystemManagement' : IDL.Null,
+    'ApiBoundaryNodeManagement' : IDL.Null,
+    'ApplicationCanisterManagement' : IDL.Null,
+    'SubnetRental' : IDL.Null,
+    'NeuronManagement' : IDL.Null,
+    'NodeProviderRewards' : IDL.Null,
+    'SubnetManagement' : IDL.Null,
+    'ExchangeRate' : IDL.Null,
+    'CatchAll' : IDL.Null,
+    'NodeAdmin' : IDL.Null,
+    'IcOsVersionElection' : IDL.Null,
+    'ProtocolCanisterManagement' : IDL.Null,
+    'NetworkEconomics' : IDL.Null,
+    'IcOsVersionDeployment' : IDL.Null,
+    'ParticipantManagement' : IDL.Null,
+    'Governance' : IDL.Null,
+    'SnsAndCommunityFund' : IDL.Null,
+  });
   const KnownNeuronData = IDL.Record({
     'name' : IDL.Text,
+    'committed_topics' : IDL.Opt(IDL.Vec(IDL.Opt(TopicToFollow))),
     'description' : IDL.Opt(IDL.Text),
     'links' : IDL.Opt(IDL.Vec(IDL.Text)),
   });

package/dist/candid/sns_wasm.did

@@ -1,4 +1,4 @@
-// Generated from IC repo commit ff761f3619 (2025-10-03) 'rs/nns/sns-wasm/canister/sns-wasm.did' by import-candid
+// Generated from IC repo commit c211885f7c (2025-10-09) 'rs/nns/sns-wasm/canister/sns-wasm.did' by import-candid
 
 type AddWasmRequest = record {
   hash : blob;