Home

gRPC — modified methods

Endpoint:

Endpoint:

Copied!
iota-grpc.nownodes.io

Authentication:

Copied!
api-key: YOUR_API_KEY

Official proto sources:

Copied!
https://github.com/iotaledger/iota
https://github.com/iotaledger/iota-rust-sdk

iota.grpc.v1.transaction_execution_service.TransactionExecutionService

ExecuteTransactions

Changed. Errors for an invalid transaction now carry google.rpc.ErrorInfo, which tells a rejection by validators apart from a transaction the node proved invalid locally. During overload, RetryInfo with a retry hint is populated again.

Description: Broadcasts one or more signed transactions through the iota.grpc.v1.transaction_execution_service.TransactionExecutionService gRPC service and returns each transaction's execution result. Transactions execute sequentially in order; each is provided as BCS bytes together with its UserSignatures. The default read_mask is transaction.digest,effects,events,input_objects,output_objects. An optional checkpointInclusionTimeoutMs makes the server wait for checkpoint inclusion. Full method:

Copied!
iota.grpc.v1.transaction_execution_service.TransactionExecutionService/ExecuteTransactions

Request:

Copied!
{
  "transactions": [
    {
      "transaction": {
        "bcs": {
          "data": "BASE64_BCS"
        }
      },
      "signatures": {
        "signatures": [
          {
            "bcs": {
              "data": "BASE64_BCS"
            }
          }
        ]
      }
    }
  ]
}

Example:

Copied!
grpcurl \
  -insecure \
  -H 'api-key: YOUR_API_KEY' \
  -d '{"transactions":[{"transaction":{"bcs":{"data":"BASE64_BCS"}},"signatures":{"signatures":[{"bcs":{"data":"BASE64_BCS"}}]}}]}' \
  'iota-grpc.nownodes.io' \
  iota.grpc.v1.transaction_execution_service.TransactionExecutionService/ExecuteTransactions

Response example:

Copied!
{
  "transactionResults": [
    {
      "executedTransaction": {
        "transaction": {
          "digest": {
            "digest": "BASE64_DIGEST"
          }
        },
        "effects": {
          "digest": {
            "digest": "BASE64_DIGEST"
          }
        },
        "checkpoint": "168035505",
        "timestamp": "2026-07-17T18:35:00.000Z"
      }
    }
  ]
}