getsignweight - Tron
getsignweight. Returns the current signature weight and threshold status of a multi-signature transaction.
getsignweight - tron [Value: 20CU]
Returns the current signature weight and threshold status of a multi-signature transaction.
Use cases
- Determine whether enough signatures have been collected to broadcast a multi-sig transaction
Constraints
- current_weight must reach the relevant permission's threshold before broadcasting will succeed
Unlock Access to 100+ chains
Boost your app's speed and reliability with dRPC - get your access API key
Language
Request
Examples
curl --request POST \
--url https://lb.drpc.live/tron/{API-KEY}/wallet/getsignweight \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"visible": true,
"signature": [
"1fd210045f5bdcf375cd478cf46ff735f132281b990bc199acf1952bd438929d1d03e12de5ea7dcb89cff5b8cfc5d161661a5c1fe6a6a2422edb313b9139075300"
],
"txID": "ee188aaf5cf78729d2d14d4db698126da2d75ef78a43837dafd6e6f591d103a2",
"raw_data": {
"contract": [
{
"parameter": {
"value": {
"amount": 125000000,
"owner_address": "TN9RRaXkCFtTXRso2GdTZxSxxwufzxLQPP",
"to_address": "TTSFjEG3Lu9WkHdp4JrWYhbGP6K1REqnGQ"
},
"type_url": "type.googleapis.com/protocol.TransferContract"
},
"type": "TransferContract"
}
],
"ref_block_bytes": "c251",
"ref_block_hash": "5c685c92bf035e72",
"expiration": 1578299967000,
"timestamp": 1578299909600
},
"raw_data_hex": "0a02c25122085c685c92bf035e7240988c89d0f72d5a68080112640a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412330a1541859009fd225692b11237a6ffd8fdba2eb7140cca121541bf97a54f4b829c4e9253b26024b1829e1a3b112018c0b2cd3b70e0cb85d0f72d"
}'Response
200
{
"permission": {
"permission_name": "owner",
"threshold": 1,
"keys": [
{
"address": "TN9RRaXkCFtTXRso2GdTZxSxxwufzxLQPP",
"weight": 1
}
]
},
"approved_list": [
"TN9RRaXkCFtTXRso2GdTZxSxxwufzxLQPP"
],
"current_weight": 1,
"result": {},
"transaction": {
"transaction": {
"raw_data": {
"ref_block_bytes": "c251",
"ref_block_hash": "5c685c92bf035e72",
"expiration": 1578299967000,
"contract": [
{
"parameter": {
"value": {
"owner_address": "TN9RRaXkCFtTXRso2GdTZxSxxwufzxLQPP",
"to_address": "TTSFjEG3Lu9WkHdp4JrWYhbGP6K1REqnGQ",
"amount": 125000000
},
"type_url": "type.googleapis.com/protocol.TransferContract"
},
"type": "TransferContract"
}
],
"timestamp": 1578299909600
},
"signature": [
"1fd210045f5bdcf375cd478cf46ff735f132281b990bc199acf1952bd438929d1d03e12de5ea7dcb89cff5b8cfc5d161661a5c1fe6a6a2422edb313b9139075300"
],
"raw_data_hex": "0a02c25122085c685c92bf035e7240988c89d0f72d5a68080112640a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412330a1541859009fd225692b11237a6ffd8fdba2eb7140cca121541bf97a54f4b829c4e9253b26024b1829e1a3b112018c0b2cd3b70e0cb85d0f72d",
"txID": "ee188aaf5cf78729d2d14d4db698126da2d75ef78a43837dafd6e6f591d103a2"
},
"txid": "ee188aaf5cf78729d2d14d4db698126da2d75ef78a43837dafd6e6f591d103a2",
"result": {
"result": true
}
}
}
Request params
idinteger
jsonrpcstring
methodstring
object
visibleboolean
Indicates whether addresses in this transaction are represented in base58 format (true) or hex format (false).
signaturearray_of_strings
The list of hex-encoded signatures already collected for this transaction.
txIDstring
The unique transaction hash (transaction ID), computed as the SHA256 of raw_data.
visibleboolean
Set to true to format addresses in Base58; set to false for hex format. (Default: false)
raw_dataobject
The unsigned transaction body containing the contract instruction and blockchain reference data.
object
contractarray_of_objects
The list of contract instructions to be executed by this transaction.
object
parameterobject
The typed payload describing the specific contract call being made.
object
valueobject
The decoded fields of the contract — here, a plain TRX transfer.
object
amountinteger
The amount of TRX to transfer, in sun.
owner_addressstring
The address sending the TRX.
to_addressstring
The address receiving the TRX.
type_urlstring
The fully qualified protobuf type identifier describing which contract schema `value` should be decoded with.
typestring
The human-readable name of the contract type being executed (here, TransferContract).
ref_block_bytesstring
The last two bytes of the reference block number, used for transaction expiration and replay protection.
ref_block_hashstring
The last eight bytes of the reference block's hash, paired with ref_block_bytes for replay protection.
expirationinteger
Unix timestamp, in ms, after which this transaction is no longer valid and will be rejected by the network.
timestampinteger
Unix timestamp, in ms, marking when the transaction was created/signed by the client.
raw_data_hexstring
The hex-encoded serialized bytes of raw_data, used as the actual payload that was signed.
Response
200
Returns the current signature weight and threshold status of a multi-signature transaction.Response params
object
permissionobject
The permission group against which the collected signatures are being evaluated.
object
permission_namestring
The label identifying this permission group (e.g. "owner").
thresholdinteger
The minimum combined key weight required to authorize this transaction under this permission.
keysarray_of_objects
The list of keys eligible to sign under this permission group.
object
addressstring
The address of the key holder.
weightinteger
The signing weight assigned to this key.
approved_listarray_of_strings
The list of addresses that have already signed this transaction.
current_weightinteger
The combined weight of all signatures collected so far, compared against the permission's threshold.
resultobject
The status of this sign-weight check; empty when no error occurred.
object
codestring
A machine-readable error code, present only if the check failed (e.g. invalid signature, permission not found).
messagestring
A human-readable explanation accompanying the error code, if any.
transactionobject
The transaction being evaluated, echoed back along with node-level processing results.
object
transactionobject
The full transaction object as parsed by the node.
object
raw_dataobject
The unsigned transaction body as parsed by the node.
object
ref_block_bytesstring
The last two bytes of the reference block number, used for transaction expiration and replay protection.
ref_block_hashstring
The last eight bytes of the reference block's hash, paired with ref_block_bytes for replay protection.
expirationinteger
Unix timestamp, in ms, after which this transaction is no longer valid.
contractarray_of_objects
The list of contract instructions parsed from the transaction, mirroring the request's raw_data.contract.
timestampinteger
Unix timestamp, in ms, marking when the transaction was created/signed by the client.
signaturearray_of_strings
The list of hex-encoded signatures attached to the transaction.
raw_data_hexstring
The hex-encoded serialized bytes of raw_data.
txIDstring
The unique transaction hash (transaction ID), computed as the SHA256 of raw_data.
txidstring
The transaction hash, duplicated here at the outer level for convenience.
resultobject
Low-level acceptance status of the transaction at the node.
object
resultboolean
Whether the node's internal validation step for this transaction passed.