Feat/ subnet mechanisms

[ibraheem-abe]

New commands

1. btcli subnet mech count

Important

Displays total number of active subnet mechanisms in a subnet.

Examples:

Note

• Subnet doesnt have any mechanisms:

Note

• Subnet has 2 active mechanisms:

2. btcli subnet mech set

Important

Change the number of mechanisms in a subnet. This command can be used for both:

• Increasing the mechanisms
• or Decreasing them

Examples:

Note

• Subnet had 1 active mechanism, changing it to 2

Note

• Subnet had 2 active mechanisms, changing it back to 1

3. btcli subnet mech emissions

Important

Check the existing emission split between subnet mechanisms

• If a split is defined, display
• If not, the cli shows the approximate split that subtensor will do on its end.

Examples:

Note

• No additional subnet mechanisms are present. Emissions will not get split.

Note

• An emission split was defined by the subnet owner.

Note

• Additional mechanism is present but split was not defined. Hence we show the default distribution

4. btcli subnet mech emissions-split

Important

This command will help users split their total emissions across different mechanisms.
Values should be relative to each subnet mechanisms - just like we set weights.
Input can be of both formats:

• Raw u16s
• Percentages

Examples:

Note

• We already had an emission split defined. A subnet owner wants to change the split by providing percentages.

Note

• There was no prior split defined. The subnet owner is defining the split for the first time.

Updated commands

1. btcli subnet metagraph --netuid 2

Important

The metagraph command has been updated to accept a new parameter mechid. If not passed, it will prompt and validate the mechanism id

Examples:

Note

• 2 mechanisms are active in netuid 2

Note

• 1 mechanism is active in netuid 1