[Feat] Yuma Consensus v3

evm-tests/src/contracts/subnet.ts

@@ -572,6 +572,43 @@ export const ISubnetABI = [
         stateMutability: "view",
         type: "function",
     },
+    {
+        inputs: [
+            {
+                internalType: "uint16",
+                name: "netuid",
+                type: "uint16",
+            },
+        ],
+        name: "getYuma3Enabled",
+        outputs: [
+            {
+                internalType: "bool",
+                name: "",
+                type: "bool",
+            },
+        ],
+        stateMutability: "view",
+        type: "function",
+    },
+    {
+      inputs: [
+          {
+              internalType: "uint16",
+              name: "netuid",
+              type: "uint16",
+          },
+          {
+              internalType: "bool",
+              name: "yuma3Enabled",
+              type: "bool",
+          },
+        ],
+        name: "setYuma3Enabled",
+        outputs: [],
+        stateMutability: "payable",
+        type: "function",
+    },
     {
         inputs: [
             {
@@ -886,4 +923,4 @@ export const ISubnetABI = [
         stateMutability: "payable",
         type: "function"
     },
-];
+];

evm-tests/test/subnet.precompile.hyperparameter.test.ts

@@ -79,7 +79,7 @@ describe("Test the Subnet precompile contract", () => {
     })
 
 
-    // minDifficulty hyperparameter 
+    // minDifficulty hyperparameter
     //
     // disabled: only by sudo
     //
@@ -471,6 +471,26 @@ describe("Test the Subnet precompile contract", () => {
         assert.equal(valueFromContract, onchainValue);
     })
 
+    it("Can set yuma3Enabled hyperparameter", async () =>
+    {
+      const totalNetwork = await api.query.SubtensorModule.TotalNetworks.getValue()
+      const contract = new ethers.Contract(ISUBNET_ADDRESS, ISubnetABI, wallet);
+      const netuid = totalNetwork - 1;
+
+      const newValue = true;
+      const tx = await contract.setYuma3Enabled(netuid, newValue);
+      await tx.wait();
+
+      let onchainValue = await api.query.SubtensorModule.Yuma3On.getValue(netuid)
+
+      let valueFromContract = Boolean(
+        await contract.getYuma3Enabled(netuid)
+      );
+      assert.equal(valueFromContract, newValue)
+      assert.equal(valueFromContract, onchainValue);
+    })
+
+
     it("Can set alphaValues parameter", async () => {
         const totalNetwork = await api.query.SubtensorModule.TotalNetworks.getValue()
         const contract = new ethers.Contract(ISUBNET_ADDRESS, ISubnetABI, wallet);
@@ -509,4 +529,4 @@ describe("Test the Subnet precompile contract", () => {
         assert.equal(valueFromContract, newValue)
         assert.equal(valueFromContract, onchainValue);
     })
-})
+})

hyperparameters.md

@@ -7,6 +7,7 @@ TxRateLimit: u64 = 1; // [1 @ 64,888]
 ### netuid 1 (text_prompting)
 ```rust
 Rho: u16 = 10;
+AlphaSigmoidSteepness: u16 = 10.0
 Kappa: u16 = 32_767; // 0.5 = 65535/2
 MaxAllowedUids: u16 = 1024;
 Issuance: u64 = 0;
@@ -46,6 +47,7 @@ WeightsSetRateLimit: u64 = 100;
 ### netuid 3 (causallmnext)
 ```rust
 Rho: u16 = 10;
+AlphaSigmoidSteepness: u16 = 10.0
 Kappa: u16 = 32_767; // 0.5 = 65535/2
 MaxAllowedUids: u16 = 4096;
 Issuance: u64 = 0;

pallets/admin-utils/src/lib.rs

@@ -77,6 +77,13 @@ pub mod pallet {
             /// Indicates if the precompile operation is enabled or not.
             enabled: bool,
         },
+        /// Event emitted when the Yuma3 enable is toggled.
+        Yuma3EnableToggled {
+            /// The network identifier.
+            netuid: u16,
+            /// Indicates if the Yuma3 enable was enabled or disabled.
+            enabled: bool,
+        },
     }
 
     // Errors inform users that something went wrong.
@@ -1538,6 +1545,63 @@ pub mod pallet {
             Ok(())
         }
 
