Skip to main content

Miner Variables

Required

VariableDescription
PHYLAX_NETUIDSubnet UID. 486 on testnet.
SUBTENSOR_NETWORKtest or finney.
WALLET_NAMEWallet folder under ~/.bittensor/wallets/.
WALLET_HOTKEYHotkey under the wallet.
PHYLAX_SERVER_URLServer URL provided by the network operator.
PHYLAX_SUPPORTED_TYPESComma separated list of skill types the miner declares.
PHYLAX_SANDBOX_IMAGERegistry URI for the sandbox image.
PHYLAX_SANDBOX_DIGESTsha256:... digest of the sandbox image.

Optional

VariableDefaultDescription
PHYLAX_SERVER_HOTKEYemptyPinned server signing key. Strongly recommended.
PHYLAX_MINER_LABELhotkey ss58Friendly label for network dashboards.
PHYLAX_LLM_PROVIDERemptyLLM provider for llm_evidence. Only finding_enrichment, mitre_owasp_mapping, cve_explanation are allowed uses.
PHYLAX_LLM_MODELemptyLLM model ID.
PHYLAX_LLM_BASE_URLemptyOverride base URL (proxy support).
PHYLAX_LLM_API_KEYemptyAPI key for LLM provider.
PHYLAX_AXON_PORT8091Port the miner axon listens on.
PHYLAX_PIPELINE_WORKERS4Concurrent analyses.
PHYLAX_SANDBOX_TIMEOUT_S600Per task sandbox wall clock.

Set by install.sh

VariableDescription
HOST_UIDContainer runs as this UID.
HOST_GIDContainer runs as this GID.
DOCKER_GIDContainer joins this docker group to reach the socket.
PHYLAX_EVIDENCE_HOST_DIRHost absolute path of the evidence bind mount.

Validator Variables

Required

VariableDescription
PHYLAX_NETUID486 on testnet.
SUBTENSOR_NETWORKtest or finney.
WALLET_NAMEWallet folder.
WALLET_HOTKEYHotkey.
PHYLAX_SERVER_URLServer URL provided by the network operator.
VariableDefaultDescription
PHYLAX_SERVER_HOTKEYemptyPinned server signing key.
PHYLAX_VALIDATOR_LABELhotkey ss58Friendly label for network dashboards.

Tunable

VariableDefaultDescription
WEIGHT_UPDATE_INTERVAL360Blocks between set_weights pushes. One tempo on netuid 486; the chain rate-limit is 100 blocks so values below ~110 will return set_weights returned False: too soon to commit.
EMA_ALPHA0.2EMA blending factor.
QUERY_TIMEOUT150Dendrite call ceiling in seconds.
PHYLAX_RERUN_QUEUE_PATH~/.phylax/rerun_queue.sqlite3Persistent rerun queue location.
PHYLAX_COLLUSION_DB_PATH~/.phylax/collusion.sqlite3Persistent collusion sample DB.
PHYLAX_INFERENCE_PROXY_URLemptyForwarded to miners as inference_config.proxy_url.
PHYLAX_ALLOWED_MODELSemptyForwarded as allowed_models.
PHYLAX_COMPOSITION_DEPTH5Default composition_depth for agent_composition.

Set by install.sh

VariableDescription
HOST_UIDContainer UID.
HOST_GIDContainer GID.
DOCKER_GIDDocker group GID for socket access.
PHYLAX_EVIDENCE_HOST_DIRHost absolute path of evidence bind mount.

Notes

.env Reload

Editing .env does not reload running containers. Use docker compose up -d --force-recreate to pick up changes.

Wallet Mounting

The install.sh scripts bind mount ~/.bittensor/wallets/ into the container read only. Wallets created on the host are visible to the container without rebuilding.

Server Hotkey Pinning

PHYLAX_SERVER_HOTKEY is optional but strongly recommended. Without it, a rogue impostor with a valid TLS cert for PHYLAX_SERVER_URL could trick miners and validators into submitting to the wrong endpoint. Pinning the hotkey closes that gap. Obtain the value from the network operator when you receive your PHYLAX_SERVER_URL.

What’s Next

Protocol Reference

The wire types validators send to miners.

Miner Setup

Start a miner.

Validator Setup

Start a validator.

Scoring

Per axis formulas and emission detail.