GetTransactionById - Tron

Example code for the GetTransactionById gRPC method. Complete guide on how to use GetTransactionById gRPC method in GetBlock Web3 documentation.

This method returns a transaction by its id, including its contract data, signatures, and result.

Service

This method is served by the protocol.Wallet and protocol.WalletSolidity service.

This is a read method. It is also served by protocol.WalletSolidity, which returns only confirmed, irreversible data. Use the Solidity service for balance and payment verification.

Method

rpc GetTransactionById (BytesMessage) returns (Transaction)

Request Message

BytesMessage

Field	Type	Description
value	bytes	The transaction id (hash) as raw bytes

Request

grpcurl

grpcurl -H 'x-api-key: <ACCESS-TOKEN>' \
  -d '{"value": "d5ec749ecc2a615399d8a6c864ea4c74ff9f523c2be0e341ac9be5d47d7c2d62"}' \
  go.getblock.io:443 protocol.Wallet/GetTransactionById

Python

example.py

import grpc
# Stubs generated from java-tron's api.proto with grpcio-tools
from api import api_pb2_grpc
from core import Contract_pb2, Tron_pb2

creds = grpc.ssl_channel_credentials()
channel = grpc.secure_channel('go.getblock.io:443', creds)
metadata = [('x-api-key', '<ACCESS-TOKEN>')]
stub = api_pb2_grpc.WalletStub(channel)

response = stub.GetTransactionById(api_pb2.BytesMessage(value=bytes.fromhex('d5ec749ecc2a615399d8a6c864ea4c74ff9f523c2be0e341ac9be5d47d7c2d62')), metadata=metadata)
print(response)

Go

example.go

conn, _ := grpc.Dial(
    "go.getblock.io:443",
    grpc.WithTransportCredentials(credentials.NewTLS(&tls.Config{})),
)
defer conn.Close()

client := api.NewWalletClient(conn)
ctx := metadata.AppendToOutgoingContext(
    context.Background(), "x-api-key", "<ACCESS-TOKEN>")

resp, _ := client.GetTransactionById(ctx, &api.BytesMessage{Value: txidBytes})
fmt.Println(resp)

Response Message

Transaction

Field	Type	Description
raw_data	raw	The transaction's contracts and metadata
signature	repeated bytes	Signatures over the transaction
ret	repeated Result	Transaction result, with the contract return code

Use Cases

• Transaction Views: Render a transaction's contract and result

• Payment Confirmation: Read a transfer's amount and parties

• Signature Inspection: Read the signatures on a transaction

• Debugging: Inspect the raw contract data

Error Handling

Code	Status	Description
3	INVALID_ARGUMENT	A request field is missing or malformed
5	NOT_FOUND	The requested account, block, or transaction does not exist
16	UNAUTHENTICATED	The access token is missing or invalid
13	INTERNAL	The node failed to process the request