@dfinity/nns 10.0.1 → 10.1.1

package/dist/candid/governance_test.d.ts

@@ -15,6 +15,7 @@ export type Action =
   | { ManageNeuron: ManageNeuron }
   | { UpdateCanisterSettings: UpdateCanisterSettings }
   | { InstallCode: InstallCode }
+  | { DeregisterKnownNeuron: DeregisterKnownNeuron }
   | { StopOrStartCanister: StopOrStartCanister }
   | { CreateServiceNervousSystem: CreateServiceNervousSystem }
   | { ExecuteNnsFunction: ExecuteNnsFunction }
@@ -174,6 +175,9 @@ export interface DateRangeFilter {
 export interface Decimal {
   human_readable: [] | [string];
 }
+export interface DeregisterKnownNeuron {
+  id: [] | [NeuronId];
+}
 export interface DerivedProposalInformation {
   swap_background_information: [] | [SwapBackgroundInformation];
 }
@@ -223,9 +227,41 @@ export interface FolloweesForTopic {
   topic: [] | [number];
   followees: [] | [Array<NeuronId>];
 }
+/**
+ * Creates a rented subnet from a rental request (in the Subnet Rental
+ * canister).
+ */
 export interface FulfillSubnetRentalRequest {
+  /**
+   * Identifies which rental request to fulfill.
+   *
+   * (Identifying the rental request by user works, because a user can have at
+   * most one rental request in the Subnet Rental canister).
+   */
   user: [] | [Principal];
+  /**
+   * What software the nodes will run.
+   *
+   * This must be approved by a prior proposal to bless an IC OS version.
+   *
+   * This is a FULL git commit ID in the ic repo. (Therefore, it must be a 40
+   * character hexidecimal string, not an abbreviated git commit ID.)
+   *
+   * One way to find a suitable value is with the following command:
+   *
+   * ic-admin \
+   * get-subnet 0 \
+   * --nns-urls https://nns.ic0.app \
+   * | grep replica_version_id
+   *
+   * Where to obtain a recent version of ic-admin:
+   *
+   * https://github.com/dfinity/ic/releases/latest
+   */
   replica_version_id: [] | [string];
+  /**
+   * Which nodes will be members of the subnet.
+   */
   node_ids: [] | [Array<Principal>];
 }
 export interface GetNeuronsFundAuditInfoRequest {
@@ -239,7 +275,6 @@ export interface GlobalTimeOfDay {
 }
 export interface Governance {
   default_followees: Array<[number, Followees]>;
-  making_sns_proposal: [] | [MakingSnsProposal];
   most_recent_monthly_node_provider_rewards: [] | [MonthlyNodeProviderRewards];
   maturity_modulation_last_updated_at_timestamp_seconds: [] | [bigint];
   wait_for_quiet_threshold_seconds: bigint;
@@ -360,6 +395,7 @@ export interface KnownNeuron {
 export interface KnownNeuronData {
   name: string;
   description: [] | [string];
+  links: [] | [Array<string>];
 }
 export interface LedgerParameters {
   transaction_fee: [] | [Tokens];
@@ -415,11 +451,6 @@ export interface MakeProposalResponse {
   message: [] | [string];
   proposal_id: [] | [ProposalId];
 }
-export interface MakingSnsProposal {
-  proposal: [] | [Proposal];
-  caller: [] | [Principal];
-  proposer_id: [] | [NeuronId];
-}
 export interface ManageNeuron {
   id: [] | [NeuronId];
   command: [] | [Command];
@@ -486,6 +517,9 @@ export interface Motion {
 }
 export interface NetworkEconomics {
   neuron_minimum_stake_e8s: bigint;
+  /**
+   * Parameters that affect the voting power of neurons.
+   */
   voting_power_economics: [] | [VotingPowerEconomics];
   max_proposals_to_keep_per_topic: number;
   neuron_management_fee_per_proposal_e8s: bigint;
@@ -706,6 +740,7 @@ export type ProposalActionRequest =
   | { ManageNeuron: ManageNeuronRequest }
   | { UpdateCanisterSettings: UpdateCanisterSettings }
   | { InstallCode: InstallCodeRequest }
+  | { DeregisterKnownNeuron: DeregisterKnownNeuron }
   | { StopOrStartCanister: StopOrStartCanister }
   | { CreateServiceNervousSystem: CreateServiceNervousSystem }
   | { ExecuteNnsFunction: ExecuteNnsFunction }
@@ -759,6 +794,11 @@ export interface ProposalInfo {
   proposer: [] | [NeuronId];
   executed_timestamp_seconds: bigint;
 }
+/**
+ * This is one way for a neuron to make sure that its deciding_voting_power is
+ * not less than its potential_voting_power. See the description of those fields
+ * in Neuron.
+ */
 export type RefreshVotingPower = {};
 export type RefreshVotingPowerResponse = {};
 export interface RegisterVote {
@@ -860,6 +900,7 @@ export interface SpawnResponse {
   created_neuron_id: [] | [NeuronId];
 }
 export interface Split {
+  memo: [] | [bigint];
   amount_e8s: bigint;
 }
 export interface StakeMaturity {
@@ -930,9 +971,41 @@ export interface UpdateCanisterSettings {
 export interface UpdateNodeProvider {
   reward_account: [] | [AccountIdentifier];
 }
+/**
+ * Parameters that affect the voting power of neurons.
+ */
 export interface VotingPowerEconomics {
+  /**
+   * If a neuron has not "refreshed" its voting power after this amount of time,
+   * its deciding voting power starts decreasing linearly. See also
+   * clear_following_after_seconds.
+   *
+   * For explanation of what "refresh" means in this context, see
+   * https://dashboard.internetcomputer.org/proposal/132411
+   *
+   * Initially, set to 0.5 years. (The nominal length of a year is 365.25 days).
+   */
   start_reducing_voting_power_after_seconds: [] | [bigint];
+  /**
+   * 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
+   * voting power, even if they are otherwise active.
+   *
+   * This value is an essential part of the staking mechanism, promoting
+   * long-term alignment with the network's governance.
+   */
   neuron_minimum_dissolve_delay_to_vote_seconds: [] | [bigint];
+  /**
+   * After a neuron has experienced voting power reduction for this amount of
+   * time, a couple of things happen:
+   *
+   * 1. Deciding voting power reaches 0.
+   *
+   * 2. Its following on topics other than NeuronManagement are cleared.
+   *
+   * Initially, set to 1/12 years.
+   */
   clear_following_after_seconds: [] | [bigint];
 }
 export interface VotingRewardParameters {

package/dist/candid/governance_test.did

@@ -1,10 +1,12 @@
-// Generated from IC repo commit 9173238 (2025-08-18 tags: release-2025-08-28_03-17-snapshot-feature) 'rs/nns/governance/canister/governance_test.did' by import-candid
+// Generated from IC repo commit 206b61a (2025-09-25 tags: release-2025-09-25_09-52-base) 'rs/nns/governance/canister/governance_test.did' by import-candid
+
 type AccountIdentifier = record {
   hash : blob;
 };
 
 type Action = variant {
   RegisterKnownNeuron : KnownNeuron;
+  DeregisterKnownNeuron : DeregisterKnownNeuron;
   ManageNeuron : ManageNeuron;
   UpdateCanisterSettings : UpdateCanisterSettings;
   InstallCode : InstallCode;
@@ -309,7 +311,6 @@ type GlobalTimeOfDay = record {
 
 type Governance = record {
   default_followees : vec record { int32; Followees };
-  making_sns_proposal : opt MakingSnsProposal;
   most_recent_monthly_node_provider_rewards : opt MonthlyNodeProviderRewards;
   maturity_modulation_last_updated_at_timestamp_seconds : opt nat64;
   wait_for_quiet_threshold_seconds : nat64;
@@ -439,9 +440,14 @@ type KnownNeuron = record {
   known_neuron_data : opt KnownNeuronData;
 };
 
+type DeregisterKnownNeuron = record {
+  id : opt NeuronId;
+};
+
 type KnownNeuronData = record {
   name : text;
   description : opt text;
+  links : opt vec text;
 };
 
 type LedgerParameters = record {
@@ -513,12 +519,6 @@ type MakeProposalResponse = record {
   proposal_id : opt ProposalId;
 };
 
-type MakingSnsProposal = record {
-  proposal : opt Proposal;
-  caller : opt principal;
-  proposer_id : opt NeuronId;
-};
-
 type ManageNeuron = record {
   id : opt NeuronId;
   command : opt Command;
@@ -869,6 +869,7 @@ type Proposal = record {
 
 type ProposalActionRequest = variant {
   RegisterKnownNeuron : KnownNeuron;
+  DeregisterKnownNeuron : DeregisterKnownNeuron;
   ManageNeuron : ManageNeuronRequest;
   UpdateCanisterSettings : UpdateCanisterSettings;
   InstallCode : InstallCodeRequest;
@@ -900,8 +901,19 @@ type FulfillSubnetRentalRequest = record {
   //
   // This must be approved by a prior proposal to bless an IC OS version.
   //
-  // This is a full git commit ID in the ic repo. (Therefore, it must be a 40
-  // character hexidecimal string.)
+  // This is a FULL git commit ID in the ic repo. (Therefore, it must be a 40
+  // character hexidecimal string, not an abbreviated git commit ID.)
+  //
+  // One way to find a suitable value is with the following command:
+  //
+  //     ic-admin \
+  //         get-subnet 0 \
+  //         --nns-urls https://nns.ic0.app \
+  //     | grep replica_version_id
+  //
+  // Where to obtain a recent version of ic-admin:
+  //
+  //     https://github.com/dfinity/ic/releases/latest
   replica_version_id : opt text;
 };
 
@@ -1103,6 +1115,7 @@ type SpawnResponse = record {
 
 type Split = record {
   amount_e8s : nat64;
+  memo : opt nat64;
 };
 
 type StakeMaturity = record {