/wallet/getapprovedlist¶
根据账户当前权限验证全部签名后,返回交易的签名地址。验证失败时返回错误,不返回已批准地址列表。
- 源码:
framework/src/main/java/org/tron/core/services/http/GetTransactionApprovedListServlet.java - Method:
POST - Response:
api.TransactionApprovedList(api.proto)
请求参数¶
请求体同 /wallet/getsignweight:
| 字段 | 类型 | 必填 | 说明 |
|---|---|---|---|
raw_data |
object | 是 | 与 createtransaction 返回一致 |
raw_data_hex |
string | 否(节点忽略) | 同 broadcasttransaction:客户端可视化辅助字段,不参与验签 |
signature |
string[] | 否 | 已收集的签名;省略时仍可解析请求,若账户和权限检查通过,已批准地址列表为空 |
visible |
bool | 否 | 控制地址及 bytes 字段的格式;result.message 是 protobuf string,无论 visible 取值如何,均保持为 JSON 文本 |
示例:请求体为带 signature 的 Transaction JSON,结构同 /wallet/broadcasttransaction。
curl --request POST \
--url https://nile.trongrid.io/wallet/getapprovedlist \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"raw_data": { "...": "..." },
"raw_data_hex": "0a02...",
"signature": ["b8c0...01"]
}
'
上例为占位结构。实际权限检查通常使用由
/wallet/createtransaction等接口生成并加签的多签交易 JSON,但该接口也接受空的或省略的signature数组;若账户和权限检查通过,则不返回任何已批准地址。
响应¶
| 字段 | 类型 | 说明 |
|---|---|---|
approved_list |
repeated bytes | 已签名地址;visible=true 时为 base58 数组,visible=false 时为 hex(21 字节,带 41 前缀) |
result.code |
enum | SUCCESS / SIGNATURE_FORMAT_ERROR / COMPUTE_ADDRESS_ERROR / OTHER_ERROR |
result.message |
string | 错误描述,始终为 JSON 文本,不受 visible 影响 |
transaction |
TransactionExtention | 提交的交易及其已收集的签名 |
成功时,result.code 为 protobuf 默认值 SUCCESS,会在 JSON 中省略;因此没有消息时,result 对象为 {}。
响应示例:
{
"approved_list": ["41dd791d6b49e190062d650e6a23c575510d35f2f9"],
"result": {},
"transaction": {
"txid": "<由 raw_data 计算>",
"result": { "result": true },
"transaction": { "...": "..." }
}
}
注意:交易 JSON 解码后,签名格式、地址恢复和权限检查失败会写入响应的
result.code/result.message(HTTP 200)。下表列出返回{"Error": ...}形式响应的情况,包括 JSON 解码阶段的非法签名 hex。
protobuf JSON 解析器也接受将单个 hex 字符串作为 signature,并将其视为仅含一个元素的列表;非数组值不一定导致解析错误。正常请求请使用文档规定的数组形式。
异常响应¶
| 触发条件 | 响应 |
|---|---|
请求体超过 node.http.maxMessageSize |
通常由 SizeLimitHandler 返回 HTTP 413 Payload Too Large |
| 请求体不是合法 JSON | {"Error": "class org.tron.json.JSONException : <解析器信息>"} |
raw_data / raw_data.contract 缺失或为 null |
访问缺失的对象或数组时返回 {"Error": "class java.lang.NullPointerException : <message>"} |
raw_data 不是对象,或 raw_data.contract 不是数组(不包括能解析为所需结构的 JSON 字符串) |
{"Error": "class org.tron.json.JSONException : <message>"},例如 Field 'contract' is not an array |
签名 hex 非法,或 raw_data 中的字段值无法由 JsonFormat.merge 解码 |
packTransaction 捕获最终的 JsonFormat$ParseException 并返回 null,下游操作随后返回 {"Error": "class java.lang.NullPointerException : <message>"} |
| 其他异常 | {"Error": "<exceptionClass> : <message>"} |