跳转至

/wallet/getpaginatedproposallist

分页获取提案列表。

  • 源码:framework/src/main/java/org/tron/core/services/http/GetPaginatedProposalListServlet.java
  • Method:GET / POST
  • Response:api.ProposalList

请求参数

字段 类型 必填 说明
offset int64 起始偏移;缺省为 0
limit int64 返回条数;缺省为 0,此时返回空列表
visible bool 地址格式

示例:

curl --request POST \
     --url https://nile.trongrid.io/wallet/getpaginatedproposallist \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "offset": 0,
  "limit": 1
}
'

响应

字段同 /wallet/listproposals

响应示例(Nile,limit=1;approvals 实际包含 27 位 SR 的地址,示例省略):

{
  "proposals": [
    {
      "proposal_id": 1,
      "proposer_address": "41217179d498883cdbda5699402905d1feb258796c",
      "parameters": [
        { "key": 9,  "value": 1 },
        { "key": 10, "value": 1 }
      ],
      "expiration_time": 1572597600000,
      "create_time": 1572596523000,
      "approvals": [
        "41217179d498883cdbda5699402905d1feb258796c"
        /* ... 其余 SR */
      ],
      "state": "APPROVED"
    }
  ]
}

异常响应

触发条件 响应
请求体超过 node.maxMessageSize(POST) {"Error": "class java.lang.Exception : body size is too big, the limit is <N>"}
offset / limit 不是数字(GET) {"Error": "class java.lang.NumberFormatException : <message>"}
请求体不是合法 JSON / 字段类型不符(POST) {"Error": "class com.alibaba.fastjson.JSONException : <解析器信息>"}{"Error": "class org.tron.core.services.http.JsonFormat$ParseException : <解码器信息>"}
其他异常 {"Error": "<exceptionClass> : <message>"}