run-manager automatic run selection

architectures/decentralized/justfile

@@ -25,16 +25,16 @@ setup-solana-localnet-light-test-run-treasurer run_id="test" *args='':
     RUN_ID={{ run_id }} CONFIG_FILE=./config/solana-test/light-config.toml PERMISSIONLESS=true ./scripts/setup-and-deploy-solana-test.sh --treasurer {{ args }}
 
 setup-solana-localnet-permissioned-test-run run_id="test" *args='':
-    RUN_ID={{ run_id }} ./scripts/deploy-solana-test.sh {{ args }}
+    RUN_ID={{ run_id }} ./scripts/setup-and-deploy-solana-test.sh {{ args }}
 
 setup-solana-localnet-permissioned-light-test-run run_id="test" *args='':
-    RUN_ID={{ run_id }} CONFIG_FILE=./config/solana-test/light-config.toml ./scripts/deploy-solana-test.sh {{ args }}
+    RUN_ID={{ run_id }} CONFIG_FILE=./config/solana-test/light-config.toml ./scripts/setup-and-deploy-solana-test.sh {{ args }}
 
 setup-solana-localnet-permissioned-test-run-treasurer run_id="test" *args='':
-    RUN_ID={{ run_id }} ./scripts/deploy-solana-test.sh --treasurer {{ args }}
+    RUN_ID={{ run_id }} ./scripts/setup-and-deploy-solana-test.sh --treasurer {{ args }}
 
 setup-solana-localnet-permissioned-light-test-run-treasurer run_id="test" *args='':
-    RUN_ID={{ run_id }} CONFIG_FILE=./config/solana-test/light-config.toml ./scripts/deploy-solana-test.sh --treasurer {{ args }}
+    RUN_ID={{ run_id }} CONFIG_FILE=./config/solana-test/light-config.toml ./scripts/setup-and-deploy-solana-test.sh --treasurer {{ args }}
 
 start-training-localnet-client run_id="test" *args='':
     AUTHORIZER={{ AUTHORIZER }} RUN_ID={{ run_id }} ./scripts/train-solana-test.sh {{ args }}

psyche-book/src/enduser/join-run.md

@@ -64,7 +64,8 @@ WALLET_PATH=/path/to/your/keypair.json
 RPC=https://your-primary-rpc-provider.com
 WS_RPC=wss://your-primary-rpc-provider.com
 
-# Required: Which run id to join
+# Optional: Which run id to join
+# If not set, the client will automatically discover and join an available run
 RUN_ID=your_run_id_here
 
 # Recommended: Fallback RPC Endpoints (for reliability)
@@ -78,6 +79,19 @@ Then, you can start training through the run manager running:
 ./run-manager --env-file /path/to/your/.env
 ```
 
+### Automatic Run Selection
+
+If you don't specify a `RUN_ID` in your `.env` file, the run-manager will automatically query the Solana coordinator to find a suitable run to join.
+This makes it easier to join training without needing to know the specific run ID in advance. The run-manager will display which run it selected in the logs:
+
+```
+INFO RUN_ID not set, discovering available runs...
+INFO Found 2 available run(s):
+INFO   - run_abc123 (state: Waiting for members)
+INFO   - run_def456 (state: Training)
+INFO Selected run: run_abc123 (state: Waiting for members)
+```
+
 After the initial setup, you'll see the Psyche client logs streaming in real-time. These logs show training progress, network status, and other important information.
 
 To stop the client, press `Ctrl+C` in the terminal.
@@ -86,9 +100,19 @@ To stop the client, press `Ctrl+C` in the terminal.
 
 We recommend using a dedicated RPC service such as [Helius](https://www.helius.dev/), [QuickNode](https://www.quicknode.com/), [Triton](https://triton.one/), or self-hosting your own Solana RPC node.
 
+## Filtering by Authorizer
+
+If you want to only join runs authorized by a specific entity, you can use the `--authorizer` flag:
+
+```bash
+./run-manager --env-file /path/to/your/.env --authorizer <AUTHORIZER_PUBKEY>
+```
+
+This is useful when you want to ensure you only join runs from a trusted coordinator.
+
 ## Additional config variables
 
-In general it's not neccesary to change these variables to join a run since we provide sensible defaults,
+In general it's not necessary to change these variables to join a run since we provide sensible defaults,
 though you might need to.
 
 **`NVIDIA_DRIVER_CAPABILITIES`** - An environment variable that the NVIDIA Container Toolkit uses to determine which compute capabilities should be provided to your container. It is recommended to set it to 'all', e.g. `NVIDIA_DRIVER_CAPABILITIES=all`.

scripts/setup-and-deploy-solana-test.sh

@@ -40,13 +40,19 @@ sleep 3
 
 solana airdrop 10 --url ${RPC} --keypair ${WALLET_FILE}
 
-# Pass treasurer flag to deploy script if set
-if [[ "$DEPLOY_TREASURER" == "true"  && "$PERMISSIONLESS" == "true" ]]; then
+
+if [[ "$DEPLOY_TREASURER" == "true" ]]; then
     WALLET_FILE=${WALLET_FILE} ./scripts/deploy-solana-test.sh --treasurer "${EXTRA_ARGS[@]}"
-    CONFIG_FILE=${CONFIG_FILE} WALLET_FILE=${WALLET_FILE} ./scripts/create-permissionless-run.sh --treasurer "${EXTRA_ARGS[@]}"
-elif [[ "$PERMISSIONLESS" == "true"  ]]; then
+else
     WALLET_FILE=${WALLET_FILE} ./scripts/deploy-solana-test.sh "${EXTRA_ARGS[@]}"
-    CONFIG_FILE=${CONFIG_FILE} WALLET_FILE=${WALLET_FILE} ./scripts/create-permissionless-run.sh "${EXTRA_ARGS[@]}"
+fi
+
+if [[ "$PERMISSIONLESS" == "true" ]]; then
+    if [[ "$DEPLOY_TREASURER" == "true" ]]; then
+        CONFIG_FILE=${CONFIG_FILE} WALLET_FILE=${WALLET_FILE} ./scripts/create-permissionless-run.sh --treasurer "${EXTRA_ARGS[@]}"
+    else
+        CONFIG_FILE=${CONFIG_FILE} WALLET_FILE=${WALLET_FILE} ./scripts/create-permissionless-run.sh "${EXTRA_ARGS[@]}"
+    fi
 fi
 echo -e "\n[+] Testing Solana setup ready, starting Solana logs...\n"
 

tools/rust-tools/run-manager/Cargo.toml

@@ -35,6 +35,7 @@ rand.workspace = true
 rand_chacha.workspace = true
 time.workspace = true
 solana-client = "=2.1.4"
+solana-account-decoder-client-types = "=2.1.4"
 
 [dev-dependencies]
 serial_test = "3.0"