RaoFoundation · UnArbosSix · Jul 28, 2026 · Jul 28, 2026 · Jul 28, 2026 · Jul 28, 2026
diff --git a/docs/errors/chain/BondsMovingAverageMaxReached.mdx b/docs/errors/chain/BondsMovingAverageMaxReached.mdx
@@ -9,7 +9,7 @@ A subnet owner called `sudo_set_bonds_moving_average` with a value above 975000,
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`limit_exceeded`](/docs/errors/limit-exceeded).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L149`](/code/pallets/admin-utils/src/lib.rs#L149).
+Declared at [`pallets/admin-utils/src/lib.rs#L155`](/code/pallets/admin-utils/src/lib.rs#L155).
 
 ## Remediation
 

diff --git a/docs/errors/chain/CollateralDrainRatioOutOfBounds.mdx b/docs/errors/chain/CollateralDrainRatioOutOfBounds.mdx
@@ -9,7 +9,7 @@ description: "Check the argument values against the operation schema"
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`invalid_argument`](/docs/errors/invalid-argument).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L173`](/code/pallets/admin-utils/src/lib.rs#L173).
+Declared at [`pallets/admin-utils/src/lib.rs#L179`](/code/pallets/admin-utils/src/lib.rs#L179).
 
 ## Remediation
 

diff --git a/docs/errors/chain/CollateralLockShareTooHigh.mdx b/docs/errors/chain/CollateralLockShareTooHigh.mdx
@@ -9,7 +9,7 @@ description: "Check the argument values against the operation schema"
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`invalid_argument`](/docs/errors/invalid-argument).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L171`](/code/pallets/admin-utils/src/lib.rs#L171).
+Declared at [`pallets/admin-utils/src/lib.rs#L177`](/code/pallets/admin-utils/src/lib.rs#L177).
 
 ## Remediation
 

diff --git a/docs/errors/chain/Deprecated.mdx b/docs/errors/chain/Deprecated.mdx
@@ -9,7 +9,7 @@ The extrinsic has been removed and always fails, e.g. `schedule_swap_coldkey`, t
 
 Declared by the `SubtensorModule`, `AdminUtils`, `Swap` pallets; it classifies to the semantic code [`disabled`](/docs/errors/disabled).
 
-Declared at [`pallets/subtensor/src/macros/errors.rs#L287`](/code/pallets/subtensor/src/macros/errors.rs#L287), [`pallets/admin-utils/src/lib.rs#L169`](/code/pallets/admin-utils/src/lib.rs#L169), [`pallets/swap/src/pallet/mod.rs#L181`](/code/pallets/swap/src/pallet/mod.rs#L181).
+Declared at [`pallets/subtensor/src/macros/errors.rs#L287`](/code/pallets/subtensor/src/macros/errors.rs#L287), [`pallets/admin-utils/src/lib.rs#L175`](/code/pallets/admin-utils/src/lib.rs#L175), [`pallets/swap/src/pallet/mod.rs#L181`](/code/pallets/swap/src/pallet/mod.rs#L181).
 
 ## Remediation
 

diff --git a/docs/errors/chain/InvalidValue.mdx b/docs/errors/chain/InvalidValue.mdx
@@ -9,7 +9,7 @@ A generic out-of-range parameter on an admin or sudo call, e.g. mechanism counts
 
 Declared by the `SubtensorModule`, `AdminUtils` pallets; it classifies to the semantic code [`invalid_argument`](/docs/errors/invalid-argument).
 
-Declared at [`pallets/subtensor/src/macros/errors.rs#L257`](/code/pallets/subtensor/src/macros/errors.rs#L257), [`pallets/admin-utils/src/lib.rs#L163`](/code/pallets/admin-utils/src/lib.rs#L163).
+Declared at [`pallets/subtensor/src/macros/errors.rs#L257`](/code/pallets/subtensor/src/macros/errors.rs#L257), [`pallets/admin-utils/src/lib.rs#L169`](/code/pallets/admin-utils/src/lib.rs#L169).
 
 ## Remediation
 

diff --git a/docs/errors/chain/MaxAllowedUIdsLessThanCurrentUIds.mdx b/docs/errors/chain/MaxAllowedUIdsLessThanCurrentUIds.mdx
@@ -9,7 +9,7 @@ description: "Check the argument values against the operation schema"
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`invalid_argument`](/docs/errors/invalid-argument).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L147`](/code/pallets/admin-utils/src/lib.rs#L147).
+Declared at [`pallets/admin-utils/src/lib.rs#L153`](/code/pallets/admin-utils/src/lib.rs#L153).
 
 ## Remediation
 

diff --git a/docs/errors/chain/MaxAllowedUidsGreaterThanDefaultMaxAllowedUids.mdx b/docs/errors/chain/MaxAllowedUidsGreaterThanDefaultMaxAllowedUids.mdx
@@ -9,7 +9,7 @@ description: "Check the argument values against the operation schema"
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`invalid_argument`](/docs/errors/invalid-argument).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L161`](/code/pallets/admin-utils/src/lib.rs#L161).
+Declared at [`pallets/admin-utils/src/lib.rs#L167`](/code/pallets/admin-utils/src/lib.rs#L167).
 
 ## Remediation
 

diff --git a/docs/errors/chain/MaxAllowedUidsLessThanMinAllowedUids.mdx b/docs/errors/chain/MaxAllowedUidsLessThanMinAllowedUids.mdx
@@ -9,7 +9,7 @@ description: "Check the argument values against the operation schema"
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`invalid_argument`](/docs/errors/invalid-argument).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L159`](/code/pallets/admin-utils/src/lib.rs#L159).
+Declared at [`pallets/admin-utils/src/lib.rs#L165`](/code/pallets/admin-utils/src/lib.rs#L165).
 
 ## Remediation
 

diff --git a/docs/errors/chain/MaxValidatorsLargerThanMaxUIds.mdx b/docs/errors/chain/MaxValidatorsLargerThanMaxUIds.mdx
@@ -9,7 +9,7 @@ description: "Check the argument values against the operation schema"
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`invalid_argument`](/docs/errors/invalid-argument).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L145`](/code/pallets/admin-utils/src/lib.rs#L145).
+Declared at [`pallets/admin-utils/src/lib.rs#L151`](/code/pallets/admin-utils/src/lib.rs#L151).
 
 ## Remediation
 

