/wallet/getcandelegatedmaxsize¶
Query the maximum amount of resource an account can currently delegate (Stake 2.0).
- Source:
framework/src/main/java/org/tron/core/services/http/GetCanDelegatedMaxSizeServlet.java - Method:
GET/POST - Response:
api.CanDelegatedMaxSizeResponseMessage - Solidity endpoint:
/walletsolidity/getcandelegatedmaxsize
Request parameters¶
| Field | Type | Required | Description |
|---|---|---|---|
owner_address |
string | Yes | Account address |
type |
int32 | No | Resource type: 0=BANDWIDTH (default), 1=ENERGY |
visible |
bool | No | Address format |
Example:
curl --request POST \
--url https://nile.trongrid.io/wallet/getcandelegatedmaxsize \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '
{
"owner_address": "41dd791d6b49e190062d650e6a23c575510d35f2f9",
"type": 1
}
'
Response¶
| Field | Type | Description |
|---|---|---|
max_size |
int64 | Maximum frozen amount that can be delegated (sun) |
Response example (account has 0 delegatable ENERGY; proto default is not serialized, returns empty {}; when there is delegatable resource it looks like {"max_size": 5000000000}):
{}
Error responses¶
| Trigger | Response |
|---|---|
Request body exceeds node.maxMessageSize (POST) |
{"Error": "class java.lang.Exception : body size is too big, the limit is <N>"} |
type is not numeric (GET) |
{"Error": "class java.lang.NumberFormatException : <message>"} |
owner_address is not valid base58check (visible=true) |
GET: with non-base58 characters, throws {"Error": "class java.lang.IllegalArgumentException : <details>"}; if only the checksum is wrong, Util.getHexAddress silently returns empty string → no record found, returns {}. POST (via JsonFormat.merge): with non-base58 characters, throws {"Error": "class org.tron.core.services.http.JsonFormat$ParseException : <pos>: INVALID base58 String, ..."}; if only the checksum is wrong, throws {"Error": "class java.lang.NullPointerException : null"} |
owner_address is not valid hex (visible=false) |
{"Error": "class org.bouncycastle.util.encoders.DecoderException : <message>"} (GET); {"Error": "class org.tron.core.services.http.JsonFormat$ParseException : <message>"} (POST) |
| Request body is not valid JSON / field type mismatch (POST) | {"Error": "class com.alibaba.fastjson.JSONException : <parser info>"} or {"Error": "class org.tron.core.services.http.JsonFormat$ParseException : <decoder info>"} |
| Other exceptions | {"Error": "<exceptionClass> : <message>"} |