跳转至

/wallet/proposaldelete

撤销自己创建的提案(仅提案发起人)。

  • 源码:framework/src/main/java/org/tron/core/services/http/ProposalDeleteServlet.java
  • Method:POST
  • Contract:protocol.ProposalDeleteContract

请求参数

字段 类型 必填 说明
owner_address string 提案发起人地址
proposal_id int64 提案 ID
permission_id int32 多签权限 ID
visible bool 地址格式

示例:

curl --request POST \
     --url https://nile.trongrid.io/wallet/proposaldelete \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '
{
  "owner_address": "419c7c7049d26108be0dcb5f78479c6ff27ba101d1",
  "proposal_id":   1
}
'

响应

构造前会校验调用者必须是该提案的发起人且提案未过期 / 未被取消,因此真实调用须使用 /wallet/listproposalsstate=PENDINGproposer_address 等于 owner_address 的提案。示例账户不是 proposal_id=1 的发起人,Nile 实抓返回:

{"Error": "class org.tron.core.exception.ContractValidateException : Proposal[1] is not proposed by 419c7c7049d26108be0dcb5f78479c6ff27ba101d1"}

校验通过时返回未签名 protocol.Transaction,结构示意(txID / ref_block_* / expiration / timestamp / raw_data_hex 含义同 /wallet/createtransaction):

{
  "visible": false,
  "txID": "<由 raw_data 计算>",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "owner_address": "419c7c7049d26108be0dcb5f78479c6ff27ba101d1",
            "proposal_id":   1
          },
          "type_url": "type.googleapis.com/protocol.ProposalDeleteContract"
        },
        "type": "ProposalDeleteContract"
      }
    ],
    "ref_block_bytes": "<构造时最新固化块>",
    "ref_block_hash":  "<构造时最新固化块>",
    "expiration":      "<timestamp + 60_000>",
    "timestamp":       "<构造时刻>"
  },
  "raw_data_hex": "<raw_data 的 protobuf 编码>"
}

异常响应

触发条件 响应
请求体超过 node.maxMessageSize {"Error": "class java.lang.Exception : body size is too big, the limit is <N>"}
请求体不是合法 JSON / 字段类型不符 {"Error": "class com.alibaba.fastjson.JSONException : <解析器信息>"}{"Error": "class org.tron.core.services.http.JsonFormat$ParseException : <解码器信息>"}
owner_address 非法 {"Error": "class org.tron.core.exception.ContractValidateException : Invalid address"}
owner 账户不存在 {"Error": "... : Account[<address>] not exists"}
proposal_id > 最新提案编号 {"Error": "... : Proposal[<id>] not exists"}
提案 ID 在存储中找不到 {"Error": "... : Proposal[<id>] not exists"}
调用者不是该提案的发起人 {"Error": "... : Proposal[<id>] is not proposed by <address>"}
提案已过期 {"Error": "... : Proposal[<id>] expired"}
提案已被取消 {"Error": "... : Proposal[<id>] canceled"}
其他异常 {"Error": "<exceptionClass> : <message>"}