diff --git a/docs/errors/chain/MinAllowedUidsGreaterThanCurrentUids.mdx b/docs/errors/chain/MinAllowedUidsGreaterThanCurrentUids.mdx
@@ -9,7 +9,7 @@ description: "Check the argument values against the operation schema"
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`invalid_argument`](/docs/errors/invalid-argument).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L155`](/code/pallets/admin-utils/src/lib.rs#L155).
+Declared at [`pallets/admin-utils/src/lib.rs#L161`](/code/pallets/admin-utils/src/lib.rs#L161).
 
 ## Remediation
 

diff --git a/docs/errors/chain/MinAllowedUidsGreaterThanMaxAllowedUids.mdx b/docs/errors/chain/MinAllowedUidsGreaterThanMaxAllowedUids.mdx
@@ -9,7 +9,7 @@ description: "Check the argument values against the operation schema"
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`invalid_argument`](/docs/errors/invalid-argument).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L157`](/code/pallets/admin-utils/src/lib.rs#L157).
+Declared at [`pallets/admin-utils/src/lib.rs#L163`](/code/pallets/admin-utils/src/lib.rs#L163).
 
 ## Remediation
 

diff --git a/docs/errors/chain/NegativeSigmoidSteepness.mdx b/docs/errors/chain/NegativeSigmoidSteepness.mdx
@@ -9,7 +9,7 @@ A non-root caller (subnet owner) passed a negative value to `sudo_set_alpha_sigm
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`invalid_argument`](/docs/errors/invalid-argument).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L151`](/code/pallets/admin-utils/src/lib.rs#L151).
+Declared at [`pallets/admin-utils/src/lib.rs#L157`](/code/pallets/admin-utils/src/lib.rs#L157).
 
 ## Remediation
 

diff --git a/docs/errors/chain/NotPermittedOnRootSubnet.mdx b/docs/errors/chain/NotPermittedOnRootSubnet.mdx
@@ -9,7 +9,7 @@ An admin-utils call that only applies to regular subnets (burn half-life, burn i
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`invalid_argument`](/docs/errors/invalid-argument).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L165`](/code/pallets/admin-utils/src/lib.rs#L165).
+Declared at [`pallets/admin-utils/src/lib.rs#L171`](/code/pallets/admin-utils/src/lib.rs#L171).
 
 ## Remediation
 

diff --git a/docs/errors/chain/POWRegistrationDisabled.mdx b/docs/errors/chain/POWRegistrationDisabled.mdx
@@ -9,7 +9,7 @@ description: "This call or feature is switched off on this network"
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`disabled`](/docs/errors/disabled).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L167`](/code/pallets/admin-utils/src/lib.rs#L167).
+Declared at [`pallets/admin-utils/src/lib.rs#L173`](/code/pallets/admin-utils/src/lib.rs#L173).
 
 ## Remediation
 

diff --git a/docs/errors/chain/SubnetDoesNotExist.mdx b/docs/errors/chain/SubnetDoesNotExist.mdx
@@ -9,7 +9,7 @@ The admin-utils call targets a netuid with no registered subnet. Verify the `net
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`subnet_not_exists`](/docs/errors/subnet-not-exists).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L143`](/code/pallets/admin-utils/src/lib.rs#L143).
+Declared at [`pallets/admin-utils/src/lib.rs#L149`](/code/pallets/admin-utils/src/lib.rs#L149).
 
 ## Remediation
 

diff --git a/docs/errors/chain/TooManyRootClaimHotkeys.mdx b/docs/errors/chain/TooManyRootClaimHotkeys.mdx
@@ -0,0 +1,18 @@
+---
+title: "TooManyRootClaimHotkeys"
+description: "A chain-side capacity limit was hit; reduce the size or count of the request"
+---
+
+{/* GENERATED by scripts/generate.py from the SDK registries — do not edit. */}
+
+The coldkey has more staking hotkeys than a single manual root claim can process. Reduce the coldkey's staking-hotkey fanout below `MAX_ROOT_CLAIM_HOTKEYS`, or use automatic root claiming instead.
+
+Declared by the `SubtensorModule` pallet; it classifies to the semantic code [`limit_exceeded`](/docs/errors/limit-exceeded).
+
+Declared at [`pallets/subtensor/src/macros/errors.rs#L350`](/code/pallets/subtensor/src/macros/errors.rs#L350).
+
+## Remediation
+
+A chain-side capacity limit was hit; reduce the size or count of the request
+
+The same explanation is available in the terminal: `btcli explain TooManyRootClaimHotkeys`.
diff --git a/docs/errors/chain/ValueNotInBounds.mdx b/docs/errors/chain/ValueNotInBounds.mdx
@@ -9,7 +9,7 @@ An admin-utils argument fell outside its allowed range: `min_burn` must be below
 
 Declared by the `AdminUtils` pallet; it classifies to the semantic code [`invalid_argument`](/docs/errors/invalid-argument).
 
-Declared at [`pallets/admin-utils/src/lib.rs#L153`](/code/pallets/admin-utils/src/lib.rs#L153).
+Declared at [`pallets/admin-utils/src/lib.rs#L159`](/code/pallets/admin-utils/src/lib.rs#L159).
 
 ## Remediation
 

diff --git a/docs/errors/chain/index.mdx b/docs/errors/chain/index.mdx
@@ -330,6 +330,7 @@ The exact chain error name (from the extrinsic receipt) maps to a semantic [code
 | [`TooManyRegistrationsThisBlock`](/docs/errors/chain/TooManyRegistrationsThisBlock) | [`rate_limited`](/docs/errors/rate-limited) | Registrations in the current block already reached the subnet's per-block cap (`MaxRegistrationsPerBlock`, the max_regs_per_block hyperparameter); root registration enforces the same cap on netuid 0. Retry in the next block. |
 | [`TooManyRegistrationsThisInterval`](/docs/errors/chain/TooManyRegistrationsThisInterval) | [`rate_limited`](/docs/errors/rate-limited) | Registrations in the current interval reached the cap of three times `TargetRegistrationsPerInterval` for the subnet. Compare `RegistrationsThisInterval` against that hyperparameter and wait for the next interval to start. |
 | [`TooManyReserves`](/docs/errors/chain/TooManyReserves) | [`limit_exceeded`](/docs/errors/limit-exceeded) | The account already has the maximum number of named reserves. Check the account's `Reserves` entry against the `MaxReserves` constant; a named reserve must be unreserved before adding another. |
+| [`TooManyRootClaimHotkeys`](/docs/errors/chain/TooManyRootClaimHotkeys) | [`limit_exceeded`](/docs/errors/limit-exceeded) | The coldkey has more staking hotkeys than a single manual root claim can process. Reduce the coldkey's staking-hotkey fanout below `MAX_ROOT_CLAIM_HOTKEYS`, or use automatic root claiming instead. |
 | [`TooManySignatories`](/docs/errors/chain/TooManySignatories) | [`limit_exceeded`](/docs/errors/limit-exceeded) | The multisig signatory list exceeds the maximum allowed. Compare the length of `other_signatories` plus the sender against the pallet's `MaxSignatories` constant. |
 | [`TooManyTopics`](/docs/errors/chain/TooManyTopics) | [`limit_exceeded`](/docs/errors/limit-exceeded) | The number of topics passed to `seal_deposit_event` exceeds the schedule's `event_topics` limit. Reduce the number of indexed topics in the contract's event definition or compare against the schedule limit. |
 | [`TooManyUIDsPerMechanism`](/docs/errors/chain/TooManyUIDsPerMechanism) | [`limit_exceeded`](/docs/errors/limit-exceeded) | Setting max UIDs or mechanism count would make max_uids times mechanism_count exceed the chain default of 256 UIDs per subnet. Check `MaxAllowedUids` and the subnet's mechanism count so their product stays within the limit. |

diff --git a/docs/errors/chain/meta.json b/docs/errors/chain/meta.json
@@ -323,6 +323,7 @@
     "TooManyRegistrationsThisBlock",
     "TooManyRegistrationsThisInterval",
     "TooManyReserves",
+    "TooManyRootClaimHotkeys",
     "TooManySignatories",
     "TooManyTopics",
     "TooManyUIDsPerMechanism",

diff --git a/docs/errors/index.mdx b/docs/errors/index.mdx
@@ -21,7 +21,7 @@ A failed `execute` returns an `ExtrinsicResult` whose `error` has a semantic `co
 | [`disabled`](/docs/errors/disabled) | 19 | This call or feature is switched off on this network |
 | [`too_early`](/docs/errors/too-early) | 18 | The required window has not opened yet; wait some blocks and retry |
 | [`expired`](/docs/errors/expired) | 5 | The window has closed; restart the flow with fresh state |
-| [`limit_exceeded`](/docs/errors/limit-exceeded) | 37 | A chain-side capacity limit was hit; reduce the size or count of the request |
+| [`limit_exceeded`](/docs/errors/limit-exceeded) | 38 | A chain-side capacity limit was hit; reduce the size or count of the request |
 | [`unit_mismatch`](/docs/errors/unit-mismatch) | — | Match the Balance netuid to the operation's currency |
 | [`invalid_argument`](/docs/errors/invalid-argument) | 135 | Check the argument values against the operation schema |
 | [`policy_violation`](/docs/errors/policy-violation) | 2 | The action exceeds a configured safety policy |

diff --git a/docs/errors/limit-exceeded.mdx b/docs/errors/limit-exceeded.mdx
@@ -48,6 +48,7 @@ The exact chain error names (from the extrinsic receipt) that classify to `limit
 | [`TooManyHolds`](/docs/errors/chain/TooManyHolds) | The account already carries the maximum number of balance holds, one per hold reason variant. Check the account's `Holds` entry; an existing hold must be released before a new reason can place another. |
 | [`TooManyPendingExtrinsics`](/docs/errors/chain/TooManyPendingExtrinsics) | `store_encrypted` was rejected because the shield pallet's queue of encrypted extrinsics is already at capacity. Compare the `PendingExtrinsics` count against `MaxPendingExtrinsicsLimit` and wait for queued items to be processed or expire. |
 | [`TooManyReserves`](/docs/errors/chain/TooManyReserves) | The account already has the maximum number of named reserves. Check the account's `Reserves` entry against the `MaxReserves` constant; a named reserve must be unreserved before adding another. |
+| [`TooManyRootClaimHotkeys`](/docs/errors/chain/TooManyRootClaimHotkeys) | The coldkey has more staking hotkeys than a single manual root claim can process. Reduce the coldkey's staking-hotkey fanout below `MAX_ROOT_CLAIM_HOTKEYS`, or use automatic root claiming instead. |
 | [`TooManySignatories`](/docs/errors/chain/TooManySignatories) | The multisig signatory list exceeds the maximum allowed. Compare the length of `other_signatories` plus the sender against the pallet's `MaxSignatories` constant. |
 | [`TooManyTopics`](/docs/errors/chain/TooManyTopics) | The number of topics passed to `seal_deposit_event` exceeds the schedule's `event_topics` limit. Reduce the number of indexed topics in the contract's event definition or compare against the schedule limit. |
 | [`TooManyUIDsPerMechanism`](/docs/errors/chain/TooManyUIDsPerMechanism) | Setting max UIDs or mechanism count would make max_uids times mechanism_count exceed the chain default of 256 UIDs per subnet. Check `MaxAllowedUids` and the subnet's mechanism count so their product stays within the limit. |