+        ///
+        ///
+        /// # Arguments
+        /// * `origin` - The origin of the call, which must be the root account.
+        /// * `netuid` - The unique identifier for the subnet.
+        /// * `steepness` - The new steepness for the alpha sigmoid function.
+        ///
+        /// # Errors
+        /// * `BadOrigin` - If the caller is not the root account.
+        /// # Weight
+        /// Weight is handled by the `#[pallet::weight]` attribute.
+        #[pallet::call_index(68)]
+        #[pallet::weight((0, DispatchClass::Operational, Pays::No))]
+        pub fn sudo_set_alpha_sigmoid_steepness(
+            origin: OriginFor<T>,
+            netuid: u16,
+            steepness: u16,
+        ) -> DispatchResult {
+            ensure_root(origin)?;
+            pallet_subtensor::Pallet::<T>::set_alpha_sigmoid_steepness(netuid, steepness);
+
+            log::debug!(
+                "AlphaSigmoidSteepnessSet( netuid: {:?}, steepness: {:?} )",
+                netuid,
+                steepness
+            );
+            Ok(())
+        }
+
+        /// Enables or disables Yuma3 for a given subnet.
+        ///
+        /// # Parameters
+        /// - `origin`: The origin of the call, which must be the root account or subnet owner.
+        /// - `netuid`: The unique identifier for the subnet.
+        /// - `enabled`: A boolean flag to enable or disable Yuma3.
+        ///
+        /// # Weight
+        /// This function has a fixed weight of 0 and is classified as an operational transaction that does not incur any fees.
+        #[pallet::call_index(69)]
+        #[pallet::weight((0, DispatchClass::Operational, Pays::No))]
+        pub fn sudo_set_yuma3_enabled(
+            origin: OriginFor<T>,
+            netuid: u16,
+            enabled: bool,
+        ) -> DispatchResult {
+            pallet_subtensor::Pallet::<T>::ensure_subnet_owner_or_root(origin, netuid)?;
+            pallet_subtensor::Pallet::<T>::set_yuma3_enabled(netuid, enabled);
+
+            Self::deposit_event(Event::Yuma3EnableToggled { netuid, enabled });
+            log::debug!(
+                "Yuma3EnableToggled( netuid: {:?}, Enabled: {:?} ) ",
+                netuid,
+                enabled
+            );
+            Ok(())
+        }
+
         /// Sets or updates the hotkey account associated with the owner of a specific subnet.
         ///
         /// This function allows either the root origin or the current subnet owner to set or update

pallets/admin-utils/src/tests/mock.rs

@@ -80,6 +80,7 @@ parameter_types! {
     pub const TransactionByteFee: Balance = 100;
     pub const SDebug:u64 = 1;
     pub const InitialRho: u16 = 30;
+    pub const InitialAlphaSigmoidSteepness: u16 = 10;
     pub const InitialKappa: u16 = 32_767;
     pub const InitialTempo: u16 = 0;
     pub const SelfOwnership: u64 = 2;
@@ -129,6 +130,7 @@ parameter_types! {
     pub const InitialAlphaHigh: u16 = 58982; // Represents 0.9 as per the production default
     pub const InitialAlphaLow: u16 = 45875; // Represents 0.7 as per the production default
     pub const InitialLiquidAlphaOn: bool = false; // Default value for LiquidAlphaOn
+    pub const InitialYuma3On: bool = false; // Default value for Yuma3On
     // pub const InitialHotkeyEmissionTempo: u64 = 1; // (DEPRECATED)
     // pub const InitialNetworkMaxStake: u64 = u64::MAX; // (DEPRECATED)
     pub const InitialColdkeySwapScheduleDuration: u64 = 5 * 24 * 60 * 60 / 12; // 5 days
@@ -158,6 +160,7 @@ impl pallet_subtensor::Config for Test {
     type InitialAdjustmentAlpha = InitialAdjustmentAlpha;
     type InitialTargetRegistrationsPerInterval = InitialTargetRegistrationsPerInterval;
     type InitialRho = InitialRho;
+    type InitialAlphaSigmoidSteepness = InitialAlphaSigmoidSteepness;
     type InitialKappa = InitialKappa;
     type InitialMaxAllowedUids = InitialMaxAllowedUids;
     type InitialValidatorPruneLen = InitialValidatorPruneLen;
@@ -196,6 +199,7 @@ impl pallet_subtensor::Config for Test {
     type AlphaHigh = InitialAlphaHigh;
     type AlphaLow = InitialAlphaLow;
     type LiquidAlphaOn = InitialLiquidAlphaOn;
+    type Yuma3On = InitialYuma3On;
     type Preimages = ();
     type InitialColdkeySwapScheduleDuration = InitialColdkeySwapScheduleDuration;
     type InitialColdkeySwapRescheduleDuration = InitialColdkeySwapRescheduleDuration;