TItig-foundation
POST

Submit a precommit

Changed on

Submit benchmark settings and per-track settings for all active tracks of the challenge. The server selects a track at random; the returned precommit will indicate the selected track.

Notes

  • This endpoint can only be invoked once every few seconds

  • track_settings must include every active track for the challenge (key = track_id). Each value has hyperparameters, fuel_budget, and num_bundles.

  • When a precommit is confirmed (precommit.state != null), a random string will be set (precommit.state.rand_hash). This string must be used when generating seeds.

post/submit-precommit

Request

Headers

X-Api-Keystring

<api_key> from /request-api-key endpoint

Request body

track_settingsobject required

Settings per active track (key = track_id). Must include all active tracks for the challenge.

compute_type'aws_t3' | 'aws_t3a' | 'aws_t4g' | 'aws_c7i' | 'aws_c7a' | 'aws_c7g' | 'aws_m7i' | 'aws_m7a' | 'aws_m7g' | 'aws_g4dn' required

Compute that can reproduce the results

Example request

{
  "settings": {
    "challenge_id": "c002",
    "algorithm_id": "c002_a001",
    "track_id": "num_variables=100,clauses_to_variables_percent=426"
  }
}

Response

Success

benchmark_idstring

Changes

  • fad74baea1a5Revision changes
    • breaking

      added the new required request property

  • 9d7802077a26Revision changes
    • breaking

      added the new required request property

    • breaking

      the request property became required

    • warning

      removed the request property

    • warning

      removed the request property

    • warning

      removed the request property