Documentation

btcli tables in Bittensor Rao

When changing the emissions protocol, you can expect huge changes in the charts we have grown used to interact with. Here are some pointers to using the new btcli commands.

btcli stake add

the delegate commands are no longer used. All commands are run through the stake add (remove/move) commands.

Let's add stake to a hotkey registered on subnet 2:

The chart shows you the hotkey, how much, conversion rate, your received alpha (beta) and the slippage:

$ btcli st add   --subtensor.network local 

Enter netuid (0): 2
Enter wallet name (default): dtao
Enter staking hotkey name or ss58_address (default): 5DNnU3JjWVcXT28wBvbsK9ihJjSgkugU5ayin8fh5LaZBLy5
Stake all: Ο„1,999.3250? [y/n]: y
                                               Add Stake: 5HbjWim3NhYzGvacnZPL46tTLV5Sv5CrTKmis8aWTvhJbBLp                                               
    netuid     ┃       hotkey       ┃       amount (Ο„)       ┃                 rate (Ξ²/Ο„)                  ┃      received (Ξ²)       ┃     slippage      
━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━
       2       β”‚     5DN...Ly5      β”‚      Ο„1,999.3250       β”‚           1.8872974366492192(Ξ²/Ο„)           β”‚       2,639.5357Ξ²β€Ž       β”‚     30.0474 %     
───────────────┼────────────────────┼────────────────────────┼─────────────────────────────────────────────┼─────────────────────────┼───────────────────
               β”‚                    β”‚                        β”‚                                             β”‚                         β”‚                   
        -------------------------------------------------------------------------------------------------------------------
        WARNING:        Slippage is high: 30.0474 %, this may result in a loss of funds. 
        -------------------------------------------------------------------------------------------------------------------

btcli stake move

Move your staked tao from from subnet/hotkey to another subnet/hotkey.

  • Move stake in the same subnet - and swap hotkeys. This will incur zero slippage as you are in the same subnet)
btcli st move 
Enter origin netuid (0): 2
Enter destination netuid (0): 2
Enter coldkey name (default): rao
Enter origin hotkey name or ss58_address (default): 5FcDHCx5KpAX1ECqGuPZXGRHj8hAwjej7Hwh4roWy2HvCrHe
Enter destination hotkey name or ss58_address (default): 5DoFxQgKZopsyKGTuYt2M5baRZAjcjeCUDSdpZDi7JrMowxL
Move all: 1.1217 Ξ²β€Ž? [y/n]: y
                                                                                                                                         Move Stake                                                                                                                                         
             origin netuid              ┃             origin hotkey              ┃            dest netuid            ┃           dest hotkey            ┃           amount (Ξ²)           ┃           rate  (Ξ²/Ξ²)            ┃            recieved (Ξ²)             ┃        slippage         
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━
                  Ξ²(2)                  β”‚               5Fc...rHe                β”‚               Ξ²(2)                β”‚            5Do...wxL             β”‚            1.1217 Ξ²β€Ž            β”‚              1.0Ξ²/Ξ²              β”‚              1.1217 Ξ²β€Ž               β”‚           0%            
────────────────────────────────────────┼────────────────────────────────────────┼───────────────────────────────────┼──────────────────────────────────┼────────────────────────────────┼──────────────────────────────────┼─────────────────────────────────────┼─────────────────────────
                                        β”‚                                        β”‚                                   β”‚                                  β”‚                                β”‚                                  β”‚                                     β”‚                         


  • Move stake across subnets - to the same hotkey, or a different one. Moving alpha stake across subnets will incur a slippage.
