Merge branch 'main' into docs-edits

chideraao · web-flow · commit 3bb62c40d0ed · 2025-06-07T02:14:12.000+01:00
diff --git a/docs/subnets/create-a-subnet.md b/docs/subnets/create-a-subnet.md
@@ -8,10 +8,9 @@ This page describes the procedures for creating a new Bittensor subnet on test c
 
 You should first try [Creating a Subnet on a locally deployed chain](../local-build/create-subnet).
 
-Creating a subnet is a major undertaking. You should read up on [Understanding Subnets](understanding-subnets) and research existing subnets before planning to create one.
+Creating a subnet is a major undertaking. You should read up on [Understanding Subnets](understanding-subnets) and research existing subnets before planning to create one. 
 
 ## Considerations
-
 ### Research existing subnets
 
 Prospective subnet creators should familiarize themselves with the space of existing subnets.
@@ -34,21 +33,19 @@ Check the burn cost to create a subnet on Bittensor main network and test networ
 ```shell
 btcli subnet burn-cost --network finney
 ```
-
 <codapi-snippet sandbox="python" editor="basic" init-delay="500">
 </codapi-snippet>
 
 ```shell
 btcli subnet burn-cost --network test
 ```
-
 <codapi-snippet sandbox="python" editor="basic" init-delay="500">
 </codapi-snippet>
 :::
 
 ### A new subnet is not automatically active
 
-To allow subnet owners to fully set up their subnets and to prevent extraction of emissions to subnet participants before the subnet is contributing to the network, new subnets are inactive and cannot be started for 7 \* 7200 blocks (roughly one week) after they are registered. During this time, you can register and activate validators and invite miners into the subnet.
+To allow subnet owners to fully set up their subnets and to prevent extraction of emissions to subnet participants before the subnet is contributing to the network, new subnets are inactive and cannot be started for 7 * 7200 blocks (roughly one week) after they are registered.  During this time, you can register and activate validators and invite miners into the subnet.  
 
 :::info
 The subnet and its participants will receive **no emissions** during the time that the subnet is inactive.
@@ -58,7 +55,7 @@ The subnet and its participants will receive **no emissions** during the time th
 
 You must meet the same [requirements for validation](../validators#requirements-for-validation) as other validators in order to set weights in your own subnet.
 
-One option for subnet owners is to ask one of the root network (subnet 0) validators to parent your validator hotkey as a childkey of theirs. This will lend their stake to your validator, and can help you ensure that your validator maintains a sufficient stake to effectively participate in consensus as well as resist deregistration. See the [Child Hotkeys](./child-hotkeys) documentation for more detail.
+One option for subnet owners is to ask one of the root network (subnet 0) validators to parent your validator hotkey as a childkey of theirs.  This will lend their stake to your validator, and can help you ensure that your validator maintains a sufficient stake to effectively participate in consensus as well as resist deregistration. See the [Child Hotkeys](./child-hotkeys) documentation for more detail.
 
 ### Subnet creation rate limits
 
@@ -67,7 +64,7 @@ Subnet creations are limited to **one subnet creation per 7200 blocks** (approxi
 ## Prerequisites
 
 - [Install the most recent version of BTCLI](../getting-started/install-btcli).
-- [Created a wallet](../getting-started/wallets.md#creating-a-local-wallet).
+- [Created a wallet](../getting-started/wallets.md#creating-a-local-wallet). 
 - To create a subnet on test chain, your wallet must have sufficient test net TAO. Inquire in [Discord](https://discord.com/channels/799672011265015819/1107738550373454028/threads/1331693251589312553) to obtain TAO on Bittensor test network.
 - To create a subnet on main network (finney) requires a substantial investment of TAO, depending on current registration cost for new subnets.
 
@@ -78,11 +75,9 @@ Create your new subnet on the testchain using the test TAO you received from the
 Run the create subnet command on the testchain.
 
 ```bash
-btcli subnet create --network test
+btcli subnet create --network test 
 ```
-
 Output:
-
 ```bash
 # Enter the owner wallet name, which gives the coldkey permissions to define running hyperparameters later.
 >> Enter wallet name (default): owner   # Enter your owner wallet name
@@ -94,20 +89,18 @@ Output:
 
 ## Creating a subnet on mainchain
 
-:::caution Alert: Minimum required TAO
+:::caution Alert: Minimum required TAO 
 Creating a subnet on the mainnet is competitive, and the cost is determined by the rate at which new networks are registered onto the chain.
 :::
 
-### Create the subnet
+### Create the subnet 
 
-Use the below command to create a new subnet on the mainchain.
+Use the below command to create a new subnet on the mainchain. 
 
 ```bash
 btcli subnet create
 ```
-
 Output:
-
 ```bash
 >> Enter wallet name (default): owner   # Enter your owner wallet name
 >> Enter password to unlock key:        # Enter your wallet password.
@@ -118,20 +111,20 @@ Output:
 
 ### Check to see if you can start the subnet
 
-Use the below command to check whether the subnet can be started.
+Use the below command to check whether the subnet can be started. 
 
 ```bash
 btcli subnet check-start --netuid x
 ```
 
 Where "x" is the subnet ID.
 
-The output will provide you with the block registered and the block at which the subnet can be started, with "blocks remaining" and an estimated time. When this time has passed, the `check-start` command will return `Emission schedule can be started.`
+The output will provide you with the block registered and the block at which the subnet can be started, with "blocks remaining" and an estimated time.  When this time has passed, the `check-start` command will return `Emission schedule can be started.` 
 
 ### Start the subnet
 
-Use the below command to start the subnet once `check-start` returns `Emission schedule can be started.`
+Use the below command to start the subnet once `check-start` returns `Emission schedule can be started.` 
 
 ```bash
 btcli subnet start --netuid x
-```
+```
diff --git a/static/llms.txt b/static/llms.txt
@@ -0,0 +1,135 @@
+# Bittensor Documentation Resources
+
+## Official Documentation
+The primary sources for Bittensor documentation and learning resources.
+- Main Documentation: https://docs.bittensor.com - Comprehensive technical documentation covering all aspects of Bittensor
+- Learn Bittensor (More Accessible): https://learnbittensor.org - User-friendly explanations and tutorials for beginners
+
+## Core Concepts
+### Introduction
+- Introduction to Bittensor: https://docs.bittensor.com/learn/introduction
+- Learn Bittensor Introduction: https://learnbittensor.org/explore/article/introduction-to-bittensor
+
+### Subnets
+- Understanding Subnets: https://docs.bittensor.com/subnets/understanding-subnets
+- Creating Subnets: https://docs.bittensor.com/subnets/create-a-subnet
+- Subnet Management:
+  - Subnet Creators Guide: https://docs.bittensor.com/subnets/subnet-creators-btcli-guide
+  - Subnet Hyperparameters: https://docs.bittensor.com/subnets/subnet-hyperparameters
+  - Working with Subnets: https://docs.bittensor.com/subnets/working-with-subnets
+  -  Walkthrough of example subnet: https://docs.bittensor.com/subnets/walkthrough-prompting
+
+### Consensus and Emissions
+The mechanisms that power Bittensor's incentive system and reward distribution.
+- Yuma Consensus: https://docs.bittensor.com/yuma-consensus - Technical details of Bittensor's consensus mechanism
+- Emissions: https://docs.bittensor.com/emissions - How TAO and alpha tokens are distributed in the network
+
+## Network Participants
+### Miners
+Participants who provide AI services to the network.
+- Miner Documentation: https://docs.bittensor.com/miners/ - Complete guide to mining on Bittensor
+- Miner Guide: https://docs.bittensor.com/miners/miners-btcli-guide - Command-line interface guide for miners
+- Learn Bittensor Miner Concept: https://learnbittensor.org/explore/concept/miner - Simplified explanation of mining
+
+### Validators
+Network participants who verify and rank miner performance.
+- Validator Documentation: https://docs.bittensor.com/validators/ - Comprehensive validator guide
+- Validator Guide: https://docs.bittensor.com/validators/validators-btcli-guide - CLI operations for validators
+- Child Hotkeys: https://docs.bittensor.com/validators/subnets/child-hotkeys - Managing multiple validator instances
+- Learn Bittensor Validator Concept: https://learnbittensor.org/explore/concept/validator - Beginner's guide to validation
+
+### Staking and Delegation
+- Staking/Delegation Overview: https://docs.bittensor.com/staking-and-delegation/delegation
+- Staking Guides:
+  - BTCLI Guide: https://docs.bittensor.com/staking-and-delegation/stakers-btcli-guide
+  - Managing Stake with BTCLI: https://docs.bittensor.com/staking-and-delegation/managing-stake-btcli
+  - Managing Stake with SDK: https://docs.bittensor.com/staking-and-delegation/managing-stake-sdk
+  - Polkadot.js Guide: https://docs.bittensor.com/staking-and-delegation/staking-polkadot-js
+  - Ledger Hardware Wallet: https://docs.bittensor.com/staking-and-delegation/using-ledger-hw-wallet
+
+## Development Tools
+Essential tools for building and interacting with Bittensor.
+
+### BTCLI (Command Line Interface)
+The primary command-line tool for Bittensor operations.
+- Overview: https://docs.bittensor.com/btcli/overview - Introduction to BTCLI
+- Installation: https://docs.bittensor.com/getting-started/install-btcli - Setting up BTCLI
+- Playground: https://docs.bittensor.com/btcli/btcli-playground - Interactive BTCLI learning environment
+- Permissions: https://docs.bittensor.com/btcli-permissions - Understanding BTCLI access levels
+
+### Bittensor Python SDK
+- Installation: https://docs.bittensor.com/getting-started/installation
+- Wallet SDK Installation: https://docs.bittensor.com/getting-started/install-wallet-sdk
+- SDK Documentation:
+  - Async Subtensor: https://docs.bittensor.com/python-api/autoapi/bittensor/core/async_subtensor/index.html
+  - Subtensor: https://docs.bittensor.com/python-api/autoapi/bittensor/core/subtensor/index.html
+- Migration Guide: https://docs.bittensor.com/migration_guide
+- Subtensor Connections: https://docs.bittensor.com/sdk/managing-subtensor-connections
+
+## Security
+### Wallets and Keys
+- Wallet Basics: https://docs.bittensor.com/getting-started/wallets
+- Seed Phrase Security: https://docs.bittensor.com/keys/handle-seed-phrase
+- Coldkey/Hotkey Security: https://docs.bittensor.com/getting-started/coldkey-hotkey-security
+- Working with Keys: https://docs.bittensor.com/working-with-keys
+- Multisig Security: https://docs.bittensor.com/keys/multisig
+- Coldkey Rotation: https://docs.bittensor.com/subnets/schedule-coldkey-swap
+
+## Network Environments
+### Endpoints
+- Mainnet: wss://entrypoint-finney.opentensor.ai:443
+- Testnet: wss://test.finney.opentensor.ai:443
+- Devnet: wss://dev.chain.opentensor.ai:443
+
+## Advanced Topics
+### Local Development
+- Local Subtensor Deployment: https://docs.bittensor.com/local-build/deploy
+
+### Subtensor Nodes
+- Node Basics: https://docs.bittensor.com/subtensor-nodes/
+- Node Requirements: https://docs.bittensor.com/subtensor-nodes/subtensor-node-requirements
+- Source Installation: https://docs.bittensor.com/subtensor-nodes/using-source
+- Docker Installation: https://docs.bittensor.com/subtensor-nodes/using-docker
+- Rate Limits: https://docs.bittensor.com/subtensor-nodes/subtensor-rate-limits
+- Storage Queries: https://docs.bittensor.com/subtensor-nodes/subtensor-storage-query-examples
+- Error Messages: https://docs.bittensor.com/subtensor-nodes/subtensor-error-messages
+
+### EVM Integration
+- EVM on Bittensor Overview: https://docs.bittensor.com/evm-tutorials/
+- EVM on Subtensor: https://docs.bittensor.com/evm-tutorials/evm-on-subtensor
+- Installation: https://docs.bittensor.com/evm-tutorials/install
+- Setup:
+  - Hardhat Config: https://docs.bittensor.com/evm-tutorials/hardhat-config-for-subtensor-evm
+  - Testnet: https://docs.bittensor.com/evm-tutorials/evm-testnet-with-metamask-wallet
+  - Localnet: https://docs.bittensor.com/evm-tutorials/evm-localnet-with-metamask-wallet
+  - Mainnet: https://docs.bittensor.com/evm-tutorials/evm-mainnet-with-metamask-wallet
+- Precompiles:
+  - Metamask to SS58: https://docs.bittensor.com/evm-tutorials/transfer-from-metamask-to-ss58
+  - Between H160 Accounts: https://docs.bittensor.com/evm-tutorials/transfer-between-two-h160-accounts
+  - Staking Precompile: https://docs.bittensor.com/evm-tutorials/staking-precompile
+  - ED25519 Verify: https://docs.bittensor.com/evm-tutorials/ed25519-verify-precompile
+
+### Governance
+- Overview: https://docs.bittensor.com/governance
+- Senate: https://docs.bittensor.com/senate
+- Senator Guide: https://docs.bittensor.com/governance/senators-btcli-guide
+
+### Dynamic TAO
+- Guide: https://docs.bittensor.com/dynamic-tao/dtao-guide
+- SDK Cheat Sheet: https://docs.bittensor.com/dynamic-tao/sdk-cheat-sheet
+
+## Releases
+### Bittensor
+- PyPI: https://pypi.org/project/bittensor/
+- GitHub: https://github.com/opentensor/bittensor/releases
+
+### BTCLI
+- PyPI: https://pypi.org/project/bittensor-cli/
+- GitHub: https://github.com/opentensor/btcli/releases
+
+### Subtensor
+- GitHub: https://github.com/opentensor/subtensor/releases
+
+## Additional Resources
+- Glossary: https://docs.bittensor.com/glossary
+  
