兑换 API

意图交易solver結算#

POST /settle#

  • 中標的 solver 將先前已求解的拍賣執行上鏈。
  • 待執行的拍賣由其 ID 識別,該 ID 由 solver 的 /solve 端點回傳。

注意事項:

  • 一旦 solver 接受 /settle 請求,即承諾在所要求的區塊數內將解決方案執行上鏈。
POST /settle
Content-Type: application/json

請求參數(SettleRequest)

參數類型必填說明範例
chainIndexString鏈 ID1
auctionIdString拍賣 ID123
submissionDeadlineLatestBlockString解決方案交易必須被打包進區塊的最晚區塊高度。12345678
settleInfosArray<SettleInfo>包含多組 ID:Solution ID(由 /solve 端點回傳)與 Settle ID(透過合約事件發出,用於業務關聯)。
> solutionIdStringSolution ID(由 /solve 端點回傳)1
> settleIdStringSettle ID(透過合約事件發出,用於業務關聯)456

POST /settle 請求範例:

json
{
  "chainIndex": "1",
  "auctionId": "16911293074615936",
  "settleInfos": [
    {
      "settleId": "16911293081366144",
      "solutionId": "1"
    }
  ],
  "submissionDeadlineLatestBlock": "24596909"
}

POST /settle 回應範例:

json
{
  "code": 0,
  "msg": "success",
  "error_code": "0",
  "error_message": "",
  "detailMsg": ""
}