btcli st move
Enter origin netuid (0): 1
Enter destination netuid (0): 2
Enter coldkey name (default): rao
Enter origin hotkey name or ss58_address (default): 5FbfQ61pKLaVAJ8rR2p2B6ioJw6LNpcYgdKuCij6x1dnKoNT
Enter destination hotkey name or ss58_address (default): 5FbfQ61pKLaVAJ8rR2p2B6ioJw6LNpcYgdKuCij6x1dnKoNT
Move all: 116.0991 Ξ±β€Ž? [y/n]: y
                                                                                                                                         Move Stake                                                                                                                                         
           origin netuid            ┃           origin hotkey            ┃          dest netuid          ┃          dest hotkey          ┃         amount (Ξ±)          ┃                       rate  (Ξ²/Ξ±)                       ┃           recieved (Ξ²)           ┃       slippage        
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━
                Ξ±(1)                β”‚             5Fb...oNT              β”‚             Ξ²(2)              β”‚           5Fb...oNT           β”‚         116.0991 Ξ±β€Ž          β”‚                 0.36601241403859214Ξ²/Ξ±                  β”‚            42.1347 Ξ²β€Ž             β”‚       0.2462 %        
────────────────────────────────────┼────────────────────────────────────┼───────────────────────────────┼───────────────────────────────┼─────────────────────────────┼─────────────────────────────────────────────────────────┼──────────────────────────────────┼───────────────────────
                                    β”‚                                    β”‚                               β”‚                               β”‚                             β”‚                                                         β”‚                                  β”‚                       
                                    

btcli subnet list

This lists all of the subnets, their emission, and information about the token and conversion to tao.

                                                                                                                                            Subnets - rao                                                                                                                                             
                                                                                                                                                                                                                                                                                                      
           Netuid           ┃           Symbol           ┃                                   Emission (Ο„) ┃                                         TAO(Ο„) ┃                                          Stake(Ξ±) ┃               Rate (Ξ±/Ο„)                ┃                Tempo (k/n)                 
