Skip to content
Minotaur
+ 05 · API Reference

API · Solver Round

Internal solver-round orchestration: round close, certify, activate, abort, and the champion-consensus proposal/finalize cycle.

All endpoints below are mounted under /v1 on the validator API (https://api.minotaursubnet.com). The CORS allowlist covers https://app.minotaursubnet.com.

GET /v1/solver/champion

Return the last activated/adopted champion snapshot.

Response: SolverChampionResponse

POST /v1/solver/champion/reattest

Force-resync the fleet to the CURRENT certified champion.

GET /v1/solver/champion/sync-bundle

Serve the standing champion’s force-sync chain for follower PULL reconcile.

GET /v1/solver/round

Return the current solver submission round.

Response: SolverRoundResponse

POST /v1/solver/round/abort

Abort a solver round without activating a challenger.

Query parameters

  • bodyAbortRoundRequest

Response: SolverRoundResponse

POST /v1/solver/round/activate

Activate a previously certified round at an explicit epoch.

Query parameters

  • bodyActivateRoundRequest

POST /v1/solver/round/certify

Persist a champion certificate for a replay-qualified finalist.

Query parameters

  • bodyCertifyRoundRequest

Response: SolverRoundResponse

POST /v1/solver/round/close

Explicitly close the current solver round for replay evaluation.

Query parameters

  • bodyCloseRoundRequest

Response: SolverRoundResponse

POST /v1/solver/round/consensus/proposal

Receive a champion certification proposal from the current round leader.

Query parameters

  • bodyChampionConsensusProposalRequest

POST /v1/solver/round/internal/abort

Persist a leader-broadcast round abort on this validator.

Query parameters

  • bodyAbortRoundRequest

Response: SolverRoundResponse

POST /v1/solver/round/internal/activate

Persist a leader-broadcast round activation on this validator.

Query parameters

  • bodyActivateRoundRequest

POST /v1/solver/round/internal/certify

Persist a leader-broadcast round certificate on this validator.

Query parameters

  • bodyCertifyRoundRequest

Response: SolverRoundResponse

POST /v1/solver/round/internal/close

Persist a leader-broadcast round close on this validator.

Query parameters

  • bodyCloseRoundRequest

Response: SolverRoundResponse

POST /v1/solver/round/internal/veto-assignment

Follower receiver: a leader-signed slice assignment.

POST /v1/solver/round/internal/veto-response

Leader receiver: a follower-signed slice verdict.

GET /v1/solver/round/{round_id}

Return a specific solver submission round by ID.

Path parameters

  • round_idstr (required)

Response: SolverRoundResponse

GET /v1/solver/round/{round_id}/veto-assignment

Serve the persisted assignment for one validator (leader side).

Path parameters

  • round_idstr (required)

Query parameters

  • validatorstr

GET /v1/solver/rounds

Paginated solver-round HISTORY (newest first), sourced from the durable order-book DB (AppIntentStore) that the round store mirrors into.

Query parameters

  • limitint
  • offsetint
  • statusstr | None

Response: SolverRoundsResponse