文档首页/ Web3节点引擎服务 NES/ API参考/ API/ 专享版/ MEV-Boost相关/ 校验relay地址
更新时间：2024-01-31 GMT+08:00
查看PDF
分享

校验relay地址

功能介绍

校验指定的Mev-Relay地址是否可用

URI

POST /v1/{project_id}/node-provider/networks/{network_id}/mev-relays/validation

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

项目ID

最小长度：32

最大长度：32

network_id

是

String

网络ID

最小长度：36

最大长度：36

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

用户Token

最小长度：1

最大长度：65535
表3 请求Body参数

参数

是否必选

参数类型

描述

relays

是

Array of strings

new relays

最小长度：1

最大长度：1000

数组长度：0 - 100

响应参数

状态码： 400

表4 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度：3

最大长度：3

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：1

最大长度：65535

message

String

错误详细信息

最小长度：0

最大长度：65535

状态码： 401

表5 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度：3

最大长度：3

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：1

最大长度：65535

message

String

错误详细信息

最小长度：0

最大长度：65535

状态码： 422

表6 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度：3

最大长度：3

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：1

最大长度：65535

valid_relays

Array of strings

可用的relays

最小长度：1

最大长度：1000

数组长度：0 - 1000

invalid_relays

Array of invalid_relays objects

不可用的relays

数组长度：0 - 1000
表7 invalid_relays

参数

参数类型

描述

relay

String

不可用relay地址

最小长度：1

最大长度：1000

reason

String

不可用原因

最小长度：1

最大长度：1000

状态码： 500

表8 响应Body参数

参数

参数类型

描述

code

String

状态码

最小长度：3

最大长度：3

error_code

String

错误码

最小长度：12

最大长度：12

error_msg

String

错误信息

最小长度：1

最大长度：65535

message

String

错误详细信息

最小长度：0

最大长度：65535

请求示例

{
  "relays" : [ "https://0xa7ab7a996c8584251c8f925da3170bdfd6ebc75d50f5ddc4050a6fdc77f2a3b5fce2cc750d0865e05d7228af97d69561@agnostic-relay.net", "https://0xa7ab7a996c8584251c8f925da3170bdfd6ebc75d50f5ddc4050a6fdc77f2a3b5fce2cc750d0865e05d7228af97d69561@agnostic-relay.net" ]
}

响应示例

状态码： 200

全部MEV Relays合法

{
  "code" : 200
}

状态码： 400

请求参数校验不通过

{
  "code" : 400,
  "error_code" : "BCS.03400001",
  "error_msg" : "Invalid request.",
  "message" : "unmarshal request data error"
}

状态码： 401

鉴权失败

{
  "code" : 401,
  "error_code" : "BCS.03401001",
  "error_msg" : "Authorization failed.",
  "message" : "request token is not valid"
}

状态码： 422

部分MEV Relays不合法

{
  "status" : "partial_error",
  "data" : {
    "valid_relays" : [ "relay1", "..." ],
    "invalid_relays" : [ {
      "relay" : "relay2",
      "reason" : "Unreachable Relay"
    }, {
      "relay" : "relay3",
      "reason" : "Failed to Parse URI"
    } ]
  }
}

状态码： 500

服务内部执行错误

{
  "code" : 500,
  "error_code" : "BCS.03500001",
  "error_msg" : "Internal error.",
  "message" : "project [xxx] node [xxx] get service bearer user token error"
}

状态码

状态码

描述

200

全部MEV Relays合法

400

请求参数校验不通过

401

鉴权失败

422

部分MEV Relays不合法

500

服务内部执行错误

错误码

请参见错误码。

父主题： MEV-Boost相关