rate limits updates with updater script (#115)

MichaelTrestman · web-flow · commit 88189c802873 · 2025-10-06T15:22:01.000-07:00
* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip

* wip
diff --git a/docs/evm-tutorials/subnet-precompile.md b/docs/evm-tutorials/subnet-precompile.md
@@ -74,6 +74,8 @@ Registers a new subnet with comprehensive identity metadata that helps users und
 
 ### Rate Limiting
 
+See [Rate Limits in Bittensor](../learn/chain-rate-limits.md).
+
 #### `getServingRateLimit`
 
 Gets the serving rate limit for a subnet.
diff --git a/docs/learn/announcements.md b/docs/learn/announcements.md
@@ -29,6 +29,8 @@ For detailed information, see: [Multiple Incentive Mechanisms Within Subnets](..
 - **Purpose**: Prevent exploitation where subnet owners kick off root validators to take full incentives
 - **Implementation**: Applies 7,200-block rate limit to prevent subnet owner exploitation
 
+See [Rate Limits in Bittensor](../learn/chain-rate-limits.md).
+
 ## Child Key Fee
 
 A percentage fee will be deducted from emissions bound to validator hotkeys through a *child hotkey* relationship. This is designed to more highly incentivize validators who perform validation work, over child-key-only validators. It is being gradually rolled out to reduce surprise for the community and allow validators to adjust.
@@ -46,7 +48,7 @@ A percentage fee will be deducted from emissions bound to validator hotkeys thro
 - **Key Changes**:
   - Subnet limit remains at 128 initially with no new registrations available immediately
   - Immunity period reduced from 6 months to 4 months from registration block
-  - Network rate limit increased to 3 days (from 2 days) between registrations
+  - Network rate limit increased to 4 days between registrations
   - Initial lock cost set at 1,000 TAO with standard linear decay mechanism
   - First deregistrations available approximately September 23 (one week after deployment)
 
diff --git a/docs/learn/chain-rate-limits.md b/docs/learn/chain-rate-limits.md
diff --git a/docs/scripts/check-rate-limits.js b/docs/scripts/check-rate-limits.js
@@ -0,0 +1,132 @@
+/* 
+SIMPLE BITENSOR RATE LIMITS CHECKER
+===================================
+Queries the specific rate limit state variables mentioned in the documentation.
+
+Usage: node simple-rate-limits.js
+*/
+
+const { ApiPromise, WsProvider } = require("@polkadot/api");
+
+async function checkRateLimits() {
+  try {
+    console.log("Connecting to Bittensor network...");
+    const wsProvider = new WsProvider("wss://entrypoint-finney.opentensor.ai:443");
+    const api = await ApiPromise.create({ provider: wsProvider });
+
+    console.log("✓ Connected successfully!\n");
+
+    const blockTimeSeconds = 12; // Bittensor blocks are ~12 seconds
+
+    // Global rate limits
+    console.log("GLOBAL RATE LIMITS:");
+    console.log("==================");
+    
+    try {
+      const txRateLimit = await api.query.subtensorModule.txRateLimit();
+      console.log(`TxRateLimit: ${txRateLimit.toNumber()} blocks (~${Math.round(txRateLimit.toNumber() * blockTimeSeconds / 3600 * 10) / 10}h)`);
+    } catch (e) {
+      console.log("TxRateLimit: Unable to query");
+    }
+
+    try {
+      const txDelegateTakeRateLimit = await api.query.subtensorModule.txDelegateTakeRateLimit();
+      console.log(`TxDelegateTakeRateLimit: ${txDelegateTakeRateLimit.toNumber()} blocks (~${Math.round(txDelegateTakeRateLimit.toNumber() * blockTimeSeconds / 3600 * 10) / 10}h)`);
+    } catch (e) {
+      console.log("TxDelegateTakeRateLimit: Unable to query");
+    }
+
+    try {
+      const txChildkeyTakeRateLimit = await api.query.subtensorModule.txChildkeyTakeRateLimit();
+      console.log(`TxChildkeyTakeRateLimit: ${txChildkeyTakeRateLimit.toNumber()} blocks (~${Math.round(txChildkeyTakeRateLimit.toNumber() * blockTimeSeconds / 3600 * 10) / 10}h)`);
+    } catch (e) {
+      console.log("TxChildkeyTakeRateLimit: Unable to query");
+    }
+
+    try {
+      const networkRateLimit = await api.query.subtensorModule.networkRateLimit();
+      console.log(`NetworkRateLimit: ${networkRateLimit.toNumber()} blocks (~${Math.round(networkRateLimit.toNumber() * blockTimeSeconds / 3600 * 10) / 10}h)`);
+    } catch (e) {
+      console.log("NetworkRateLimit: Unable to query");
+    }
+
+    try {
+      const ownerHyperparamRateLimit = await api.query.subtensorModule.ownerHyperparamRateLimit();
+      console.log(`OwnerHyperparamRateLimit: ${ownerHyperparamRateLimit.toNumber()} tempos`);
+    } catch (e) {
+      console.log("OwnerHyperparamRateLimit: Unable to query");
+    }
+
+    try {
+      const weightsVersionKeyRateLimit = await api.query.subtensorModule.weightsVersionKeyRateLimit();
+      console.log(`WeightsVersionKeyRateLimit: ${weightsVersionKeyRateLimit.toNumber()} blocks (~${Math.round(weightsVersionKeyRateLimit.toNumber() * blockTimeSeconds / 3600 * 10) / 10}h)`);
+    } catch (e) {
+      console.log("WeightsVersionKeyRateLimit: Unable to query");
+    }
+
+    try {
+      const adminFreezeWindow = await api.query.subtensorModule.adminFreezeWindow();
+      console.log(`AdminFreezeWindow: ${adminFreezeWindow.toNumber()} blocks (~${Math.round(adminFreezeWindow.toNumber() * blockTimeSeconds / 3600 * 10) / 10}h)`);
+    } catch (e) {
+      console.log("AdminFreezeWindow: Unable to query");
+    }
+
+    // Subnet-specific rate limits (check subnet 1 as example)
+    console.log("\nSUBNET-SPECIFIC RATE LIMITS (Subnet 1):");
+    console.log("=======================================");
+
+    try {
+      const servingRateLimit = await api.query.subtensorModule.servingRateLimit(1);
+      console.log(`ServingRateLimit: ${servingRateLimit.toNumber()} blocks (~${Math.round(servingRateLimit.toNumber() * blockTimeSeconds / 3600 * 10) / 10}h)`);
+    } catch (e) {
+      console.log("ServingRateLimit: Unable to query");
+    }
+
+    try {
+      const adjustmentInterval = await api.query.subtensorModule.adjustmentInterval(1);
+      console.log(`AdjustmentInterval: ${adjustmentInterval.toNumber()} blocks (~${Math.round(adjustmentInterval.toNumber() * blockTimeSeconds / 3600 * 10) / 10}h)`);
+    } catch (e) {
+      console.log("AdjustmentInterval: Unable to query");
+    }
+
+    try {
+      const immunityPeriod = await api.query.subtensorModule.immunityPeriod(1);
+      console.log(`ImmunityPeriod: ${immunityPeriod.toNumber()} blocks (~${Math.round(immunityPeriod.toNumber() * blockTimeSeconds / 3600 * 10) / 10}h)`);
+    } catch (e) {
+      console.log("ImmunityPeriod: Unable to query");
+    }
+
+    try {
+      const weightsSetRateLimit = await api.query.subtensorModule.weightsSetRateLimit(1);
+      console.log(`WeightsSetRateLimit: ${weightsSetRateLimit.toNumber()} blocks (~${Math.round(weightsSetRateLimit.toNumber() * blockTimeSeconds / 3600 * 10) / 10}h)`);
+    } catch (e) {
+      console.log("WeightsSetRateLimit: Unable to query");
+    }
+
+    try {
+      const maxRegistrationsPerBlock = await api.query.subtensorModule.maxRegistrationsPerBlock(1);
+      console.log(`MaxRegistrationsPerBlock: ${maxRegistrationsPerBlock.toNumber()} registrations`);
+    } catch (e) {
+      console.log("MaxRegistrationsPerBlock: Unable to query");
+    }
+
+    try {
+      const targetRegistrationsPerInterval = await api.query.subtensorModule.targetRegistrationsPerInterval(1);
+      console.log(`TargetRegistrationsPerInterval: ${targetRegistrationsPerInterval.toNumber()} registrations`);
+    } catch (e) {
+      console.log("TargetRegistrationsPerInterval: Unable to query");
+    }
+
+    console.log("\n✓ Complete");
+
+  } catch (error) {
+    console.error("Error:", error.message);
+    process.exit(1);
+  }
+}
+
+// Run the script
+checkRateLimits().catch(console.error);
+
+// Suppress warning messages
+console.warn = () => {};
diff --git a/docs/subnets/managing-mechanisms-btcli.md b/docs/subnets/managing-mechanisms-btcli.md
@@ -151,6 +151,6 @@ Totals are expressed as a fraction of 65535 (U16_MAX).
 
 ## Troubleshooting
 
-- Rate limiting: mechanism count changes are restricted (on mainnet) to once per ~24 hours (7200 blocks).
+- Rate limiting: mechanism count changes are restricted (on mainnet) to once per ~24 hours (7200 blocks). See [Rate Limits in Bittensor](../learn/chain-rate-limits.md).
 - Permissions: emission split and count updates require the subnet owner wallet.
 - Local chain connectivity: ensure your local chain is running and the `network` parameter in your BTCLI config is set to `local`.
diff --git a/docs/subnets/managing-mechanisms-with-sdk.md b/docs/subnets/managing-mechanisms-with-sdk.md
@@ -160,6 +160,6 @@ split:
 
 ## Troubleshooting
 
-- Rate limiting: mechanism count changes are restricted (on mainnet) to once per ~24 hours (7200 blocks).
+- Rate limiting: mechanism count changes are restricted (on mainnet) to once per ~24 hours (7200 blocks). See [Rate Limits in Bittensor](../learn/chain-rate-limits.md).
 - Permissions: emission split and count updates require the subnet owner wallet.
 - Local chain connectivity: ensure your local chain is running and your SDK points to `network="local"`.
diff --git a/docs/subnets/subnet-deregistration.md b/docs/subnets/subnet-deregistration.md
@@ -67,6 +67,8 @@ Deregistration can occur at most every once every 4 days (coordinated with regis
   - Block-based timing: 28800 blocks ≈ 4 days at 12s/block
   - [Source code](https://github.com/opentensor/subtensor/blob/main/pallets/subtensor/src/utils/rate_limiting.rs#L27)
 
+See [Rate Limits in Bittensor](../learn/chain-rate-limits.md).
+
 ## Special Cases and Edge Conditions
 
 ### All Subnets Immune
diff --git a/docs/subnets/uid-trimming.md b/docs/subnets/uid-trimming.md
@@ -8,6 +8,8 @@ UID trimming is a subnet management feature that allows subnet owners to reduce
 
 :::info UID trimming rate limit
 The chain's trim UID rate limit is 216,000 blocks (~30 days). Therefore, subnet owners can only make changes to their UID count every 30 days.
+
+See [Rate Limits in Bittensor](../learn/chain-rate-limits.md).
 :::
 
 - **Preserves Immune UIDs**: Both temporally immune UIDs and owner-owned UIDs are protected from trimming
diff --git a/docs/subnets/understanding-multiple-mech-subnets.md b/docs/subnets/understanding-multiple-mech-subnets.md
@@ -109,7 +109,7 @@ As of the current Subtensor runtime, a subnet can have a maximum of 2 mechanisms
 - **Transparent configuration**: All mechanism settings are visible on-chain for community oversight
 - **Single subnet slot**: No need to register multiple subnets for multiple competitions
 - **Immediate mechanism number setting**: The number of mechanisms is set immediately when changed. <!-- See: subtensor/pallets/subtensor/src/subnets/subsubnet.rs:91-116 -->
-- **Rate limiting**: Subnet owners can set the number of mechanisms once per 7200 blocks (24 hours) on mainnet. <!-- See: subtensor/pallets/subtensor/src/lib.rs:1842-1844 -->
+- **Rate limiting**: Subnet owners can set the number of mechanisms once per 7200 blocks (24 hours) on mainnet. See [Rate Limits in Bittensor](../learn/chain-rate-limits.md). <!-- See: subtensor/pallets/subtensor/src/lib.rs:1842-1844 -->
 
 :::tip
 Ensure proportions sum to 100% when setting them, or the request will be rejected.
diff --git a/docs/validators/child-hotkeys.md b/docs/validators/child-hotkeys.md
@@ -69,6 +69,8 @@ The following rate limits apply for child hotkeys:
 - A child hotkey's take rate can only be adjusted once per 30 days.
 - One successful execution of `set_children` or `revoke_children` is allowed for every 720 blocks.
 
+See [Rate Limits in Bittensor](../learn/chain-rate-limits.md).
+
 ## Minimum stake
 
 The minimum stake you can redelegate to a child hotkey is as follows:
