Bittensor subnets are a great way to provide open APIs aimed at outsourcing certain computational workloads, whether it be model inference, distributed learning or other highly specific compute. However, a key ingredient to create extra valuable APIs is simply the leveraging of collaborative computation, rather than competitive computation. We believe that Bittensor will only be fully leveraged if subnets begin thinking more deeply about collaborative mining in tandem with the current approach. This is why we are building Apollo, and our first subnet will be a great example of the potential impact we can make; which is aimed at fruitfully combining compute power to achieve competitive results on the open market.
Our first objective - to create a publicly available, massively scalable, concretely competitive and extremely cost-effective zero-knowledge proof generation cluster, by leveraging the work of Pianist.
Our aim with this subnet is to provide a public API which can easily undercut costs of bespoke GPU cluster solutions, and to become the go-to solution for many blockchain protocols and applications that are live today which leverage the magic of zero-knowledge proofs.
pm2Very minimally, you will want to at least have:
Next, you will want to set up a coldkey and hotkey, if you are planning on mining or validating on the Apollo subnet.
btcli wallet new_coldkey --wallet.name <your_wallet_name>
btcli wallet new_hotkey --wallet.name <your_wallet_name> --wallet.hotkey <your_hotkey_name>Be sure to replace <your_wallet_name> and <your_hotkey_name> with names of your choosing.
Then, ensure you have the subnet code on your machine.
git clone https://github.com/apollozkp/zkp-subnet.git
cd zkp-subnetFinally, to start a miner, run:
make miner WALLET_NAME=<your_wallet_name> HOTKEY_NAME=<your_hotkey_name>where <your_wallet_name> is the name of your wallet, and <your_hotkey_name> is the name of your hotkey.
To start a validator, run:
make validator WALLET_NAME=<your_wallet_name> HOTKEY_NAME=<your_hotkey_name>where <your_wallet_name> is the name of your wallet, and <your_hotkey_name> is the name of your hotkey.
The command starts a pm2 process which ensures that the miner or validator will continue running, even if you log out of your server session. To check the logs, simply type:
pm2 logsto get a look at what's happening.
If a new update has been released, you may update your miner or validator by running
pm2 stop <miner/validator>choosing miner or validator depending on what you're running. Then, you can use
git pullto update the codebase. Finally, you can run the same make command as you did before to restart your miner or validator, and use pm2 logs to observe the output.
When registered and running, you can increase your stake to the subnet by running:
btcli stake add --wallet.name validator --wallet.hotkey defaultAny issues you may run into can be discussed in the Discord. Some common issues are:
I'm running into python errors while running the make command
Make sure you have permissions to run the make command. If you don't, you can run the command with sudo.
If you're still running into issues, please let us know in the Discord.
I'm not receiving requests
Syncing the metagraph can take up to 20 minutes. Please allow for some time before you start receiving requests.
If you are still not receiving requests, make sure that the necessary ports are open on your server.
The default ports for receiving requests is 8091.
To see which port the metagraph has you on, you can run:
btcli subnet metagraph --netuid NETUID --subtensor.network test/mainnetAnd look for the AXON field for your miner/validator.
It should look like <your_ip>:<your_port>.
Please see the contribution guidelines for details.
This repository is licensed under the MIT License.
The MIT License (MIT)
Copyright © 2024 Apollo
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
documentation files (the “Software”), to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software,
and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of
the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.The repository also contains code licensed by Yuma Rao under the MIT License.
The MIT License (MIT)
Copyright © 2023 Yuma Rao
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated
documentation files (the “Software”), to deal in the Software without restriction, including without limitation
the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software,
and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of
the Software.
THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO
THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
DEALINGS IN THE SOFTWARE.