{"openapi":"3.1.0","info":{"title":"FastAPI","version":"0.1.0"},"paths":{"/miner/initiate_file_upload":{"post":{"tags":["Miner"],"summary":" Initiate File Upload","operationId":"_initiate_file_upload_miner_initiate_file_upload_post","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/FileUploadResponse"},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Initiate File Upload Miner Initiate File Upload Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/complete_multipart_upload":{"post":{"tags":["Miner"],"summary":" Complete Multipart Upload","operationId":"_complete_multipart_upload_miner_complete_multipart_upload_post","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FileUploadCompletionRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/CompleteFileUploadResponse"},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Complete Multipart Upload Miner Complete Multipart Upload Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/register":{"post":{"tags":["Miner"],"summary":" Register Miner","operationId":"_register_miner_miner_register_post","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterMinerRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/MinerRegistrationResponse"},{"$ref":"#/components/schemas/MinerRegistrationQueueStatusResponse"},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Register Miner Miner Register Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/register/status/{queue_id}":{"get":{"tags":["Miner"],"summary":" Get Registration Status","operationId":"_get_registration_status_miner_register_status__queue_id__get","parameters":[{"name":"queue_id","in":"path","required":true,"schema":{"type":"string","title":"Queue Id"}},{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/MinerRegistrationResponse"},{"$ref":"#/components/schemas/MinerRegistrationQueueStatusResponse"},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Get Registration Status Miner Register Status  Queue Id  Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/register/confirm/{queue_id}":{"post":{"tags":["Miner"],"summary":" Confirm Registration","operationId":"_confirm_registration_miner_register_confirm__queue_id__post","parameters":[{"name":"queue_id","in":"path","required":true,"schema":{"type":"string","title":"Queue Id"}},{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterMinerConfirmationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/MinerRegistrationQueueStatusResponse"},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Confirm Registration Miner Register Confirm  Queue Id  Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/request_attestation_challenge":{"post":{"tags":["Miner"],"summary":" Request Attestation Challenge","operationId":"_request_attestation_challenge_miner_request_attestation_challenge_post","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/AttestationChallengeRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/RequestAttestationChallengeResponse"},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Request Attestation Challenge Miner Request Attestation Challenge Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/payout_coldkey":{"post":{"tags":["Miner"],"summary":" Change Payout Coldkey","operationId":"_change_payout_coldkey_miner_payout_coldkey_post","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PayoutColdkeyRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/get_activations":{"get":{"tags":["Miner"],"summary":" Get Activations","operationId":"_get_activations_miner_get_activations_get","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/GetActivationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/ActivationResponse"}},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Get Activations Miner Get Activations Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/submit_activation":{"post":{"tags":["Miner"],"summary":" Submit Activation","operationId":"_submit_activation_miner_submit_activation_post","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitActivationRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/submit_weights":{"post":{"tags":["Miner"],"summary":" Submit Weights","operationId":"_submit_weights_miner_submit_weights_post","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WeightUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/WeightSubmitResponse"},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Submit Weights Miner Submit Weights Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/submit_optimizer_state":{"post":{"tags":["Miner"],"summary":" Submit Optimizer State","description":"Update the optimizer state path for a miner who was told to upload their optimizer state.\nThis should only be called by miners who received should_upload_optimizer_state=True\nfrom the submit_weights endpoint.","operationId":"_submit_optimizer_state_miner_submit_optimizer_state_post","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OptimizerStateUpdate"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Submit Optimizer State Miner Submit Optimizer State Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/get_layer_optimizer_state":{"get":{"tags":["Miner"],"summary":" Get Layer Optimizer State","description":"Get the layer optimizer state presigned URL for the miner's current layer.\nThis is used by new miners joining a layer to download the optimizer state\nfrom one of the first miners who submitted weights.","operationId":"_get_layer_optimizer_state_miner_get_layer_optimizer_state_get","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/LayerOptimizerStateResponse"},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Get Layer Optimizer State Miner Get Layer Optimizer State Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/submit_merged_partitions":{"post":{"tags":["Miner"],"summary":" Submit Merged Partitions","operationId":"_submit_merged_partitions_miner_submit_merged_partitions_post","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SubmitMergedPartitionsRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/get_previous_partitions":{"get":{"tags":["Miner"],"summary":" Get Previous Partitions","operationId":"_get_previous_partitions_miner_get_previous_partitions_get","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"type":"integer"}},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Partition Indices"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/MinerPartition"}},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Get Previous Partitions Miner Get Previous Partitions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/get_partitions":{"get":{"tags":["Miner"],"summary":" Fetch Partitions","operationId":"_fetch_partitions_miner_get_partitions_get","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/MinerPartition"}},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Fetch Partitions Miner Get Partitions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/get_weight_path_per_layer":{"get":{"tags":["Miner"],"summary":" Fetch Weight Path Per Layer","operationId":"_fetch_weight_path_per_layer_miner_get_weight_path_per_layer_get","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/SubmittedWeightsAndOptimizerPresigned"}},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Fetch Weight Path Per Layer Miner Get Weight Path Per Layer Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/heartbeat":{"get":{"tags":["Miner"],"summary":" Heartbeat","operationId":"_heartbeat_miner_heartbeat_get","parameters":[{"name":"expected_phase","in":"query","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Phase"}},{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/HeartbeatResponse"},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Heartbeat Miner Heartbeat Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/layer_state":{"get":{"tags":["Miner"],"summary":" Get Miner Layer State","operationId":"_get_miner_layer_state_miner_layer_state_get","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/all_layers_training":{"get":{"tags":["Miner"],"summary":" Get All Layers Training","description":"Return True iff every layer in this miner's run is currently in TRAINING.\n\nMiners call this before polling for activations so they don't ask the\norchestrator (or process pushed activations) while any layer is still in\nWEIGHTS_UPLOADING or MERGING_PARTITIONS. The underlying DB query is cached\nin Redis.","operationId":"_get_all_layers_training_miner_all_layers_training_get","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"boolean"},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Get All Layers Training Miner All Layers Training Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/notify_orchestrator_of_state_call":{"get":{"tags":["Miner"],"summary":" Notify Orchestrator Of State Call","operationId":"_notify_orchestrator_of_state_call_miner_notify_orchestrator_of_state_call_get","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/report_loss":{"post":{"tags":["Miner"],"summary":" Report Loss","operationId":"_report_loss_miner_report_loss_post","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LossReportRequest"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"object","additionalProperties":true},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Report Loss Miner Report Loss Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/miner/fleet-telemetry":{"post":{"tags":["Miner"],"summary":" Fleet Telemetry","description":"Receive batched telemetry from a miner.\n\nSECURITY: miner_hotkey is overridden from the authenticated identity.","operationId":"_fleet_telemetry_miner_fleet_telemetry_post","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetTelemetryPayload"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FleetTelemetryResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/validator/register":{"post":{"tags":["Validator"],"summary":" Register Validator","operationId":"_register_validator_validator_register_post","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ValidatorRegistrationResponse"},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Register Validator Validator Register Post"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/validator/global_miner_scores":{"get":{"tags":["Validator"],"summary":" Get Global Miner Scores","operationId":"_get_global_miner_scores_validator_global_miner_scores_get","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/SubnetScores"},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Get Global Miner Scores Validator Global Miner Scores Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/validator/fetch_task":{"get":{"tags":["Validator"],"summary":" Fetch Task","operationId":"_fetch_task_validator_fetch_task_get","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/ValidatorTask"},{"$ref":"#/components/schemas/BaseErrorModel"},{"type":"null"}],"title":"Response  Fetch Task Validator Fetch Task Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/validator/submit_task_result":{"post":{"tags":["Validator"],"summary":" Submit Task Result","operationId":"_submit_task_result_validator_submit_task_result_post","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidationTaskResponse"}}}},"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/validator/get_validator_code":{"get":{"tags":["Validator"],"summary":"Get Validator Code","operationId":"get_validator_code_validator_get_validator_code_get","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/healthcheck":{"get":{"tags":["System"],"summary":" Healthcheck","operationId":"_healthcheck_healthcheck_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/profiler/status":{"get":{"tags":["System"],"summary":"Profiler Status","description":"Get the current status of the profiler. No authentication required.","operationId":"profiler_status_profiler_status_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}},"/profiler/start":{"post":{"tags":["System"],"summary":"Start Profiler","description":"Start the global pyinstrument profiler. Requires valid API key.","operationId":"start_profiler_profiler_start_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/profiler/stop":{"post":{"tags":["System"],"summary":"Stop Profiler","description":"Stop the profiler and upload HTML report to S3. Returns presigned download URL. Requires valid API key.","operationId":"stop_profiler_profiler_stop_post","parameters":[{"name":"X-API-Key","in":"header","required":false,"schema":{"type":"string","title":"X-Api-Key"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/common/get_merged_partitions":{"get":{"tags":["Common"],"summary":" Get Merged Partitions","operationId":"_get_merged_partitions_common_get_merged_partitions_get","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"anyOf":[{"type":"array","items":{"$ref":"#/components/schemas/MinerPartition"}},{"$ref":"#/components/schemas/BaseErrorModel"}],"title":"Response  Get Merged Partitions Common Get Merged Partitions Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/common/get_run_info":{"get":{"tags":["Common"],"summary":" Get Run Info","operationId":"_get_run_info_common_get_run_info_get","parameters":[{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/RunInfo"},"title":"Response  Get Run Info Common Get Run Info Get"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/common/get_run_epoch":{"get":{"tags":["Common"],"summary":" Get Run Epoch","description":"Return the authoritative current epoch for ``run_id``.\n\nThe miner uses this as the source of truth for \"what epoch am I in?\" so\nit doesn't need to maintain its own counter that can drift from the\norchestrator across resets, kicks, and skipped epochs. Layers in a run\nadvance their epoch independently but stay near-lockstep in healthy\noperation; we return MAX(layer_state.epoch) across the run so a miner\nthat queries while its own layer is between phases still sees forward\nprogress.\n\nAuth is the same hotkey-rate-limited bucket as the other /common\nendpoints — the request must be signed by some registered hotkey, but\nis not scoped to the miner's specific run/layer (so it works before\nregistration, which is when the genesis-epoch gate needs it most).","operationId":"_get_run_epoch_common_get_run_epoch_get","parameters":[{"name":"run_id","in":"query","required":true,"schema":{"type":"string","title":"Run Id"}},{"name":"Epistula-Timestamp","in":"header","required":false,"schema":{"type":"string","default":"1782739048","title":"Epistula-Timestamp"}},{"name":"Epistula-Signed-By","in":"header","required":false,"schema":{"type":"string","default":"sample_hotkey","title":"Epistula-Signed-By"}},{"name":"Epistula-Request-Signature","in":"header","required":false,"schema":{"type":"string","default":"sample_signature","title":"Epistula-Request-Signature"}},{"name":"X-Request-Id","in":"header","required":false,"schema":{"type":"string","default":"no-request-id","title":"X-Request-Id"}},{"name":"X-Spec-Version","in":"header","required":false,"schema":{"type":"string","default":"30017","title":"X-Spec-Version"}},{"name":"X-Is-Mounted","in":"header","required":false,"schema":{"type":"boolean","default":false,"title":"X-Is-Mounted"}},{"name":"X-Host-Version","in":"header","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Host-Version"}}],"responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{"$ref":"#/components/schemas/RunEpochResponse"}}}},"422":{"description":"Validation Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}}}}},"/metrics":{"get":{"summary":"Metrics","description":"Endpoint that serves Prometheus metrics.","operationId":"metrics_metrics_get","responses":{"200":{"description":"Successful Response","content":{"application/json":{"schema":{}}}}}}}},"components":{"schemas":{"ActivationMetadata":{"properties":{"max_activation_cache_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Activation Cache Size"},"n_backwards_for_cache_increase_stop":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N Backwards For Cache Increase Stop"},"max_forward_activations_in_queue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Max Forward Activations In Queue"},"min_forward_activations_in_queue":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Min Forward Activations In Queue"}},"type":"object","title":"ActivationMetadata"},"ActivationResponse":{"properties":{"activation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activation Id"},"direction":{"anyOf":[{"type":"string","enum":["forward","backward"]},{"type":"null"}],"title":"Direction"},"upload_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upload Id"},"presigned_download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Presigned Download Url"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"presigned_upload_url":{"anyOf":[{"items":{"type":"string"},"type":"array"},{"type":"null"}],"title":"Presigned Upload Url"},"activation_upload_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activation Upload Path"},"target_download_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Target Download Url"},"source_node_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Node Id"},"source_activation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Source Activation Id"},"expected_input_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Expected Input Hash"}},"type":"object","title":"ActivationResponse"},"AttestationChallengeRequest":{"properties":{"action":{"type":"string","enum":["registration","weights","merged_partitions","submit_activation"],"title":"Action"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Id"}},"type":"object","required":["action"],"title":"AttestationChallengeRequest"},"BaseErrorModel":{"properties":{"error_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Name"},"error_dict":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error Dict"}},"type":"object","title":"BaseErrorModel"},"CompleteFileUploadResponse":{"properties":{"object_path":{"type":"string","title":"Object Path"}},"type":"object","required":["object_path"],"title":"CompleteFileUploadResponse"},"DatasetMetadata":{"properties":{"dataset_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dataset Name"},"shuffle_dataset":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Shuffle Dataset"},"sequence_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Sequence Length"},"mini_batch_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Mini Batch Size"}},"type":"object","title":"DatasetMetadata"},"EnclaveGetKeyIdResponse":{"properties":{"key_id":{"type":"string","title":"Key Id"},"public_key_base64":{"type":"string","title":"Public Key Base64"},"alg":{"type":"string","const":"ES256","title":"Alg"}},"type":"object","required":["key_id","public_key_base64","alg"],"title":"EnclaveGetKeyIdResponse"},"EnclaveSignResponse":{"properties":{"key_id":{"type":"string","title":"Key Id"},"signature_der_base64":{"type":"string","title":"Signature Der Base64"},"alg":{"type":"string","const":"ES256","title":"Alg"},"challenge_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Challenge Id"},"public_key_base64":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Public Key Base64"}},"type":"object","required":["key_id","signature_der_base64","alg"],"title":"EnclaveSignResponse"},"FileUploadCompletionRequest":{"properties":{"object_name":{"type":"string","title":"Object Name"},"upload_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upload Id"},"parts":{"anyOf":[{"items":{"additionalProperties":true,"type":"object"},"type":"array"},{"type":"null"}],"title":"Parts"}},"type":"object","required":["object_name"],"title":"FileUploadCompletionRequest"},"FileUploadRequest":{"properties":{"num_parts":{"type":"integer","title":"Num Parts"},"file_type":{"type":"string","enum":["weights","optimizer_state","activation","partition"],"title":"File Type"},"multipart":{"type":"boolean","title":"Multipart","default":true}},"type":"object","required":["num_parts","file_type"],"title":"FileUploadRequest"},"FileUploadResponse":{"properties":{"object_name":{"type":"string","title":"Object Name"},"urls":{"items":{"type":"string"},"type":"array","title":"Urls"},"upload_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Upload Id"}},"type":"object","required":["object_name","urls"],"title":"FileUploadResponse"},"FleetTelemetryPayload":{"properties":{"training_metrics":{"items":{"$ref":"#/components/schemas/TrainingMetric"},"type":"array","title":"Training Metrics","default":[]},"lifecycle_events":{"items":{"$ref":"#/components/schemas/LifecycleEvent"},"type":"array","title":"Lifecycle Events","default":[]},"prometheus_snapshots":{"items":{"$ref":"#/components/schemas/PrometheusMetricSnapshot"},"type":"array","title":"Prometheus Snapshots","default":[]},"hotkey_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Hotkey Name"}},"type":"object","title":"FleetTelemetryPayload","description":"Typed batched telemetry payload from miner to orchestrator."},"FleetTelemetryResponse":{"properties":{"accepted_snowpipe":{"type":"integer","title":"Accepted Snowpipe","default":0},"accepted_prometheus":{"type":"integer","title":"Accepted Prometheus","default":0},"errors":{"items":{"type":"string"},"type":"array","title":"Errors","default":[]}},"type":"object","title":"FleetTelemetryResponse","description":"Acknowledgement from orchestrator."},"GetActivationRequest":{"properties":{"n_fwd_activations":{"type":"integer","title":"N Fwd Activations","default":1}},"type":"object","title":"GetActivationRequest"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"HeartbeatResponse":{"properties":{"run_id":{"type":"string","title":"Run Id"},"layer":{"type":"integer","title":"Layer"},"epoch":{"type":"integer","title":"Epoch"},"phase":{"type":"string","title":"Phase"}},"type":"object","required":["run_id","layer","epoch","phase"],"title":"HeartbeatResponse"},"LayerOptimizerStateResponse":{"properties":{"optimizer_state_url":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Optimizer State Url"},"available":{"type":"boolean","title":"Available","default":false}},"type":"object","title":"LayerOptimizerStateResponse","description":"Response containing the presigned URL for layer-based optimizer state download."},"LearningRateMetadata":{"properties":{"warmup_start_factor":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Warmup Start Factor"},"warmup_steps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Warmup Steps"},"const_steps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Const Steps"},"tail_steps_frac":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Tail Steps Frac"},"final_factor":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Final Factor"},"saw_cycle_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Saw Cycle Length"}},"type":"object","title":"LearningRateMetadata"},"LifecycleEvent":{"properties":{"type":{"type":"string","title":"Type"},"message_id":{"type":"string","title":"Message Id"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"source_service":{"type":"string","title":"Source Service"},"git_sha":{"type":"string","title":"Git Sha","default":"25eba66"},"miner_hotkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Miner Hotkey"},"miner_coldkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Miner Coldkey"},"correlation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Correlation Id"},"activation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activation Id"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Id"},"epoch":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Epoch"},"layer_idx":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Layer Idx"},"received_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Received At"},"event_category":{"type":"string","title":"Event Category"},"old_state":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Old State"},"new_state":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"New State"},"reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason"},"details":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Details"}},"type":"object","required":["type","source_service","event_category"],"title":"LifecycleEvent","description":"Wide-table message for lifecycle events and state transitions.\n\nCallers set ``type`` to categorize the event (e.g. ``\"miner_status_change\"``,\n``\"phase_transition\"``, ``\"run_state_change\"``, ``\"phase_snapshot\"``).\n\nExample::\n\n    LifecycleEvent(\n        type=\"miner_status_change\", source_service=\"scheduler\",\n        event_category=\"miner\", miner_hotkey=\"5F...\",\n        old_state={\"status\": \"idle\"}, new_state={\"status\": \"frozen\"},\n        reason=\"No activations in 3 epochs\",\n    )"},"LossReportRequest":{"properties":{"activation_id":{"type":"string","title":"Activation Id"},"loss":{"type":"number","title":"Loss"},"layer_idx":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Layer Idx"}},"type":"object","required":["activation_id","loss"],"title":"LossReportRequest"},"MinerAttestationPayload":{"properties":{"payload_blob":{"type":"string","title":"Payload Blob"},"runtime":{"anyOf":[{"$ref":"#/components/schemas/MinerAttestationRuntime"},{"type":"null"}]},"encrypted_attestation":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Encrypted Attestation"}},"type":"object","required":["payload_blob"],"title":"MinerAttestationPayload"},"MinerAttestationRuntime":{"properties":{"duration_ms":{"type":"number","title":"Duration Ms"},"delay_suspect":{"type":"boolean","title":"Delay Suspect"}},"type":"object","required":["duration_ms","delay_suspect"],"title":"MinerAttestationRuntime"},"MinerPartition":{"properties":{"layer":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Layer"},"chunk_number":{"anyOf":[{"type":"integer"},{"type":"string","const":"all"}],"title":"Chunk Number"},"miner_hotkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Miner Hotkey"},"blob_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Blob Path"},"other_miner_hotkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Other Miner Hotkey"}},"type":"object","title":"MinerPartition"},"MinerRegistrationQueueStatusResponse":{"properties":{"queue_id":{"type":"string","title":"Queue Id"},"status":{"type":"string","enum":["queued","confirming","confirmed","processing","succeeded","failed","expired"],"title":"Status"},"position":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Position"},"poll_after_seconds":{"type":"number","title":"Poll After Seconds","default":5.0},"confirmation_required":{"type":"boolean","title":"Confirmation Required","default":false},"selected_run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Selected Run Id"},"reserved_until":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reserved Until"},"payload_mismatch":{"type":"boolean","title":"Payload Mismatch","default":false},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"response":{"anyOf":[{"$ref":"#/components/schemas/MinerRegistrationResponse"},{"type":"null"}]},"error":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Error"}},"type":"object","required":["queue_id","status"],"title":"MinerRegistrationQueueStatusResponse"},"MinerRegistrationResponse":{"properties":{"layer":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Layer"},"current_epoch":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Current Epoch"},"model_cfg":{"anyOf":[{"$ref":"#/components/schemas/ModelConfig"},{"type":"null"}]},"model_metadata":{"anyOf":[{"$ref":"#/components/schemas/ModelMetadata"},{"type":"null"}]},"run_id":{"type":"string","title":"Run Id"},"run_flags":{"$ref":"#/components/schemas/RunFlags"},"num_partitions":{"type":"integer","title":"Num Partitions"}},"type":"object","required":["run_id","run_flags","num_partitions"],"title":"MinerRegistrationResponse"},"MinerScore":{"properties":{"uid":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Uid"},"hotkey":{"type":"string","title":"Hotkey"},"coldkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coldkey"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Id"},"raw_score":{"type":"number","title":"Raw Score"},"total_score":{"type":"number","title":"Total Score"},"run_weight":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Run Weight"},"weight":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Weight"}},"type":"object","required":["hotkey","raw_score","total_score"],"title":"MinerScore","description":"Miner's incentive details"},"ModelConfig":{"properties":{"model_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Name"},"total_global_params":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Global Params"},"vocab_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Vocab Size"},"context_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Context Length"},"orig_context_length":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Orig Context Length"},"emb_dim":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Emb Dim"},"bottleneck_dim":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Bottleneck Dim"},"quantize_activations":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Quantize Activations"},"quantize_activations_grads":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Quantize Activations Grads"},"quantize_weights":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Quantize Weights"},"n_heads":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N Heads"},"n_layers":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N Layers"},"hidden_dim":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Hidden Dim"},"n_kv_groups":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N Kv Groups"},"rope_base":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Rope Base"},"dtype":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Dtype"},"rope_freq":{"anyOf":[{"additionalProperties":{"type":"number"},"type":"object"},{"type":"null"}],"title":"Rope Freq"},"s3_download_timeout":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"S3 Download Timeout"},"s3_upload_timeout":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"S3 Upload Timeout"},"activation_timeout":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Activation Timeout"}},"type":"object","title":"ModelConfig"},"ModelMetadata":{"properties":{"model_splits":{"anyOf":[{"items":{"items":{"type":"integer"},"type":"array"},"type":"array"},{"type":"null"}],"title":"Model Splits"},"model_size":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Model Size"},"n_splits":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"N Splits"},"tokenizer_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tokenizer Name"},"effective_batch_size":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Effective Batch Size"},"mini_batch_accumulation_count":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Mini Batch Accumulation Count"},"grad_clip_norm":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Grad Clip Norm"},"total_train_steps":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Total Train Steps"},"lr":{"anyOf":[{"$ref":"#/components/schemas/LearningRateMetadata"},{"type":"null"}]},"opt":{"anyOf":[{"$ref":"#/components/schemas/OptimizerMetadata"},{"type":"null"}]},"dataset":{"anyOf":[{"$ref":"#/components/schemas/DatasetMetadata"},{"type":"null"}]},"activation":{"anyOf":[{"$ref":"#/components/schemas/ActivationMetadata"},{"type":"null"}]},"miners_per_layer":{"anyOf":[{"items":{"type":"integer"},"type":"array"},{"type":"null"}],"title":"Miners Per Layer"}},"type":"object","title":"ModelMetadata"},"MountedAttestationPayload":{"properties":{"schema_version":{"type":"integer","title":"Schema Version"},"key_id":{"type":"string","title":"Key Id"},"public_key_base64":{"type":"string","title":"Public Key Base64"},"payload_base64":{"type":"string","title":"Payload Base64"},"signature_der_base64":{"type":"string","title":"Signature Der Base64"},"payload_sha256_base64":{"type":"string","title":"Payload Sha256 Base64"},"alg":{"type":"string","const":"ES256","title":"Alg"},"challenge_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Challenge Id"}},"type":"object","required":["schema_version","key_id","public_key_base64","payload_base64","signature_der_base64","payload_sha256_base64","alg"],"title":"MountedAttestationPayload"},"NodeLocation":{"properties":{"ip":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Ip"},"country":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"region":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Region"},"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"latitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Longitude"},"timezone":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Timezone"},"isp":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Isp"},"org":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Org"}},"type":"object","title":"NodeLocation","description":"Geographic location of a node, resolved from its public IP address.\n\nPopulated at miner startup via IP geolocation (ip-api.com / ipinfo.io).\nAll fields are optional to ensure backward compatibility — if geolocation\nfails, the miner still registers successfully; location is simply absent."},"OptimizerMetadata":{"properties":{"learning_rate":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Learning Rate"},"weight_decay":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Weight Decay"},"betas":{"anyOf":[{"items":{"type":"number"},"type":"array"},{"type":"null"}],"title":"Betas"},"eps":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Eps"}},"type":"object","title":"OptimizerMetadata"},"OptimizerStateUpdate":{"properties":{"optimizer_state_path":{"type":"string","title":"Optimizer State Path"}},"type":"object","required":["optimizer_state_path"],"title":"OptimizerStateUpdate","description":"Request to update optimizer state path after weight submission."},"PayoutColdkeyRequest":{"properties":{"payout_coldkey":{"type":"string","title":"Payout Coldkey"}},"type":"object","required":["payout_coldkey"],"title":"PayoutColdkeyRequest"},"PrometheusMetricSnapshot":{"properties":{"name":{"type":"string","title":"Name"},"type":{"type":"string","title":"Type"},"labels":{"additionalProperties":{"type":"string"},"type":"object","title":"Labels","default":{}},"value":{"type":"number","title":"Value"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"}},"type":"object","required":["name","type","value","timestamp"],"title":"PrometheusMetricSnapshot","description":"A single metric sample from a miner's prometheus registry."},"RegisterMinerConfirmationRequest":{"properties":{"attestation":{"anyOf":[{"$ref":"#/components/schemas/MinerAttestationPayload"},{"$ref":"#/components/schemas/MountedAttestationPayload"},{"$ref":"#/components/schemas/EnclaveSignResponse"},{"type":"null"}],"title":"Attestation"},"enclave_payload":{"anyOf":[{"$ref":"#/components/schemas/EnclaveGetKeyIdResponse"},{"type":"null"}]}},"type":"object","title":"RegisterMinerConfirmationRequest"},"RegisterMinerRequest":{"properties":{"attestation":{"anyOf":[{"$ref":"#/components/schemas/MinerAttestationPayload"},{"$ref":"#/components/schemas/MountedAttestationPayload"},{"$ref":"#/components/schemas/EnclaveSignResponse"},{"type":"null"}],"title":"Attestation"},"coldkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Coldkey"},"register_as_metagraph_miner":{"type":"boolean","title":"Register As Metagraph Miner","default":true},"enclave_payload":{"anyOf":[{"$ref":"#/components/schemas/EnclaveGetKeyIdResponse"},{"type":"null"}]},"p2p_node_id":{"type":"string","title":"P2P Node Id"},"system_data":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"System Data"},"location":{"anyOf":[{"$ref":"#/components/schemas/NodeLocation"},{"type":"null"}]}},"type":"object","required":["p2p_node_id"],"title":"RegisterMinerRequest"},"RequestAttestationChallengeResponse":{"properties":{"action":{"type":"string","enum":["registration","weights","merged_partitions","submit_activation"],"title":"Action"},"attestation_challenge_blob":{"type":"string","title":"Attestation Challenge Blob"},"self_checks":{"items":{"type":"string"},"type":"array","title":"Self Checks"},"crypto":{"type":"string","title":"Crypto"},"expires_at":{"type":"number","title":"Expires At"}},"type":"object","required":["action","attestation_challenge_blob","self_checks","crypto","expires_at"],"title":"RequestAttestationChallengeResponse"},"RunEpochResponse":{"properties":{"run_id":{"type":"string","title":"Run Id"},"epoch":{"type":"integer","title":"Epoch"}},"type":"object","required":["run_id","epoch"],"title":"RunEpochResponse","description":"Authoritative current epoch for a run, served by /common/get_run_epoch.\n\nLayers within a run advance their epoch independently but stay\nnear-lockstep in healthy operation; the orchestrator reports the maximum\nepoch across the run's layers as the \"current\" epoch so a miner that\nqueries before its own layer has ticked still sees forward progress."},"RunFlag":{"properties":{"enabled":{"type":"boolean","title":"Enabled","default":false},"version":{"type":"number","title":"Version","default":1.0}},"type":"object","title":"RunFlag"},"RunFlags":{"properties":{"test_flag":{"$ref":"#/components/schemas/RunFlag","default":{"enabled":false,"version":1.0}},"compress_s3_files":{"$ref":"#/components/schemas/RunFlag","default":{"enabled":false,"version":1.0}},"attest":{"$ref":"#/components/schemas/RunFlag","default":{"enabled":false,"version":1.0}},"keep_cache_on_local_step":{"$ref":"#/components/schemas/RunFlag","default":{"enabled":false,"version":1.0}},"upload_optimizer_state":{"$ref":"#/components/schemas/RunFlag","default":{"enabled":false,"version":1.0}},"enforce_min_local_optimizer_steps":{"$ref":"#/components/schemas/RunFlag","default":{"enabled":false,"version":1.0}},"weighted_partition_averaging":{"$ref":"#/components/schemas/RunFlag","default":{"enabled":true,"version":1.0}},"clip_pseudo_gradients":{"$ref":"#/components/schemas/RunFlag","default":{"enabled":false,"version":1.0}},"use_AdamW":{"$ref":"#/components/schemas/RunFlag","default":{"enabled":false,"version":1.0}},"peer_eviction":{"$ref":"#/components/schemas/RunFlag","default":{"enabled":false,"version":1.0}},"auto_max_cache":{"$ref":"#/components/schemas/RunFlag","default":{"enabled":false,"version":1.0}},"sync_patches":{"$ref":"#/components/schemas/RunFlag","default":{"enabled":true,"version":1.0}}},"type":"object","title":"RunFlags"},"RunIncentiveAllocation":{"properties":{"run_id":{"type":"string","title":"Run Id"},"incentive_weight":{"type":"number","title":"Incentive Weight"},"burn_factor":{"type":"number","title":"Burn Factor"}},"type":"object","required":["run_id","incentive_weight","burn_factor"],"title":"RunIncentiveAllocation","description":"Run incentive allocation details"},"RunInfo":{"properties":{"run_id":{"type":"string","title":"Run Id"},"is_default":{"type":"boolean","title":"Is Default"},"num_miners":{"type":"integer","title":"Num Miners"},"whitelisted":{"type":"boolean","title":"Whitelisted"},"is_miner_pool":{"type":"boolean","title":"Is Miner Pool"},"burn_factor":{"type":"number","title":"Burn Factor"},"incentive_perc":{"type":"number","title":"Incentive Perc"},"authorized":{"type":"boolean","title":"Authorized"},"run_flags":{"$ref":"#/components/schemas/RunFlags"},"max_miners":{"type":"integer","title":"Max Miners"},"whitelist_force_allow":{"type":"boolean","title":"Whitelist Force Allow","default":false}},"type":"object","required":["run_id","is_default","num_miners","whitelisted","is_miner_pool","burn_factor","incentive_perc","authorized","run_flags","max_miners"],"title":"RunInfo"},"SubmitActivationRequest":{"properties":{"direction":{"type":"string","enum":["forward","backward"],"title":"Direction"},"activation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activation Id"},"activation_path":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activation Path"},"activation_stats":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Activation Stats"},"attestation":{"anyOf":[{"$ref":"#/components/schemas/MinerAttestationPayload"},{"$ref":"#/components/schemas/MountedAttestationPayload"},{"$ref":"#/components/schemas/EnclaveSignResponse"},{"type":"null"}],"title":"Attestation"},"input_activation_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Input Activation Hash"},"output_activation_hash":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Output Activation Hash"}},"type":"object","required":["direction"],"title":"SubmitActivationRequest"},"SubmitMergedPartitionsRequest":{"properties":{"partitions":{"items":{"$ref":"#/components/schemas/MinerPartition"},"type":"array","title":"Partitions"},"attestation":{"anyOf":[{"$ref":"#/components/schemas/MinerAttestationPayload"},{"$ref":"#/components/schemas/MountedAttestationPayload"},{"$ref":"#/components/schemas/EnclaveSignResponse"},{"type":"null"}],"title":"Attestation"}},"type":"object","required":["partitions"],"title":"SubmitMergedPartitionsRequest"},"SubmittedWeightsAndOptimizerPresigned":{"properties":{"layer":{"type":"integer","title":"Layer"},"weights_path_presigned":{"type":"string","title":"Weights Path Presigned"},"weighting_factor":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Weighting Factor"}},"type":"object","required":["layer","weights_path_presigned"],"title":"SubmittedWeightsAndOptimizerPresigned"},"SubnetScores":{"properties":{"miner_scores":{"items":{"$ref":"#/components/schemas/MinerScore"},"type":"array","title":"Miner Scores"},"runs":{"items":{"$ref":"#/components/schemas/RunIncentiveAllocation"},"type":"array","title":"Runs"},"burn_factor":{"type":"number","title":"Burn Factor"}},"type":"object","required":["miner_scores","runs","burn_factor"],"title":"SubnetScores","description":"Details about a subnet's scores (weights)"},"TrainingMetric":{"properties":{"type":{"type":"string","title":"Type"},"message_id":{"type":"string","title":"Message Id"},"timestamp":{"type":"string","format":"date-time","title":"Timestamp"},"source_service":{"type":"string","title":"Source Service"},"git_sha":{"type":"string","title":"Git Sha","default":"25eba66"},"miner_hotkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Miner Hotkey"},"miner_coldkey":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Miner Coldkey"},"correlation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Correlation Id"},"activation_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Activation Id"},"run_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Run Id"},"epoch":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Epoch"},"layer_idx":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Layer Idx"},"received_at":{"anyOf":[{"type":"string","format":"date-time"},{"type":"null"}],"title":"Received At"},"metric_name":{"type":"string","title":"Metric Name"},"metric_value":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Metric Value"},"details":{"anyOf":[{"additionalProperties":true,"type":"object"},{"type":"null"}],"title":"Details"}},"type":"object","required":["type","source_service","metric_name"],"title":"TrainingMetric","description":"Wide-table message for numeric training metrics (wandb.log equivalent).\n\nCallers set ``type`` to categorize the metric (e.g. ``\"loss_report\"``,\n``\"epoch_loss_summary\"``, ``\"miner_score\"``, ``\"activation_count\"``).\n\nExample::\n\n    TrainingMetric(\n        type=\"miner_score\", source_service=\"scheduler\",\n        run_id=\"run-abc\", epoch=5, miner_hotkey=\"5F...\",\n        metric_name=\"score\", metric_value={\"value\": 0.85},\n    )"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"ValidationTaskResponse":{"properties":{"task_result_id":{"type":"integer","title":"Task Result Id"},"task_type":{"type":"string","title":"Task Type"},"function_name":{"type":"string","title":"Function Name"},"inputs":{"additionalProperties":true,"type":"object","title":"Inputs"},"outputs":{"additionalProperties":true,"type":"object","title":"Outputs"}},"type":"object","required":["task_result_id","task_type","function_name","inputs","outputs"],"title":"ValidationTaskResponse"},"ValidatorRegistrationResponse":{"properties":{"layer":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Layer"},"miner_uid_to_track":{"type":"integer","title":"Miner Uid To Track"},"miner_hotkey_to_track":{"type":"string","title":"Miner Hotkey To Track"},"model_cfg":{"anyOf":[{"$ref":"#/components/schemas/ModelConfig"},{"type":"null"}]},"model_metadata":{"anyOf":[{"$ref":"#/components/schemas/ModelMetadata"},{"type":"null"}]},"run_id":{"type":"string","title":"Run Id"},"run_flags":{"$ref":"#/components/schemas/RunFlags"}},"type":"object","required":["miner_uid_to_track","miner_hotkey_to_track","run_id","run_flags"],"title":"ValidatorRegistrationResponse"},"ValidatorTask":{"properties":{"task_result_id":{"type":"integer","title":"Task Result Id"},"task_type":{"type":"string","title":"Task Type"},"function_name":{"type":"string","title":"Function Name"},"inputs":{"additionalProperties":true,"type":"object","title":"Inputs"}},"type":"object","required":["task_result_id","task_type","function_name","inputs"],"title":"ValidatorTask"},"WeightSubmitResponse":{"properties":{"message":{"type":"string","title":"Message"},"should_upload_optimizer_state":{"type":"boolean","title":"Should Upload Optimizer State","default":false}},"type":"object","required":["message"],"title":"WeightSubmitResponse"},"WeightUpdate":{"properties":{"weights_path":{"type":"string","title":"Weights Path"},"attestation":{"anyOf":[{"$ref":"#/components/schemas/MinerAttestationPayload"},{"$ref":"#/components/schemas/MountedAttestationPayload"},{"$ref":"#/components/schemas/EnclaveSignResponse"},{"type":"null"}],"title":"Attestation"}},"type":"object","required":["weights_path"],"title":"WeightUpdate"}}}}