Foundry is launching Foundry S&P 500 Oracle to incentivize miners to make predictions on the S&P 500 price frequently throughout trading hours. Validators send miners a timestamp (a future time), which the miners need to use to make predictions on the close price of the S&P 500 for the next six 5m intervals. Miners need to respond with their prediction for the price of the S&P 500 at the given time. Validators store the miner predictions, and then calculate the scores of the miners after the predictions mature. Miners are ranked against eachother, naturally incentivizing competition between the miners.
A Bittensor integration into financial markets will expose Bittensor to the largest system in the world; the global economy. The S&P 500 serves as a perfect starting place for financial predictions given its utility and name recognition. Financial market predictions were chosen for three main reasons:
- Utility: financial markets provide a massive userbase of professional traders, wealth managers, and individuals alike
- Objective Rewards Mechanism: by tying the rewards mechanism to an external source of truth (yahoo finance's S&P Price), the defensibility of the subnet regarding gamification is quite strong.
- Adversarial Environment: the adversarial environment, especially given the rewards mechanism, will allow for significant diversity of models. Miners will be driven to acquire different datasets, implement different training methods, and utilize different model architectures in order to develop the most performant models.
First, install PM2:
sudo apt update
sudo apt install nodejs npm
sudo npm install pm2@latest -g
Verify installation:
pm2 --version
| Validator | Miner |
|---|---|
| 8gb RAM | 8gb RAM |
| 2 vCPUs | 2 vCPUs |
Begin by creating and sourcing a python virtual environment:
python3 -m venv .sn28
source .sn28/bin/activate
Clone the Foundry S&P 500 Oracle repo:
git clone https://github.com/foundryservices/snpOracle.git
Install Requirements:
pip3 install -e snpOracle
ecosystem.config.js files have been created to make deployment of miners and validators easier for the node operator. These files are the default configuration files for PM2, and allow the user to define the environment & application in a cleaner way. IMPORTANT: Make sure your have activated your virtual environment before running your validator/miner. First copy the .env.template file to .env
cp .env.template .env
Update the .env file with your Huggingface access token. A huggingface access token can be procured from the huggingface platform. Follow the steps mentioned here to get your huggingface access token. If you're model weights are uploaded to a repository of your own or if you're reading a custom model weights file from huggingface, make sure to also make changes to the miner.config.js file's --hf_repo_id and --model args.
To run your miner:
pm2 start miner.config.js
The miner.config.js has few flags added. Any standard flags can be passed, for example, wallet name and hotkey name will default to "default"; if you have a different configuration, edit your "args" in miner.config.js. Below shows a miner.config.js with extra configuration flags.
- The hf_repo_id flag will be used to define which huggingface model repository the weights file needs to be downloaded from. You need not necessarily load your model weights from huggingface. If you would like to load weights from a local folder like
mining_models/, then store the weights in themining_models/folder and make sure to define the --hf_repo_id arg toLOCALlike--hf_repo_id LOCAL. - The model flag is used to reference a new model you save to the mining_models directory or to your huggingface hf_repo_id. The example below uses the default which is the new base lstm on Foundry's Huggingface repository.
module.exports = {
apps: [
{
name: 'miner',
script: 'python3',
args: './neurons/miner.py --netuid 28 --logging.debug --logging.trace --subtensor.network local --wallet.name walletName --wallet.hotkey hotkeyName --axon.port 8091 --hf_repo_id foundryservices/bittensor-sn28-base-lstm --model mining_models/base_lstm_new.h5'
},
],
};
ecosystem.config.js files have been created to make deployment of miners and validators easier for the node operator. These files are the default configuration files for PM2, and allow the user to define the environment & application in a cleaner way. IMPORTANT: Make sure your have activated your virtual environment before running your validator/miner.
Before starting the process, validators would be required to procure a WANDB API Key. Please follow the instructions mentioned below:
- Log in to Weights & Biases and generate an API key in your account settings.
- Copy the .env.template file's contents to a .env file -
cp .env.template .env - Set the variable WANDB_API_KEY in the .env file. You can leave the
HUGGINGFACE_ACCESS_TOKENvariable as is. Just make sure to update theWANDB_API_KEYvariable. - Finally, run
wandb loginand paste your API key. Now you're all set with weights & biases.
Once you've setup wandb, you can now run your validator by running the command below. Make sure to set your respective hotkey, coldkey, and other configuration variables accurately.
To run your validator:
pm2 start validator.config.js
The validator.config.js has few flags added. Any standard flags can be passed, for example, wallet name and hotkey name will default to "default"; if you have a different configuration, edit your "args" in validator.config.js. Below shows a validator.config.js with extra configuration flags.
module.exports = {
apps: [
{
name: 'validator',
script: 'python3',
args: './neurons/validator.py --netuid 28 --logging.debug --logging.trace --subtensor.network local --wallet.name walletName --wallet.hotkey hotkeyName'
},
],
};
As an alternative to using pm2, a docker image has been pushed to docker hub that can be used in accordance with docker-compose.yml, or the image can be built locally using the Dockerfile in this repo. To prepare the docker compose file, make the following changes to the compose script:
version: '3.7'
services:
my_container:
image: zrross11/snporacle:1.0.4
container_name: subnet28-<MINER OR VALIDATOR>
network_mode: host
volumes:
- /home/ubuntu/.bittensor:/root/.bittensor
restart: always
command: "python ./neurons/<MINER OR VALIDATOR>.py --wallet.name <YOUR WALLET NAME> --wallet.hotkey <YOUR WALLET HOTKEY> --netuid 28 --axon.port <YOUR AXON PORT> --subtensor.network local --subtensor.chain_endpoint 127.0.0.1:9944 --logging.debug"
Once this is ready, run docker compose up -d in the base directory
We implement a tiered ranking system to calculate miner rewards. For each prediction timepoint t, we sort miners into two buckets: one for miners with correct direction predictions and a second for miners with incorrect direction predictions. For any t, it is considered correctly predicting direction if, relative to the stock price just before the prediction was requested, the predicted price moves in the same direction as the actual stock price. This means that, for example, a prediction that was requested 10min ago, will use the S&P 500 stock price from 15min go to calculate directional accuracy. Once miner outputs are separated, we rank the miners within each bucket according to their
where
Once the miners have all been ranked, we convert these ranks to validator weights using:
The constant shown in this equation, −0.05, is a hyperparameter which controls the steepness of the curve (i.e. what proportion of the emissions are allocated to rank 1, 2, 3,... etc.). We chose this value to fairly distribute across miners to mitigate the effect of rank volatility. This ranking system ensures that machine learning or statistical models will inherently perform better than any method of gamification. By effectively performing a commit-reveal on a future S&P Price Prediction, S&P Oracle ensures that only well-tuned models will survive.
Foundry will constantly work to make this subnet more robust, with the north star of creating end-user utility in mind. Some key features we are focused on rolling out to improve the S&P 500 Oracle are listed here:
- Huggingface Integration
- Add Features to Rewards Mechanism
- Query all miners instead of a random subset
- Automate holiday detection and market close logic
- (Ongoing) Wandb Integration
- (Ongoing) Altering Synapse to hold short term history of predictions
- (Ongoing) Front end for end-user access
- Add new Synapse type for Inference Requests
We happily accept community feedback and features suggestions. Please reach out to @0xthebom on discord :-)
This repository is licensed under the MIT License.
# The MIT License (MIT)
# Copyright © 2024 Foundry Digital LLC
# 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.