HotKeySwapOnSubnetIntervalNotPassed

Error Re-added v276 → v315, v320 → v326, v334 → v377, v385 → current 7.94

Not enough time has passed since the last hotkey swap on this subnet .

Encountered by: minersvalidatorsdevelopers

Why This Error Exists

Hotkey swaps are rate-limited per-subnet to prevent gaming the network. Without this limit, someone could rapidly cycle through hotkeys to reset reputation, avoid penalties, or manipulate subnet dynamics. The interval ensures stability and gives the network time to adjust to new hotkeys.

Deep Dive

HotkeySwapOnSubnetInterval is measured in blocks. LastHotkeySwapOnNetuid(coldkey, netuid) stores when you last swapped a hotkey on that subnet. You must wait (last_swap + interval) blocks before swapping again. This is per-coldkey per-subnet, so you can swap on different subnets simultaneously.

Debugging Example

You swapped hotkey on subnet 3 at block 500,000. Interval is 14,400 blocks (~48 hours). You try to swap again at block 510,000. Error: HotKeySwapOnSubnetIntervalNotPassed. 510,000 - 500,000 = 10,000 blocks elapsed. Need 14,400. Wait until block 514,400.

Prevention Tips

  • Track your last swap block per subnet
  • Plan hotkey rotations with the interval in mind
  • Query LastHotkeySwapOnNetuid before attempting a swap

From Chain Metadata

Too frequent hotkey swap on subnet

What This Means

Not enough time has passed since the last hotkey swap on this subnet.

Common Causes

  • Swapped hotkey too recently on this subnet
  • Rate limit applies per-subnet

How to Fix

  • Wait for HotkeySwapOnSubnetInterval blocks to pass
  • Check the constant for the required wait time

Storage to Check

SubtensorModule.LastHotkeySwapOnNetuidSubtensorModule.HotkeySwapOnSubnetInterval (removed)

Thrown By

Version History

v276 block 5,781,672 Added
v320 block 6,523,566 Re-added
v334 block 6,811,690 Re-added
v385 block 7,782,670 Re-added Current

Runtime Info

Pallet Index
7
Error Index
94
Error Code
7.94
Runtime Version
v393