get_transaction_status

async get_transaction_status(tx_id: str) -> dict

Get the status and details of a transaction by its ID.

https://developers.tron.network/reference/wallet-gettransactionbyid

Parameters:

• tx_id (str): The transaction ID.

Returns:

{
"ret":[
    {
        "contractRet":"SUCCESS"
    }
],
"signature":[
    "ffbf691a89d95f6ad8175611c7d334c8159b95ff9c1e83872e7670103b185e85faf0a394b23d99581385d38038ab5c4684759c864a5621009f6e95da0a5feab501"
],
"txID":"d0807adb3c5412aa150787b944c96ee898c997debdc27e2f6a643c771edb5933",
"raw_data":{
    "contract":[
        {
            "parameter":{
            "value":{
                "amount":16,
                "asset_name":"54726f6e696373",
                "owner_address":"414a5fe0179f2dd9c900194e63d661863cd0ade7b0",
                "to_address":"41718de6b323652d1257437ace160c4f4198aae4e1"
            },
            "type_url":"type.googleapis.com/protocol.TransferAssetContract"
            },
            "type":"TransferAssetContract"
        }
    ],
    "ref_block_bytes":"6bdd",
    "ref_block_hash":"1616edaf3a57fe19",
    "expiration":1546455678000,
    "timestamp":1546455620175
}
}

Raises:

• TransactionNotFound: If the transaction is not found.

• InvalidArgumentError: invalid hash value

• RpcConnectionError: RpcConnectionError

Example usage:

tron_client = AioTxTRONClient("NODE_URL")

# Get transaction status
status = await tron_client.get_transaction_status(
    "1eb454389c148f9b0e3fb458fffcb37569b6498d87b4945fbdef4d266c64089b"
)
print("Transaction status:", status)

Example output trx transaction 68bc7cf2fa0a356be43f893ff7466d26edbd86bf5874c1f8398b4a0662ee2e71:

{
    "ret": [
        {
            "contractRet": "SUCCESS"
        }
    ]
}

Part of example output from trc20 OUT_OF_ENERGY e63a324a43aebfe41273db4f7fdfe325b2257b4f5711595a5fc0f8a75cf1b481:

{
    "ret": [
        {
        "contractRet": "OUT_OF_ENERGY"
        }
    ]
}

Part of example output from trc20 SUCCESS:

{
    "ret": [
        {
        "contractRet": "SUCCESS"
        }
    ]
}

The get_transaction_status method provides a simple way to check if a transaction has been confirmed and was successful. This is particularly useful for: - Monitoring transaction confirmations - Verifying successful contract interactions - Checking energy consumption - Error handling for failed transactions

Note: The transaction ID should be a valid TRON transaction hash. For TRC20 token transfers or contract interactions, the contract_result field will contain relevant execution results.

Possible status codes https://github.com/tronprotocol/java-tron/blob/develop/Tron%20protobuf%20protocol%20document.md

DEFAULT = 0;

SUCCESS = 1;

REVERT = 2;

BAD_JUMP_DESTINATION = 3;

OUT_OF_MEMORY = 4;

PRECOMPILED_CONTRACT = 5;

STACK_TOO_SMALL = 6;

STACK_TOO_LARGE = 7;

ILLEGAL_OPERATION = 8;

STACK_OVERFLOW = 9;

OUT_OF_ENERGY = 10;

OUT_OF_TIME = 11;

JVM_STACK_OVER_FLOW = 12;

UNKNOWN = 13;

TRANSFER_FAILED = 14;