━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
             0              β”‚             Ο„              β”‚                                       Ο„ 0.0000 β”‚                                     Ο„ 579.0260 β”‚                                        579.0260 Ο„ β”‚               1.0000 Ο„/Ο„                β”‚                   38/100                   
             2              β”‚             Ξ²              β”‚                                       Ο„ 0.2245 β”‚                                   Ο„ 5,037.4243 β”‚                                     15,364.2237 Ξ² β”‚               0.2922 Ο„/Ξ²                β”‚                  314/441                   
             8              β”‚             ΞΈ              β”‚                                       Ο„ 0.1033 β”‚                                   Ο„ 2,318.5485 β”‚                                     14,795.0593 ΞΈ β”‚               0.1320 Ο„/ΞΈ                β”‚                  275/958                   
             12             β”‚             ΞΌ              β”‚                                       Ο„ 0.0963 β”‚                                   Ο„ 2,160.2676 β”‚                                     13,792.1730 ΞΌ β”‚               0.1670 Ο„/ΞΌ                β”‚                  30/1028                   
             1              β”‚             Ξ±              β”‚                                       Ο„ 0.0923 β”‚                                   Ο„ 2,071.5843 β”‚                                     12,568.0831 Ξ± β”‚               0.1070 Ο„/Ξ±                β”‚                  360/1072                  
             10             β”‚             ΞΊ              β”‚                                       Ο„ 0.0626 β”‚                                   Ο„ 1,404.4772 β”‚                                     12,855.8705 ΞΊ β”‚               0.0802 Ο„/ΞΊ                β”‚                  707/1200                  
             9              β”‚             ΞΉ              β”‚                                       Ο„ 0.0618 β”‚                                   Ο„ 1,386.5258 β”‚                                     15,523.5555 ΞΉ β”‚               0.0844 Ο„/ΞΉ                β”‚                  706/1200                  
             7              β”‚             Ξ·              β”‚                                       Ο„ 0.0555 β”‚                                   Ο„ 1,244.8638 β”‚                                     14,486.7022 Ξ· β”‚               0.0690 Ο„/Ξ·                β”‚                  704/1200                  
             6              β”‚             ΞΆ              β”‚                                       Ο„ 0.0508 β”‚                                   Ο„ 1,140.7683 β”‚                                     14,867.5373 ΞΆ β”‚               0.0645 Ο„/ΞΆ                β”‚                  703/1200                  
             3              β”‚             Ξ³              β”‚                                       Ο„ 0.0418 β”‚                                     Ο„ 938.0996 β”‚                                     16,181.6471 Ξ³ β”‚               0.0571 Ο„/Ξ³                β”‚                  700/1200                  
             5              β”‚             Ξ΅              β”‚                                       Ο„ 0.0336 β”‚                                     Ο„ 753.4745 β”‚                                     16,796.2056 Ξ΅ β”‚               0.0477 Ο„/Ξ΅                β”‚                  702/1200                  
             4              β”‚             Ξ΄              β”‚                                       Ο„ 0.0319 β”‚                                     Ο„ 716.1923 β”‚                                     16,838.4833 Ξ΄ β”‚               0.0454 Ο„/Ξ΄                β”‚                  701/1200                  
             13             β”‚             Ξ½              β”‚                                       Ο„ 0.0308 β”‚                                     Ο„ 691.3259 β”‚                                     12,117.5937 Ξ½ β”‚               0.0554 Ο„/Ξ½                β”‚                  710/1200                  
             11             β”‚             Ξ»              β”‚                                       Ο„ 0.0253 β”‚                                     Ο„ 567.6519 β”‚                                     14,166.3862 Ξ» β”‚               0.0440 Ο„/Ξ»                β”‚                  708/1200                  
             16             β”‚             Ο€              β”‚                                       Ο„ 0.0177 β”‚                                     Ο„ 396.6541 β”‚                                      9,823.8763 Ο€ β”‚               0.0593 Ο„/Ο€                β”‚                  713/1200                  
             14             β”‚             ΞΎ              β”‚                                       Ο„ 0.0154 β”‚                                     Ο„ 345.9552 β”‚                                     10,522.4218 ΞΎ β”‚               0.0315 Ο„/ΞΎ                β”‚                  711/1200                  
             15             β”‚             ΞΏ              β”‚                                       Ο„ 0.0123 β”‚                                     Ο„ 275.5102 β”‚                                      9,921.6595 ΞΏ β”‚               0.0290 Ο„/ΞΏ                β”‚                  712/1200                             Ο„ 36.4267 β”‚                                      4,463.7029 Ο† β”‚               0.0132 Ο„/Ο†                β”‚                  718/1200                  
────────────────────────────┼────────────────────────────┼────────────────────────────────────────────────┼────────────────────────────────────────────────┼───────────────────────────────────────────────────┼─────────────────────────────────────────┼────────────────────────────────────────────
                            β”‚                            β”‚                                                β”‚                                                β”‚                                                   β”‚                                         β”‚                                            



  • Netuid: The Subnet number
  • Symbol: Greek (hebrew, etc.) character representing the Subnet.
  • Emission: Breakdown of tao emission across subnets. This is determined by the amount of tao staked to the subnet. This is represented as a fraction of tao.
  • TAO(Ο„): tao staked to the subnet.
  • Stake(⍺): Amount of alpha token available. This is direct conversion of P(Ο„.
  • Rate: (⍺, Ο„): Conversion rate from the alpha into tao. Or tao/alpha from the last 2 columns.
  • Tempo: Tempo varies by how much tao is staked to the subnet.

btcli subnet show

                Subnet: 2: Owner: 5HbjWim3NhYzGvacnZPL46tTLV5Sv5CrTKmis8aWTvhJbBLp, Total Locked: 206.1464Ξ²β€Ž, Owner Locked: 206.1464Ξ²β€Ž




   Index   ┃   Symbol   ┃    Emission (Ο„)     ┃                     P(Ο„, ┃ Ξ±)                    ┃         Ξ±          ┃    Rate (Ξ±/Ο„)    ┃   Tempo    
━━━━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━
     2     β”‚     Ξ²      β”‚       Ο„0.3623       β”‚          P( Ο„2,662.2423, β”‚ 3,285.5701Ξ² )         β”‚    4,778.4299Ξ²     β”‚    0.8103Ο„/Ξ²     β”‚  129/273   




                                                                   Subnet State #2                                                                    
 uid  ┃       Ξ²       ┃   Global(Ο„)   ┃  stake   ┃  dividends  ┃  incentive  ┃  emission (Ξ²)  ┃                        hotkey                         
━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  0   β”‚  3,753.1826Ξ²β€Ž  β”‚  Ο„6,456.3339  β”‚  1.0000  β”‚     0.0     β”‚     0.0     β”‚    1.0000Ξ²β€Ž     β”‚   5ETnYbd1asLmArmPQwcKzQGSzPLKB5fN4AcCXm5ZXX11GDcG    
──────┼───────────────┼───────────────┼──────────┼─────────────┼─────────────┼────────────────┼───────────────────────────────────────────────────────
      β”‚               β”‚               β”‚          β”‚             β”‚             β”‚                β”‚                                                       

Top row hows the subnet owner's key, and how much tao the owner has locked to this subnet. Locked alpha ensures this key retains ownership.

Top chart:

This replicates the data from btcli subnet list but just for this subnet

Main Chart

This is similar to the current btcli metagraph - showing all of the neurons registered to the subnet. Notice in the example above, that the subnet owner gains UID 0 by default.

We can see the amount of token (beta, in this case). As there is just one UID, all emission goes to this uid. Adding a second UID, we see emission is divided based on the staked amounts:

                                                                     Subnet State #2                                                                     
 uid  ┃       Ξ²        ┃    Global(Ο„)    ┃  stake   ┃  dividends  ┃  incentive  ┃  emission (Ξ²)  ┃                        hotkey                         
━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
  0   β”‚  9,574.5228Ξ²β€Ž   β”‚  Ο„12,931.1954   β”‚  0.8438  β”‚     0.0     β”‚     0.0     β”‚    0.8439Ξ²β€Ž     β”‚   5ETnYbd1asLmArmPQwcKzQGSzPLKB5fN4AcCXm5ZXX11GDcG    
  1   β”‚  2,643.7618Ξ²β€Ž   β”‚   Ο„1,371.9084   β”‚  0.1561  β”‚     0.0     β”‚     0.0     β”‚    0.1561Ξ²β€Ž     β”‚   5DNnU3JjWVcXT28wBvbsK9ihJjSgkugU5ayin8fh5LaZBLy5    
──────┼────────────────┼─────────────────┼──────────┼─────────────┼─────────────┼────────────────┼───────────────────────────────────────────────────────
      β”‚                β”‚                 β”‚          β”‚             β”‚             β”‚                β”‚                                               

btcli stake list

                                            hotkey: 5FbfQ61pKLaVAJ8rR2p2B6ioJw6LNpcYgdKuCij6x1dnKoNT                                             
                                                                                                                                                 
 Netuid  ┃ Symbol ┃     TAO(Ο„) ┃    Stake(Ξ±) ┃  Rate(Ο„/Ξ±)  ┃  Value(Ξ± x Ο„/Ξ±) ┃        Swap(Ξ±) -> Ο„ ┃  Registered ┃ Emission(Ξ±/block) ┃ Locked(Ξ±) 
━━━━━━━━━╇━━━━━━━━╇━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━━━╇━━━━━━━━━━━━━━━━━━━╇━━━━━━━━━━━
 1       β”‚      Ξ±β€Ž β”‚  Ο„ 24.0240 β”‚  157.4016 Ξ± β”‚ 0.1013 Ο„/Ξ±  β”‚       Ο„ 15.9406 β”‚  Ο„ 15.8283 (0.704%) β”‚         YES β”‚          0.0073 Ξ±β€Ž β”‚  0.0000 Ξ±β€Ž 
 2       β”‚      Ξ²β€Ž β”‚   Ο„ 8.9870 β”‚   28.7272 Ξ² β”‚ 0.2805 Ο„/Ξ²  β”‚        Ο„ 8.0588 β”‚   Ο„ 8.0471 (0.145%) β”‚         YES β”‚          0.0021 Ξ²β€Ž β”‚  0.0000 Ξ²β€Ž 
 3       β”‚      Ξ³β€Ž β”‚   Ο„ 2.0264 β”‚   35.2100 Ξ³ β”‚ 0.0602 Ο„/Ξ³  β”‚        Ο„ 2.1187 β”‚   Ο„ 2.1146 (0.194%) β”‚         YES β”‚          0.0021 Ξ³β€Ž β”‚  0.0000 Ξ³β€Ž 
 4       β”‚      Ξ΄β€Ž β”‚   Ο„ 1.1637 β”‚   27.5335 Ξ΄ β”‚ 0.0434 Ο„/Ξ΄  β”‚        Ο„ 1.1941 β”‚   Ο„ 1.1923 (0.151%) β”‚         YES β”‚          0.0018 Ξ΄β€Ž β”‚  0.0000 Ξ΄β€Ž 
 5       β”‚      Ξ΅β€Ž β”‚   Ο„ 1.4583 β”‚   32.6697 Ξ΅ β”‚ 0.0456 Ο„/Ξ΅  β”‚        Ο„ 1.4886 β”‚   Ο„ 1.4860 (0.179%) β”‚         YES β”‚          0.0020 Ξ΅β€Ž β”‚  0.0000 Ξ΅β€Ž 
 6       β”‚      ΞΆβ€Ž β”‚   Ο„ 2.4118 β”‚   32.0925 ΞΆ β”‚ 0.0626 Ο„/ΞΆ  β”‚        Ο„ 2.0079 β”‚   Ο„ 2.0047 (0.159%) β”‚         YES β”‚          0.0021 ΞΆβ€Ž β”‚  0.0000 ΞΆβ€Ž 
 7       β”‚      Ξ·β€Ž β”‚   Ο„ 3.0167 β”‚   36.0081 Ξ· β”‚ 0.0671 Ο„/Ξ·  β”‚        Ο„ 2.4151 β”‚   Ο„ 2.4109 (0.175%) β”‚         YES β”‚          0.0022 Ξ·β€Ž β”‚  0.0000 Ξ·β€Ž 
 8       β”‚      ΞΈβ€Ž β”‚   Ο„ 3.9587 β”‚   26.4221 ΞΈ β”‚ 0.1293 Ο„/ΞΈ  β”‚        Ο„ 3.4164 β”‚   Ο„ 3.4119 (0.132%) β”‚         YES β”‚          0.0018 ΞΈβ€Ž β”‚  0.0000 ΞΈβ€Ž 
 9       β”‚      ΞΉβ€Ž β”‚   Ο„ 7.1767 β”‚   81.0266 ΞΉ β”‚ 0.0812 Ο„/ΞΉ  β”‚        Ο„ 6.5785 β”‚   Ο„ 6.5504 (0.427%) β”‚         YES β”‚          0.0025 ΞΉβ€Ž β”‚  0.0000 ΞΉβ€Ž 
─────────┼────────┼────────────┼─────────────┼─────────────┼─────────────────┼─────────────────────┼─────────────┼───────────────────┼───────────
         β”‚        β”‚  Ο„ 54.2232 β”‚             β”‚             β”‚       Ο„ 43.2188 β”‚                     β”‚             β”‚                   β”‚           
  • TAO: amount of tao staked
  • Stake amount of alpha taked
  • Rate Ο„/⍺: Exchange rate tao/alpha
  • Value: Conversion of alpha to tao
  • Swap Conversion: How much alpha-> tao will return (this includes slippage).
  • Regitered:Is this Hotkey registered on the Subnet
  • Emission Emission per block for this hotkey
  • Locked Amount of take that i locked