Methods
SendTransaction
Submit a new transaction to the cluster.Request message type
Response message type
BatchSendTransactions
Submit multiple transactions to the cluster in batch.Request message type
Response message type
SendAndTrackTxn
Submit a transaction and track its execution status. Returns a stream of status updates starting with RECEIVED, then ACCEPTED, followed by consensus and execution updates, closing after the transaction is executed.Request message type
Response message type
This method uses streaming responses.
Messages
BatchSendTransactionsRequest
| Field | Type | Description |
|---|---|---|
raw_transactions | repeated ``bytes | List of raw transaction bytes encoded according to chain specification. |
num_retries | int32 | Number of retries for each transaction if not accepted by UDS (defaults to 0). |
BatchSendTransactionsResponse
| Field | Type | Description |
|---|---|---|
signatures | repeated ``thru.common.v1.Signature | Signatures for each transaction (in same order as request). |
accepted | repeated ``bool | Acceptance status for each transaction (true if accepted, false if not). |
SendAndTrackTxnRequest
| Field | Type | Description |
|---|---|---|
transaction | bytes | Raw transaction bytes encoded according to chain specification. |
timeout | google.protobuf.Duration | Optional timeout for tracking the transaction execution. If not specified, the stream will remain open until the transaction is executed or the client cancels. |
SendAndTrackTxnResponse
| Field | Type | Description |
|---|---|---|
status | SubmissionStatus | Current submission status of the transaction. |
signature | thru.common.v1.Signature | Transaction signature (populated for tracking messages). |
consensus_status | thru.common.v1.ConsensusStatus | Consensus status (populated for tracking messages). |
execution_result | thru.core.v1.TransactionExecutionResult | Execution result (populated for tracking messages when execution completes). |
SendTransactionRequest
| Field | Type | Description |
|---|---|---|
raw_transaction | bytes | Raw transaction bytes encoded according to chain specification. |
SendTransactionResponse
| Field | Type | Description |
|---|---|---|
signature | thru.common.v1.Signature |
Enums
SubmissionStatus
SubmissionStatus represents the status of a transaction in the submission pipeline.| Value | Number | Description |
|---|---|---|
SUBMISSION_STATUS_UNSPECIFIED | 0 | Submission status is unspecified (default value). |
SUBMISSION_STATUS_RECEIVED | 1 | Transaction has been received by the gRPC server. |
SUBMISSION_STATUS_ACCEPTED | 2 | Transaction has been accepted by the forwarder via UDS. |